Metadata-Version: 2.4
Name: veneer-py
Version: 0.1.1
Summary: Lightweight overlay venv manager for worktrees with shared conda bases.
Project-URL: Homepage, https://github.com/alik-git/veneer-py
Project-URL: Repository, https://github.com/alik-git/veneer-py
Project-URL: Issues, https://github.com/alik-git/veneer-py/issues
Author-email: Ali K <alikgithb@gmail.com>
Maintainer-email: Ali K <alikgithb@gmail.com>
Keywords: conda,environment,python,venv,worktree
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: mypy>=1.15; extra == 'dev'
Requires-Dist: pre-commit>=4.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.11; extra == 'dev'
Description-Content-Type: text/markdown

# veneer

Lightweight overlay venv manager for Python worktrees with shared conda bases.

veneer sits as a thin layer between a heavy shared conda environment and the
editable packages you actually work on day-to-day — like a veneer over the
underlying structure. It is designed for setups where conda owns the base
(e.g. IsaacSim, heavy GPU stacks) but you want fast, worktree-local editable
installs without duplicating the full environment.

## Installation

```bash
uv tool install veneer-py
```

Or install from source:

```bash
uv tool install --editable path/to/veneer-py
```

## Usage

```bash
veneer --help
```

## Development

```bash
uv sync --extra dev
uv run ruff format --check .
uv run ruff check .
uv run mypy
uv run pytest
```

## Publishing

Releases are published to PyPI automatically when a GitHub Release is created.
