Struct Control

pub struct Control(/* private fields */);

A Debian control file

Implementations

impl Control

pub fn new() -> Self

Create a new control file

pub fn as_mut_deb822(&mut self) -> &mut Deb822

Return the underlying deb822 object, mutable

pub fn as_deb822(&self) -> &Deb822

Return the underlying deb822 object

pub fn parse(text: &str) -> Parse<Control>

Parse control file text, returning a Parse result

pub fn source(&self) -> Option<Source>

Return the source package

pub fn binaries(&self) -> impl Iterator<Item = Binary>

Iterate over all binary packages

pub fn add_source(&mut self, name: &str) -> Source

Add a new source package

Arguments

• name - The name of the source package

Returns

The newly created source package

Example

use debian_control::lossless::control::Control;
let mut control = Control::new();
let source = control.add_source("foo");
assert_eq!(source.name(), Some("foo".to_owned()));

pub fn add_binary(&mut self, name: &str) -> Binary

Add new binary package

Arguments

• name - The name of the binary package

Returns

The newly created binary package

Example

use debian_control::lossless::control::Control;
let mut control = Control::new();
let binary = control.add_binary("foo");
assert_eq!(binary.name(), Some("foo".to_owned()));

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self, Error>

Read a control file from a file

pub fn from_file_relaxed<P: AsRef<Path>>( path: P, ) -> Result<(Self, Vec<String>), Error>

Read a control file from a file, allowing syntax errors

pub fn read<R: Read>(r: R) -> Result<Self, Error>

Read a control file from a reader

pub fn read_relaxed<R: Read>(r: R) -> Result<(Self, Vec<String>), Error>

Read a control file from a reader, allowing syntax errors

pub fn wrap_and_sort( &mut self, indentation: Indentation, immediate_empty_line: bool, max_line_length_one_liner: Option<usize>, )

Wrap and sort the control file

Arguments

• indentation - The indentation to use
• immediate_empty_line - Whether to add an empty line at the start of multi-line fields
• max_line_length_one_liner - The maximum line length for one-liner fields

Trait Implementations

impl AstNode for Control

type Language = Lang

fn can_cast(kind: <Self::Language as Language>::Kind) -> bool

fn cast(syntax: SyntaxNode<Self::Language>) -> Option<Self>

fn syntax(&self) -> &SyntaxNode<Self::Language>

fn clone_for_update(&self) -> Self

where Self: Sized,

fn clone_subtree(&self) -> Self

where Self: Sized,

impl Clone for Control

fn clone(&self) -> Control

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Control

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

Formats the value using the given formatter.

impl Default for Control

fn default() -> Self

Returns the “default value” for a type.

impl Display for Control

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

Formats the value using the given formatter.

impl From<Control> for Deb822

fn from(c: Control) -> Self

Converts to this type from the input type.

impl From<Deb822> for Control

fn from(d: Deb822) -> Self

Converts to this type from the input type.

impl FromStr for Control

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for Control

fn eq(&self, other: &Control) -> 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 Eq for Control

impl StructuralPartialEq for Control