Struct GitVcs 

pub struct GitVcs;

Git implementation of the VCS trait.

Implementations

impl GitVcs

pub fn version(&self) -> Result<GitVersion, JoyError>

Get the installed git version. Returns error if git is not found.

pub fn check_version(&self) -> Result<GitVersion, JoyError>

Check that git meets the minimum version requirement.

impl GitVcs

pub fn add(&self, root: &Path, paths: &[&str]) -> Result<(), JoyError>

Stage files for commit.

pub fn is_ignored(&self, root: &Path, path: &str) -> bool

True if path matches one of the .gitignore patterns (regardless of whether it is currently tracked).

git check-ignore --quiet <path> exits 0 when the path is ignored, 1 when it is not, anything else on error. Errors are treated as “not ignored” so that genuine staging attempts surface via the regular add error path rather than getting swallowed here.

pub fn add_all(&self, root: &Path) -> Result<(), JoyError>

Stage all changes (git add -A).

pub fn commit(&self, root: &Path, message: &str) -> Result<(), JoyError>

Create a commit with a message.

pub fn tag_annotated( &self, root: &Path, name: &str, body: &str, ) -> Result<(), JoyError>

Create an annotated tag with a message body.

pub fn tag(&self, root: &Path, name: &str) -> Result<(), JoyError>

Create a lightweight tag.

pub fn push(&self, root: &Path, remote: &str) -> Result<(), JoyError>

Push the current branch to a remote.

pub fn push_tag( &self, root: &Path, remote: &str, tag: &str, ) -> Result<(), JoyError>

Push a specific tag to a remote.

pub fn push_with_tags(&self, root: &Path, remote: &str) -> Result<(), JoyError>

Push current branch and tags in one call.

pub fn default_remote(&self, root: &Path) -> Result<String, JoyError>

Get the default remote name (usually “origin”).

pub fn remote_url(&self, root: &Path, remote: &str) -> Result<String, JoyError>

Get the remote URL for a given remote name.

pub fn all_remotes( &self, root: &Path, ) -> Result<Vec<(String, String)>, JoyError>

List every configured remote as (name, url) pairs, in the order git remote returns them. Empty when the repo has no remotes configured.

pub fn is_clean(&self, root: &Path) -> Result<bool, JoyError>

Check if the working tree is clean.

pub fn head_is_tagged(&self, root: &Path) -> bool

Check if HEAD is exactly on a tag.

impl GitVcs

pub fn detect_forge(&self, root: &Path) -> Forge

Detect the hosting platform from the remote URL.

pub fn detect_forges(&self, root: &Path) -> Vec<(String, Forge)>

Detect the forge type for every configured remote. Each entry is (remote_name, forge). Remotes with no recognisable forge are returned as Forge::Unknown so callers can report what was configured.

Trait Implementations

impl Vcs for GitVcs

fn is_repo(&self, root: &Path) -> bool

Check if the given directory is inside a VCS repository.

fn init_repo(&self, root: &Path) -> Result<(), JoyError>

Initialize a new repository at the given path.

fn user_email(&self) -> Result<String, JoyError>

Get the current user’s email from VCS config.

fn version_tags(&self, root: &Path) -> Result<Vec<String>, JoyError>

List all version tags (e.g. v0.5.0), sorted descending.

fn latest_version_tag(&self, root: &Path) -> Result<Option<String>, JoyError>

Get the latest reachable version tag, if any.

fn config_get(&self, root: &Path, key: &str) -> Result<String, JoyError>

Read a per-clone VCS-config value. The semantics are Git-flavoured (git config --local <key>); other backends implement on the closest equivalent (jj has jj config, pijul pijul config).

fn config_set( &self, root: &Path, key: &str, value: &str, ) -> Result<(), JoyError>

Write a per-clone VCS-config value. Same semantics as Vcs::config_get.