Struct NntpClient 

pub struct NntpClient { /* private fields */ }

Standalone NNTP client for fetching articles

Zero-allocation design using caller-provided buffer pool. Share one pool across multiple clients for minimal allocations. Returns PooledBuffer - caller parses with Article::parse().

Implementations

impl NntpClient

pub const fn new( conn_pool: DeadpoolConnectionProvider, buffer_pool: BufferPool, ) -> Self

Create a new client with connection pool and buffer pool

The buffer pool can be shared across multiple clients via Clone.

pub fn fetch_body( &self, message_id: &MessageId<'_>, ) -> impl Future<Output = Result<PooledBuffer>> + '_

Fetch article body (BODY command)

Returns PooledBuffer with the backend response bytes. Parse with Article::parse(&buffer, validate_yenc).

Arguments

• message_id - Message-ID including angle brackets, e.g. <abc@example.com>

Errors

Returns any connection, write, or backend-response error encountered while fetching the BODY response.

pub fn fetch_head( &self, message_id: &MessageId<'_>, ) -> impl Future<Output = Result<PooledBuffer>> + '_

Fetch article headers (HEAD command)

Returns PooledBuffer with the backend response bytes. Parse with Article::parse(&buffer, false).

Arguments

• message_id - Message-ID including angle brackets

Errors

Returns any connection, write, or backend-response error encountered while fetching the HEAD response.

pub fn fetch_article( &self, message_id: &MessageId<'_>, ) -> impl Future<Output = Result<PooledBuffer>> + '_

Fetch full article (ARTICLE command)

Returns PooledBuffer with the backend response bytes. Parse with Article::parse(&buffer, validate_yenc).

Arguments

• message_id - Message-ID including angle brackets

Errors

Returns any connection, write, or backend-response error encountered while fetching the ARTICLE response.

pub async fn stat(&self, message_id: &MessageId<'_>) -> Result<bool>

Check if article exists (STAT command)

Arguments

• message_id - Message-ID including angle brackets

Returns

true if article exists, false if 430 (not found)

Errors

Returns any connection or protocol error while issuing STAT, including malformed or unexpected backend status codes.

Trait Implementations

impl Clone for NntpClient

fn clone(&self) -> NntpClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.