ftracker-identifiers 0.0.2

Validated, no_std-first identifier types: CNPJ, ISIN, CFI, and ISO 3166-1 country codes.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

//! [`JsonSchema`] implementation for [`Cfi`].
//!
//! Enabled by the `schemars` feature. The schema is a structural, pattern-constrained string: it
//! captures the six-uppercase-letter shape, but a regex cannot express which category/group/
//! attribute *combinations* ISO 10962 actually defines. Deserialization (via the `serde` feature)
//! still enforces the full taxonomy.

#[cfg(not(feature = "std"))]
extern crate alloc;

#[cfg(not(feature = "std"))]
use alloc::borrow::Cow;
#[cfg(feature = "std")]
use std::borrow::Cow;

use schemars::{JsonSchema, Schema, SchemaGenerator, json_schema};

use super::Cfi;

impl JsonSchema for Cfi {
    fn schema_name() -> Cow<'static, str> {
        Cow::Borrowed("Cfi")
    }

    fn json_schema(_: &mut SchemaGenerator) -> Schema {
        json_schema!({
            "type": "string",
            "format": "cfi",
            "minLength": 6,
            "maxLength": 6,
            "pattern": "^[A-Z]{6}$",
            "description": "CFI (Classification of Financial Instruments, ISO 10962). \
            The pattern is structural; taxonomic validity is enforced on deserialization."
        })
    }
}

#[cfg(test)]
mod tests {
    use super::super::Cfi;
    use schemars::schema_for;

    #[test]
    fn schema_is_a_pattern_constrained_string() {
        let schema = schema_for!(Cfi);
        let json = serde_json::to_value(&schema).unwrap();

        assert_eq!(json["type"], "string");
        assert_eq!(json["format"], "cfi");
        assert_eq!(json["minLength"], 6);
        assert_eq!(json["maxLength"], 6);
        assert_eq!(json["pattern"], "^[A-Z]{6}$");
    }
}