python-alpm 0.3.0__cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

alpm/type_aliases.py

@@ -0,0 +1,139 @@
+"""Type aliases for various submodules of the alpm package."""
+
+from typing import TypeAlias, Union, Any
+
+from alpm.alpm_types import (
+    Blake2b512Checksum,
+    Md5Checksum,
+    Sha1Checksum,
+    Sha224Checksum,
+    Sha256Checksum,
+    Sha384Checksum,
+    Sha512Checksum,
+    Crc32CksumChecksum,
+    SkippableBlake2b512Checksum,
+    SkippableMd5Checksum,
+    SkippableSha1Checksum,
+    SkippableSha224Checksum,
+    SkippableSha256Checksum,
+    SkippableSha384Checksum,
+    SkippableSha512Checksum,
+    SkippableCrc32CksumChecksum,
+    OpenPGPKeyId,
+    OpenPGPv4Fingerprint,
+    BuildEnvironmentOption,
+    PackageOption,
+    PackageVersion,
+    SonameV1,
+    PackageRelation,
+    BzrInfo,
+    FossilInfo,
+    GitInfo,
+    HgInfo,
+    SvnInfo,
+    KnownArchitecture,
+    UnknownArchitecture,
+)
+
+from alpm.alpm_srcinfo import SourceInfoV1
+
+Checksum: TypeAlias = Union[
+    Blake2b512Checksum,
+    Md5Checksum,
+    Sha1Checksum,
+    Sha224Checksum,
+    Sha256Checksum,
+    Sha384Checksum,
+    Sha512Checksum,
+    Crc32CksumChecksum,
+]
+"""A checksum using a supported algorithm"""
+
+SkippableChecksum: TypeAlias = Union[
+    SkippableBlake2b512Checksum,
+    SkippableMd5Checksum,
+    SkippableSha1Checksum,
+    SkippableSha224Checksum,
+    SkippableSha256Checksum,
+    SkippableSha384Checksum,
+    SkippableSha512Checksum,
+    SkippableCrc32CksumChecksum,
+]
+""" A skippable checksum using a supported algorithm.
+
+Strings representing checksums are used to verify the integrity of files.
+If the "SKIP" keyword is found, the integrity check is skipped.
+"""
+
+OpenPGPIdentifier: TypeAlias = Union[
+    OpenPGPKeyId,
+    OpenPGPv4Fingerprint,
+]
+"""An OpenPGP key identifier.
+
+The OpenPGPIdentifier type represents a valid OpenPGP identifier, which can be either
+an OpenPGP Key ID or an OpenPGP v4 fingerprint.
+"""
+
+MakepkgOption: TypeAlias = Union[
+    BuildEnvironmentOption,
+    PackageOption,
+]
+"""Either PackageOption or BuildEnvironmentOption.
+
+This is necessary for metadata files such as SRCINFO or PKGBUILD package scripts that 
+don't differentiate between the different types and scopes of options.
+"""
+
+VersionOrSoname: TypeAlias = Union[
+    PackageVersion,
+    str,
+]
+"""Either a PackageVersion or a string representing a shared object name."""
+
+
+RelationOrSoname: TypeAlias = Union[
+    SonameV1,
+    PackageRelation,
+]
+"""Either a SonameV1 or a PackageRelation."""
+
+SystemArchitecture: TypeAlias = Union[KnownArchitecture, UnknownArchitecture]
+"""A specific system architecture.
+
+Either KnownArchitecture or UnknownArchitecture.
+"""
+
+SourceInfo: TypeAlias = Union[SourceInfoV1, Any]
+"""The representation of SRCINFO data.
+
+Tracks all available versions of the file format.
+
+This union includes Any to allow for future extensions without breaking changes.
+"""
+
+VcsInfo: TypeAlias = Union[
+    BzrInfo,
+    FossilInfo,
+    GitInfo,
+    HgInfo,
+    SvnInfo,
+]
+"""Information on Version Control Systems (VCS) using a URL.
+
+Several different VCS systems can be used in the context of a SourceUrl.
+Each system supports addressing different types of objects and may optionally require 
+signature verification for those objects.
+"""
+
+__all__ = [
+    "Checksum",
+    "SkippableChecksum",
+    "OpenPGPIdentifier",
+    "MakepkgOption",
+    "VersionOrSoname",
+    "RelationOrSoname",
+    "SystemArchitecture",
+    "SourceInfo",
+    "VcsInfo",
+]

