Package io.github.joke.conventionalversion.git

@NullMarked package io.github.joke.conventionalversion.git

Gathers repository facts by running git.

The CLI rather than a library: JGit would be the only entry on a consuming build's buildscript classpath, and the real client already handles worktrees, submodules and safe.directory correctly. Requiring git on the PATH is a fair precondition for a plugin whose whole purpose is reading git.

Unit tested and mutation tested like any other package. Running git is a collaboration, not an obstacle to testing: the command runner is spied to stub the spawn, and everything above it is asserted against a mocked runner - including the exact argument list each read sends to git.

Related Packages

Package	Description
io.github.joke.conventionalversion	The Gradle surface: the settings plugin, its configuration, and the value source that reads git.
io.github.joke.conventionalversion.calc	The version calculation core: a pure function from repository facts to a version string.
io.github.joke.conventionalversion.config	Reads the configuration release-please keeps in the repository, so that every value which affects a calculated version comes from the release tooling's own declarations rather than from a restatement of them.

Class	Description
ConventionalVersionException	A precondition the calculation cannot proceed without.
GitCommandRunner	Runs git in a directory and returns its standard output.
GitRepository	The repository reads the calculation needs, each one git command.
RepositoryStateReader	Gathers what the calculation needs, once per build, for every package at once.
RepositoryStateReader.PackageState	One package and the repository facts its own range yielded.