gitflow-gitcode 1.1.0

gf 的 GitCode 适配器,基于 gitcode CLI 提供 Issue/MR/Release/Review 等能力。GitCode adapter for gf via gitcode CLI.
Documentation
//! `gitflow-gitcode` —— GitCode 平台实现。
//!
//! 本 crate 实现了 `gitflow-core` 中定义的 [`IssueProvider`]、[`PrProvider`]、
//! [`ReleaseProvider`]、[`ReviewProvider`]、[`AuthProvider`]、[`LabelProvider`]、
//! [`MilestoneProvider`]、[`CommitProvider`] 与 [`PipelineProvider`] trait,
//! 通过调用 `gc` CLI 获取数据并解析其 JSON 输出。
//!
//! # 主要类型
//!
//! - [`GitCodeIssueProvider`]:操作 GitCode Issue。
//! - [`GitCodePrProvider`]:操作 GitCode Pull Request。
//! - [`GitCodeReleaseProvider`]:操作 GitCode Release。
//! - [`GitCodeReviewProvider`]:操作 GitCode PR Review。
//! - [`GitCodeAuthProvider`]:处理 GitCode 认证(登录、登出、状态、Token)。
//! - [`GitCodeLabelProvider`]:管理 GitCode 仓库标签。
//! - [`GitCodeMilestoneProvider`]:管理 GitCode 仓库里程碑。
//! - [`GitCodeCommitProvider`]:查看 GitCode Commit 及 Diff/Patch。
//! - [`GitCodePipelineProvider`]:查看 GitCode CI/CD 流水线。
//!
//! # 错误处理
//!
//! 所有平台调用失败时,`gc` 的 stderr 会通过 [`error::parse_gitcode_error`] 解析,
//! 并统一映射为 [`CoreError::Platform`]。
//!
//! [`IssueProvider`]: gitflow_core::issue::IssueProvider
//! [`PrProvider`]: gitflow_core::pr::PrProvider
//! [`ReleaseProvider`]: gitflow_core::release::ReleaseProvider
//! [`ReviewProvider`]: gitflow_core::review::ReviewProvider
//! [`AuthProvider`]: gitflow_core::auth::AuthProvider
//! [`LabelProvider`]: gitflow_core::label::LabelProvider
//! [`MilestoneProvider`]: gitflow_core::label::MilestoneProvider
//! [`CommitProvider`]: gitflow_core::commit::CommitProvider
//! [`PipelineProvider`]: gitflow_core::pipeline::PipelineProvider
//! [`CoreError::Platform`]: gitflow_core::CoreError::Platform

#![forbid(unsafe_code)]
#![allow(
    clippy::doc_markdown,
    reason = "GitCode is a platform brand name, not a Rust code item"
)]
#![cfg_attr(
    test,
    allow(
        clippy::expect_used,
        clippy::unwrap_used,
        clippy::indexing_slicing,
        clippy::useless_format,
        clippy::clone_on_copy,
        reason = "Tests legitimately need to unwrap fixture data and index into known-shape \
                  collections"
    )
)]

pub mod auth;
pub mod commit;
pub mod error;
pub mod issue;
pub mod label;
pub mod pipeline;
pub mod pr;
pub mod release;
pub mod review;
pub mod runner;

pub use auth::GitCodeAuthProvider;
pub use commit::GitCodeCommitProvider;
pub use error::parse_gitcode_error;
pub use issue::GitCodeIssueProvider;
pub use label::{GitCodeLabelProvider, GitCodeMilestoneProvider};
pub use pipeline::GitCodePipelineProvider;
pub use pr::GitCodePrProvider;
pub use release::GitCodeReleaseProvider;
pub use review::GitCodeReviewProvider;

/// Return the GitCode CLI binary path.
///
/// Prefers `gc` (Linux/macOS native name), falls back to `gitcode` (cross-platform).
/// Searches PATH first, then pip user install directories
/// (`~/Library/Python/*/bin/` on macOS, `~/.local/bin/` on Linux).
#[allow(
    clippy::disallowed_methods,
    reason = "binary discovery runs at startup before async runtime is ready"
)]
pub(crate) fn gitcode_binary() -> String {
    const CANDIDATES: &[&str] = &["gc", "gitcode"];

    // 1. which <candidate> (pip/wheel/DEB/RPM install)
    for &candidate in CANDIDATES {
        if let Ok(p) = which::which(candidate) {
            return p.to_string_lossy().into_owned();
        }
    }
    // 2. pip user install paths (e.g. ~/Library/Python/3.9/bin/)
    if let Ok(home) = std::env::var("HOME") {
        for &candidate in CANDIDATES {
            let lib = std::path::PathBuf::from(&home).join("Library/Python");
            if let Ok(entries) = std::fs::read_dir(&lib) {
                for entry in entries.flatten() {
                    let p = entry.path().join("bin").join(candidate);
                    if p.exists() {
                        return p.to_string_lossy().into_owned();
                    }
                }
            }
            // Also check ~/.local/bin
            let p = std::path::PathBuf::from(&home)
                .join(".local/bin")
                .join(candidate);
            if p.exists() {
                return p.to_string_lossy().into_owned();
            }
        }
    }
    // 3. Desperate fallback — prefer gc
    "gc".into()
}

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

    #[test]
    fn test_should_return_non_empty_binary_name() {
        let binary = gitcode_binary();
        assert!(!binary.is_empty());
    }
}