Enum ParsedWatchFile

Source

pub enum ParsedWatchFile {
    LineBased(WatchFile),
    Deb822(WatchFile),
}

Expand description

Parsed watch file that can be either line-based or deb822 format

Variants§

§

LineBased(WatchFile)

Line-based watch file (v1-4)

§

Implementations§

Source §

impl ParsedWatchFile

Source

pub fn snapshot(&self) -> Self

Capture an independent snapshot of this watch file.

The returned value shares the underlying immutable green-node data with self at the time of the call, but lives in its own mutable tree: subsequent mutations to self do not propagate to the snapshot. Pair with Self::tree_eq to detect later mutations.

Source

pub fn tree_eq(&self, other: &Self) -> bool

Returns true iff the syntax trees of self and other are value-equal. An O(1) pointer-identity fast path makes this free for trees that still share state with a recent Self::snapshot. Mismatched variants are never considered equal.

Source

pub fn new(version: u32) -> Result<Self, ParseError>

Create a new empty watch file with the specified version.

For version 5, creates a deb822-format watch file (requires deb822 feature)
For versions 1-4, creates a line-based watch file (requires linebased feature)

§Examples

use debian_watch::parse::ParsedWatchFile;

let wf = ParsedWatchFile::new(5).unwrap();
assert_eq!(wf.version(), 5);

Source

pub fn version(&self) -> u32

Get the version of the watch file

Source

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

Get an iterator over entries as ParsedEntry enum

Source

pub fn add_entry(&mut self, source: &str, matching_pattern: &str) -> ParsedEntry

Add a new entry to the watch file and return it.

For v5 (deb822) watch files, this adds a new paragraph with Source and Matching-Pattern fields. For v1-4 (line-based) watch files, this adds a new entry line.

Returns a ParsedEntry that can be used to query or modify the entry.

§Examples

use debian_watch::parse::ParsedWatchFile;
use debian_watch::WatchOption;

let mut wf = ParsedWatchFile::new(5).unwrap();
let mut entry = wf.add_entry("https://github.com/foo/bar/tags", ".*/v?([\\d.]+)\\.tar\\.gz");
entry.set_option(WatchOption::Component("upstream".to_string()));

Source

pub fn version_range(&self) -> Option<TextRange>

Byte range of the version declaration.

In line-based files this is the version=N directive on the first line; in deb822 files it’s the Version: entry on the header paragraph. Returns None when the file has no version declaration (legal for v1 line-based files; unusual for v5).