gri-plot 0.2.5__tar.gz → 0.2.6__tar.gz

{gri_plot-0.2.5 → gri_plot-0.2.6}/.gitignore

@@ -25,6 +25,7 @@ coverage.xml
 *.stats
 .claude/
 CLAUDE.md
+AGENTS.md
 
 ### Credentials ###
 .env*

gri_plot-0.2.6/.hatch_build.py

@@ -0,0 +1,46 @@
+"""Custom hatchling build hook that wires up the project's git hooks.
+
+`uv sync` installs this project in editable mode, which runs the hatchling
+build backend and therefore this hook. The hook points git's ``core.hooksPath``
+at the tracked ``.githooks`` directory, so a fresh clone gets working git hooks
+on its first sync without a separate install step.
+
+This only adjusts local git config and is a no-op outside a git work tree (for
+example, in an isolated sdist/wheel build), so it is safe in CI release builds.
+"""
+
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Any
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+
+class GitHooksBuildHook(BuildHookInterface):
+    """Set ``core.hooksPath`` to the tracked ``.githooks`` directory."""
+
+    PLUGIN_NAME = "custom"
+
+    def initialize(self, version: str, build_data: dict[str, Any]) -> None:  # noqa: ARG002
+        """Point git at ``.githooks`` if this build runs inside a work tree."""
+        root = Path(self.root)
+        git = shutil.which("git")
+        if git is None or not (root / ".githooks").is_dir():
+            return
+        # Only act inside a real git work tree; check=False keeps release
+        # builds (sdist/wheel in a non-git temp dir) from failing.
+        inside = subprocess.run(  # noqa: S603
+            [git, "rev-parse", "--is-inside-work-tree"],
+            cwd=root,
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+        if inside.stdout.strip() != "true":
+            return
+        subprocess.run(  # noqa: S603
+            [git, "config", "core.hooksPath", ".githooks"],
+            cwd=root,
+            check=False,
+        )

{gri_plot-0.2.5 → gri_plot-0.2.6}/CONTRIBUTING.md

@@ -10,19 +10,25 @@ Requires **Python 3.12+** and **bash**.
 ```bash
 git clone <repo-url>
 cd <repo>
-. .init_venv.sh
+uv sync
 ```
 
-This creates a virtual environment with [uv](https://docs.astral.sh/uv/),
-installs all dependencies (including editable local siblings), and sets up
-pre-commit hooks. After the first run you can just activate the existing
-environment:
+`uv sync` creates a virtual environment with [uv](https://docs.astral.sh/uv/),
+installs all dependencies (including any editable local siblings), and wires up
+the git hooks automatically: a [hatchling](https://hatch.pypa.io/) build hook
+(`.hatch_build.py`) runs during the editable install and points
+`core.hooksPath` at the tracked `.githooks/` directory. No separate
+`pre-commit install` step is needed. To run commands in the environment, prefix
+them with `uv run` (for example `uv run pytest`), or activate it with
+`source .venv/bin/activate`.
 
-```bash
-source .venv/bin/activate
-```
+To start fresh, delete `.venv/` and run `uv sync` again.
 
-To start fresh, delete `.venv/` and re-source `.init_venv.sh`.
+> **Note (editable local siblings):** some `gri-*` projects depend on sibling
+> packages as editable path sources. uv requires `[tool.uv]`
+> `config-settings = { editable_mode = "compat" }` in `pyproject.toml` for those
+> to import correctly. If a project declares editable path dependencies and
+> imports fail, verify that setting is present.
 
 ## Running Tests
 
@@ -62,18 +68,19 @@ ruff format    # format
 ty check
 ```
 
-### Pre-commit
+### Pre-push hooks
 
-All of the above run automatically on `git commit` via
-[pre-commit](https://pre-commit.com/). If the commit fails, fix the issues,
-re-stage, and commit again.
+All of the above run automatically on `git push` via
+[pre-commit](https://pre-commit.com/) (configured for the `pre-push` stage, so
+commits stay fast). If the push fails, fix the issues, commit the fix, and push
+again.
 
 ```bash
-pre-commit run --all-files  # run manually against everything
+uv run pre-commit run --all-files --hook-stage pre-push  # run manually
 ```
 
-> **Tip:** To force a commit past hooks (e.g. work-in-progress), use
-> `git commit -n`. CI will still enforce the same checks.
+> **Tip:** To force a push past the hooks (e.g. a work-in-progress branch), use
+> `git push --no-verify`. CI will still enforce the same checks.
 
 ## Code Style
 
@@ -88,7 +95,7 @@ pre-commit run --all-files  # run manually against everything
 1. Create a branch from `main`
 2. Make your changes with tests
 3. Ensure `pytest --cov` passes with >= 70% coverage
-4. Ensure `pre-commit run --all-files` passes
+4. Ensure `uv run pre-commit run --all-files --hook-stage pre-push` passes
 5. Open a merge request against `main`
 
 ## IDE Setup (VS Code)

{gri_plot-0.2.5 → gri_plot-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gri-plot
-Version: 0.2.5
+Version: 0.2.6
 Summary: 3D geolocation visualization and 2D plotting utilities built on Plotly
 Project-URL: Homepage, https://geosolresearch.com
 Project-URL: Repository, https://gitlab.com/geosol-foss/python/gri-plot
@@ -44,7 +44,7 @@ For development:
 ```bash
 git clone https://gitlab.com/geosol-foss/python/gri-plot.git
 cd gri-plot
-. .init_venv.sh
+uv sync
 ```
 
 ## Quick Start

{gri_plot-0.2.5 → gri_plot-0.2.6}/README.md

@@ -19,7 +19,7 @@ For development:
 ```bash
 git clone https://gitlab.com/geosol-foss/python/gri-plot.git
 cd gri-plot
-. .init_venv.sh
+uv sync
 ```
 
 ## Quick Start

{gri_plot-0.2.5 → gri_plot-0.2.6}/pyproject.toml

@@ -51,6 +51,10 @@ fallback-version = "0.0.0"
 requires = ["hatchling", "uv-dynamic-versioning"]
 build-backend = "hatchling.build"
 
+# Runs on `uv sync` (editable build) to point git at the tracked .githooks dir.
+[tool.hatch.build.hooks.custom]
+path = ".hatch_build.py"
+
 [tool.hatch.build.targets.wheel]
 packages = ["gri_plot"]
 
@@ -68,6 +72,7 @@ include = [
     "CONTRIBUTING.md",
     "LICENSE",
     "pyproject.toml",
+    ".hatch_build.py",
 ]
 
 [tool.uv]
@@ -75,6 +80,7 @@ config-settings = { editable_mode = "compat" }
 
 [dependency-groups]
 dev = [
+    "hatchling>=1.27",
     "pre-commit>=4.3.0",
     "pyqt6>=6.9.1",
     "pytest>=8.4.2",