yt-dlp 2.7.2

🎬️ A Rust library (with auto dependencies installation) for Youtube downloading
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

//! Convenience macros for common operations.
//!
//! This module provides macros that simplify common tasks when working with yt-dlp.

/// Create a Youtube instance with sensible defaults.
///
/// # Examples
///
/// ```rust,no_run
/// # use yt_dlp::youtube;
/// # #[tokio::main]
/// # async fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
/// let yt = youtube!("libs/yt-dlp", "libs/ffmpeg", "output").await?;
/// # Ok(())
/// # }
/// ```
#[macro_export]
macro_rules! youtube {
    ($yt_dlp:expr, $ffmpeg:expr, $output:expr) => {{
        let libraries =
            $crate::client::Libraries::new(std::path::PathBuf::from($yt_dlp), std::path::PathBuf::from($ffmpeg));
        $crate::Downloader::builder(libraries, $output).build()
    }};

    ($yt_dlp:expr, $ffmpeg:expr, $output:expr, cache: $cache:expr) => {{
        let libraries =
            $crate::client::Libraries::new(std::path::PathBuf::from($yt_dlp), std::path::PathBuf::from($ffmpeg));
        $crate::Downloader::builder(libraries, $output)
            .with_cache($cache)
            .build()
    }};
}

/// Configure yt-dlp arguments easily.
///
/// # Examples
///
/// ```rust,ignore
/// let args = ytdlp_args![
///     "--no-playlist",
///     "--extract-audio",
///     format: "bestvideo+bestaudio"
/// ];
/// ```
#[macro_export]
macro_rules! ytdlp_args {
    ($($arg:expr),* $(,)?) => {{
        vec![$($arg.to_string()),*]
    }};

    ($($key:ident: $value:expr),* $(,)?) => {{
        vec![$(format!("--{}={}", stringify!($key).replace('_', "-"), $value)),*]
    }};
}

/// Create a Libraries instance with automatic binary installation.
///
/// # Examples
///
/// ```rust,no_run
/// # use yt_dlp::install_libraries;
/// # #[tokio::main]
/// # async fn main() -> Result<(), Box<dyn std::error::Error>> {
/// let libs = install_libraries!("libs")?;
/// # Ok(())
/// # }
/// ```
#[macro_export]
macro_rules! install_libraries {
    ($dir:expr) => {{
        use std::path::PathBuf;

        use $crate::client::Libraries;
        use $crate::client::deps::LibraryInstaller;

        let dir = PathBuf::from($dir);
        let yt_dlp = dir.join("yt-dlp");
        let ffmpeg = dir.join("ffmpeg");

        let libraries = Libraries::new(yt_dlp, ffmpeg);
        libraries.install_dependencies().await?;

        Ok::<Libraries, $crate::error::Error>(libraries)
    }};

    ($dir:expr, token: $token:expr) => {{
        use std::path::PathBuf;

        use $crate::client::Libraries;
        use $crate::client::deps::LibraryInstaller;

        let dir = PathBuf::from($dir);
        let yt_dlp = dir.join("yt-dlp");
        let ffmpeg = dir.join("ffmpeg");

        let libraries = Libraries::new(yt_dlp, ffmpeg);
        libraries.install_dependencies_with_token($token).await?;

        Ok::<Libraries, $crate::error::Error>(libraries)
    }};
}

/// A macro to mimic the ternary operator in Rust.
#[macro_export]
macro_rules! ternary {
    ($condition:expr, $true:expr, $false:expr) => {
        if $condition { $true } else { $false }
    };
}