libfmp 0.2.0

Async, typed Rust client for the Financial Modeling Prep API
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use libfmp::responses::directory::{
    ActivelyTradingSymbol, CikEntry, CompanySymbol, EarningsTranscriptAvailability, EtfSymbol,
    FinancialStatementSymbol, SymbolChange,
};

#[test]
fn documented_directory_rows_decode_exact_field_names_and_wire_types() {
    let companies: Vec<CompanySymbol> =
        serde_json::from_str(include_str!("fixtures/directory_company_symbols.json")).unwrap();
    let financials: Vec<FinancialStatementSymbol> = serde_json::from_str(include_str!(
        "fixtures/directory_financial_statement_symbols.json"
    ))
    .unwrap();
    let ciks: Vec<CikEntry> =
        serde_json::from_str(include_str!("fixtures/directory_cik_list.json")).unwrap();
    let changes: Vec<SymbolChange> =
        serde_json::from_str(include_str!("fixtures/directory_symbol_changes.json")).unwrap();
    let etfs: Vec<EtfSymbol> =
        serde_json::from_str(include_str!("fixtures/directory_etf_symbols.json")).unwrap();
    let active: Vec<ActivelyTradingSymbol> =
        serde_json::from_str(include_str!("fixtures/directory_actively_trading.json")).unwrap();
    let transcripts: Vec<EarningsTranscriptAvailability> = serde_json::from_str(include_str!(
        "fixtures/directory_earnings_transcript_list.json"
    ))
    .unwrap();

    assert_eq!(companies[0].symbol.as_str(), "URBANCO.BO");
    assert_eq!(companies[0].company_name, "Urban Company Limited");

    assert_eq!(financials[0].symbol.as_str(), "RMES.CN");
    assert_eq!(financials[0].company_name, "Red Metal Resources Ltd.");
    assert_eq!(financials[0].trading_currency.as_str(), "CAD");
    assert_eq!(financials[0].reporting_currency.as_str(), "USD");

    assert_eq!(ciks[0].cik.as_str(), "0002137358");
    assert_eq!(ciks[0].company_name, "Osotspa Public Co Limited/ADR");

    assert_eq!(changes[0].date.to_string(), "2026-07-28");
    assert_eq!(
        changes[0].company_name,
        "Yarrow Bioscience, Inc. Common Stock"
    );
    assert_eq!(changes[0].old_symbol.as_str(), "VYNE");
    assert_eq!(changes[0].new_symbol.as_str(), "YARW");

    assert_eq!(etfs[0].symbol.as_str(), "P60.SI");
    assert_eq!(
        etfs[0].name,
        "MULTI-UNITS LUXEMBOURG - Lyxor MSCI AC Asia Pacific Ex Japan UCITS ETF"
    );
    assert_eq!(active[0].symbol.as_str(), "URBANCO.BO");
    assert_eq!(active[0].name, "Urban Company Limited");

    assert_eq!(transcripts[0].symbol.as_str(), "INBS");
    assert_eq!(
        transcripts[0].company_name,
        "Intelligent Bio Solutions Inc."
    );
    assert_eq!(transcripts[0].no_of_transcripts.as_str(), "6");

    let company_wire = serde_json::to_value(&companies[0]).unwrap();
    let etf_wire = serde_json::to_value(&etfs[0]).unwrap();
    let transcript_wire = serde_json::to_value(&transcripts[0]).unwrap();
    assert_eq!(company_wire["companyName"], "Urban Company Limited");
    assert!(company_wire.get("name").is_none());
    assert_eq!(etf_wire["name"], etfs[0].name);
    assert!(etf_wire.get("companyName").is_none());
    assert_eq!(transcript_wire["noOfTranscripts"], "6");
    assert!(transcript_wire["noOfTranscripts"].is_string());
}

#[test]
fn every_directory_response_contract_preserves_empty_arrays() {
    let empty = include_str!("fixtures/directory_empty.json");

    assert!(
        serde_json::from_str::<Vec<CompanySymbol>>(empty)
            .unwrap()
            .is_empty()
    );
    assert!(
        serde_json::from_str::<Vec<FinancialStatementSymbol>>(empty)
            .unwrap()
            .is_empty()
    );
    assert!(
        serde_json::from_str::<Vec<CikEntry>>(empty)
            .unwrap()
            .is_empty()
    );
    assert!(
        serde_json::from_str::<Vec<SymbolChange>>(empty)
            .unwrap()
            .is_empty()
    );
    assert!(
        serde_json::from_str::<Vec<EtfSymbol>>(empty)
            .unwrap()
            .is_empty()
    );
    assert!(
        serde_json::from_str::<Vec<ActivelyTradingSymbol>>(empty)
            .unwrap()
            .is_empty()
    );
    assert!(
        serde_json::from_str::<Vec<EarningsTranscriptAvailability>>(empty)
            .unwrap()
            .is_empty()
    );
}