caesura 0.31.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

use crate::testing_prelude::*;
use crate::utils::TargetFormat::{_320, V0};

/// Test `rename_tracks` with a single-disc album.
///
/// Expected output filenames: `1 Track One.mp3`, `2 Track Two.mp3`
/// (single-digit padding since max track is 2)
#[tokio::test]
async fn transcode_rename_tracks_single_disc() {
    let snapshot = rename_tracks_helper(AlbumConfig::single_disc()).await;
    let snapshot = normalize_snapshots!(snapshot);
    assert_yaml_snapshot!(snapshot);
}

/// Test `rename_tracks` with a multi-disc album from flat source directory.
///
/// Source: all files in one directory (no disc subdirs)
/// Expected output structure:
/// - `CD1/1 First Track.mp3`
/// - `CD1/2 Second Track.mp3`
/// - `CD2/1 Third Track.mp3`
/// - `CD2/2 Fourth Track.mp3`
#[tokio::test]
async fn transcode_rename_tracks_multi_disc_flat_source() {
    let snapshot = rename_tracks_helper(AlbumConfig::multi_disc_flat()).await;
    let snapshot = normalize_snapshots!(snapshot);
    assert_yaml_snapshot!(snapshot);
}

/// Test `rename_tracks` with a multi-disc album from source with disc subdirectories.
///
/// Source: `Disc 1/01 First Track.flac`, `Disc 2/01 Third Track.flac`, etc.
/// Expected output structure:
/// - `CD1/1 First Track.mp3`
/// - `CD1/2 Second Track.mp3`
/// - `CD2/1 Third Track.mp3`
/// - `CD2/2 Fourth Track.mp3`
#[tokio::test]
async fn transcode_rename_tracks_multi_disc() {
    let snapshot = rename_tracks_helper(AlbumConfig::multi_disc()).await;
    let snapshot = normalize_snapshots!(snapshot);
    assert_yaml_snapshot!(snapshot);
}

/// Test `rename_tracks` with double-digit track numbers.
///
/// Expected output filenames: `01 Track One.mp3` through `10 Track Ten.mp3`
/// (two-digit padding since max track is 10)
#[tokio::test]
async fn transcode_rename_tracks_double_digit_padding() {
    let snapshot = rename_tracks_helper(AlbumConfig::double_digit_tracks()).await;
    let snapshot = normalize_snapshots!(snapshot);
    assert_yaml_snapshot!(snapshot);
}

/// Test `rename_tracks` with vinyl-style track numbers (A1, A2, B1, B2).
///
/// The `fix_track_numbering` logic converts vinyl notation to proper track/disc numbers
/// in the cached ID3 tags, so renamed files use numeric tracks with CD subfolders.
#[tokio::test]
async fn transcode_rename_tracks_vinyl_numbering() {
    let snapshot = rename_tracks_helper(AlbumConfig::vinyl_tracks()).await;
    let snapshot = normalize_snapshots!(snapshot);
    assert_yaml_snapshot!(snapshot);
}

/// Test `rename_tracks` with "N of M" track numbers (1 of 4, 2 of 4, etc.).
///
/// The `fix_track_numbering` logic converts "of" notation to proper track numbers
/// and track totals in the cached ID3 tags.
#[tokio::test]
async fn transcode_rename_tracks_of_total_numbering() {
    let snapshot = rename_tracks_helper(AlbumConfig::of_total_tracks()).await;
    let snapshot = normalize_snapshots!(snapshot);
    assert_yaml_snapshot!(snapshot);
}

async fn rename_tracks_helper(config: AlbumConfig) -> Vec<FileSnapshot> {
    init_logger();
    let config = AlbumProvider::get_advanced(config).await;
    let test_dir = TestDirectory::new();
    let host = HostBuilder::new()
        .with_mock_api(config)
        .with_test_options(&test_dir)
        .await
        .with_options(TargetOptions {
            target: vec![_320, V0],
            ..TargetOptions::default()
        })
        .with_options(FileOptions {
            rename_tracks: true,
            no_image_compression: true,
            no_png_to_jpg: true,
            max_file_size: FileOptions::DEFAULT_MAX_FILE_SIZE,
            max_pixel_size: FileOptions::DEFAULT_MAX_PIXEL_SIZE,
            jpg_quality: FileOptions::DEFAULT_JPG_QUALITY,
        })
        .expect_build();

    let provider = host.services.get_required::<SourceProvider>();
    let transcoder = host.services.get_required::<TranscodeCommand>();
    let source = provider
        .get(AlbumConfig::TORRENT_ID)
        .await
        .expect("should not fail")
        .expect("should find source");

    let result = transcoder.execute(&source).await;

    assert!(result.is_ok(), "transcode should succeed");
    DirectorySnapshot::new()
        .with_directory(test_dir.output())
        .without_extensions(&["torrent"])
        .create()
        .expect("should read output directory")
}