Enum HeaderV1 

pub enum HeaderV1 {
    UsePackage {
        use_kw: KwUse,
        package_kw: KwPackage,
        open_kw: Option<KwOpen>,
        path: ModChainV1,
    },
    UseOf {
        use_kw: KwUse,
        open_kw: Option<KwOpen>,
        path: ModChainV1,
        of_kw: KwOf,
        relpath: LiteralTok,
    },
    Use {
        use_kw: KwUse,
        open_kw: Option<KwOpen>,
        path: ModChainV1,
    },
    Legacy(Header),
}

A 0.1 header element — the UNION of BOTH packaging generations’ header forms (Axis B). Legacy is dev-0-1-0’s @require:/@import: (byte-identical to 0.0.6’s, reusing Header); the three Use* forms are saphe-split’s headerelem (parser.mly:371-380 @ b836d512). Which family is legal is a LoadMode question the loader answers (rustyfi_loader), not a grammar question — this ONE V0_1 grammar accepts both so the mode error can be raised at load time with a better message than a lex error would give.

Variant order is parse priority (syan ordered-alternatives, most-specific first): UsePackage (the package keyword disambiguates) precedes the of-suffixed UseOf, which precedes bare Use (longest-match: use M of … must claim its of before a bare use M matches), which precedes the token-disjoint Legacy (@-headers lex to distinct tokens).

Variants

UsePackage

USE PACKAGE optional_open mod_chain — depend on an installed package by its consumer-chosen alias (used_as). Header attributes (#[test-only] etc., upstream list(attribute)) are DEFERRED.

Fields

use_kw: KwUse

package_kw: KwPackage

open_kw: Option<KwOpen>

path: ModChainV1

UseOf

USE optional_open mod_chain OF STRING — load a local file by backtick-quoted relative path (the @import: analog).

Fields

use_kw: KwUse

open_kw: Option<KwOpen>

path: ModChainV1

of_kw: KwOf

relpath: LiteralTok

Use

USE optional_open mod_chain — sibling module inside the same package (closed resolution; only legal inside envelope source trees, enforced by the loader).

Fields

use_kw: KwUse

open_kw: Option<KwOpen>

path: ModChainV1

Legacy(Header)

@require:/@import: — Legacy packaging, unchanged shape.

Implementations

impl HeaderV1

pub fn display_name(&self) -> String

A short human-readable name for this header, for loader diagnostics (e.g. use package Stdlib, @require: foo).

Trait Implementations

impl Clone for HeaderV1

fn clone(&self) -> HeaderV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HeaderV1

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

Formats the value using the given formatter.

impl<__SyanMacro_Atom> Parse<__SyanMacro_Atom> for HeaderV1

where __SyanMacro_Atom: Spanned + Clone, KwUse: Parse<__SyanMacro_Atom>, KwPackage: Parse<__SyanMacro_Atom>, Option<KwOpen>: Parse<__SyanMacro_Atom>, ModChainV1: Parse<__SyanMacro_Atom>, KwOf: Parse<__SyanMacro_Atom>, LiteralTok: Parse<__SyanMacro_Atom>, Header: Parse<__SyanMacro_Atom>,

type Error = ParseError<<__SyanMacro_Atom as Spanned>::Span>

Every error must be convertible to the universal one, so a field’s failure can become the enclosing type’s failure with no per-field where-predicate. Stating it HERE rather than at each derived impl is what keeps it out of the obligation graph: a per-field <FieldTy as Parse<Atom>>::Error: Into<…> predicate re-creates a projection cycle on a recursive field (E0275), which decycle’s bound-peeling does not break.

fn parse_stream<__SyanMacro_S: ParseStream<Atom = __SyanMacro_Atom>>( __syan_stream: &mut __SyanMacro_S, ) -> Result<Self, Self::Error>

Parse from a reborrowable stream.

fn parse(stream: impl IntoParseStream<Atom = Atom>) -> Result<Self, Self::Error>

Parse from anything that can become a stream — String, TokenStream, an existing stream.

fn attempt(self) -> Attempt<Self>

Wrap this value in Attempt, the atomic-parse marker: parsing an Attempt<Self> parses Self but rewinds the stream on failure (it requires Atom: Clone). This is the value constructor; value.attempt() is sugar for Attempt(value).

impl PartialEq for HeaderV1

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HeaderV1

impl<__SyanMacro_Atom> Unparse<__SyanMacro_Atom> for HeaderV1

where KwUse: Unparse<__SyanMacro_Atom>, KwPackage: Unparse<__SyanMacro_Atom>, Option<KwOpen>: Unparse<__SyanMacro_Atom>, ModChainV1: Unparse<__SyanMacro_Atom>, KwOf: Unparse<__SyanMacro_Atom>, LiteralTok: Unparse<__SyanMacro_Atom>, Header: Unparse<__SyanMacro_Atom>,

fn unparse<__Syan_Emitter: Emitter<__SyanMacro_Atom>>( &self, __syan_sink: &mut __Syan_Emitter, ) -> Result<(), <__Syan_Emitter as Emitter<__SyanMacro_Atom>>::Error>