Struct WyomingRequest 

#[non_exhaustive]
pub struct WyomingRequest {
    pub station: String,
    pub time_unix_s: i64,
    pub version: WyomingVersion,
    pub endpoint: Option<String>,
}

What to ask the archive for: a station, the sounding’s nominal hour and its version.

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.

station: String

The station’s WMO number (such as 72364), or the name the archive knows it by.

time_unix_s: i64

The sounding’s nominal time, a whole UTC hour (usually 00 or 12), seconds since the Unix epoch. The balloon is released about an hour before.

version: WyomingVersion

Which version to ask for.

endpoint: Option<String>

Another server with the same interface, instead of ENDPOINT: an address with no query (?) or fragment (#), to which the request’s own query is added.

Implementations

impl WyomingRequest

pub fn new(station: impl Into<String>, time_unix_s: i64) -> Self

A request for station’s coded-message sounding at the whole hour time_unix_s.

pub fn latest_before(station: impl Into<String>, launch_unix_s: i64) -> Self

A request for the latest 00 or 12 UTC sounding at or before launch_unix_s (seconds since the Unix epoch): the one a launch at that time would have had. Near its nominal hour a sounding may still be filling in; WyomingRequest::source keeps such an answer fresh for an hour only.

pub fn url(&self) -> Result<String, WyomingError>

The URL: …?datetime=YYYY-MM-DD%20HH:00:00&id=<station>&type=TEXT:CSV&src=<version>.

The URL is the cache key, and it holds no coordinates: the caller names the station, and nothing here picks one from a site’s latitude and longitude. A site kept in radians can’t change it.

Errors

WyomingError::Request when the station is empty, longer than 16 characters or not letters and digits, the time is not a whole hour from 1970 to 9999, or the endpoint is empty or has a ? or #.

pub fn source(&self, now_s: u64) -> Source

The cache’s view of the source at now_s (seconds since the Unix epoch): the archive’s name, ATTRIBUTION, and how long a cached answer stays fresh.

Until SETTLE_S after the nominal hour the sounding may still be filling in, so an answer stays fresh for YOUNG_TTL_S. After that, only an answer fetched after the sounding settled is fresh, for up to SETTLED_TTL_S: a copy fetched while it was young is fetched again online (and still served offline, marked stale).

Trait Implementations

impl Clone for WyomingRequest

fn clone(&self) -> WyomingRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WyomingRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WyomingRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for WyomingRequest

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for WyomingRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for WyomingRequest