python_alpm-0.3.0.dist-info/METADATA

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: python-alpm
+Version: 0.3.0
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Rust
+Summary: Python bindings for the Rust-based ALPM project
+Keywords: alpm,archlinux,packaging,srcinfo
+Home-Page: https://alpm.archlinux.page
+License-Expression: Apache-2.0 OR MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Changelog, https://alpm.archlinux.page/python-alpm/CHANGELOG.html
+Project-URL: Documentation, https://alpm.archlinux.page/pdoc/
+Project-URL: Homepage, https://alpm.archlinux.page/python-alpm/
+Project-URL: Issues, https://gitlab.archlinux.org/archlinux/alpm/alpm/-/issues
+Project-URL: Repository, https://gitlab.archlinux.org/archlinux/alpm/alpm
+
+# python-alpm
+
+Python bindings for the **A**rch **L**inux **P**ackage **M**anagement (ALPM) project.
+
+We are currently awaiting decision from PyPI maintainers to allow us to publish this package under the name `alpm`.
+Until then, we are using the name `python-alpm`.
+You can view the support ticket [here](https://github.com/pypi/support/issues/7813).
+
+## Documentation
+
+Latest documentation is available at <https://alpm.archlinux.page/pdoc>.
+
+## Installation
+
+```sh
+pip install python-alpm
+```
+
+## Examples
+
+### Validating and comparing versions
+
+```pycon
+>>> from alpm.alpm_types import PackageVersion, PackageRelease, FullVersion, SchemaVersion
+
+>>> full_version = FullVersion(pkgver=PackageVersion('0.1.0alpha'), pkgrel=PackageRelease(minor=1))
+>>> full_version
+FullVersion(pkgver=PackageVersion('0.1.0alpha'), pkgrel=PackageRelease(major=0, minor=1))
+
+>>> PackageVersion('1.0.1') > full_version.pkgver
+True
+
+>>> version_one = SchemaVersion.from_str('1.0.0')
+>>> version_one
+SchemaVersion(major=1, minor=0, patch=0, pre='', build='')
+
+>>> version_one == SchemaVersion(major=1)
+True
+
+```
+
+### Parsing .SRCINFO
+
+```pycon
+>>> from alpm.alpm_srcinfo import SourceInfoV1
+>>> from alpm.alpm_types import Architecture
+
+>>> srcinfo = SourceInfoV1.from_file("../alpm-srcinfo/tests/correct/all_overrides.srcinfo")
+
+>>> srcinfo.base
+PackageBase(name='example', version=FullVersion(pkgver=PackageVersion('0.1.0'), pkgrel=PackageRelease(major=1), epoch=1))
+
+>>> srcinfo.base.architectures
+Architectures([Architecture('x86_64'), Architecture('aarch64')])
+
+>>> srcinfo.packages
+[Package(name='example')]
+
+>>> srcinfo.packages_for_architecture(Architecture('aarch64'))
+[MergedPackage(architecture=Architecture('aarch64'), name='example', version=FullVersion(pkgver=PackageVersion('0.1.0'), pkgrel=PackageRelease(major=1), epoch=1))]
+
+```
+
+### Working with package metadata
+
+```pycon
+>>> from alpm.alpm_srcinfo.source_info.v1.package import Package, Override
+>>> from alpm.alpm_types import License
+
+>>> pkg = Package("testpkg")
+
+>>> pkg.description = Override("A test package")
+>>> pkg.description
+Override(value='A test package')
+
+>>> pkg.licenses = Override([License("MIT"), License("custom-license")])
+>>> pkg.licenses
+Override(value=[License('MIT'), License('custom-license')])
+
+>>> {str(lic): lic.is_spdx for lic in pkg.licenses.value}
+{'MIT': True, 'custom-license': False}
+
+```
+
+## Contributing
+
+Please refer to the [contribution guidelines] to learn how to contribute to this project.
+
+## License
+
+This project can be used under the terms of the [Apache-2.0] or [MIT].
+Contributions to this project, unless noted otherwise, are automatically licensed under the terms of both of those licenses.
+
+<!-- Note: these paths have to be absolute in order to work on PyPI -->
+[contribution guidelines]: https://gitlab.archlinux.org/archlinux/alpm/alpm/-/blob/main/CONTRIBUTING.md
+[Apache-2.0]: https://gitlab.archlinux.org/archlinux/alpm/alpm/-/blob/main/LICENSES/Apache-2.0.txt
+[MIT]: https://gitlab.archlinux.org/archlinux/alpm/alpm/-/blob/main/LICENSES/MIT.txt
+

python_alpm-0.3.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+alpm/__init__.py,sha256=VdNfeuoEmDNm8gxzuFz1B4WtO6EOZuUlHBN1yIvUReU,232
+alpm/__pycache__/__init__.cpython-313.pyc,sha256=qh0kdrhGd1seA17RjZ6C5Fz-fPOUV7wEoomPMVAEPCg,423
+alpm/__pycache__/alpm_types.cpython-313.pyc,sha256=pTtQot69vefGIzNGZ701fr-8T3uQoEhexblua4grtio,70380
+alpm/__pycache__/type_aliases.cpython-313.pyc,sha256=MCQ3dwMt5VW34cO-EDuAe1lP13qt4oBvetPB7jshZlc,2139
+alpm/_native.abi3.so,sha256=pf85tYH6VWyk3rm26QbJl9JOPtJDoZ1Vb1nYRqlSXeE,2282392
+alpm/_native.pyi,sha256=qtRhGpgRq5TKWrdiHGexaJU0OhHPaZ5pIvQJrBOwgWs,135
+alpm/alpm_srcinfo/__init__.pyi,sha256=uU9wwNCwTElNb4G0cnsGPYgdA4KHkz-AN_lhVk1KG1A,541
+alpm/alpm_srcinfo/__pycache__/__init__.cpython-313.pyc,sha256=VG9pXptXWC-KLzS_Z5SMg6KVLu9L_MQ1drFpzGp2Aac,663
+alpm/alpm_srcinfo/__pycache__/error.cpython-313.pyc,sha256=7gsaWWoDD4hqO-MQIsRgQa0hUqCjiAVfLQALJSp_RYM,592
+alpm/alpm_srcinfo/__pycache__/schema.cpython-313.pyc,sha256=qG3xoeZC67-T9a6MQWcu8TWqa8-gySM1_zUp_1zl5LI,3014
+alpm/alpm_srcinfo/error.pyi,sha256=6XNyfzOVKcn2W52wybJSxZ6gSus_g_PdiHaClP7JaMs,201
+alpm/alpm_srcinfo/schema.pyi,sha256=Y88imZSs_MguGUSN_WX0wjiiwIQmDSpu--SfARuUCCc,1982
+alpm/alpm_srcinfo/source_info/__init__.pyi,sha256=oiOX3PSzxxsusuaeDbFy4xF4SagZYO6D4v5fAGjEub4,1552
+alpm/alpm_srcinfo/source_info/__pycache__/__init__.cpython-313.pyc,sha256=hgWa-UpcWqvLT8M8S05gahT5w_u3Qhy6ftSrtmM_NTY,1920
+alpm/alpm_srcinfo/source_info/v1/__init__.pyi,sha256=jauHv2XtubSxCfFbtGulcshPovxYL_VMxJ6P4nN_eiA,2859
+alpm/alpm_srcinfo/source_info/v1/__pycache__/__init__.cpython-313.pyc,sha256=4Y1MDNPlBXeIEo3o0l7mwUzNleUlAlAavt_UrINCI6s,4003
+alpm/alpm_srcinfo/source_info/v1/__pycache__/merged.cpython-313.pyc,sha256=MPPQjf2pknGP1LJm491LOASiKMxpPbreY63a3aH6W6c,9556
+alpm/alpm_srcinfo/source_info/v1/__pycache__/package.cpython-313.pyc,sha256=0ZDAwj6hS3wtayTigR02sYRi6uA4uu8e2SxULa1y9Fk,13519
+alpm/alpm_srcinfo/source_info/v1/__pycache__/package_base.cpython-313.pyc,sha256=WraUhU_JAh1JfsP03HEulVLghE-ZFM3SCdwuMpWVHNg,22538
+alpm/alpm_srcinfo/source_info/v1/merged.pyi,sha256=jNub3dw_m2CmFxxqdpolB5R9U4vlG2z_O7e1Px0yGbw,5796
+alpm/alpm_srcinfo/source_info/v1/package.pyi,sha256=hLXAfsFw8lsL0g9EASY-Ro3SYFKht14c9JG-0LYeeCs,8672
+alpm/alpm_srcinfo/source_info/v1/package_base.pyi,sha256=eddm9dKbNHu-bl3axH4ehmoVr0G6rsWSBFJWJOadn3U,14262
+alpm/alpm_types.pyi,sha256=0P3jNrhx21hVLPJmIUIvfmj_9O0OA-DS897ImNinzVQ,40915
+alpm/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+alpm/type_aliases.py,sha256=juZFmn9NrHVJ7WD977wcSrZPPOD4unNt393p0UbFf8Q,3341
+python_alpm-0.3.0.dist-info/METADATA,sha256=r7SWDBbWrbV3AOPAtC-2KVrbksRg-9Mu2oVDNZTQYYA,4009
+python_alpm-0.3.0.dist-info/WHEEL,sha256=sHl2MPySRQtLBS4t9I9tl1bAeFFBhTGABHYdwnegkVM,130
+python_alpm-0.3.0.dist-info/RECORD,,

python_alpm-0.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.6)
+Root-Is-Purelib: false
+Tag: cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64