hum 0.6.0

A music notation language and synthesizer written in Rust.
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

/*
Hum: A Music Markup Language Synthesizer
Copyright (C) 2018 Connor R. Bulakites
 
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
 
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.
*/
 
extern crate hound;
extern crate peg;

use std::error;
use std::fmt;


// Custom type for general Hum processing errors
#[derive(Debug)]
pub struct GenerateError {
    pub message: String,
}

impl fmt::Display for GenerateError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "{}", self.message)
    }
}

impl error::Error for GenerateError {}


// Declaration of Peg ParseError (type specification required)
pub type ParseError = peg::error::ParseError<peg::str::LineCol>;


// Custom type for catch-all Hum errors.
#[derive(Debug)]
pub enum HumError {
    FileSaveError(hound::Error),
    GenerateError(GenerateError),
    HumParseError(ParseError),
}
 
impl From<hound::Error> for HumError {
    fn from(err: hound::Error) -> HumError {
        HumError::FileSaveError(err)
    }
}
 
impl From<GenerateError> for HumError {
    fn from(err: GenerateError) -> HumError {
        HumError::GenerateError(err)
    }
}

impl From<ParseError> for HumError {
    fn from(err: ParseError) -> HumError {
        HumError::HumParseError(err)
    }
}

impl fmt::Display for HumError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            HumError::FileSaveError(ref err) => write!(f, "FileSaveError: {}", err),
            HumError::GenerateError(ref err) => write!(f, "GenerateError: {}", err),
            HumError::HumParseError(ref err) => write!(f, "HumParseError: {}", err),
        }
    }
}

impl error::Error for HumError {
    fn cause(&self) -> Option<&dyn error::Error> {
        match *self {
            HumError::FileSaveError(ref err) => Some(err),
            HumError::GenerateError(ref err) => Some(err),
            HumError::HumParseError(ref err) => Some(err),
        }
    }
}