freesound-rs 0.2.0

A Rust client for the Freesound API to search and get sounds only
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

use serde::Deserialize;

/// Preview URLs for different formats and qualities
#[derive(Debug, Deserialize)]
pub struct Previews {
    /// High quality MP3 preview (~128kbps)
    #[serde(rename = "preview-hq-mp3")]
    pub preview_hq_mp3: String,
    /// Low quality MP3 preview (~64kbps)
    #[serde(rename = "preview-lq-mp3")]
    pub preview_lq_mp3: String,
    /// High quality OGG preview (~192kbps)
    #[serde(rename = "preview-hq-ogg")]
    pub preview_hq_ogg: String,
    /// Low quality OGG preview (~80kbps)
    #[serde(rename = "preview-lq-ogg")]
    pub preview_lq_ogg: String,
}

/// Image URLs for sound visualization
#[derive(Debug, Deserialize)]
pub struct Images {
    /// Large waveform image
    pub waveform_l: String,
    /// Medium waveform image
    pub waveform_m: String,
    /// Large spectral image
    pub spectral_l: String,
    /// Medium spectral image
    pub spectral_m: String,
}

/// A sound from Freesound
#[derive(Debug, Deserialize)]
#[serde(default)] // Utilise les valeurs par défaut si les champs sont manquants
pub struct Sound {
    /// The sound's unique identifier
    pub id: i32,
    /// The URI for this sound on the Freesound website
    #[serde(default)]
    pub url: String,
    /// The name user gave to the sound
    pub name: String,
    /// An array of tags the user gave to the sound
    #[serde(default)]
    pub tags: Vec<String>,
    /// The description the user gave to the sound
    #[serde(default)]
    pub description: String,
    /// Latitude and longitude of the geotag (if available)
    pub geotag: Option<String>,
    /// The date when the sound was uploaded
    #[serde(default)]
    pub created: String,
    /// The license under which the sound is available
    pub license: String,
    /// The type of sound (wav, aif, aiff, mp3, m4a or flac)
    #[serde(rename = "type", default)]
    pub sound_type: String,
    /// The number of channels
    #[serde(default)]
    pub channels: i32,
    /// The size of the file in bytes
    #[serde(default)]
    pub filesize: i32,
    /// The bit rate of the sound in kbps
    pub bitrate: Option<f32>,
    /// The bit depth of the sound
    pub bitdepth: Option<i32>,
    /// The duration of the sound in seconds
    #[serde(default)]
    pub duration: f32,
    /// The samplerate of the sound
    #[serde(default)]
    pub samplerate: f32,
    /// The username of the uploader
    pub username: String,
    /// URI pointing to the pack API resource
    pub pack: Option<String>,
    /// URI for downloading the original sound
    #[serde(default)]
    pub download: String,
    /// URI for bookmarking the sound
    #[serde(default)]
    pub bookmark: String,
    /// URLs for mp3 and ogg versions of the sound
    #[serde(default)]
    pub previews: Option<Previews>,
    /// URLs for spectrogram and waveform visualizations
    #[serde(default)]
    pub images: Option<Images>,
    /// The number of times the sound was downloaded
    #[serde(default)]
    pub num_downloads: i32,
    /// The average rating of the sound
    #[serde(default)]
    pub avg_rating: f32,
    /// The number of times the sound was rated
    #[serde(default)]
    pub num_ratings: i32,
    /// The URI for rating the sound
    #[serde(default)]
    pub rate: String,
    /// The URI for the comments
    #[serde(default)]
    pub comments: String,
    /// The number of comments
    #[serde(default)]
    pub num_comments: i32,
    /// The URI to comment the sound
    #[serde(default)]
    pub comment: String,
    /// URI for similar sounds
    #[serde(default)]
    pub similar_sounds: String,
    /// Analysis data (when requested)
    pub analysis: Option<serde_json::Value>,
    /// URI for complete analysis results
    #[serde(default)]
    pub analysis_stats: String,
    /// URI for analysis frames
    #[serde(default)]
    pub analysis_frames: String,
}

impl Default for Sound {
    fn default() -> Self {
        Self {
            id: 0,
            url: String::new(),
            name: String::new(),
            tags: Vec::new(),
            description: String::new(),
            geotag: None,
            created: String::new(),
            license: String::new(),
            sound_type: String::new(),
            channels: 0,
            filesize: 0,
            bitrate: None,
            bitdepth: None,
            duration: 0.0,
            samplerate: 0.0,
            username: String::new(),
            pack: None,
            download: String::new(),
            bookmark: String::new(),
            previews: None,
            images: None,
            num_downloads: 0,
            avg_rating: 0.0,
            num_ratings: 0,
            rate: String::new(),
            comments: String::new(),
            num_comments: 0,
            comment: String::new(),
            similar_sounds: String::new(),
            analysis: None,
            analysis_stats: String::new(),
            analysis_frames: String::new(),
        }
    }
}