Struct Entry 

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

A node in the syntax tree representing a $ast

Implementations

impl Entry

pub fn new() -> Self

Create a new entry

pub fn replace(&mut self, idx: usize, relation: Relation)

Replace the relation at the given index

pub fn wrap_and_sort(&self) -> Self

Wrap and sort the relations in this entry

pub fn relations(&self) -> impl Iterator<Item = Relation> + '_

Iterate over the relations in this entry

pub fn iter(&self) -> impl Iterator<Item = Relation> + '_

Iterate over the relations in this entry

pub fn get_relation(&self, idx: usize) -> Option<Relation>

Get the relation at the given index

pub fn remove_relation(&self, idx: usize) -> Relation

Remove the relation at the given index

Arguments

• idx - The index of the relation to remove

Example

use debian_control::lossless::relations::{Relation,Entry};
let mut entry: Entry = r"python3-dulwich (>= 0.19.0) | python3-requests".parse().unwrap();
entry.remove_relation(1);
assert_eq!(entry.to_string(), "python3-dulwich (>= 0.19.0)");

pub fn satisfied_by(&self, package_version: impl VersionLookup + Copy) -> bool

Check if this entry is satisfied by the given package versions.

Arguments

• package_version - A function that returns the version of a package.

Example

use debian_control::lossless::relations::{Relation,Entry};
let entry = Entry::from(vec!["samba (>= 2.0)".parse::<Relation>().unwrap()]);
assert!(entry.satisfied_by(|name: &str| -> Option<debversion::Version> {
   match name {
   "samba" => Some("2.0".parse().unwrap()),
   _ => None
}}));

pub fn remove(&mut self)

Remove this entry

Example

use debian_control::lossless::relations::{Relations,Entry};
let mut relations: Relations = r"python3-dulwich (>= 0.19.0), python3-urllib3 (<< 1.26.0)".parse().unwrap();
let mut entry = relations.get_entry(0).unwrap();
entry.remove();
assert_eq!(relations.to_string(), "python3-urllib3 (<< 1.26.0)");

pub fn is_empty(&self) -> bool

Check if this entry is empty

pub fn len(&self) -> usize

Get the number of relations in this entry

pub fn push(&mut self, relation: Relation)

Push a new relation to the entry

Arguments

• relation - The relation to push

Example

use debian_control::lossless::relations::{Relation,Entry};
let mut entry: Entry = "samba (>= 2.0)".parse().unwrap();
entry.push("python3-requests".parse().unwrap());
assert_eq!(entry.to_string(), "samba (>= 2.0) | python3-requests");

pub fn is_implied_by(&self, outer: &Entry) -> bool

Check if this entry (OR-group) is implied by another entry.

An entry is implied by another if any of the relations in this entry is implied by any relation in the outer entry. This follows the semantics of OR-groups in Debian dependencies.

For example:

• pkg >= 1.0 is implied by pkg >= 1.5 | libc6 (first relation matches)
• pkg1 | pkg2 is implied by pkg1 (pkg1 satisfies the requirement)

Arguments

• outer - The outer entry that may imply this entry

Returns

true if this entry is implied by outer, false otherwise

Example

use debian_control::lossless::relations::Entry;

let inner: Entry = "pkg (>= 1.0)".parse().unwrap();
let outer: Entry = "pkg (>= 1.5) | libc6".parse().unwrap();
assert!(inner.is_implied_by(&outer));

Trait Implementations

impl Debug for Entry

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

Formats the value using the given formatter.

impl Default for Entry

fn default() -> Self

Returns the “default value” for a type.

impl Display for Entry

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

Formats the value using the given formatter.

impl From<Entry> for Relations

fn from(entry: Entry) -> Self

Converts to this type from the input type.

impl From<Entry> for Vec<Relation>

fn from(entry: Entry) -> Self

Converts to this type from the input type.

impl From<Relation> for Entry

fn from(relation: Relation) -> Self

Converts to this type from the input type.

impl From<Vec<Relation>> for Entry

fn from(relations: Vec<Relation>) -> Self

Converts to this type from the input type.

impl From<Vec<Relation>> for Entry

fn from(relations: Vec<Relation>) -> Self

Converts to this type from the input type.

impl FromStr for Entry

type Err = String

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 Ord for Entry

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Entry

fn eq(&self, other: &Self) -> 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 PartialOrd for Entry

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Entry