semvec/pypi-packages huggingface dataset:
poetry-plugin-dynamic-override-sources 0.0.6
Poetry plugin to dynamically override sources for private mirroring
License: BSD-3-Clause
Requires Python: <4.0,>=3.8
Keywords: packaging, poetry, pypi, pip

# poetry-plugin-dynamic-override-sources

## Description

*poetry-plugin-dynamic-override-sources* is a [plugin](https://python-poetry.org/docs/master/plugins/)
for [poetry](https://python-poetry.org/) package manager in python.

With pip, you can override the package index URL using [configuration files](https://pip.pypa.io/en/stable/topics/configuration/)
or environment variables such as:

- `PIP_INDEX_URL`
- `PIP_PROXY`

However, with poetry there is no such option.  The pyproject.toml project configuration specifies one or more
[sources](https://python-poetry.org/docs/repositories/#package-sources) that are to be used for resolving packages from the artifact storage.

This plugin makes it possible to use environment variable overrides like:

- `PIP_INDEX_URL` will override ALL repository urls, intending to function similar to `pip install --index-url`
- `POETRY_SOURCE_SOME_REPO_URL` will override the source named `some-repo` with the specified url
- `POETRY_SOURCE_PYPI_URL` will override the `PyPI` repository's URL.  This is a special case.

## Usage

### Installation

```bash
poetry self add poetry-plugin-dynamic-override-sources
```

See [plugin installation instructions](https://python-poetry.org/docs/plugins#using-plugins).

## Development

Setup

```bash
poetry install
```

Testing

```bash
poetry run pytest
```

## Publishing

```bash
poetry publish --build
```

## Links

- [poetry-plugin-use-pip-global-index-url](https://github.com/BaxHugh/poetry-plugin-use-pip-global-index-url) - plugin that this was forked from
- [poetry-plugin-pypi-mirror](https://github.com/arcesium/poetry-plugin-pypi-mirror) - upstream plugin that inspired `poetry-plugin-use-pip-global-index-url`.
- [python-poetry/poetry#1632](https://github.com/python-poetry/poetry/issues/1632) - poetry feature request to add support for global repository URL replacement