add language

Author: leafyoung

Cargo.toml

@@ -13,7 +13,12 @@ categories = [
     "authentication",
     "web-programming::http-client",
 ]
-exclude = ["client_secret.json", "youtube-oauth2.json", "example-config.yaml"]
+exclude = [
+    "client_secret.json",
+    "youtube-oauth2.json",
+    "example-batch-config.yaml",
+    "example-individual-config.yaml",
+]
 
 [lib]
 name = "rust_yt_uploader"

README.md

@@ -5,7 +5,7 @@ A high-performance, memory-safe Rust library for YouTube video uploading with OA
 ## Features
 
 - **OAuth 2.0 Authentication**: Secure authentication with YouTube API using OAuth 2.0 flow with PKCE support
-- **Dual Configuration Formats**: Support for both legacy and batch YAML configuration formats
+- **Dual Configuration Formats**: Support for both individual and batch YAML configuration formats
 - **Concurrent Uploads**: Async upload mode with configurable concurrency (default: 3)
 - **Resumable Uploads**: Robust upload handling with automatic retry and resumption
 - **Progress Tracking**: Real-time upload progress bars for sequential uploads
@@ -135,7 +135,7 @@ files:
     - "/path/to/video2.mp4"
 ```
 
-#### Legacy Format
+#### Individual Format
 
 ```yaml
 videos:

example-config.yaml example-batch-config.yamlexample-config.yaml renamed to example-batch-config.yaml

@@ -19,6 +19,15 @@ common:
   # Get this from your YouTube playlist URL
   playlistId: "PL1234567890123456"
 
+  # Default audio language for the video (e.g., "en", "zh-Hans", "es")
+  defaultAudioLanguage: "en"
+
+  # Default language for the video (e.g., "en", "zh-Hans", "es")
+  defaultLanguage: "en"
+
+  # Recording date in ISO 8601 format (YYYY-MM-DD will be converted to YYYY-MM-DDT00:00:00.000Z)
+  recordingDate: "2026-01-24"
+
 # List of video titles (will be prefixed with common.prefix)
 titles:
   - "Episode 1: Introduction to Rust"

example-individual-config.yaml

@@ -0,0 +1,36 @@
+# Example individual configuration file for Rust YouTube Uploader
+# This demonstrates the individual configuration format with individual video configs
+
+videos:
+  - title: "My First Video"
+    description: "This is my first video uploaded with Rust uploader"
+    keywords: "rust,youtube,first,video"
+    file: "/path/to/video1.mp4"
+    category: 22 # People & Blogs
+    privacyStatus: "private"
+    playlistId: "PL1234567890123456"
+    defaultAudioLanguage: "en"
+    defaultLanguage: "en"
+    recordingDate: "2026-01-24"
+
+  - title: "My Second Video"
+    description: "This is my second video with different settings"
+    keywords: "rust,youtube,second,tutorial"
+    file: "/path/to/video2.mp4"
+    category: 28 # Science & Technology
+    privacyStatus: "unlisted"
+    playlistId: "PL1234567890123456"
+    defaultAudioLanguage: "en"
+    defaultLanguage: "en"
+    recordingDate: "2026-01-25"
+
+  - title: "My Third Video"
+    description: "A public video for everyone to see"
+    keywords: "rust,youtube,public,demo"
+    file: "/path/to/video3.mp4"
+    category: 28 # Science & Technology
+    privacyStatus: "public"
+    playlistId: "PL1234567890123456"
+    defaultAudioLanguage: "en"
+    defaultLanguage: "en"
+    recordingDate: "2026-01-26"

example-legacy-config.yaml

@@ -6,9 +6,9 @@
 
 use anyhow::Result;
 use clap::Parser;
-use rust_yt_uploader::{BatchConfigRoot, ConfigFormat, LegacyConfigRoot};
+use rust_yt_uploader::{BatchConfigRoot, ConfigFormat, IndividualConfigRoot};
 use rust_yt_uploader::{
-    upload_batch_concurrent, upload_batch_sequential, upload_legacy_sequential,
+    upload_batch_concurrent, upload_batch_sequential, upload_individual_sequential,
 };
 use std::path::PathBuf;
 use tracing::info;
