swarmauri_crypto_pgp 0.3.0.dev5__tar.gz → 0.11.0.dev1__tar.gz

{swarmauri_crypto_pgp-0.3.0.dev5 → swarmauri_crypto_pgp-0.11.0.dev1}/PKG-INFO

@@ -1,47 +1,47 @@
 Metadata-Version: 2.4
 Name: swarmauri_crypto_pgp
-Version: 0.3.0.dev5
+Version: 0.11.0.dev1
 Summary: OpenPGP (GnuPG) + AES-GCM crypto provider for Swarmauri
 License-Expression: Apache-2.0
 License-File: LICENSE
 Keywords: swarmauri,sdk,standards,crypto,pgp,cryptography
 Author: Jacob Stewart
 Author-email: jacob@swarmauri.com
-Requires-Python: >=3.10,<3.13
+Requires-Python: >=3.10,<3.15
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Natural Language :: English
-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: Development Status :: 3 - Alpha
 Classifier: Topic :: Security :: Cryptography
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+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: Programming Language :: Python :: 3.14
 Requires-Dist: cryptography (>=41)
 Requires-Dist: python-gnupg (>=0.5.0)
 Requires-Dist: swarmauri_base
 Requires-Dist: swarmauri_core
 Description-Content-Type: text/markdown
 
