git ¤

assert_git_repo(path: str | Path) -> None

Assert that a directory is a Git repository.

Parameters:

• path (str | Path) –

  Path to a directory.

Raises:

• OSError –

  When the directory is not a Git repository.

get_latest_tag(repo: str | Path) -> str

Get latest tag of a Git repository.

Parameters:

• repo (str | Path) –

  The path to Git repository.

Returns:

• str –

  The latest tag.

get_repo_root(repo: str | Path) -> str

Get the root of a Git repository.

Parameters:

• repo (str | Path) –

  The path to a Git repository.

Returns:

• str –

  The root of the repository.

tmp_worktree(
    repo: str | Path = ".", ref: str = "HEAD"
) -> Iterator[Path]

Context manager that checks out the given reference in the given repository to a temporary worktree.

Parameters:

• repo (str | Path, default: '.' ) –

  Path to the repository (i.e. the directory containing the .git directory)

• ref (str, default: 'HEAD' ) –

  A Git reference such as a commit, tag or branch.

Yields:

• Path –

  The path to the temporary worktree.

Raises:

• OSError –

  If repo is not a valid .git repository

• RuntimeError –

  If the git executable is unavailable, or if it cannot create a worktree