Functional Weave
Code in Python

form.address@1.0.0

impl/rust/address_format.rs

2,369 bytes · the Rust implementation · view raw

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

use super::form_address_data::{CountryFormat, COUNTRIES};  ← this capability’s own data, compiled from data/countries.json into the same file by fune build
use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one

// The UK and the Crown Dependencies share Royal Mail's postcode format.
const UK_FAMILY: [&str; 4] = ["GB", "GG", "JE", "IM"];

/// Leading and trailing ASCII whitespace removed, the same in every language.
pub fn trim_ascii(value: &str) -> &str {
    value.trim_matches(|c: char| matches!(c, ' ' | '\t' | '\n' | '\r' | '\x0c' | '\x0b'))
}

/// ASCII letters upper-cased; everything else as it is.
pub fn upper_ascii(value: &str) -> String {
    value.to_ascii_uppercase()
}

/// Whether a country code (already upper case) uses the UK postcode format.
pub fn is_uk_family(code: &str) -> bool {
    UK_FAMILY.contains(&code)
}

/// The country's row, by its code as typed (trimmed, any case), or None.
pub fn lookup_country(country: &str) -> Option<&'static CountryFormat> {
    let code = upper_ascii(trim_ascii(country));
    COUNTRIES.iter().find(|row| row.code == code)
}

/// How an address form for a country labels and checks its fields.
///
/// # Panics
/// Panics on a code that is not an ISO 3166-1 alpha-2 country.
pub fn address_format(country: &str) -> AddressFormat {
    let row = match lookup_country(country) {
        Some(row) => row,
        None => panic!("unknown country \"{}\": give an ISO 3166-1 alpha-2 code, such as GB, US or DE", country),
    };
    AddressFormat {
        country: row.code.to_string(),
        name: row.name.to_string(),
        uk: is_uk_family(row.code),
        postcode_label: row.postcode_label.to_string(),
        postcode_required: row.postcode_required,
        postcode_example: row.postcode_example.map(|s| s.to_string()),
        region_label: row.region_label.to_string(),
    }
}

pub fn address_format_to_value(format: &AddressFormat) -> Value {
    Value::obj(vec![
        ("country", Value::str(&format.country)),
        ("name", Value::str(&format.name)),
        ("uk", Value::Bool(format.uk)),
        ("postcodeLabel", Value::str(&format.postcode_label)),
        ("postcodeRequired", Value::Bool(format.postcode_required)),
        ("postcodeExample", format.postcode_example.as_deref().map(Value::str).unwrap_or(Value::Null)),
        ("regionLabel", Value::str(&format.region_label)),
    ])
}

pub fn fune_vector(args: &[Value]) -> Value {
    address_format_to_value(&address_format(args[0].as_str()))
}