caesura 0.29.0

An all-in-one command line tool to transcode FLAC audio files and upload to gazelle based indexers/trackers
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 std::fs;
use std::time::Duration;

use crate::prelude::*;
use crate::testing_prelude::*;
use insta::assert_snapshot;

/// Test that [`InspectFactory::create`] returns FLAC metadata for a multi-disc source directory.
#[tokio::test]
async fn inspect_factory_flac() -> Result<(), TestError> {
    // Arrange
    let config = AlbumProvider::get_advanced(AlbumConfig::multi_disc()).await;
    let path = SAMPLE_SOURCES_DIR.join(config.dir_name());
    let factory = InspectFactory::new(false);

    // Act
    let output = factory.create(&path)?;

    // Assert
    assert_inspect_snapshot!(output);
    Ok(())
}

/// Test that [`InspectFactory::create`] returns MP3 metadata for a 320kbps transcode.
#[tokio::test]
async fn inspect_factory_320() -> Result<(), TestError> {
    // Arrange
    let config = AlbumProvider::get_advanced(AlbumConfig::multi_disc()).await;
    let transcode = TranscodeProvider::get_advanced(&config, TargetFormat::_320).await;
    let path = transcode.transcode_dir();
    let factory = InspectFactory::new(false);

    // Act
    let output = factory.create(&path)?;

    // Assert
    assert_inspect_snapshot!(output);
    Ok(())
}

/// Test that [`InspectFactory::create`] returns MP3 metadata for a V0 transcode.
#[tokio::test]
async fn inspect_factory_v0() -> Result<(), TestError> {
    // Arrange
    let config = AlbumProvider::get_advanced(AlbumConfig::multi_disc()).await;
    let transcode = TranscodeProvider::get_advanced(&config, TargetFormat::V0).await;
    let path = transcode.transcode_dir();
    let factory = InspectFactory::new(false);

    // Act
    let output = factory.create(&path)?;

    // Assert
    assert_inspect_snapshot!(output);
    Ok(())
}

/// Test that [`InspectFactory::create`] formats a 48 kHz sample rate without a fractional part.
#[tokio::test]
async fn inspect_factory_flac_48khz() -> Result<(), TestError> {
    // Arrange
    let config = AlbumProvider::get(SampleFormat::FLAC16_48).await;
    let path = SAMPLE_SOURCES_DIR.join(config.dir_name());
    let factory = InspectFactory::new(false);

    // Act
    let output = factory.create(&path)?;

    // Assert
    assert_inspect_snapshot!(output);
    Ok(())
}

/// Test that [`InspectFactory::create`] handles mixed FLAC and MP3 files in the same directory.
#[tokio::test]
#[expect(
    clippy::indexing_slicing,
    reason = "test with controlled config guarantees indices exist"
)]
async fn inspect_factory_mixed() -> Result<(), TestError> {
    // Arrange
    let config = AlbumProvider::get_advanced(AlbumConfig::multi_disc()).await;
    let flac_dir = SAMPLE_SOURCES_DIR.join(config.dir_name());
    let transcode = TranscodeProvider::get_advanced(&config, TargetFormat::_320).await;
    let mp3_dir = transcode.transcode_dir();

    let temp = TempDirectory::create("mixed_format");
    fs::copy(
        flac_dir
            .join("Disc 1")
            .join(config.track_filename(&config.tracks[0])),
        temp.join(config.track_filename(&config.tracks[0])),
    )?;
    let mp3_filename = config
        .track_filename(&config.tracks[1])
        .replace(".flac", ".mp3");
    fs::copy(
        mp3_dir.join("Disc 1").join(&mp3_filename),
        temp.join(&mp3_filename),
    )?;
    let factory = InspectFactory::new(false);

    // Act
    let output = factory.create(&temp)?;

    // Assert
    assert_inspect_snapshot!(output);
    Ok(())
}

/// Test that the properties table renders mixed formats, sample rates, and bit depths.
#[test]
fn inspect_factory_properties_table_mixed_formats() {
    // Arrange
    let factory = InspectFactory::new(false);
    let tracks = vec![
        TrackInfo {
            track: Some("1".to_owned()),
            duration: Duration::from_secs(312),
            file_size: 30_408_704,
            bit_rate: 780,
            ..TrackInfo::mock_flac()
        },
        TrackInfo {
            track: Some("2".to_owned()),
            duration: Duration::from_secs(245),
            file_size: 47_710_208,
            bit_rate: 1558,
            sample_rate: 96000,
            bit_depth: Some(24),
            ..TrackInfo::mock_flac()
        },
        TrackInfo {
            track: Some("3".to_owned()),
            duration: Duration::from_secs(198),
            file_size: 19_922_944,
            bit_rate: 805,
            sample_rate: 48000,
            bit_depth: Some(24),
            ..TrackInfo::mock_flac()
        },
        TrackInfo {
            track: Some("4".to_owned()),
            duration: Duration::from_secs(312),
            file_size: 12_288_000,
            ..TrackInfo::mock_mp3()
        },
        TrackInfo {
            track: Some("5".to_owned()),
            duration: Duration::from_secs(312),
            file_size: 9_523_200,
            bit_rate: 245,
            sample_rate: 48000,
            ..TrackInfo::mock_mp3()
        },
    ];

    // Act
    let output = factory.format_properties_table(&tracks);

    // Assert
    assert_snapshot!(output);
}