# 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
Raw data
{
"_id": null,
"home_page": "https://github.com/burkestar/poetry-plugin-dynamic-override-sources",
"name": "poetry-plugin-dynamic-override-sources",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "packaging, poetry, pypi, pip",
"author": "Dustin Burke",
"author_email": "dustin@datarobot.com",
"download_url": "https://files.pythonhosted.org/packages/e1/54/abf484a3e2376baf1fff9533005967d2c2d27e5f0bf35f846932d6c7bf56/poetry_plugin_dynamic_override_sources-0.0.6.tar.gz",
"platform": null,
"description": "# poetry-plugin-dynamic-override-sources\n\n## Description\n\n*poetry-plugin-dynamic-override-sources* is a [plugin](https://python-poetry.org/docs/master/plugins/)\nfor [poetry](https://python-poetry.org/) package manager in python.\n\nWith pip, you can override the package index URL using [configuration files](https://pip.pypa.io/en/stable/topics/configuration/)\nor environment variables such as:\n\n- `PIP_INDEX_URL`\n- `PIP_PROXY`\n\nHowever, with poetry there is no such option. The pyproject.toml project configuration specifies one or more\n[sources](https://python-poetry.org/docs/repositories/#package-sources) that are to be used for resolving packages from the artifact storage.\n\nThis plugin makes it possible to use environment variable overrides like:\n\n- `PIP_INDEX_URL` will override ALL repository urls, intending to function similar to `pip install --index-url`\n- `POETRY_SOURCE_SOME_REPO_URL` will override the source named `some-repo` with the specified url\n- `POETRY_SOURCE_PYPI_URL` will override the `PyPI` repository's URL. This is a special case.\n\n## Usage\n\n### Installation\n\n```bash\npoetry self add poetry-plugin-dynamic-override-sources\n```\n\nSee [plugin installation instructions](https://python-poetry.org/docs/plugins#using-plugins).\n\n## Development\n\nSetup\n\n```bash\npoetry install\n```\n\nTesting\n\n```bash\npoetry run pytest\n```\n\n## Publishing\n\n```bash\npoetry publish --build\n```\n\n## Links\n\n- [poetry-plugin-use-pip-global-index-url](https://github.com/BaxHugh/poetry-plugin-use-pip-global-index-url) - plugin that this was forked from\n- [poetry-plugin-pypi-mirror](https://github.com/arcesium/poetry-plugin-pypi-mirror) - upstream plugin that inspired `poetry-plugin-use-pip-global-index-url`.\n- [python-poetry/poetry#1632](https://github.com/python-poetry/poetry/issues/1632) - poetry feature request to add support for global repository URL replacement\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Poetry plugin to dynamically override sources for private mirroring",
"version": "0.0.6",
"project_urls": {
"Changelog": "https://github.com/burkestar/poetry-plugin-dynamic-override-sources/blob/main/CHANGELOG.md",
"Homepage": "https://github.com/burkestar/poetry-plugin-dynamic-override-sources",
"Repository": "https://github.com/burkestar/poetry-plugin-dynamic-override-sources"
},
"split_keywords": [
"packaging",
" poetry",
" pypi",
" pip"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "253b9fd5bcac399195316e693c7128e28014a122b9e1e7a676fb9c8fb2f3dba0",
"md5": "71251c75549fdf2ab532fc5b98d12cbe",
"sha256": "65c2b84549833be421da4c1f574bd5fa46bc3fc9bebd52f1ad37b7c46b15086b"
},
"downloads": -1,
"filename": "poetry_plugin_dynamic_override_sources-0.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "71251c75549fdf2ab532fc5b98d12cbe",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 6534,
"upload_time": "2024-06-02T13:14:21",
"upload_time_iso_8601": "2024-06-02T13:14:21.692901Z",
"url": "https://files.pythonhosted.org/packages/25/3b/9fd5bcac399195316e693c7128e28014a122b9e1e7a676fb9c8fb2f3dba0/poetry_plugin_dynamic_override_sources-0.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e154abf484a3e2376baf1fff9533005967d2c2d27e5f0bf35f846932d6c7bf56",
"md5": "81ca3af2c1be47d1824f8723cc67a6e1",
"sha256": "37104057e659260f01a6b7e53dbd41c80d9cc8555d9bcc95c264adfe87be22db"
},
"downloads": -1,
"filename": "poetry_plugin_dynamic_override_sources-0.0.6.tar.gz",
"has_sig": false,
"md5_digest": "81ca3af2c1be47d1824f8723cc67a6e1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 5184,
"upload_time": "2024-06-02T13:14:22",
"upload_time_iso_8601": "2024-06-02T13:14:22.661475Z",
"url": "https://files.pythonhosted.org/packages/e1/54/abf484a3e2376baf1fff9533005967d2c2d27e5f0bf35f846932d6c7bf56/poetry_plugin_dynamic_override_sources-0.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-02 13:14:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "burkestar",
"github_project": "poetry-plugin-dynamic-override-sources",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "poetry-plugin-dynamic-override-sources"
}
JSON
