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 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 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.

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.