Enum ParagraphSelector 

pub enum ParagraphSelector {
    Source,
    Binary {
        package: String,
    },
    CopyrightHeader,
    CopyrightFiles {
        glob: String,
    },
    CopyrightLicense {
        name: String,
    },
    Index {
        index: usize,
    },
    ByKey {
        field: String,
        value: String,
    },
}

Identifies a paragraph in a deb822 file.

The variants are a union of file-format vocabularies. Each variant is labelled with the family of files it applies to; the applier validates that a selector matches the file it’s targeting (e.g. Binary on debian/copyright is an error).

File-format-agnostic selectors (Index, ByKey) work on any deb822 file, including ones we don’t have a typed wrapper for.

Variants

Source

debian/control: the source paragraph.

Binary

debian/control: a binary paragraph identified by its Package: field.

Fields

package: String

Package name.

CopyrightHeader

debian/copyright: the header paragraph (carrying Format:, Upstream-Name:, etc.).

CopyrightFiles

debian/copyright: the paragraph whose Files: field matches the given glob string exactly.

Fields

glob: String

Files-glob string, matched literally against the field value.

CopyrightLicense

debian/copyright: a standalone License paragraph (no Files: field) whose License synopsis equals name.

Fields

name: String

License short-name as it appears on the first line of the License: field (e.g. GPL-2+).

Index

File-format-agnostic: the Nth paragraph (0-indexed). Use sparingly: indices shift as paragraphs are inserted or removed.

Fields

index: usize

Zero-based paragraph index.

ByKey

File-format-agnostic: the first paragraph whose field has exactly the given value.

Fields

field: String

Field name to match (case-sensitive, as deb822 keys are).

value: String

Required value.

Trait Implementations

impl Clone for ParagraphSelector

fn clone(&self) -> ParagraphSelector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParagraphSelector

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ParagraphSelector

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ParagraphSelector

impl PartialEq for ParagraphSelector

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ParagraphSelector

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ParagraphSelector