Struct Repository

pub struct Repository {

    pub enabled: Option<bool>,
    pub types: HashSet<RepositoryType>,
    pub uris: Vec<Url>,
    pub suites: Vec<String>,
    pub components: Option<Vec<String>>,
    pub architectures: Vec<String>,
    pub languages: Option<Vec<String>>,
    pub targets: Option<Vec<String>>,
    pub pdiffs: Option<bool>,
    pub by_hash: Option<YesNoForce>,
    pub allow_insecure: Option<bool>,
    pub allow_weak: Option<bool>,
    pub allow_downgrade_to_insecure: Option<bool>,
    pub trusted: Option<bool>,
    pub signature: Option<Signature>,
    pub x_repolib_name: Option<String>,
    pub description: Option<String>,
}

A structure representing APT repository as declared by DEB822 source file

According to sources.list(5) man pages, only four fields are mandatory:

• Types either deb or/and deb-src
• URIs to repositories holding valid APT structure (unclear if multiple are allowed)
• Suites usually being distribution codenames
• Component most of the time main, but it’s a section of the repository

The manpage specifies following optional fields

• Enabled is a yes/no field, default yes
• Architectures
• Languages
• Targets
• PDiffs is a yes/no field
• By-Hash is a yes/no/force field
• Allow-Insecure is a yes/no field, default no
• Allow-Weak is a yes/no field, default no
• Allow-Downgrade-To-Insecure is a yes/no field, default no
• Trusted us a yes/no field
• Signed-By is either path to the key or PGP key block
• Check-Valid-Until is a yes/no field
• Valid-Until-Min
• Valid-Until-Max
• Check-Date is a yes/no field
• Date-Max-Future
• InRelease-Path relative path
• Snapshot either enable or a snapshot ID

The unit tests of APT use:

• Description

The RepoLib tool uses:

• X-Repolib-Name identifier for own reference, meaningless for APT

Note: Multivalues *-Add & *-Remove semantics aren’t supported.

Fields

enabled: Option<bool>

If no (false) the repository is ignored by APT

types: HashSet<RepositoryType>

The value RepositoryType::Binary (deb) or/and RepositoryType::Source (deb-src)

uris: Vec<Url>

The address of the repository

suites: Vec<String>

The distribution name as codename or suite type (like stable or testing)

components: Option<Vec<String>>

(Optional) Section of the repository, usually main, contrib or non-free return None if repository is Flat Repository Format (https://wiki.debian.org/DebianRepository/Format#Flat_Repository_Format)

architectures: Vec<String>

(Optional) Architectures binaries from this repository run on

languages: Option<Vec<String>>

(Optional) Translations support to download

targets: Option<Vec<String>>

(Optional) Download targets to acquire from this source

pdiffs: Option<bool>

(Optional) Controls if APT should try PDiffs instead of downloading indexes entirely; if not set defaults to configuration option Acquire::PDiffs

by_hash: Option<YesNoForce>

(Optional) Controls if APT should try to acquire indexes via a URI constructed from a hashsum of the expected file

allow_insecure: Option<bool>

(Optional) If yes circumvents parts of apt-secure, don’t thread lightly

allow_weak: Option<bool>

(Optional) If yes circumvents parts of apt-secure, don’t thread lightly

allow_downgrade_to_insecure: Option<bool>

(Optional) If yes circumvents parts of apt-secure, don’t thread lightly

trusted: Option<bool>

(Optional) If set forces whether APT considers source as rusted or no (default not present is a third state)

signature: Option<Signature>

(Optional) Contains either absolute path to GPG keyring or embedded GPG public key block, if not set APT uses all trusted keys; I can’t find example of using with fingerprints

x_repolib_name: Option<String>

(Optional) Field ignored by APT but used by RepoLib to identify repositories, Ubuntu sources contain them

description: Option<String>

(Optional) Field not present in the man page, but used in APT unit tests, potentially to hold the repository description

Implementations

impl Repository

pub fn suites(&self) -> &[String]

Returns slice of strings containing suites for which this repository provides

pub fn types(&self) -> &HashSet<RepositoryType>

Returns the repository types (deb/deb-src)

pub fn uris(&self) -> &[Url]

Returns the repository URIs

pub fn components(&self) -> Option<&[String]>

Returns the repository components

pub fn architectures(&self) -> &[String]

Returns the repository architectures

pub fn to_legacy_format(&self) -> String

Generate legacy .list format lines for this repository

pub fn parse_legacy_line(line: &str) -> Result<Repository, String>

Parse a legacy apt sources.list line (e.g., “deb http://example.com/debian stable main”)

Trait Implementations

impl Clone for Repository

fn clone(&self) -> Repository

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Repository

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

Formats the value using the given formatter.

impl Default for Repository

fn default() -> Repository

Returns the “default value” for a type.

impl<P: Deb822LikeParagraph> FromDeb822Paragraph<P> for Repository

fn from_paragraph(para: &P) -> Result<Self, String>

Convert a paragraph to this object.

impl PartialEq for Repository

fn eq(&self, other: &Repository) -> 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<P: Deb822LikeParagraph> ToDeb822Paragraph<P> for Repository

fn to_paragraph(&self) -> P

Convert this object to a paragraph.

fn update_paragraph(&self, para: &mut P)

Update the given paragraph with the values from this object.

impl StructuralPartialEq for Repository