db-git 0.1.0__tar.gz → 0.2.0__tar.gz

db_git-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,79 @@
+name: release
+
+on:
+  workflow_run:
+    workflows: [test]
+    branches: [main]
+    types: [completed]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.workflow_run.head_branch }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  release:
+    name: semantic release
+    runs-on: ubuntu-latest
+    if: github.event.workflow_run.conclusion == 'success'
+    permissions:
+      contents: write
+      id-token: write
+    outputs:
+      released: ${{ steps.release.outputs.released || 'false' }}
+    steps:
+      - name: Checkout release branch
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.workflow_run.head_branch }}
+          fetch-depth: 0
+
+      - name: Reset to tested commit
+        run: git reset --hard "${{ github.event.workflow_run.head_sha }}"
+
+      - name: Semantic version release
+        id: release
+        uses: python-semantic-release/python-semantic-release@v10.5.3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          git_committer_name: "github-actions"
+          git_committer_email: "actions@users.noreply.github.com"
+
+      - name: Upload distributions to GitHub Release
+        if: steps.release.outputs.released == 'true'
+        uses: python-semantic-release/publish-action@v10.5.3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          tag: ${{ steps.release.outputs.tag }}
+
+      - name: Upload distributions artifact
+        if: steps.release.outputs.released == 'true'
+        uses: actions/upload-artifact@v7
+        with:
+          name: distribution-artifacts
+          path: dist
+          if-no-files-found: error
+
+  publish:
+    name: publish to PyPI
+    runs-on: ubuntu-latest
+    needs: release
+    if: needs.release.outputs.released == 'true'
+    permissions:
+      actions: read
+      contents: read
+      id-token: write
+    steps:
+      - name: Download distributions artifact
+        uses: actions/download-artifact@v8
+        with:
+          name: distribution-artifacts
+          path: dist
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+          print-hash: true

{db_git-0.1.0 → db_git-0.2.0}/.github/workflows/test.yml

@@ -10,6 +10,34 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  lint:
+    name: ruff
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - run: pipx install nox
+      - run: nox -s lint
+
+  types:
+    name: mypy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - run: pipx install nox
+      - run: nox -s types
+
   unit:
     name: unit (${{ matrix.python }})
     runs-on: ubuntu-latest
@@ -30,6 +58,7 @@ jobs:
   integration:
     name: integration (py${{ matrix.python }}, pg${{ matrix.postgres }})
     runs-on: ubuntu-latest
+    needs: [lint, types, unit]
     strategy:
       fail-fast: false
       matrix:
@@ -51,31 +80,3 @@ jobs:
           sudo apt-get install -y postgresql-client-${{ matrix.postgres }}
       - run: pipx install nox
       - run: nox -s "integration-${{ matrix.python }}(pg_image='postgres:${{ matrix.postgres }}')"
-
-  types:
-    name: mypy
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
-        with:
-          enable-cache: true
-      - uses: actions/setup-python@v6
-        with:
-          python-version: "3.12"
-      - run: pipx install nox
-      - run: nox -s types
-
-  lint:
-    name: ruff
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
-        with:
-          enable-cache: true
-      - uses: actions/setup-python@v6
-        with:
-          python-version: "3.12"
-      - run: pipx install nox
-      - run: nox -s lint

{db_git-0.1.0 → db_git-0.2.0}/.pre-commit-config.yaml

@@ -13,7 +13,7 @@ repos:
       - id: check-added-large-files
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.15
+    rev: v0.15.16
     hooks:
       - id: ruff-check
         args: [--fix]

{db_git-0.1.0 → db_git-0.2.0}/CHANGELOG.md

@@ -9,7 +9,7 @@ and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.ht
 
 ### Added
 
-- Initial `git-db` command-line interface.
+- Initial `db-git` command-line interface.
 - Git `post-checkout` hook installation, removal, enable, disable, and dispatch
   support.
 - Shared database mode for saving and restoring branch-specific snapshots.
@@ -18,8 +18,15 @@ and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.ht
 - Active connection handling with `terminate` and `fail` policies.
 - Manual commands for `save`, `restore`, `create`, `reset`, `list`, `status`,
   and `prune`.
-- Snapshot metadata and local state storage under `.git/git-db/`.
+- Snapshot metadata and local state storage under `.git/db-git/`.
 - Unit, integration, and end-to-end tests for CLI, storage, git hooks,
   PostgreSQL strategies, and branch database workflows.
 - Nox sessions, Ruff linting/format checks, mypy type checking, pre-commit
   hooks, Dependabot, and GitHub Actions CI.
+
+## [0.1.1] - 2026-06-01
+
+### Changed
+
+- Renamed project, CLI, package imports, configuration files, environment
+  variables, hook metadata, and local state paths to `db-git`.

{db_git-0.1.0 → db_git-0.2.0}/PKG-INFO

@@ -1,16 +1,16 @@
 Metadata-Version: 2.4
 Name: db-git
