def initialize_repo(worktree: str,
*,
gitdir: Optional[str] = None) -> Iterator[Git]:
"""Initialize a git repository for the given `worktree`.
NB: The given `worktree` must contain at least one file which will be committed to form an initial
commit.
:param worktree: The path to the git work tree.
:param gitdir: An optional path to the `.git` dir to use.
:returns: A `Git` repository object that can be used to interact with the repo.
"""
@contextmanager
def use_gitdir() -> Iterator[str]:
if gitdir:
yield gitdir
else:
with temporary_dir() as d:
yield d
with use_gitdir() as git_dir, environment_as(GIT_DIR=git_dir,
GIT_WORK_TREE=worktree):
subprocess.run(["git", "init"], check=True)
subprocess.run(["git", "config", "user.email", "*****@*****.**"],
check=True)
# TODO: This method inherits the global git settings, so if a developer has gpg signing on,
# this will turn that off. We should probably just disable reading from the global config
# somehow: https://git-scm.com/docs/git-config.
subprocess.run(["git", "config", "commit.gpgSign", "false"],
check=True)
subprocess.run(["git", "config", "user.name", "Your Name"], check=True)
subprocess.run(["git", "add", "."], check=True)
subprocess.run(["git", "commit", "-am", "Add project files."],
check=True)
yield Git.mount(subdir=worktree)
def get_git() -> Git | None:
"""Returns Git, if available."""
global _Git
if _Git is _GitIinitialized.NO:
# We know about Git, so attempt an auto-configure
try:
git = Git.mount()
logger.debug(
f"Detected git repository at {git.worktree} on branch {git.branch_name}"
)
_Git = git
except GitException as e:
logger.info(f"No git repository at {os.getcwd()}: {e!r}")
_Git = None
return _Git