# packageurl-python
A parser and builder for purl aka. Package URLs for Python 2 and 3. See https://github.com/package-url/purl-spec for details.
Join the discussion at https://gitter.im/package-url/Lobby or enter a ticket for support.
License: MIT
| Linux (Travis) on Python 2 and 3 |
|---|
|
>>> from packageurl import PackageURL
>>> purl = PackageURL.from_string("pkg:maven/org.apache.commons/[email protected]")
>>> print(purl.to_dict())
{'type': 'maven', 'namespace': 'org.apache.commons', 'name': 'io', 'version': '1.3.4', 'qualifiers': None, 'subpath': None}
>>> print(purl.to_string())
pkg:maven/org.apache.commons/[email protected]
>>> print(str(purl))
pkg:maven/org.apache.commons/[email protected]
>>> print(repr(purl))
PackageURL(type='maven', namespace='org.apache.commons', name='io', version='1.3.4', qualifiers={}, subpath=None)
Other utilities:
- packageurl.contrib.django_models.PackageURLMixin is a Django abstract model mixin to use Package URLs in Django.
- packageurl.contrib.purl2url.get_url(purl) returns the download URL inferred from a Package URL.
- packageurl.contrib.url2purl.get_purl(url) returns a Package URL inferred from URL.
pip install packageurl-python
install:
python -m venv . bin/pip install -r requirements_tests.txt
run tests:
bin/py.test -vvs
start a new release branch
update the CHANGELOG.rst and AUTHORS.rst
update README.rst if needed
bump version in setup.py
run all tests
install restview and validate that all .rst docs are correct
push this branch
tag and push that tag
make a PR to merge branch
once merged, run:
pip install --upgrade pip wheel twine setuptools
delete the "dist" and "build" directories:
rm -rf dist/ build/
create a source distribution and wheel with:
python setup.py sdist bdist_wheel
finally, upload to PyPI:
twine upload dist/*