Co-authored-by: Rhys Arkins <rhys@arkins.net>
2.7 KiB
title | description |
---|---|
Python Package Manager Support | Python/pip dependencies support in Renovate |
Python package manager support
Renovate supports the following Python package managers:
pip
(e.g.requirements.txt
,requirements.pip
) filespipenv
(e.g.Pipfile
)setup.py
Versioning support
The PEP440 versioning scheme has been rewritten for JavaScript for the purposes of use in this project is published as @renovatebot/pep440.
It supports both pinned versions as well as ranges.
Legacy versions (===
prefix) are ignored.
How it works
- Renovate searches through each repository for package files
- Existing dependencies are extracted from the package files
- Renovate looks up the latest version on PyPI to determine if any upgrades are available
- If the source package includes a GitHub URL as its source, and has a "changelog" file or uses GitHub releases, a Release Note will be embedded in the generated PR
Alternative file names
The default file matching regex for requirements.txt
aims to pick up the most popular conventions for file naming, but it's possible that some get missed.
If you have a specific file or file pattern you want the Renovate bot to find, use the fileMatch
field in the pip_requirements
object.
e.g.:
"pip_requirements": {
"fileMatch": ["my/specifically-named.file", "\.requirements$"]
}
Alternate registries
By default Renovate performs all lookups on pypi.org, but you can configure alternative index URLs. There are two ways to do this:
index-url in requirements.txt
The index URL can be specified in the first line of the file. For example:
--index-url http://example.com/private-pypi/
some-package==0.3.1
some-other-package==1.0.0
Sources in Pipfile
Renovate detects any custom-configured sources in Pipfile
and uses them.
Specify URL in configuration
You can use the registryUrls
array to configure alternate index URL(s).
e.g.:
"python": {
"registryUrls": ["http://example.com/private-pypi/"]
}
Note: the index-url found in the requirements.txt
file takes precedence over a registryUrl
configured like the above.
To override the URL found in requirements.txt
, you need to configure it in packageRules
, as they are applied after package file extraction.
Disabling Python support
The most direct way to disable all Python support in Renovate is like this:
"python": {
"enabled": false
}
Alternatively, maybe you only want one package manager, such as npm
.
In that case this would enable only npm
:
"enabledManagers": ["npm"]