Struct MetainfoEditor 

pub struct MetainfoEditor { /* private fields */ }

Owned metainfo editor preserving untouched known and unknown fields.

Implementations

impl MetainfoEditor

pub fn from_metainfo(metainfo: &Metainfo) -> Result<Self>

Starts from a parsed validated metainfo object.

Errors

Returns an error if parsing or owned top-level conversion fails.

pub fn from_info(info: OwnedValue) -> Result<Self>

Starts from an owned validated info dictionary.

Errors

Returns an error when info is not a dictionary.

pub fn trackers(self, tiers: impl IntoIterator<Item = Vec<Vec<u8>>>) -> Self

Replaces tracker tiers.

pub fn web_seeds(self, seeds: impl IntoIterator<Item = Vec<u8>>) -> Self

Replaces web seed URLs.

pub fn nodes(self, nodes: impl IntoIterator<Item = (Vec<u8>, u16)>) -> Self

Replaces DHT bootstrap nodes.

pub fn comment(self, value: Option<Vec<u8>>) -> Self

Sets or removes the top-level comment.

pub fn created_by(self, value: Option<Vec<u8>>) -> Self

Sets or removes the top-level creator.

pub fn creation_date(self, value: Option<i64>) -> Self

Sets or removes the top-level creation timestamp.

pub fn private(self, value: Option<bool>) -> Self

Sets or removes the private flag inside info.

pub fn source(self, value: Option<Vec<u8>>) -> Self

Sets or removes the source field inside info.

pub fn raw_top_level(self, key: Vec<u8>, value: OwnedValue) -> Result<Self>

Adds or replaces an unknown top-level extension.

Errors

Returns an error for reserved keys.

pub fn file_attributes( self, path: &[Vec<u8>], attributes: Vec<u8>, ) -> Result<Self>

Sets file attributes for a validated v1 or v2 path.

Errors

Returns an error when the path is absent or has an unsupported shape.

pub fn to_metainfo(self) -> Result<Metainfo>

Serializes top-level fields canonically and validates the edited result.

Untouched info bytes retain their exact source encoding. Any info-level edit canonicalizes the updated info dictionary. Calling Metainfo::to_bytes on the result explicitly canonicalizes the complete metainfo object.

Errors

Returns serialization or protocol validation errors.

Trait Implementations

impl Clone for MetainfoEditor

fn clone(&self) -> MetainfoEditor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetainfoEditor

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

Formats the value using the given formatter.