cuenv 0.40.6

Event-driven CLI with inline TUI for cuenv
Documentation
//! Codegen sync provider.
//!
//! Syncs codegen-generated files from CUE configuration.

use std::any::Any;
use std::path::Path;

use async_trait::async_trait;
use clap::{Arg, Command, arg};
use cuenv_core::Result;
use cuenv_core::manifest::{Base, Project};

use crate::commands::CommandExecutor;
use crate::commands::sync::functions;
use crate::commands::sync::provider::{SyncMode, SyncOptions, SyncResult};
use crate::provider::{Provider, SyncCapability};

/// Codegen sync provider.
///
/// Syncs codegen-generated files from CUE configuration. Codegen modules are
/// reusable templates that generate project files.
///
/// # Example
///
/// ```ignore
/// use cuenv::Cuenv;
/// use cuenv::providers::CodegenProvider;
///
/// Cuenv::builder()
///     .with_sync_provider(CodegenProvider::new())
///     .build()
///     .run()
/// ```
pub struct CodegenProvider;

impl CodegenProvider {
    /// Create a new codegen provider.
    #[must_use]
    pub fn new() -> Self {
        Self
    }
}

impl Default for CodegenProvider {
    fn default() -> Self {
        Self::new()
    }
}

impl Provider for CodegenProvider {
    fn name(&self) -> &'static str {
        "codegen"
    }

    fn description(&self) -> &'static str {
        "Sync files from CUE codegen configurations"
    }

    fn as_any(&self) -> &dyn Any {
        self
    }

    fn as_any_mut(&mut self) -> &mut dyn Any {
        self
    }
}

#[async_trait]
impl SyncCapability for CodegenProvider {
    fn build_sync_command(&self) -> Command {
        Command::new(self.name())
            .about(self.description())
            .arg(arg!(-p --path <PATH> "Path to directory containing CUE files").default_value("."))
            .arg(
                Arg::new("package")
                    .long("package")
                    .help("Name of the CUE package to evaluate")
                    .default_value("cuenv"),
            )
            .arg(arg!(--"dry-run" "Show what would be generated without writing files"))
            .arg(arg!(--check "Check if files are in sync without making changes"))
            .arg(arg!(-A --all "Sync all projects in the workspace"))
            .arg(arg!(--diff "Show diff for files that would change"))
    }

    async fn sync_path(
        &self,
        path: &Path,
        package: &str,
        options: &SyncOptions,
        executor: &CommandExecutor,
    ) -> Result<SyncResult> {
        let dry_run = options.mode == SyncMode::DryRun;
        let check = options.mode == SyncMode::Check;

        let path_str = path.to_str().ok_or_else(|| {
            cuenv_core::Error::configuration(format!(
                "Path contains invalid UTF-8: {}",
                path.display()
            ))
        })?;

        let codegen_options = functions::CodegenSyncOptions {
            dry_run: dry_run.into(),
            check,
            diff: options.show_diff,
        };
        let request = functions::CodegenSyncRequest {
            path: path_str,
            package,
            options: codegen_options,
        };
        let output = functions::execute_sync_codegen(request, executor).await?;

        Ok(SyncResult::success(output))
    }

    async fn sync_workspace(
        &self,
        package: &str,
        options: &SyncOptions,
        executor: &CommandExecutor,
    ) -> Result<SyncResult> {
        let dry_run = options.mode == SyncMode::DryRun;
        let check = options.mode == SyncMode::Check;

        let cwd = std::env::current_dir().map_err(|e| {
            cuenv_core::Error::configuration(format!("Failed to get current directory: {e}"))
        })?;

        // Collect project info before any async operations
        let project_paths: Vec<(std::path::PathBuf, String)> = {
            let module = executor.discover_all_modules(&cwd)?;
            let mut paths = Vec::new();
            for instance in module.projects() {
                if let Ok(manifest) = instance.deserialize::<Project>()
                    && manifest.codegen.is_some()
                {
                    paths.push((
                        module.root.join(&instance.path),
                        instance.path.display().to_string(),
                    ));
                }
            }
            paths
        };

        let mut outputs = Vec::new();
        let mut had_error = false;

        for (full_path, display_path) in project_paths {
            let Some(path_str) = full_path.to_str() else {
                outputs.push(format!(
                    "{}: Error: Path contains invalid UTF-8",
                    full_path.display()
                ));
                had_error = true;
                continue;
            };

            let codegen_options = functions::CodegenSyncOptions {
                dry_run: dry_run.into(),
                check,
                diff: options.show_diff,
            };
            let request = functions::CodegenSyncRequest {
                path: path_str,
                package,
                options: codegen_options,
            };
            let result = functions::execute_sync_codegen(request, executor).await;

            match result {
                Ok(output) if !output.is_empty() => {
                    let display = if display_path.is_empty() {
                        "[root]".to_string()
                    } else {
                        display_path
                    };
                    outputs.push(format!("{display}:\n{output}"));
                }
                Ok(_) => {}
                Err(e) => {
                    outputs.push(format!("{display_path}: Error: {e}"));
                    had_error = true;
                }
            }
        }

        if outputs.is_empty() {
            Ok(SyncResult::success("No codegen configurations found."))
        } else {
            Ok(SyncResult {
                output: outputs.join("\n\n"),
                had_error,
            })
        }
    }

    fn has_config(&self, _manifest: &Base) -> bool {
        // Codegen configs are only in Projects, not Base
        false
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_codegen_provider_name() {
        let provider = CodegenProvider::new();
        assert_eq!(provider.name(), "codegen");
    }

    #[test]
    fn test_codegen_provider_description() {
        let provider = CodegenProvider::new();
        assert!(!provider.description().is_empty());
        assert!(provider.description().contains("codegen"));
    }

    #[test]
    fn test_codegen_provider_as_any() {
        let provider = CodegenProvider::new();
        let any = provider.as_any();
        assert!(any.is::<CodegenProvider>());
    }

    #[test]
    fn test_codegen_provider_as_any_mut() {
        let mut provider = CodegenProvider::new();
        let any = provider.as_any_mut();
        assert!(any.is::<CodegenProvider>());
    }

    #[test]
    fn test_codegen_provider_command() {
        let provider = CodegenProvider::new();
        let cmd = provider.build_sync_command();
        assert_eq!(cmd.get_name(), "codegen");
    }

    #[test]
    fn test_codegen_provider_command_has_args() {
        let provider = CodegenProvider::new();
        let cmd = provider.build_sync_command();

        let args: Vec<_> = cmd.get_arguments().map(|a| a.get_id().as_str()).collect();
        assert!(args.contains(&"path"));
        assert!(args.contains(&"package"));
        assert!(args.contains(&"dry-run"));
        assert!(args.contains(&"check"));
        assert!(args.contains(&"all"));
        assert!(args.contains(&"diff"));
    }

    #[test]
    fn test_codegen_provider_default() {
        let provider = CodegenProvider;
        assert_eq!(provider.name(), "codegen");
    }

    #[test]
    fn test_codegen_provider_has_config() {
        let provider = CodegenProvider::new();
        let base = Base::default();
        // Codegen configs are only in Projects, not Base
        assert!(!provider.has_config(&base));
    }
}