use std::str::FromStr;
use serde::{Deserialize, Deserializer, Serialize};
use super::wire::wire_enum;
use crate::ValidationError;
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash, Serialize, derive_more::Display)]
#[serde(transparent)]
pub struct FinancialReport(String);
impl FinancialReport {
pub fn parse(value: impl Into<String>) -> Result<Self, ValidationError> {
let value = value.into();
let bytes = value.as_bytes();
let valid = bytes.len() == 6
&& bytes[..4].iter().all(u8::is_ascii_digit)
&& bytes[4] == b'-'
&& matches!(bytes[5], b'1'..=b'4');
if !valid {
return Err(ValidationError::new("report", "must use YYYY-[1-4] format"));
}
Ok(Self(value))
}
#[must_use]
pub fn as_str(&self) -> &str {
&self.0
}
}
impl FromStr for FinancialReport {
type Err = ValidationError;
fn from_str(value: &str) -> Result<Self, Self::Err> {
Self::try_from(value)
}
}
impl TryFrom<&str> for FinancialReport {
type Error = ValidationError;
fn try_from(value: &str) -> Result<Self, Self::Error> {
Self::parse(value)
}
}
impl TryFrom<String> for FinancialReport {
type Error = ValidationError;
fn try_from(value: String) -> Result<Self, Self::Error> {
Self::parse(value)
}
}
impl TryFrom<&String> for FinancialReport {
type Error = ValidationError;
fn try_from(value: &String) -> Result<Self, Self::Error> {
Self::parse(value)
}
}
impl From<&FinancialReport> for FinancialReport {
fn from(value: &FinancialReport) -> Self {
value.clone()
}
}
impl AsRef<str> for FinancialReport {
fn as_ref(&self) -> &str {
self.as_str()
}
}
impl<'de> Deserialize<'de> for FinancialReport {
fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
let value = String::deserialize(deserializer)?;
Self::parse(value).map_err(serde::de::Error::custom)
}
}
wire_enum! {
pub enum FinancialPeriod {
Annual => "annual",
Quarterly => "quarterly",
}
}
wire_enum! {
pub enum FiscalPeriod {
FullYear => "FY",
FirstQuarter => "Q1",
SecondQuarter => "Q2",
ThirdQuarter => "Q3",
FourthQuarter => "Q4",
}
}
wire_enum! {
pub enum FinancialAbilityKind {
Growth => "growth",
Profitability => "profitability",
Solvency => "solvency",
Operation => "operation",
CashFlow => "cash-flow",
}
}
wire_enum! {
pub enum FinancialIndicatorId {
TotalAssetsGrowthRatio => "total_assets_growth_ratio",
NetProfitYoyGrowthRatio => "net_profit_yoy_growth_ratio",
#[serde(alias = "calculate_operating_income_yoy_growth_ratio")]
OperatingIncomeYoyGrowthRatio => "operating_income_yoy_growth_ratio",
#[serde(alias = "calculate_operating_profit_yoy_growth_ratio")]
OperatingProfitYoyGrowthRatio => "operating_profit_yoy_growth_ratio",
FixedAssetInvestExpansionRatio => "fixed_asset_invest_expansion_ratio",
#[serde(alias = "calculate_parent_holder_net_profit_yoy_growth_ratio")]
ParentHolderNetProfitYoyGrowthRatio => "parent_holder_net_profit_yoy_growth_ratio",
SaleGrossMargin => "sale_gross_margin",
SaleNetInterestRatio => "sale_net_interest_ratio",
TotalAssetsNetRatio => "total_assets_net_ratio",
DeductWeightedAverageReturnOnEquity => "index_deduct_weighted_avg_roe",
WeightedAverageReturnOnEquity => "index_weighted_avg_roe",
CurrentRatio => "current_ratio",
QuickRatio => "quick_ratio",
AssetsDebtRatio => "assets_debt_ratio",
CashRatio => "cash_ratio",
EarnedInterestMultiple => "earned_interest_multiple",
LongTermDebtEquityRatio => "long_term_debt_equity_ratio",
TotalAssetsTurnoverRatio => "total_assets_turnover_ratio",
InventoryTurnoverRatio => "inventory_turnover_ratio",
CurrentAssetsTurnoverRatio => "current_assets_turnover_ratio",
ReceiveAccountTurnoverRatio => "receive_account_turnover_ratio",
CashOperatingIndex => "cash_operating_index",
OperatingCashFlowNetDivideIncome => "operating_cash_flow_net_divide_income",
NetProfitCashContent => "net_profit_cash_content",
OperatingCashNetYoyGrowthRatio => "operating_cash_net_yoy_growth_ratio",
CashMeetInvestRatio => "cash_meet_invest_ratio",
}
}
#[cfg(test)]
mod tests {
use super::FinancialReport;
#[test]
fn financial_report_uses_standard_fallible_conversion() {
let report = FinancialReport::try_from("2024-4").unwrap();
assert_eq!(report.as_str(), "2024-4");
assert!(FinancialReport::try_from("2024-5".to_owned()).is_err());
}
}