ass-editor 0.1.2

High-performance, ergonomic editor layer for ASS subtitles
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180

//! Tests for event split/merge/timing and event deletion fluent operations.

use crate::core::EditorDocument;
use ass_core::parser::ast::EventType;

#[cfg(not(feature = "std"))]
use alloc::vec;

#[test]
fn test_fluent_event_operations() {
    const TEST_CONTENT: &str = r#"[V4+ Styles]
Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding
Style: Default,Arial,20,&H00FFFFFF,&H000000FF,&H00000000,&H00000000,0,0,0,0,100,100,0,0,1,2,0,2,10,10,10,1

[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:05.00,Default,Speaker,0,0,0,,First event
Dialogue: 0,0:00:05.00,0:00:10.00,Default,Speaker,0,0,0,,Second event
Comment: 0,0:00:10.00,0:00:15.00,Default,Speaker,0,0,0,,Third event
"#;

    let mut doc = EditorDocument::from_content(TEST_CONTENT).unwrap();

    // Test split event
    doc.events().split(0, "0:00:03.00").unwrap();

    // Should now have 4 events (first split into 2)
    let events_count = doc
        .text()
        .lines()
        .filter(|line| line.starts_with("Dialogue:") || line.starts_with("Comment:"))
        .count();
    assert_eq!(events_count, 4);
    assert!(doc.text().contains("0:00:01.00,0:00:03.00"));
    assert!(doc.text().contains("0:00:03.00,0:00:05.00"));
}

#[test]
fn test_fluent_event_merge() {
    const TEST_CONTENT: &str = r#"[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:05.00,Default,Speaker,0,0,0,,First event
Dialogue: 0,0:00:05.00,0:00:10.00,Default,Speaker,0,0,0,,Second event
Comment: 0,0:00:10.00,0:00:15.00,Default,Speaker,0,0,0,,Third event
"#;

    let mut doc = EditorDocument::from_content(TEST_CONTENT).unwrap();

    // Test merge events with custom separator
    doc.events()
        .merge(0, 1)
        .with_separator(" | ")
        .apply()
        .unwrap();

    // Should now have 2 events (first two merged)
    let events_count = doc
        .text()
        .lines()
        .filter(|line| line.starts_with("Dialogue:") || line.starts_with("Comment:"))
        .count();
    assert_eq!(events_count, 2);
    assert!(doc.text().contains("First event | Second event"));
    assert!(doc.text().contains("0:00:01.00,0:00:10.00")); // Start of first, end of second
}

#[test]
fn test_fluent_event_timing() {
    const TEST_CONTENT: &str = r#"[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:05.00,Default,Speaker,0,0,0,,First event
Dialogue: 0,0:00:05.00,0:00:10.00,Default,Speaker,0,0,0,,Second event
"#;

    let mut doc = EditorDocument::from_content(TEST_CONTENT).unwrap();

    // Test shifting all events by 2 seconds (200 centiseconds)
    doc.events().timing().shift(200).unwrap();

    assert!(doc.text().contains("0:00:03.00,0:00:07.00")); // First event shifted
    assert!(doc.text().contains("0:00:07.00,0:00:12.00")); // Second event shifted
}

#[test]
fn test_fluent_event_timing_specific() {
    const TEST_CONTENT: &str = r#"[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:05.00,Default,Speaker,0,0,0,,First event
Dialogue: 0,0:00:05.00,0:00:10.00,Default,Speaker,0,0,0,,Second event
"#;

    let mut doc = EditorDocument::from_content(TEST_CONTENT).unwrap();

    // Test adjusting only first event
    doc.events()
        .timing()
        .event(0)
        .shift_start(100) // +1 second to start only
        .unwrap();

    // Only first event should change
    assert!(doc.text().contains("0:00:02.00,0:00:05.00")); // First event start shifted
    assert!(doc.text().contains("0:00:05.00,0:00:10.00")); // Second event unchanged
}

#[test]
fn test_event_delete_single() {
    const TEST_CONTENT: &str = r#"[Script Info]
Title: Test

[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:05.00,Default,Speaker,0,0,0,,First event
Dialogue: 0,0:00:05.00,0:00:10.00,Default,Speaker,0,0,0,,Second event
Dialogue: 0,0:00:10.00,0:00:15.00,Default,Speaker,0,0,0,,Third event
"#;

    let mut doc = EditorDocument::from_content(TEST_CONTENT).unwrap();

    // Delete the second event (index 1)
    doc.events().delete(1).unwrap();

    let events = doc.events().all().unwrap();
    assert_eq!(events.len(), 2);
    assert!(doc.text().contains("First event"));
    assert!(!doc.text().contains("Second event"));
    assert!(doc.text().contains("Third event"));
}

#[test]
fn test_event_delete_multiple() {
    const TEST_CONTENT: &str = r#"[Script Info]
Title: Test

[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:05.00,Default,Speaker,0,0,0,,Event 1
Dialogue: 0,0:00:05.00,0:00:10.00,Default,Speaker,0,0,0,,Event 2
Dialogue: 0,0:00:10.00,0:00:15.00,Default,Speaker,0,0,0,,Event 3
Dialogue: 0,0:00:15.00,0:00:20.00,Default,Speaker,0,0,0,,Event 4
"#;

    let mut doc = EditorDocument::from_content(TEST_CONTENT).unwrap();

    // Delete events at indices 0 and 2
    doc.events().delete_multiple(vec![0, 2]).unwrap();

    let events = doc.events().all().unwrap();
    assert_eq!(events.len(), 2);
    assert!(!doc.text().contains("Event 1"));
    assert!(doc.text().contains("Event 2"));
    assert!(!doc.text().contains("Event 3"));
    assert!(doc.text().contains("Event 4"));
}

#[test]
fn test_event_delete_query() {
    const TEST_CONTENT: &str = r#"[Script Info]
Title: Test

[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:05.00,Default,Speaker,0,0,0,,Keep this
Comment: 0,0:00:05.00,0:00:10.00,Default,Speaker,0,0,0,,Delete this comment
Dialogue: 0,0:00:10.00,0:00:15.00,Default,Speaker,0,0,0,,Keep this too
Comment: 0,0:00:15.00,0:00:20.00,Default,Speaker,0,0,0,,Delete this comment too
"#;

    let mut doc = EditorDocument::from_content(TEST_CONTENT).unwrap();

    // Delete all comment events
    doc.events().delete_query().comments().unwrap();

    let events = doc.events().all().unwrap();
    assert_eq!(events.len(), 2);
    assert!(events
        .iter()
        .all(|e| e.event.event_type == EventType::Dialogue));
    assert!(!doc.text().contains("Delete this comment"));
}