-Version: 0.1.0
+Version: 0.2.0
 Summary: Keep your database in sync with your git branches.
-Project-URL: Homepage, https://github.com/earthcomfy/git-db
-Project-URL: Repository, https://github.com/earthcomfy/git-db
-Project-URL: Issues, https://github.com/earthcomfy/git-db/issues
-Project-URL: Changelog, https://github.com/earthcomfy/git-db/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/earthcomfy/db-git
+Project-URL: Repository, https://github.com/earthcomfy/db-git
+Project-URL: Issues, https://github.com/earthcomfy/db-git/issues
+Project-URL: Changelog, https://github.com/earthcomfy/db-git/blob/main/CHANGELOG.md
 Author: Hana Belay
 License-Expression: MIT
 License-File: LICENSE
 Keywords: branching,cli,database,developer-tools,git,migrations,postgresql,snapshot
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -29,15 +29,15 @@ Requires-Dist: tomlkit>=0.14.0
 Requires-Dist: typer>=0.24.1
 Description-Content-Type: text/markdown
 
-# git-db
+# db-git
 
-[![CI](https://github.com/earthcomfy/git-db/actions/workflows/test.yml/badge.svg)](https://github.com/earthcomfy/git-db/actions/workflows/test.yml)
-[![Python](https://img.shields.io/pypi/pyversions/git-db.svg)](https://pypi.org/project/git-db/)
+[![CI](https://github.com/earthcomfy/db-git/actions/workflows/test.yml/badge.svg)](https://github.com/earthcomfy/db-git/actions/workflows/test.yml)
+[![Python](https://img.shields.io/pypi/pyversions/db-git.svg)](https://pypi.org/project/db-git/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 Keep your database in sync with your git branches.
 
-`git-db` is a developer tool for projects where database state follows code
+`db-git` is a developer tool for projects where database state follows code
 changes: schema migrations, seed data, experimental feature work, and branch
 switching during reviews. It installs a git `post-checkout` hook and keeps your
 local database aligned with the branch you are working on.
@@ -57,19 +57,19 @@ local database aligned with the branch you are working on.
   - `pgdump`: portable snapshots using `pg_dump` and `pg_restore`
 - Manual `save`, `restore`, `create`, `reset`, `list`, `status`, and `prune`
   commands
-- Safe hook behavior: checkout is never blocked by git-db failures
-- Rich terminal output and local state stored under `.git/git-db/`
+- Safe hook behavior: checkout is never blocked by db-git failures
+- Rich terminal output and local state stored under `.git/db-git/`
 
 ## Quick Start
 
 ```bash
-uv tool install git-db # or pip install git-db
+uv tool install db-git # or pip install db-git
 ```
 
 Run this from inside a git repository:
 
 ```bash
-git-db init --database-url postgresql://postgres:postgres@localhost:5432/myapp
+db-git init --database-url postgresql://postgres:postgres@localhost:5432/myapp
 ```
 
 Interactive init will ask:
@@ -85,10 +85,10 @@ After setup, switch branches normally:
 git checkout feature/auth
 ```
 
-In `shared` mode, git-db saves the previous branch database and restores the
+In `shared` mode, db-git saves the previous branch database and restores the
 new branch snapshot if one exists.
 
-In `per-branch` mode, git-db creates or selects a database named from the
+In `per-branch` mode, db-git creates or selects a database named from the
 current branch, for example:
 
 ```text
@@ -99,6 +99,14 @@ Because the database name changes per branch, your application server also
 needs to connect to the branch database. For example, when working on
 `feature/auth`, point your app's `DATABASE_URL` at `myapp__feature__auth`.
 
+`db-git url` prints the full connection URL for the current branch, so you can
+hand it straight to your app or client:
+
+```bash
+export DATABASE_URL=$(db-git url)
+psql "$(db-git url)"
+```
+
 ## Choosing a Mode
 
 ### Shared Mode
@@ -109,7 +117,7 @@ Use this when:
 
 - You want one familiar local database name
 - You want branch-specific snapshots
-- You are comfortable with git-db dropping and restoring that local database
+- You are comfortable with db-git dropping and restoring that local database
   during branch switches
 
 ### Per-Branch Mode
@@ -148,13 +156,13 @@ not available. It requires PostgreSQL client tools to be installed locally.
 ### Initialize
 
 ```bash
-git-db init --database-url postgresql://user:password@localhost:5432/myapp
+db-git init --database-url postgresql://user:password@localhost:5432/myapp
 ```
 
 Useful options:
 
 ```bash
-git-db init \
+db-git init \
   --database-url postgresql://user:password@localhost:5432/myapp \
   --mode per-branch \
   --strategy template \
@@ -164,14 +172,15 @@ git-db init \
 Skip hook installation:
 
 ```bash
-git-db init --database-url postgresql://localhost/myapp --no-hook
+db-git init --database-url postgresql://localhost/myapp --no-hook
 ```
 
 ### Inspect State
 
 ```bash
-git-db status
-git-db list
+db-git status
+db-git list
+db-git url
 ```
 
 ### Shared Mode Commands
@@ -179,20 +188,20 @@ git-db list
 Save the current branch database:
 
 ```bash
-git-db save
+db-git save
 ```
 
 Restore the current branch database:
 
 ```bash
-git-db restore
+db-git restore
 ```
 
 Save or restore a specific branch:
 
 ```bash
-git-db save main
-git-db restore feature/auth
+db-git save main
+db-git restore feature/auth
 ```
 
 ### Per-Branch Commands
@@ -200,13 +209,13 @@ git-db restore feature/auth
 Create a branch database before checking out the branch:
 
 ```bash
-git-db create feature/auth
+db-git create feature/auth
 ```
 
 Drop and recreate a branch database from the seed database:
 
 ```bash
-git-db reset feature/auth
+db-git reset feature/auth
 ```
 
 The default branch database cannot be reset because it is the seed for other
@@ -217,13 +226,13 @@ branch databases.
 Preview stale snapshots or branch databases:
 
 ```bash
-git-db prune --dry-run
+db-git prune --dry-run
 ```
 
 Remove stale snapshots or branch databases:
 
 ```bash
-git-db prune --yes
+db-git prune --yes
 ```
 
 ### Hook Management
@@ -231,31 +240,31 @@ git-db prune --yes
 Install or reinstall the checkout hook:
 
 ```bash
-git-db hook install
+db-git hook install
 ```
 
 Remove the checkout hook:
 
 ```bash
-git-db hook remove
+db-git hook remove
 ```
 
-Temporarily disable git-db without removing the hook:
+Temporarily disable db-git without removing the hook:
 
 ```bash
-git-db disable
-git-db enable
+db-git disable
+db-git enable
 ```
 
 You can also skip hook behavior for a single checkout:
 
 ```bash
-GIT_DB_SKIP=1 git checkout other-branch
+DB_GIT_SKIP=1 git checkout other-branch
 ```
 
 ## Configuration
 
-`git-db init` writes `.git-db.toml` at the repository root.
+`db-git init` writes `.db-git.toml` at the repository root.
 
 Example:
 
@@ -276,14 +285,14 @@ Supported configuration keys:
 | `default_branch` | Seed branch for per-branch mode | `main` |
 | `strategy` | `template` or `pgdump` | required |
 | `on_active_connections` | `terminate` or `fail` | `terminate` |
-| `snapshot_dir` | Shared-mode snapshot metadata/dump directory | `.git/git-db/snapshots` |
+| `snapshot_dir` | Shared-mode snapshot metadata/dump directory | `.git/db-git/snapshots` |
 | `max_snapshots` | Snapshot count kept by prune logic | `20` |
 | `force_terminate_timeout_ms` | Active connection termination timeout | `5000` |
 
 Configuration precedence:
 
 1. Built-in defaults
-2. `.git-db.toml`
+2. `.db-git.toml`
 3. Environment variables
 4. CLI options
 
@@ -291,16 +300,16 @@ Environment variables:
 
 ```bash
 DATABASE_URL
-GIT_DB_DATABASE_URL
-GIT_DB_MODE
-GIT_DB_STRATEGY
-GIT_DB_ON_ACTIVE_CONNECTIONS
-GIT_DB_SNAPSHOT_DIR
-GIT_DB_MAX_SNAPSHOTS
-GIT_DB_FORCE_TERMINATE_TIMEOUT_MS
+DB_GIT_DATABASE_URL
+DB_GIT_MODE
+DB_GIT_STRATEGY
+DB_GIT_ON_ACTIVE_CONNECTIONS
+DB_GIT_SNAPSHOT_DIR
+DB_GIT_MAX_SNAPSHOTS
+DB_GIT_FORCE_TERMINATE_TIMEOUT_MS
 ```
 
-`GIT_DB_DATABASE_URL` takes precedence over `DATABASE_URL`.
+`DB_GIT_DATABASE_URL` takes precedence over `DATABASE_URL`.
 
 ### Active connections block an operation
 
@@ -316,24 +325,24 @@ on_active_connections = "terminate"
 Your PostgreSQL user may need superuser privileges or membership in
 `pg_signal_backend` to terminate sessions owned by other users.
 
-### Temporarily skip git-db
+### Temporarily skip db-git
 
 ```bash
-git-db disable
+db-git disable
 git checkout some-branch
-git-db enable
+db-git enable
 ```
 
 Or for one command:
 
 ```bash
-GIT_DB_SKIP=1 git checkout some-branch
+DB_GIT_SKIP=1 git checkout some-branch
 ```
 
 ### Show full tracebacks
 
 ```bash
-GIT_DB_DEBUG=1 git-db status
+DB_GIT_DEBUG=1 db-git status
 ```
 
 ## Development