chordlib 0.8.1

Work with chord-and-lyrics songs: parse, transform, and render them to multiple formats
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

use super::FormatChordPro;
use super::render_section::render_section;
use crate::types::{ChordRepresentation, SimpleChord, Song};

impl FormatChordPro for &Song {
    fn format_chord_pro(
        &self,
        key: Option<&SimpleChord>,
        representation: Option<&ChordRepresentation>,
        language: Option<usize>,
        worship_pro_features: bool,
    ) -> String {
        let self_key = self.key.clone().unwrap_or_default();
        let key = key.unwrap_or(&self_key);

        let separator = if worship_pro_features { ": " } else { ":" };

        let mut meta = Vec::new();

        // Title(s)
        if worship_pro_features {
            let mut any = false;
            for (idx, title) in self.titles.iter().enumerate() {
                if title.is_empty() {
                    continue;
                }
                any = true;
                let key = if idx == 0 {
                    "title".to_string()
                } else {
                    format!("title{}", idx + 1)
                };
                meta.push(format!("{{{}{}{}}}", key, separator, title));
            }
            if !any {
                meta.push(format!("{{title{}{}}}", separator, self.title()));
            }
        } else {
            meta.push(format!("{{title{}{}}}", separator, self.title()));
        }

        // Subtitle
        if let Some(subtitle) = &self.subtitle {
            meta.push(format!("{{subtitle{}{}}}", separator, subtitle));
        }

        // Key
        meta.push(format!(
            "{{key{}{}}}",
            separator,
            SimpleChord::default().format(key, &ChordRepresentation::Default)
        ));

        // Copyright (note: preserve existing field name typo for compatibility)
        if let Some(copyright) = &self.copyright {
            meta.push(format!("{{coptyright{}{}}}", separator, copyright));
        }

        // Artist(s)
        if worship_pro_features {
            for (idx, artist) in self.artists.iter().enumerate() {
                if artist.is_empty() {
                    continue;
                }
                let key = if idx == 0 {
                    "artist".to_string()
                } else {
                    format!("artist{}", idx + 1)
                };
                meta.push(format!("{{{}{}{}}}", key, separator, artist));
            }
        } else if !self.artist().is_empty() {
            meta.push(format!("{{artist{}{}}}", separator, self.artist()));
        }

        // Language(s)
        if worship_pro_features {
            for (idx, lang) in self.languages.iter().enumerate() {
                if lang.is_empty() {
                    continue;
                }
                let key = if idx == 0 {
                    "language".to_string()
                } else {
                    format!("language{}", idx + 1)
                };
                meta.push(format!("{{{}{}{}}}", key, separator, lang));
            }
        } else if !self.language().is_empty() {
            meta.push(format!("{{language{}{}}}", separator, self.language()));
        }

        // Tempo & time
        if let Some(tempo) = &self.tempo {
            meta.push(format!("{{tempo{}{}}}", separator, tempo));
        }
        if let Some(time) = &self.time {
            meta.push(format!("{{time{}{}/{}}}", separator, time.0, time.1));
        }

        // Custom tags (ChordPro {meta: name value}); written for both Chord Pro and Worship Pro
        if !self.tags.is_empty() {
            for (name, value) in &self.tags {
                meta.push(format!("{{meta: {} {}}}", name, value));
            }
        }

        meta.into_iter()
            .chain(self.sections.iter().map(|section| {
                render_section(
                    section,
                    Some(key),
                    representation,
                    language,
                    worship_pro_features,
                    self.bar_duration(),
                    self.beats_per_bar(),
                )
            }))
            .chain(std::iter::once("".to_string()))
            .collect::<Vec<String>>()
            .join("\n")
    }
}