ito-common 0.1.33

//! Canonical Ito path builders.
//!
//! These helpers consistently build paths under an Ito root directory.

use std::path::{Path, PathBuf};

/// Canonical `.ito/` path builders.
///
/// These helpers intentionally take a `ito_path` (the configured ito root directory)
/// so callers do not duplicate `.join("changes")`, `.join("modules")`, or ad-hoc
/// string-based path formatting.
pub fn default_ito_root(workspace_root: &Path) -> PathBuf {
    workspace_root.join(".ito")
}

/// Return the `changes/` directory under the Ito root.
pub fn changes_dir(ito_path: &Path) -> PathBuf {
    ito_path.join("changes")
}

/// Return the on-disk directory for a specific change.
pub fn change_dir(ito_path: &Path, change_id: &str) -> PathBuf {
    changes_dir(ito_path).join(change_id)
}

/// Return the path to a change's metadata file.
pub fn change_meta_path(ito_path: &Path, change_id: &str) -> PathBuf {
    change_dir(ito_path, change_id).join(".ito.yaml")
}

/// Return the `specs/` directory within a change directory.
pub fn change_specs_dir(ito_path: &Path, change_id: &str) -> PathBuf {
    change_dir(ito_path, change_id).join("specs")
}

/// Return the archive directory for changes (`changes/archive/`).
pub fn changes_archive_dir(ito_path: &Path) -> PathBuf {
    changes_dir(ito_path).join("archive")
}

/// Return the directory used by `ito archive` for archived change artifacts.
pub fn archive_changes_dir(ito_path: &Path) -> PathBuf {
    ito_path.join("archive").join("changes")
}

/// Return the `modules/` directory under the Ito root.
pub fn modules_dir(ito_path: &Path) -> PathBuf {
    ito_path.join("modules")
}

/// Return the `specs/` directory under the Ito root.
pub fn specs_dir(ito_path: &Path) -> PathBuf {
    ito_path.join("specs")
}

/// Return the canonical path to a spec's markdown file (`spec.md`).
pub fn spec_markdown_path(ito_path: &Path, spec_id: &str) -> PathBuf {
    specs_dir(ito_path).join(spec_id).join("spec.md")
}

#[cfg(test)]
#[path = "paths_tests.rs"]
mod paths_tests;