Metadata-Version: 2.4
Name: uv-add-complete
Version: 0.1.5
Summary: Fast dependency suggestions and shell completion for uv add
Project-URL: Homepage, https://github.com/kavangajera/uv-aide
Project-URL: Repository, https://github.com/kavangajera/uv-aide
Project-URL: Issues, https://github.com/kavangajera/uv-aide/issues
Keywords: cli,completion,dependencies,pypi,uv
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# uv-add-complete

`uv-add-complete` provides fast, curated Python dependency suggestions and shell
completion for `uv add`.

This initial release includes a small offline package catalog and a CLI suitable
for both developers and future shell-completion adapters. Suggestions use a
cached prefix trie with precomputed matches at each node.

## Install

Global tool setup:

```console
uv tool install "uv-add-complete>=0.1.5"
uvpy init --yes
```

Restart your shell, then complete dependencies while writing `uv add` commands:

```console
uv add fast<Tab> py<Tab>
```

Project-local setup:

```console
uv add "uv-add-complete>=0.1.5"
uv run uvpy init --yes
```

When installed as a project dependency, run commands through `uv run`:

```console
uv run uvpy --version
uv run uvpy add py --list
```

PowerShell users can opt into the experimental Tab cycling UI:

```console
uvpy init --yes --tab-ui
```

`uvpy init` auto-detects your current shell. If detection is wrong, pass
`--shell powershell`, `--shell pwsh`, `--shell zsh`, `--shell bash`, or
`--shell fish`.

## Development

```console
uv sync
uv run uvpy add al --list
uv run uvpy init --shell powershell --dry-run
uv run pytest
uv run ruff check .
```

## CLI

Show rich suggestions:

```console
uvpy add fast --list
```

Return package names for shell integrations:

```console
uvpy _complete add fast --format names
```

Return structured output:

```console
uvpy _complete add fast --format json
```

List the complete curated catalog:

```console
uv-aide packages
```
