Struct CommentSpan 

pub struct CommentSpan {
    pub file: PathBuf,
    pub span: [usize; 2],
    pub lines: [usize; 2],
    pub kind: CommentKind,
    pub text: String,
    pub hash: String,
    pub attached_item: Option<AttachedItem>,
    pub in_body: bool,
    pub annotation: bool,
}

Fields

file: PathBuf

span: [usize; 2]

Byte range [start, end) in the file. Pass it back verbatim to apply.

lines: [usize; 2]

1-based inclusive line range.

kind: CommentKind

text: String

Raw source text of the span, comment markers included.

hash: String

Guard for apply and the sole key it resolves an op by: blake3 of text plus this span’s occurrence ordinal among same-text spans in the file, first 16 hex chars. Unique per file by construction — file_spans hard-errors if it ever were not.

attached_item: Option<AttachedItem>

in_body: bool

annotation: bool

True if the span holds an @yah: / @arch: annotation (or its wrapped continuation).

Trait Implementations

impl Clone for CommentSpan

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 CommentSpan

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CommentSpan

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CommentSpan

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

where __S: Serializer,

Serialize this value into the given Serde serializer.