Struct ProducerVersion 

pub struct ProducerVersion(/* private fields */);

The fraiseql build that produced a compiled schema (#1304).

A compiled schema is a build artifact of the release that produced it, and its meaning is not stable across releases — an absent field is a value the runtime reads, not a gap it ignores. pagination_order is the worked example: 2.14 wrote none, 2.15 reads its absence as “this query has no page order”, so a 2.14 artifact paginates a 2.15 runtime into overlapping pages under a 200, which is the defect 2.15 shipped to remove. Nothing about that is visible to an operator.

The stamp is therefore compared, never interpreted: a runtime does not decide whether some other build’s artifact is close enough, because deciding that is the judgement #1303 got wrong. What the type buys over the Option<u32> format version it replaces is that the two producers of a CompiledSchema can no longer collapse into one value:

• the compiler stamps the build it is part of into the artifact it writes;
• a CompiledSchema built in process is this build, so Default yields it;
• an artifact carrying no stamp is unstamped, a third value — where None previously meant both “compiled before versioning existed” and “freshly constructed”, and was accepted on the strength of the second reading.

See docs/adr/0020-compiled-schema-build-identity.md.

Implementations

impl ProducerVersion

pub const fn unstamped() -> Self

The value an artifact carrying no fraiseql_version deserializes to.

Reachable only through deserialization: Default is this build, so a missing JSON key is the one way to obtain it.

pub fn get(&self) -> Option<&str>

The build named by the stamp, or None when the artifact carries none.

pub const fn is_unstamped(&self) -> bool

Whether the artifact carries no stamp.

Trait Implementations

impl Clone for ProducerVersion

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 ProducerVersion

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

Formats the value using the given formatter.

impl Default for ProducerVersion

fn default() -> Self

This build — the honest answer for a schema this binary just constructed.

impl<'de> Deserialize<'de> for ProducerVersion

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ProducerVersion

impl PartialEq for ProducerVersion

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ProducerVersion

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 ProducerVersion