abc-parser 0.4.0

An ABC music notation parser. Turns ABC text into Rust data structures and back.
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

# rust-abc-2

ABC Parser written in rust using PEG.

## Usage

Add the package to your cargo dependencies.
```toml
[dependencies]
abc-parser = "0.4"
```

Then you can use the PEG generated rules through the abc module.
```rust
use abc_parser::abc;
use abc_parser::datatypes::*;

let parsed = abc::tune_book("X:1\nT:Example\nK:D\n").unwrap();
assert_eq!(
    parsed,
    TuneBook::new(
        vec![],
        None,
        vec![Tune::new(
            TuneHeader::new(vec![
                HeaderLine::Field(InfoField::new('X', "1".to_string()), None),
                HeaderLine::Field(InfoField::new('T', "Example".to_string()), None),
                HeaderLine::Field(InfoField::new('K', "D".to_string()), None)
            ]),
            None
        )]
    )
)
```

## Feature List

These are roughly taken in order from the abc standard.
  - [x] Comments
    - [x] Comment lines with preceding whitespace
  - [x] Info fields
    - [x] Inline fields
    - [x] Remarks
    - [ ] Macros
    - [ ] Redefining Symbols
    - [ ] Multiple Voices
    - [ ] Clefs and Transposition
  - [x] Field continuation
  - [x] Notes
    - [x] Pitch
    - [x] Accidentals
    - [x] Lengths
    - [x] Ties
    - [x] Broken Rhythm
      - [ ] Splitting grace notes e.g. A{g}<A
  - [x] Rests
  - [x] Beams
  - [x] Bars
  - [x] First and second repeats
    - [x] Shortened e.g. |1 and :|2
  - [x] Variant Endings
  - [x] Slurs
  - [x] Grace Notes
  - [x] Tuplets
  - [x] Decorations
  - [x] Symbol Lines
  - [x] Chords and Unisons
  - [x] Annotations
    - [ ] Chord Symbols
  - [x] Lyrics
  - [x] Multiple Voices
    - [ ] Voice grouping shorthand syntax
  - [ ] Text Strings
  - [x] Reserved characters
  - [x] Stylesheet Directives
  - [ ] Dialects
  - [x] Spacers

## History

The first version was an attempt to write the parser by hand, but using PEG is
much more maintainable. The older repo is here:
[https://gitlab.com/Askaholic/rust-abc](https://gitlab.com/Askaholic/rust-abc)