@@ -21,7 +21,7 @@ use tracing::info;
 Upload videos to YouTube from a YAML configuration file.
 
 Supports two YAML schema formats:
-- Legacy: 'videos' array with per-video configuration
+- Individual: 'videos' array with per-video configuration
 - Batch: 'common' config + separate 'titles' and 'files' arrays
 
 Async mode uploads multiple videos concurrently for better performance.
@@ -50,7 +50,7 @@ struct Cli {
 /// * `config` - Raw YAML configuration as a string
 ///
 /// # Returns
-/// * `ConfigFormat` - Either Legacy or Batch
+/// * `ConfigFormat` - Either Individual or Batch
 ///
 /// # Errors
 /// * Returns error if schema cannot be determined
@@ -59,7 +59,7 @@ fn detect_yaml_schema(config: &str) -> Result<ConfigFormat> {
 
     if let Some(mapping) = value.as_mapping() {
         if mapping.contains_key("videos") {
-            return Ok(ConfigFormat::Legacy);
+            return Ok(ConfigFormat::Individual);
         }
 
         if mapping.contains_key("common")
@@ -71,7 +71,7 @@ fn detect_yaml_schema(config: &str) -> Result<ConfigFormat> {
     }
 
     anyhow::bail!(
-        "Unable to determine YAML schema. Expected either 'videos' key (legacy) or 'common', 'titles', and 'files' keys (batch)."
+        "Unable to determine YAML schema. Expected either 'videos' key (individual) or 'common', 'titles', and 'files' keys (batch)."
     );
 }
 
@@ -104,12 +104,12 @@ async fn main() -> Result<()> {
     let schema_type = detect_yaml_schema(&config_content)?;
 
     match schema_type {
-        ConfigFormat::Legacy => {
-            info!("Detected legacy YAML schema format");
-            let config: LegacyConfigRoot = serde_yaml_ng::from_str(&config_content)
-                .map_err(|e| anyhow::anyhow!("Failed to parse legacy config: {}", e))?;
+        ConfigFormat::Individual => {
+            info!("Detected individual YAML schema format");
+            let config: IndividualConfigRoot = serde_yaml_ng::from_str(&config_content)
+                .map_err(|e| anyhow::anyhow!("Failed to parse individual config: {}", e))?;
 
-            upload_legacy_sequential(config, cli.progress).await?;
+            upload_individual_sequential(config, cli.progress).await?;
         }
         ConfigFormat::Batch => {
             info!("Detected batch YAML schema format");

src/bin/yt_upload.rs

@@ -12,11 +12,11 @@ pub mod youtube_client;
 // Re-export commonly used types
 pub use google_oauth::{Credentials, GoogleOAuth};
 pub use models::{
-    BatchConfigRoot, CommonConfig, ConfigFormat, LegacyConfigRoot, PrivacyStatus, RetryConfig,
+    BatchConfigRoot, CommonConfig, ConfigFormat, IndividualConfigRoot, PrivacyStatus, RetryConfig,
     VideoCategory, VideoConfig, VideoUploadOptions,
 };
 pub use youtube_client::{
-    YouTubeClient, upload_batch_concurrent, upload_batch_sequential, upload_legacy_sequential,
+    YouTubeClient, upload_batch_concurrent, upload_batch_sequential, upload_individual_sequential,
 };
 
 pub use retry::retry_with_backoff;

src/lib.rs

@@ -1,7 +1,7 @@
 //! Configuration models for YouTube uploader with validation.
 //!
 //! This module provides Serde-based models that mirror the Python Pydantic models,
-//! supporting both legacy and batch YAML configuration formats.
+//! supporting both individual and batch YAML configuration formats.
 
 use anyhow::{Result, anyhow};
 use futures::future::try_join_all;
@@ -14,7 +14,7 @@ use validator::{Validate, ValidationError};
 /// Configuration format detection result
 #[derive(Debug, Clone, PartialEq)]
 pub enum ConfigFormat {
-    Legacy,
+    Individual,
     Batch,
 }
 
@@ -67,6 +67,25 @@ pub struct VideoUploadOptions {
     pub category: u32,
     pub privacy_status: String,
     pub playlist_id: String,
+    #[serde(rename = "defaultAudioLanguage")]
+    pub default_audio_language: String,
+    #[serde(rename = "defaultLanguage")]
+    pub default_language: String,
+    #[serde(rename = "recordingDate")]
+    pub recording_date: String,
+}
+
+impl VideoUploadOptions {
+    /// Convert recording_date from "YYYY-MM-DD" to YouTube API timestamp format "YYYY-MM-DDTHH:MM:SS.000Z"
+    pub fn formatted_recording_date(&self) -> String {
+        if self.recording_date.contains('T') {
+            // Already in timestamp format, return as-is
+            self.recording_date.clone()
+        } else {
+            // Convert "YYYY-MM-DD" to "YYYY-MM-DDT00:00:00.000Z"
+            format!("{}T00:00:00.000Z", self.recording_date)
+        }
+    }
 }
 
 /// Valid YouTube video privacy status values.
@@ -227,6 +246,18 @@ pub struct CommonConfig {
     #[validate(custom(function = "validate_playlist_id"))]
     #[serde(rename = "playlistId")]
     pub playlist_id: String,
+
+    /// Default audio language for the video
+    #[serde(rename = "defaultAudioLanguage")]
+    pub default_audio_language: String,
+
+    /// Default language for the video
+    #[serde(rename = "defaultLanguage")]
+    pub default_language: String,
+
+    /// Recording date for the video
+    #[serde(rename = "recordingDate")]
+    pub recording_date: String,
 }
 
 impl CommonConfig {
@@ -239,7 +270,7 @@ impl CommonConfig {
     }
 }
 
-/// Configuration for a single video (legacy format).
+/// Configuration for a single video (individual format).
 #[derive(Debug, Clone, Serialize, Deserialize, Validate)]
 pub struct VideoConfig {
     /// Video title
@@ -269,11 +300,23 @@ pub struct VideoConfig {
     #[validate(custom(function = "validate_playlist_id"))]
     #[serde(rename = "playlistId")]
     pub playlist_id: String,
+
+    /// Default audio language for the video
+    #[serde(rename = "defaultAudioLanguage")]
+    pub default_audio_language: String,
+
+    /// Default language for the video
+    #[serde(rename = "defaultLanguage")]
+    pub default_language: String,
+
+    /// Recording date for the video
+    #[serde(rename = "recordingDate")]
+    pub recording_date: String,
 }
 
-/// Root model for legacy YAML format with videos array.
+/// Root model for individual YAML format with videos array.
 #[derive(Debug, Clone, Serialize, Deserialize, Validate)]
-pub struct LegacyConfigRoot {
+pub struct IndividualConfigRoot {
     /// Test mode flag - if true, delete videos after upload
     #[serde(default = "bool::default")]
     pub test: bool,
@@ -365,4 +408,36 @@ mod tests {
         assert!(validate_playlist_id("invalid").is_err());
         assert!(validate_playlist_id("PL123").is_err()); // too short
     }
+
+    #[test]
+    fn test_formatted_recording_date() {
+        let options = VideoUploadOptions {
+            file: "test.mp4".to_string(),
+            title: "Test".to_string(),
+            description: "Test".to_string(),
+            keywords: "test".to_string(),
+            category: 22,
+            privacy_status: "private".to_string(),
+            playlist_id: "PL1234567890123456".to_string(),
+            default_audio_language: "en".to_string(),
+            default_language: "en".to_string(),
+            recording_date: "2026-01-24".to_string(),
+        };
+
+        // Should convert YYYY-MM-DD to YYYY-MM-DDT00:00:00.000Z
+        assert_eq!(
+            options.formatted_recording_date(),
+            "2026-01-24T00:00:00.000Z"
+        );
+
+        // Already in timestamp format should remain unchanged
+        let options_with_timestamp = VideoUploadOptions {
+            recording_date: "2026-01-24T12:30:45.000Z".to_string(),
+            ..options
+        };
+        assert_eq!(
+            options_with_timestamp.formatted_recording_date(),
+            "2026-01-24T12:30:45.000Z"
+        );
+    }
 }