Changelog

Copy Markdown View Source

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

0.2.0 - 2026-08-20

Added

First functional release — the complete snapshot-first query library.

  • Query API over immutable commit snapshots: Gitility.list_tree/3, read_file/3, search/3, log/2, history/3, diff/3, blame/3, and ancestor?/4 — structured, paginated results with explicit byte/entry/time budgets (Gitility.Limits), cancellable jobs, SHA-1 and SHA-256 repositories.
  • Repositories and snapshots: Gitility.Repository.open/2 for local bare/normal directories (worktree never read), selector resolution (:head, {:branch, _}, {:tag, _}, {:ref, _}, {:oid, _}) into pinned Gitility.Snapshots.
  • Pluggable storage behaviours: static in-memory object sets, Elixir provider callbacks (Gitility.ODB.Backend), immutable range-addressed pack stores (Gitility.ODB.RangeBackend with a LocalDirectory reference backend and publish/2), and pluggable ref stores (Gitility.RefDB.Backend).
  • PackFetch hydration (Gitility.ODB.PackFetch): fetch from a remote immutable pack store under explicit request/byte budgets into a local scratch directory or straight into a bundle file (into: {:bundle, path}), with warm restarts served locally.
  • Bundles (Gitility.Bundle): a complete read-only repository in one flat file — write/2 (byte-deterministic, atomic-rename publication), open/2 (into: :memory or {:dir, path}), verify/1, and info/1. Container format frozen as bundle format v1 (docs/format/bundle-v1.md): 0.2+ readers open any v1 bundle; future changes bump the format version rather than reinterpret v1 fields.
  • Precompiled NIF targets: macOS arm64/x86_64, Linux glibc x86_64/arm64 (GITILITY_BUILD=1 builds from source elsewhere; Windows unsupported).