Enum ChangelogAction 

pub enum ChangelogAction {
    ReplaceEntryChanges {
        file: PathBuf,
        version: String,
        lines: Vec<String>,
    },
    SetEntryDate {
        file: PathBuf,
        version: String,
        rfc2822: String,
    },
    RemoveBullet {
        file: PathBuf,
        version: String,
        author: Option<String>,
        text: String,
        occurrence: usize,
    },
    ReplaceBullet {
        file: PathBuf,
        version: String,
        author: Option<String>,
        text: String,
        occurrence: usize,
        new_lines: Vec<String>,
    },
    SetEntryVersion {
        file: PathBuf,
        version: String,
        new_version: String,
    },
}

Edits to a debian/changelog.

Operations target entries by their version, which is stable across minor edits. Change-line content is supplied verbatim — the applier preserves the changelog’s existing indentation rules when re-rendering.

Variants

ReplaceEntryChanges

Replace the change lines of the entry with the given version. The lines are stored verbatim with their leading */ continuation prefix; the applier writes them as-is into the entry.

Fields

file: PathBuf

File to edit, relative to the package root. Almost always debian/changelog, but kept explicit for symmetry.

version: String

Version string of the target entry (e.g. 2.6.0-1).

lines: Vec<String>

Replacement change lines (one per line, no trailing newline).

SetEntryDate

Set the trailer datetime of the entry with the given version.

The datetime is stored as an RFC 2822 string ("Sun, 22 Apr 2018 00:58:14 +0000") — what chrono::DateTime::to_rfc2822 produces and what changelog trailers use natively.

Fields

file: PathBuf

File to edit, relative to the package root.

version: String

Version string of the target entry.

rfc2822: String

New datetime as an RFC 2822 string.

RemoveBullet

Remove a bullet from the entry with the given version.

The bullet is identified by its author attribution (the [ Name ] header that introduces multi-author groups, or None for an entry without one) and its body text (the bullet’s lines joined with \n, exactly as debian_changelog’s Bullet::lines() returns them).

occurrence is a 0-based index that disambiguates when several bullets share the same (author, text) key: 0 removes the first match, 1 the second, etc. The applier walks bullets in iter_changes_by_author order. Whitespace between surviving bullets is preserved.

Fields

file: PathBuf

File to edit, relative to the package root.

version: String

Version string of the target entry.

author: Option<String>

Author header above the bullet, if any.

text: String

Body text of the bullet (lines joined by \n).

occurrence: usize

0-based index among bullets sharing the same (author, text) key. Defaults to 0 over the wire when omitted.

ReplaceBullet

Replace the body lines of a bullet, identified the same way as in RemoveBullet. new_lines are stored without their */ continuation prefix — the applier passes them straight to Bullet::replace_with, which re-adds the proper indentation.

Fields

file: PathBuf

File to edit, relative to the package root.

version: String

Version string of the target entry.

author: Option<String>

Author header above the bullet, if any.

text: String

Current body text of the bullet (lines joined by \n).

occurrence: usize

0-based index among bullets sharing the same (author, text) key.

new_lines: Vec<String>

Replacement body lines.

SetEntryVersion

Replace the version of the entry currently identified by version with new_version. A no-op if no entry has that version.

Fields

file: PathBuf

File to edit, relative to the package root.

version: String

Current version string of the target entry.

new_version: String

New version string to write into the entry header.

Trait Implementations

impl Clone for ChangelogAction

fn clone(&self) -> ChangelogAction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChangelogAction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChangelogAction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ChangelogAction

impl PartialEq for ChangelogAction

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

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 ChangelogAction