-![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)
+![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
 
 <p align="center">
-    <a href="https://pypi.org/project/swarmauri_crypto_pgp/">
-        <img src="https://img.shields.io/pypi/dm/swarmauri_crypto_pgp" alt="PyPI - Downloads"/></a>
+    <a href="https://pepy.tech/project/swarmauri_crypto_pgp/">
+        <img src="https://static.pepy.tech/badge/swarmauri_crypto_pgp/month" alt="PyPI - Downloads"/></a>
     <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_crypto_pgp/">
         <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_crypto_pgp.svg"/></a>
     <a href="https://pypi.org/project/swarmauri_crypto_pgp/">
-        <img src="https://img.shields.io/pypi/pyversions/swarmauri_crypto_pgp" alt="PyPI - Python Version"/></a>
+        <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
     <a href="https://pypi.org/project/swarmauri_crypto_pgp/">
         <img src="https://img.shields.io/pypi/l/swarmauri_crypto_pgp" alt="PyPI - License"/></a>
     <a href="https://pypi.org/project/swarmauri_crypto_pgp/">
         <img src="https://img.shields.io/pypi/v/swarmauri_crypto_pgp?label=swarmauri_crypto_pgp&color=green" alt="PyPI - swarmauri_crypto_pgp"/></a>
-</p>
-
----
+    <a href="https://discord.gg/N4UpBuQv8T">
+        <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
 
 ## Swarmauri Crypto PGP
 
@@ -52,18 +52,18 @@ symmetrical encryption, public-key key wrapping, and hybrid envelopes.
 
 ### Features at a glance
 
-- **Symmetric AEAD** – AES-256-GCM powers `encrypt` and `decrypt`.
-- **Key wrapping** – `wrap` and `unwrap` delegate to GnuPG to protect random or
+- **Symmetric AEAD** ? AES-256-GCM powers `encrypt` and `decrypt`.
+- **Key wrapping** ? `wrap` and `unwrap` delegate to GnuPG to protect random or
   supplied key material with a recipient's public/private key pair.
-- **Hybrid envelopes** – `encrypt_for_many` supports both traditional
+- **Hybrid envelopes** ? `encrypt_for_many` supports both traditional
   KEM+AEAD (shared ciphertext + wrapped session key) and OpenPGP sealed mode for
   per-recipient ciphertexts.
-- **Sealing convenience** – `seal` and `unseal` provide single-recipient
+- **Sealing convenience** ? `seal` and `unseal` provide single-recipient
   OpenPGP public-key encryption without managing the envelope structure.
 
 ### System requirements
 
-- Python 3.10 – 3.13.
+- Python 3.10 ? 3.13.
 - [GnuPG](https://gnupg.org/) available on the `PATH` (required by
   `python-gnupg`).
 
@@ -144,3 +144,5 @@ The provider is registered under the `swarmauri.cryptos` entry-point as
 If you want to contribute to swarmauri-sdk, read up on our
 [guidelines for contributing](https://github.com/swarmauri/swarmauri-sdk/blob/master/CONTRIBUTING.md)
 that will help you get started.
+
+

{swarmauri_crypto_pgp-0.3.0.dev5 → swarmauri_crypto_pgp-0.11.0.dev1}/README.md

@@ -1,19 +1,18 @@
-![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)
+![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
 
 <p align="center">
-    <a href="https://pypi.org/project/swarmauri_crypto_pgp/">
-        <img src="https://img.shields.io/pypi/dm/swarmauri_crypto_pgp" alt="PyPI - Downloads"/></a>
+    <a href="https://pepy.tech/project/swarmauri_crypto_pgp/">
+        <img src="https://static.pepy.tech/badge/swarmauri_crypto_pgp/month" alt="PyPI - Downloads"/></a>
     <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_crypto_pgp/">
         <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_crypto_pgp.svg"/></a>
     <a href="https://pypi.org/project/swarmauri_crypto_pgp/">
-        <img src="https://img.shields.io/pypi/pyversions/swarmauri_crypto_pgp" alt="PyPI - Python Version"/></a>
+        <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
     <a href="https://pypi.org/project/swarmauri_crypto_pgp/">
         <img src="https://img.shields.io/pypi/l/swarmauri_crypto_pgp" alt="PyPI - License"/></a>
     <a href="https://pypi.org/project/swarmauri_crypto_pgp/">
         <img src="https://img.shields.io/pypi/v/swarmauri_crypto_pgp?label=swarmauri_crypto_pgp&color=green" alt="PyPI - swarmauri_crypto_pgp"/></a>
-</p>
-
----
+    <a href="https://discord.gg/N4UpBuQv8T">
+        <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
 
 ## Swarmauri Crypto PGP
 
@@ -24,18 +23,18 @@ symmetrical encryption, public-key key wrapping, and hybrid envelopes.
 
 ### Features at a glance
 
-- **Symmetric AEAD** – AES-256-GCM powers `encrypt` and `decrypt`.
-- **Key wrapping** – `wrap` and `unwrap` delegate to GnuPG to protect random or
+- **Symmetric AEAD** ? AES-256-GCM powers `encrypt` and `decrypt`.
+- **Key wrapping** ? `wrap` and `unwrap` delegate to GnuPG to protect random or
   supplied key material with a recipient's public/private key pair.
-- **Hybrid envelopes** – `encrypt_for_many` supports both traditional
+- **Hybrid envelopes** ? `encrypt_for_many` supports both traditional
   KEM+AEAD (shared ciphertext + wrapped session key) and OpenPGP sealed mode for
   per-recipient ciphertexts.
-- **Sealing convenience** – `seal` and `unseal` provide single-recipient
+- **Sealing convenience** ? `seal` and `unseal` provide single-recipient
   OpenPGP public-key encryption without managing the envelope structure.
 
 ### System requirements
 
-- Python 3.10 – 3.13.
+- Python 3.10 ? 3.13.
 - [GnuPG](https://gnupg.org/) available on the `PATH` (required by
   `python-gnupg`).
 
@@ -115,4 +114,5 @@ The provider is registered under the `swarmauri.cryptos` entry-point as
 
 If you want to contribute to swarmauri-sdk, read up on our
 [guidelines for contributing](https://github.com/swarmauri/swarmauri-sdk/blob/master/CONTRIBUTING.md)
-that will help you get started.
+that will help you get started.
+

{swarmauri_crypto_pgp-0.3.0.dev5 → swarmauri_crypto_pgp-0.11.0.dev1}/pyproject.toml

@@ -1,24 +1,25 @@
 [project]
 name = "swarmauri_crypto_pgp"
-version = "0.3.0.dev5"
+version = "0.11.0.dev1"
 description = "OpenPGP (GnuPG) + AES-GCM crypto provider for Swarmauri"
 license = "Apache-2.0"
 readme = "README.md"
-requires-python = ">=3.10,<3.13"
+requires-python = ">=3.10,<3.15"
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
 classifiers = [
     "License :: OSI Approved :: Apache Software License",
     "Natural Language :: English",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
     "Development Status :: 3 - Alpha",
     "Topic :: Security :: Cryptography",
     "Intended Audience :: Developers",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
     "swarmauri_core",

{swarmauri_crypto_pgp-0.3.0.dev5 → swarmauri_crypto_pgp-0.11.0.dev1}/swarmauri_crypto_pgp/PGPCrypto.py

@@ -4,11 +4,13 @@ Implements the ICrypto contract using:
 - AES-256-GCM for symmetric encrypt/decrypt (AEAD)
 - OpenPGP public-key encryption for:
     • wrapping the session key to many recipients (KEM+AEAD mode)
-    • sealing/unsealing (direct public-key encryption of plaintext) for one or many
+    • sealing/unsealing (direct public-key encryption of plaintext) for one or
+    many
 
 Notes
 -----
-- For wrap/encrypt_for_many/seal, ``KeyRef.public`` must contain an ASCII-armored
+- For wrap/encrypt_for_many/seal, ``KeyRef.public`` must contain an
+  ASCII-armored
   OpenPGP public key (as produced by ``gpg --armor --export``)
 - For unwrap/unseal, ``KeyRef.material`` must contain an ASCII-armored OpenPGP
   private key (as produced by ``gpg --armor --export-secret-keys``)
@@ -47,7 +49,8 @@ _SEAL_ALG = "OpenPGP-SEAL"
 
 @ComponentBase.register_type(CryptoBase, "PGPCrypto")
 class PGPCrypto(CryptoBase):
-    """Concrete implementation of the ICrypto contract using AES-GCM and OpenPGP."""
+    """Concrete implementation of the ICrypto contract using AES-GCM and
+    OpenPGP."""
 
     type: Literal["PGPCrypto"] = "PGPCrypto"
 
@@ -92,7 +95,9 @@ class PGPCrypto(CryptoBase):
                 "KeyRef.material must contain symmetric key bytes for AEAD"
             )
         if len(key.material) not in (16, 24, 32):
-            raise ValueError("KeyRef.material must be 16/24/32 bytes for AES-GCM")
+            raise ValueError(
+                "KeyRef.material must be 16/24/32 bytes for AES-GCM"
+            )
 
         nonce = nonce or secrets.token_bytes(12)
         aead = AESGCM(key.material)
@@ -128,7 +133,8 @@ class PGPCrypto(CryptoBase):
         return aead.decrypt(ct.nonce, blob, aad or ct.aad)
 
     # ─────────────────────────── sealing ───────────────────────────
-    # (OpenPGP public-key encryption of plaintext; gpg handles hybrid internally)
+    # (OpenPGP public-key encryption of plaintext; gpg handles hybrid
+    # internally)
 
     async def seal(
         self,
@@ -152,7 +158,9 @@ class PGPCrypto(CryptoBase):
                 else recipient.public
             )
             if not import_result.fingerprints:
-                raise RuntimeError("Failed to import recipient OpenPGP public key")
+                raise RuntimeError(
+                    "Failed to import recipient OpenPGP public key"
+                )
             fp = import_result.fingerprints[0]
 
             enc = gpg.encrypt(pt, fp, armor=False, always_trust=True)
@@ -171,7 +179,11 @@ class PGPCrypto(CryptoBase):
             raise UnsupportedAlgorithm(f"Unsupported seal alg: {alg}")
         if recipient_priv.material is None:
             raise ValueError(
-                "KeyRef.material must contain ASCII-armored OpenPGP private key"
+                (
+                    "KeyRef.material must contain ASCII-armored OpenPGP "
+                    "private "
+                    "key"
+                )
             )
 
         passphrase = None
@@ -190,7 +202,9 @@ class PGPCrypto(CryptoBase):
 
             dec = gpg.decrypt(sealed, passphrase=passphrase or "")
             if not dec.ok:
-                raise RuntimeError(f"GPG decrypt (unseal) failed: {dec.status}")
+                raise RuntimeError(
+                    f"GPG decrypt (unseal) failed: {dec.status}"
+                )
             return bytes(dec.data)
 
     # ─────────── hybrid encrypt-for-many via OpenPGP (KEM+AEAD) ───────────
@@ -213,10 +227,16 @@ class PGPCrypto(CryptoBase):
                 for r in recipients:
                     if r.public is None:
                         raise ValueError(
-                            "Recipient KeyRef.public must contain ASCII-armored OpenPGP public key"
+                            (
+                                "Recipient KeyRef.public must contain "
+                                "ASCII-armored OpenPGP "
+                                "public key"
+                            )
                         )
                     import_result = gpg.import_keys(
-                        r.public.decode() if isinstance(r.public, bytes) else r.public
+                        r.public.decode()
+                        if isinstance(r.public, bytes)
+                        else r.public
                     )
                     if not import_result.fingerprints:
                         raise RuntimeError(
@@ -250,7 +270,8 @@ class PGPCrypto(CryptoBase):
                 aad=None,  # AAD is not bound in OpenPGP-seal mode
             )
 
-        # 2) Default KEM+AEAD path (shared AES-GCM ct + PGP-wrapped session key)
+        # 2) Default KEM+AEAD path (shared AES-GCM ct + PGP-wrapped session
+        # key)
         enc_alg = self._normalize_aead_alg(enc_alg)
         if enc_alg != _AEAD_DEFAULT:
             raise UnsupportedAlgorithm(f"Unsupported enc_alg: {enc_alg}")
@@ -270,13 +291,21 @@ class PGPCrypto(CryptoBase):
             for r in recipients:
                 if r.public is None:
                     raise ValueError(
-                        "Recipient KeyRef.public must contain ASCII-armored OpenPGP public key"
+                        (
+                            "Recipient KeyRef.public must contain "
+                            "ASCII-armored OpenPGP "
+                            "public key"
+                        )
                     )
                 import_result = gpg.import_keys(
-                    r.public.decode() if isinstance(r.public, bytes) else r.public
+                    r.public.decode()
+                    if isinstance(r.public, bytes)
+                    else r.public
                 )
                 if not import_result.fingerprints:
-                    raise RuntimeError("Failed to import recipient OpenPGP public key")
+                    raise RuntimeError(
+                        "Failed to import recipient OpenPGP public key"
+                    )
                 fp = import_result.fingerprints[0]
 
                 enc = gpg.encrypt(k, fp, armor=False, always_trust=True)
@@ -323,14 +352,20 @@ class PGPCrypto(CryptoBase):
         with tempfile.TemporaryDirectory() as gpg_home:
             gpg = gnupg.GPG(gnupghome=gpg_home)
             import_result = gpg.import_keys(
-                kek.public.decode() if isinstance(kek.public, bytes) else kek.public
+                kek.public.decode()
+                if isinstance(kek.public, bytes)
+                else kek.public
             )
             if not import_result.fingerprints:
-                raise RuntimeError("Failed to import recipient OpenPGP public key")
+                raise RuntimeError(
+                    "Failed to import recipient OpenPGP public key"
+                )
             recipient_fp = import_result.fingerprints[0]
 
             dek = dek or secrets.token_bytes(32)
-            enc = gpg.encrypt(dek, recipient_fp, armor=False, always_trust=True)
+            enc = gpg.encrypt(
+                dek, recipient_fp, armor=False, always_trust=True
+            )
             if not enc.ok:
                 raise RuntimeError(f"GPG encrypt failed: {enc.status}")
 
@@ -344,10 +379,16 @@ class PGPCrypto(CryptoBase):
 
     async def unwrap(self, kek: KeyRef, wrapped: WrappedKey) -> bytes:
         if wrapped.wrap_alg != _WRAP_ALG:
-            raise UnsupportedAlgorithm(f"Unsupported wrap_alg: {wrapped.wrap_alg}")
+            raise UnsupportedAlgorithm(
+                f"Unsupported wrap_alg: {wrapped.wrap_alg}"
+            )
         if kek.material is None:
             raise ValueError(
-                "KeyRef.material must contain ASCII-armored OpenPGP private key"
+                (
+                    "KeyRef.material must contain ASCII-armored OpenPGP "
+                    "private "
+                    "key"
+                )
             )
 
         passphrase = None