updates

Backend/venv/lib/python3.12/site-packages/packageurl_python-0.17.6.dist-info/METADATA

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: packageurl-python
+Version: 0.17.6
+Summary: A purl aka. Package URL parser and builder
+Home-page: https://github.com/package-url/packageurl-python
+Author: the purl authors
+License: MIT
+Keywords: package,url,package manager,package url
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Provides-Extra: lint
+Requires-Dist: isort; extra == "lint"
+Requires-Dist: black; extra == "lint"
+Requires-Dist: mypy; extra == "lint"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: build
+Requires-Dist: setuptools; extra == "build"
+Requires-Dist: wheel; extra == "build"
+Provides-Extra: sqlalchemy
+Requires-Dist: sqlalchemy>=2.0.0; extra == "sqlalchemy"
+
+=================
+packageurl-python
+=================
+
+Python library to parse and build "purl" aka. Package URLs.
+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
+
+Tests and build status
+======================
+
++----------------------+
+| **Tests and build**  |
++======================+
+| |ci-tests|           |
++----------------------+
+
+Install
+=======
+::
+
+    pip install packageurl-python
+
+Usage
+=====
+::
+
+    >>> from packageurl import PackageURL
+
+    >>> purl = PackageURL.from_string("pkg:maven/org.apache.commons/io@1.3.4")
+    >>> 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/io@1.3.4
+
+    >>> print(str(purl))
+    pkg:maven/org.apache.commons/io@1.3.4
+
+    >>> print(repr(purl))
+    PackageURL(type='maven', namespace='org.apache.commons', name='io', version='1.3.4', qualifiers={}, subpath=None)
+
+Utilities
+=========
+
+Django models
+^^^^^^^^^^^^^
+
+`packageurl.contrib.django.models.PackageURLMixin` is a Django abstract model mixin to
+use Package URLs in Django.
+
+SQLAlchemy mixin
+^^^^^^^^^^^^^^^^
+
+`packageurl.contrib.sqlalchemy.mixin.PackageURLMixin` is a SQLAlchemy declarative mixin
+to use Package URLs in SQLAlchemy models.
+
+URL to PURL
+^^^^^^^^^^^
+
+`packageurl.contrib.url2purl.get_purl(url)` returns a Package URL inferred from an URL.
+
+::
+
+    >>> from packageurl.contrib import url2purl
+    >>> url2purl.get_purl("https://github.com/package-url/packageurl-python")
+    PackageURL(type='github', namespace='package-url', name='packageurl-python', version=None, qualifiers={}, subpath=None)
+
+PURL to URL
+^^^^^^^^^^^
+
+- `packageurl.contrib.purl2url.get_repo_url(purl)` returns a repository URL inferred
+  from a Package URL.
+- `packageurl.contrib.purl2url.get_download_url(purl)` returns a download URL inferred
+  from a Package URL.
+- `packageurl.contrib.purl2url.get_inferred_urls(purl)` return all inferred URLs
+  (repository, download) from a Package URL.
+
+::
+
+    >>> from packageurl.contrib import purl2url
+
+    >>> purl2url.get_repo_url("pkg:gem/bundler@2.3.23")
+    "https://rubygems.org/gems/bundler/versions/2.3.23"
+
+    >>> purl2url.get_download_url("pkg:gem/bundler@2.3.23")
+    "https://rubygems.org/downloads/bundler-2.3.23.gem"
+
+    >>> purl2url.get_inferred_urls("pkg:gem/bundler@2.3.23")
+    ["https://rubygems.org/gems/bundler/versions/2.3.23", "https://rubygems.org/downloads/bundler-2.3.23.gem"]
+
+Run tests
+=========
+
+Install test dependencies::
+
+    python3 thirdparty/virtualenv.pyz --never-download --no-periodic-update .
+    bin/pip install -e ."[test]"
+
+Run tests::
+
+    bin/pytest tests
+
+Make a new release
+==================
+
+- Start a new release branch
+- Update the CHANGELOG.rst, AUTHORS.rst, and README.rst if needed
+- Bump version in setup.cfg
+- Run all tests
+- Install restview and validate that all .rst docs are correct
+- Commit and push this branch
+- Make a PR and merge once approved
+- Tag and push that tag. This triggers the pypi-release.yml workflow that takes care of
+  building the dist release files and upload those to pypi::
+
+    VERSION=v0.x.x
+    git tag -a $VERSION -m "Tag $VERSION"
+    git push origin $VERSION
+
+- Review the GitHub release created by the workflow at
+  https://github.com/package-url/packageurl-python/releases
+
+.. |ci-tests| image:: https://github.com/package-url/packageurl-python/actions/workflows/ci.yml/badge.svg?branch=main
+    :target: https://github.com/package-url/packageurl-python/actions/workflows/ci.yml
+    :alt: CI Tests and build status