uv-developer

The name is a pun on [mr.developer], the zc.buildout extension that solved the same “toggle a dependency to a local checkout while developing” problem for buildout-based projects.

[PyPI][pypi status] [Status][pypi status] [Python Version][pypi status] [License][license]

[Read the documentation at https://uv-developer.readthedocs.io/][read the docs] [Tests][tests] [Codecov][codecov]

[pre-commit][pre-commit] [Ruff][ruff]

Features

  • Toggle [tool.uv.sources] local path overrides in pyproject.toml on and off in one command.

  • Auto-clones a dependency from a # git clone ... comment the first time you switch it on.

  • Pin a rarely-used override off with ## so a bulk toggle on never sweeps it up.

  • check fails CI or a pre-commit hook if a local/editable path ever reaches uv.lock.

See [Introduction] for the full problem this solves.

Requirements

  • Python >= 3.9

  • [uv]

Installation

You can install uv-developer via [pip] from [PyPI]:

pip install uv-developer

See [Installation] for adding it as a project dependency or a pre-commit hook.

Usage

Please see the [Command-line Reference] for details.

Contributing

Contributions are very welcome. To learn more, see the [Contributor Guide].

License

Distributed under the terms of the [MIT license][license], uv-developer is free and open source software.

Issues

If you encounter any problems, please [file an issue] along with a detailed description.

Credits

This project was generated from [@libranet]’s [Kickstart Python Project] template.