asai 0.1.2

Library for .ass file parsing.
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

# asai

A rust library for parsing .ass files, which are used for storing subtitles in the Advanced SubStation Alpha format.

## Installation

Add this to your Cargo.toml:

```toml
[dependencies]
asai = "0.1.0"
```

## Usage 

If you want to simply parse ass, you can use parse_str from asai's root:
```rust
use asai::structure::Ass;

fn main() {
    let data = "...";
    let ass = asai::parse_str(data);
    println!("{:?}", ass.styles); // Get styles
    println!("{:?}", ass.info); // Get info
    println!("{:?}", ass.events); // Get events
}
```

Another approach is to use custom structure to represent ass. It allows us to set defaults and parse only required fields.
There is an example:
```rust
use asai_macro::FromLine;
use asai::structure::event::EventKey;
use asai::structure::Ass;

#[derive(FromLine, Debug)]
struct MyEvent<'a> {
    #[name("Text")]
    text: &'a str,
    #[name("Custom")]
    #[default("Some default value")]
    custom_field: &'a str
}

fn main() {
    let data = "...";
    let my_events: FormattedSection<EventKey, MyEvent> = Ass::parse_section("Events", data).unwrap();
}
```