Artifact [693ccc535c]

Artifact 693ccc535c5796a4c1fc4001d6fbb23f30690647f694a6e8b816df1ab962d074:

• File db/doc.go — part of check-in [f5744359d3] at 2026-04-19 16:30:54 on branch trunk — Initial open source release

  libfossil is a pure-Go implementation of the Fossil SCM, reading and writing the same .fossil SQLite repository format as upstream Fossil.

  This is the first public release of code that previously lived in a private repository. The module path is github.com/danmestas/libfossil and the binary is named libfossil to avoid $PATH collisions with upstream fossil.

  Included: - Repo lifecycle (create, clone), checkout/checkin, timeline, merge, diff, annotate, shun, tag, branch, bisect, stash, undo/redo - Sync-over-HTTP protocol (client and handler) - Two SQLite drivers: modernc (pure Go, default) and ncruces (wasm-capable) - Observer interfaces (SyncObserver, CheckoutObserver) with an optional OpenTelemetry implementation in observer/otel (separate submodule) - Deterministic simulation testing harness with BUGGIFY fault injection - Kong-based embeddable CLI under cli/ and a standalone binary under cmd/libfossil/ (user: [email protected], size: 644) [annotate] [blame] [check-ins using]

// Package db provides a SQLite database layer with pluggable drivers.
//
// Two SQLite drivers ship with libfossil — modernc (pure Go, default)
// and ncruces (WASM-capable). Select one at build time by importing
// its driver package:
//
//	import _ "github.com/danmestas/libfossil/db/driver/modernc"
//
// [Open] and [OpenWith] handle DSN construction, WAL/pragma setup, and
// WASM-specific workarounds. Use [DB.WithTx] for transaction scoping
// with automatic rollback on error.
//
// The [Querier] interface (Exec, QueryRow, Query) is satisfied by both
// [DB] and [Tx], allowing callers to write transaction-agnostic code.
package db