Enum Edit 

#[non_exhaustive]
pub enum Edit {
    SetTime {
        line: usize,
        seconds: f64,
    },
    Shift {
        seconds: f64,
        lines: Option<Vec<usize>>,
        from: Option<usize>,
    },
    SortByTime,
    SetRest {
        line: usize,
        rest: String,
    },
    Insert {
        after: usize,
        text: String,
    },
    Delete {
        line: usize,
    },
}

One edit of a tracklist text (R13.9). Line numbers are 1-based and refer to the text as the previous edit left it.

The JSON form is the spec’s ({"op":"set-time","line":3,"seconds":90}).

use trackparse::tracklist::{apply_edits, Edit};

let text = "00:00 A - B\n01:00 C - D\n";
let edits = [Edit::set_time(2, 90.0), Edit::insert(2, "02:00 E - F"), Edit::delete(1)];
assert_eq!(apply_edits(text, &edits).text, "01:30 C - D\n02:00 E - F\n");
assert_eq!(edits[0].to_json(), r#"{"op":"set-time","line":2,"seconds":90}"#);
assert_eq!(edits[0], Edit::SetTime { line: 2, seconds: 90.0 });

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

SetTime

Rewrite the time of line, keeping its written style (R13.9.2).

Fields

line: usize

The line to change.

seconds: f64

The new time in seconds.

Shift

Add seconds to every timed line of lines, else from line from on, else of the whole text.

Fields

seconds: f64

Seconds to add; negative moves the times back.

lines: Option<Vec<usize>>

Only these lines.

from: Option<usize>

Only this line and the ones after it.

SortByTime

Stable sort of the timed lines, each with the untimed lines after it (R13.9.4).

SetRest

Replace everything after the time and gap of line.

Fields

line: usize

The line to change.

rest: String

The new text after the time.

Insert

Insert text as a new line after line after (0: at the start).

Fields

after: usize

The line to insert after.

text: String

The new line, without a terminator.

Delete

Remove line.

Fields

line: usize

The line to remove.

Implementations

impl Edit

pub fn set_time(line: usize, seconds: f64) -> Edit

Edit::SetTime: rewrite the time of line.

pub fn shift(seconds: f64) -> Edit

Edit::Shift over every timed line of the text.

use trackparse::tracklist::{apply_edits, Edit};

let result = apply_edits("00:10 A - B\n01:00 C - D", &[Edit::shift(-10.0)]);
assert_eq!(result.text, "00:00 A - B\n00:50 C - D");

pub fn shift_from(seconds: f64, from: usize) -> Edit

Edit::Shift over line from and the lines after it.

pub fn shift_lines(seconds: f64, lines: impl IntoIterator<Item = usize>) -> Edit

Edit::Shift over the given lines only.

pub fn sort_by_time() -> Edit

Edit::SortByTime.

pub fn set_rest(line: usize, rest: impl Into<String>) -> Edit

Edit::SetRest: replace what follows the time of line.

pub fn insert(after: usize, text: impl Into<String>) -> Edit

Edit::Insert: a new line after line after (0: at the start).

pub fn delete(line: usize) -> Edit

Edit::Delete: remove line.

impl Edit

pub fn to_json(&self) -> String

The spec’s JSON form as compact text: camelCase keys, every key present, in the schema’s order. The same text the JavaScript and Python packages give.

Trait Implementations

impl Clone for Edit

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Edit

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Edit

Available on crate feature serde only.

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Edit

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Edit

Available on crate feature serde only.

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 Edit

impl ToJson for Edit

fn to_json_value(&self) -> Json

The edit as the spec writes it ({"op":"set-time","line":3,"seconds":90}).

fn to_json(&self) -> String

Compact JSON text.