Struct LseBondYieldQuery 

#[non_exhaustive]
pub struct LseBondYieldQuery {
    pub country: SmolStr,
    pub maturity: Option<SmolStr>,
    pub start: NaiveDate,
    pub end: NaiveDate,
}

A bond-yield request.

#[non_exhaustive]: construct with new and with_maturity so a parameter added alongside a future provider filter does not break callers.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

country: SmolStr

Country code, in any spelling LseBondYieldStats::normalise_country accepts.

maturity: Option<SmolStr>

Tenor label, or None for every tenor the country publishes.

Omitting it is a genuine bulk request: all of the United States over its full history is 76,406 rows across 15 tenors.

start: NaiveDate

First date of the requested window, inclusive.

end: NaiveDate

Last date of the requested window, inclusive.

Implementations

impl LseBondYieldQuery

pub fn new( country: impl Into<SmolStr>, start: NaiveDate, end: NaiveDate, ) -> Self

A query for every tenor a country publishes, over [start, end] inclusive.

Narrow it to one tenor with with_maturity.

pub fn with_maturity(self, maturity: impl Into<SmolStr>) -> Self

Restrict the query to one tenor, named as the provider labels it ("5Y", "10Y TIPS").

pub fn validate(&self, stats: &LseBondYieldStats) -> Result<(), LseError>

Check this query against the provider’s published coverage.

Called unconditionally by fetch_bond_yields, so it cannot be skipped; it is public so a caller can screen a batch of queries without spending a request on each.

Checks, in order: that the window is not inverted, that the country is published, that the tenor is published for it, and that the window overlaps that series’ own coverage. A partial overlap passes — it returns the rows that exist, which is what was asked for; only a disjoint window is rejected.

Errors

• LseError::InvalidInput if end precedes start.
• LseError::UnknownBondYieldCountry if the country is not published.
• LseError::UnknownBondYieldMaturity if the tenor is not published for that country.
• LseError::BondYieldRangeOutsideCoverage if the window is disjoint from the series’.
• LseError::Deserialize if a date in stats is not in the provider’s spelling.

Trait Implementations

impl Clone for LseBondYieldQuery

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LseBondYieldQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for LseBondYieldQuery

impl PartialEq for LseBondYieldQuery

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for LseBondYieldQuery