Changes¶

1.1.0 (10 Jul 2026)¶

Warning

Breaking changes:

The prefix parameter of Repo.commit_content has been renamed to name and is now optional.

Added read(), which replays the history of a repository as a series of Giteration snapshots, either one per commit or taken on a schedule such as daily.
Added write(), which turns a series of Giteration snapshots into commits, useful for turning dated copies of a project, such as backups, into version history. Combining it with read() allows a repository’s history to be resampled.
The giterator command line tool has grown pack and unpack commands for moving between files with dates in their names and commits in a repository.
Added Git.log(), which returns the commits in a repository as Commit instances, giving structured access to the hash, author, committer, dates and full message of each commit.
Repo.commit_content no longer needs a file name, and the content and commit message can now be given when a test cares about them.
The documentation has been substantially expanded, and every example in it is now executed as part of the test suite.
Fixed a bug where Git.clone() failed when the source repository was given as a relative path.
Fixed a bug where calling a Git instance with environment variable overrides, as Git.commit() does when given explicit dates, ran git with only those variables rather than the full process environment.

Moved to a uv-based, pyproject.toml-driven project layout, with main replacing master as the default git branch.
Repo.clone now always ensures a user is configured in the clone, whether specified explicitly, inherited from the source repo, or falling back to the same default as Repo.make, so commits made in clones no longer depend on the git config of the machine the tests are running on.
Git.init() can now pin the name of the initial branch, and Repo.make does so by default, using main, so branch names in test repos no longer depend on the git config of the machine the tests are running on.

General refresh.
Add short parameter to methods that return commit hashes, allowing the full commit hash to be returned.