Struct Article 

pub struct Article<'a> {
    pub message_id: MessageId<'a>,
    pub article_number: Option<u64>,
    pub headers: Option<Headers<'a>>,
    pub body: Option<&'a [u8]>,
}

Parsed NNTP article response (zero-copy)

Different response codes populate different fields:

• 220 ARTICLE: headers + body
• 221 HEAD: headers only
• 222 BODY: body only
• 223 STAT: neither (just metadata)

Fields

message_id: MessageId<'a>

article_number: Option<u64>

headers: Option<Headers<'a>>

body: Option<&'a [u8]>

Implementations

impl<'a> Article<'a>

pub fn parse(buf: &'a [u8], validate_yenc: bool) -> Result<Self, ParseError>

Parse NNTP article response with optional yEnc validation

Arguments

• buf - Complete response bytes from the session response reader.
• validate_yenc - Whether to validate yEnc structure/checksums

Errors

Returns ParseError when the NNTP response status line, message metadata, headers, body structure, or optional yEnc validation fails.

pub fn decode(&self) -> Option<Vec<u8>>

Decode yEnc-encoded body to raw bytes

This method allocates a new Vec<u8> for each call. For hot paths where articles are frequently decoded, prefer Article::decode_into to reuse a caller-provided buffer and avoid per-call allocations.

Returns

Decoded bytes, or None if body is not yEnc-encoded

pub fn decode_into(&self, output: &mut Vec<u8>) -> bool

Decode yEnc-encoded body into the provided buffer

This method reuses the capacity of output and performs no allocations if the buffer is already large enough, making it suitable for hot paths.

Behavior

• Returns false if:
  • The article has no body, or
  • The body is not yEnc-encoded (does not start with =ybegin)
• Returns true and writes the decoded bytes into output otherwise.

On success, output is cleared before writing the decoded bytes.

Trait Implementations

impl<'a> Clone for Article<'a>

fn clone(&self) -> Article<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Article<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for Article<'a>

impl<'a> PartialEq for Article<'a>

fn eq(&self, other: &Article<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for Article<'a>

impl<'a> TryFrom<&'a [u8]> for Article<'a>

fn try_from(buf: &'a [u8]) -> Result<Self, Self::Error>

Parse article with yEnc validation enabled by default Use Article::parse(buf, false) to disable validation

type Error = ParseError

The type returned in the event of a conversion error.