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`.
