rusty-fmp 0.5.1

JSON CLI and client library for Financial Modeling Prep
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

//! SEC command group for SEC filing searches.

use clap::Subcommand;

use crate::cli::args::SymbolDateRangeArgs;
use crate::cli::dispatch::run_by_symbol_date_range;
use crate::cli::help;
use crate::cli::output::CommandPayload;
use crate::client::FmpClient;
use crate::endpoint;
use crate::error::Result;

/// Default lookback period for SEC filings when `--from` is omitted.
const SEC_FILINGS_LOOKBACK_DAYS: i64 = 90;

/// SEC filing search subcommands.
#[derive(Debug, Subcommand)]
pub(crate) enum Cmd {
    /// Get SEC filing metadata for a stock ticker.
    #[command(
        about = help::SEC_FILINGS_ABOUT,
        long_about = help::SEC_FILINGS_LONG
    )]
    Filings(SymbolDateRangeArgs),
}

/// Dispatch an SEC group command.
///
/// # Errors
///
/// Returns an error when the API request fails or the response cannot be parsed.
pub(crate) async fn dispatch(client: &FmpClient, cmd: &Cmd) -> Result<CommandPayload> {
    match cmd {
        Cmd::Filings(args) => {
            let from = args.from.clone().or_else(|| {
                let ago = jiff::Zoned::now()
                    .checked_sub(jiff::Span::new().days(SEC_FILINGS_LOOKBACK_DAYS))
                    .expect("90-day subtraction from current date cannot fail");
                Some(ago.date().to_string())
            });
            run_by_symbol_date_range(
                client,
                endpoint::SEC_FILINGS_SEARCH_SYMBOL,
                &args.symbol,
                &from,
                &args.to,
            )
            .await
        }
    }
}