grove-wt 0.5.0__tar.gz

grove_wt-0.5.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: grove-wt
+Version: 0.5.0
+Summary: Manage git worktrees with a consistent convention and structure (gwt command)
+Author: Victor Ney
+License: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/N3Y70R/grove
+Project-URL: Repository, https://github.com/N3Y70R/grove
+Project-URL: Documentation, https://github.com/N3Y70R/grove/tree/main/docs
+Keywords: git,worktree,cli,git-worktree,branches
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.2; extra == "mcp"
+
+# grove — Python implementation
+
+Reference implementation of **grove** (the `gwt` command). Standard library only; requires **Python 3.11+** (uses `tomllib`).
+
+To learn how to use the tool, see the shared documentation in [`../docs/`](../docs/); for the design, see [`../spec/specification.md`](../spec/specification.md). This README covers only what's specific to the Python implementation.
+
+## Installation
+
+The PyPI/distribution name is **`grove-wt`** (the name `grove` was taken); the
+imported package and commands are still `grove`, `gwt` and `grove-mcp`.
+
+With [pipx](https://pipx.pypa.io/) (recommended):
+
+```
+# from PyPI
+pipx install grove-wt            # or: grove-wt[mcp] for the MCP server
+
+# from the repo folder
+pipx install ./python
+
+# from git, pointing at the subdirectory
+pipx install "grove-wt[mcp] @ git+https://github.com/N3Y70R/grove.git#subdirectory=python"
+```
+
+Verify with `gwt --version`. Update with `pipx upgrade grove-wt`. Full guide
+(other systems, updating, troubleshooting) in [`../docs/INSTALL.md`](../docs/INSTALL.md).
+
+Development (editable):
+
+```
+cd python
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+```
+
+## Building the wheel
+
+```
+cd python
+python3 -m pip install --upgrade build
+python3 -m build --wheel        # produces dist/grove-<version>-py3-none-any.whl
+```
+
+The wheel is universal (`py3-none-any`): it works on Windows, macOS and Linux.
+
+## Architecture
+
+- `src/grove/core/`: reusable logic (convention, validations, git). Designed so a future MCP facade can import it directly.
+- `src/grove/cli/`: command-line facade (argparse + presentation).
+
+## Version
+
+The version lives in `pyproject.toml`. Releases tagged `python/vX.Y.Z`.

grove_wt-0.5.0/README.md

@@ -0,0 +1,53 @@
+# grove — Python implementation
+
+Reference implementation of **grove** (the `gwt` command). Standard library only; requires **Python 3.11+** (uses `tomllib`).
+
+To learn how to use the tool, see the shared documentation in [`../docs/`](../docs/); for the design, see [`../spec/specification.md`](../spec/specification.md). This README covers only what's specific to the Python implementation.
+
+## Installation
+
+The PyPI/distribution name is **`grove-wt`** (the name `grove` was taken); the
+imported package and commands are still `grove`, `gwt` and `grove-mcp`.
+
+With [pipx](https://pipx.pypa.io/) (recommended):
+
+```
+# from PyPI
+pipx install grove-wt            # or: grove-wt[mcp] for the MCP server
+
+# from the repo folder
+pipx install ./python
+
+# from git, pointing at the subdirectory
+pipx install "grove-wt[mcp] @ git+https://github.com/N3Y70R/grove.git#subdirectory=python"
+```
+
+Verify with `gwt --version`. Update with `pipx upgrade grove-wt`. Full guide
+(other systems, updating, troubleshooting) in [`../docs/INSTALL.md`](../docs/INSTALL.md).
+
+Development (editable):
+
+```
+cd python
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+```
+
+## Building the wheel
+
+```
+cd python
+python3 -m pip install --upgrade build
+python3 -m build --wheel        # produces dist/grove-<version>-py3-none-any.whl
+```
+
+The wheel is universal (`py3-none-any`): it works on Windows, macOS and Linux.
+
+## Architecture
+
+- `src/grove/core/`: reusable logic (convention, validations, git). Designed so a future MCP facade can import it directly.
+- `src/grove/cli/`: command-line facade (argparse + presentation).
+
+## Version
+
+The version lives in `pyproject.toml`. Releases tagged `python/vX.Y.Z`.

grove_wt-0.5.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# Distribution name on PyPI ("grove" was already taken). The imported package is
+# still `grove` and the commands are still `gwt` and `grove-mcp`.
+name = "grove-wt"
+version = "0.5.0"
+description = "Manage git worktrees with a consistent convention and structure (gwt command)"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "GPL-3.0-or-later" }
+authors = [{ name = "Victor Ney" }]
+keywords = ["git", "worktree", "cli", "git-worktree", "branches"]
+dependencies = []  # standard library only
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=7"]
+mcp = ["mcp>=1.2"]
+
+[project.urls]
+Homepage = "https://github.com/N3Y70R/grove"
+Repository = "https://github.com/N3Y70R/grove"
+Documentation = "https://github.com/N3Y70R/grove/tree/main/docs"
+
+[project.scripts]
+gwt = "grove.cli.main:main"
+grove-mcp = "grove.mcp.server:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

grove_wt-0.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

grove_wt-0.5.0/src/grove/__init__.py

@@ -0,0 +1,11 @@
+"""grove: git worktree management with a consistent convention.
+
+Command: gwt
+
+Structure:
+    grove.core  -> reusable logic (shared by the facades)
+    grove.cli   -> command-line facade (gwt)
+    grove.mcp   -> MCP server facade (grove-mcp)
+"""
+
+__version__ = "0.5.0"

grove_wt-0.5.0/src/grove/__main__.py

@@ -0,0 +1,6 @@
+import sys
+
+from .cli.main import main
+
+if __name__ == "__main__":
+    sys.exit(main())

grove_wt-0.5.0/src/grove/cli/__init__.py

@@ -0,0 +1 @@
+"""Command-line facade of wt."""