crossmool 1.3.0__tar.gz

crossmool-1.3.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: crossmool
+Version: 1.3.0
+Summary: Cross-language SM2/SM3/SM4 cryptographic utilities, interoperable with the Java/Go/Rust/C/C++/C#/JavaScript implementations
+Author: crossmool
+License-Expression: LGPL-3.0-only
+Project-URL: Homepage, https://gitee.com/iilic/crossmool
+Project-URL: Repository, https://gitee.com/iilic/crossmool
+Keywords: sm2,sm3,sm4,cryptography,gmssl,sm-crypto,chinese-cryptography,encryption
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Security :: Cryptography
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: gmssl>=3.2.2
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+
+# crossmool
+
+Cross-language SM2/SM3/SM4 cryptographic utilities. The Python implementation is fully interoperable with the Java/Go/Rust/C/C++/C#/JavaScript implementations in the [crossmool](https://gitee.com/iilic/crossmool) project.
+
+## Features
+
+- **SM2** — asymmetric encryption/decryption and signature (C1C3C2 ciphertext, X.509 / PKCS#8 DER keys, DER signatures).
+- **SM3** — hash and HMAC-SM3.
+- **SM4** — symmetric GCM encryption/decryption.
+- Hex and Base64 encodings supported throughout.
+- Guaranteed cross-language interop (simplified Chinese, traditional Chinese and English Unicode input).
+
+## Installation
+
+```bash
+pip install crossmool
+```
+
+Requires Python 3.8+.
+
+## Quick start
+
+### SM2 — encrypt / decrypt / sign / verify
+
+```python
+from crossmool import SM2Util
+
+priv, pub = SM2Util.generate_keypair_raw()
+
+# encrypt then decrypt (Hex)
+cipher = SM2Util.encrypt('hello', pub)
+assert SM2Util.decrypt(cipher, priv) == 'hello'
+
+# sign then verify
+sig = SM2Util.sign(cipher, priv)
+assert SM2Util.verify_str(cipher, pub, sig)
+```
+
+### SM3 — hash / HMAC
+
+```python
+from crossmool import SM3Util
+
+digest = SM3Util.digest_str('hello 国密')
+key = SM3Util.generate_hmac_key_to_str()
+mac = SM3Util.hmac_str(key, 'hello 国密')
+assert SM3Util.hmac_verify(key, 'hello 国密', mac)
+```
+
+### SM4 — GCM encrypt / decrypt
+
+```python
+from crossmool import SM4Util
+
+key = SM4Util.generate_key()
+cipher = SM4Util.encrypt_gcm_string(key, 'hello 国密')
+plain = SM4Util.decrypt_gcm_to_string(key, cipher)
+assert plain == 'hello 国密'
+```
+
+## Development
+
+Editable install for development:
+
+```bash
+cd <repo-root>
+pip install -e python/crossmool
+```
+
+Run the test suite:
+
+```bash
+cd python/crossmool
+pytest -q
+```
+
+## License
+
+LGPL-v3. See the [LICENSE](https://gitee.com/iilic/crossmool) file for details.

crossmool-1.3.0/README.md

@@ -0,0 +1,79 @@
+# crossmool
+
+Cross-language SM2/SM3/SM4 cryptographic utilities. The Python implementation is fully interoperable with the Java/Go/Rust/C/C++/C#/JavaScript implementations in the [crossmool](https://gitee.com/iilic/crossmool) project.
+
+## Features
+
+- **SM2** — asymmetric encryption/decryption and signature (C1C3C2 ciphertext, X.509 / PKCS#8 DER keys, DER signatures).
+- **SM3** — hash and HMAC-SM3.
+- **SM4** — symmetric GCM encryption/decryption.
+- Hex and Base64 encodings supported throughout.
+- Guaranteed cross-language interop (simplified Chinese, traditional Chinese and English Unicode input).
+
+## Installation
+
+```bash
+pip install crossmool
+```
+
+Requires Python 3.8+.
+
+## Quick start
+
+### SM2 — encrypt / decrypt / sign / verify
+
+```python
+from crossmool import SM2Util
+
+priv, pub = SM2Util.generate_keypair_raw()
+
+# encrypt then decrypt (Hex)
+cipher = SM2Util.encrypt('hello', pub)
+assert SM2Util.decrypt(cipher, priv) == 'hello'
+
+# sign then verify
+sig = SM2Util.sign(cipher, priv)
+assert SM2Util.verify_str(cipher, pub, sig)
+```
+
+### SM3 — hash / HMAC
+
+```python
+from crossmool import SM3Util
+
+digest = SM3Util.digest_str('hello 国密')
+key = SM3Util.generate_hmac_key_to_str()
+mac = SM3Util.hmac_str(key, 'hello 国密')
+assert SM3Util.hmac_verify(key, 'hello 国密', mac)
+```
+
+### SM4 — GCM encrypt / decrypt
+
+```python
+from crossmool import SM4Util
+
+key = SM4Util.generate_key()
+cipher = SM4Util.encrypt_gcm_string(key, 'hello 国密')
+plain = SM4Util.decrypt_gcm_to_string(key, cipher)
+assert plain == 'hello 国密'
+```
+
+## Development
+
+Editable install for development:
+
+```bash
+cd <repo-root>
+pip install -e python/crossmool
+```
+
+Run the test suite:
+
+```bash
+cd python/crossmool
+pytest -q
+```
+
+## License
+
+LGPL-v3. See the [LICENSE](https://gitee.com/iilic/crossmool) file for details.

crossmool-1.3.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "crossmool"
+version = "1.3.0"
+description = "Cross-language SM2/SM3/SM4 cryptographic utilities, interoperable with the Java/Go/Rust/C/C++/C#/JavaScript implementations"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "LGPL-3.0-only"
+authors = [{ name = "crossmool" }]
+keywords = ["sm2", "sm3", "sm4", "cryptography", "gmssl", "sm-crypto", "chinese-cryptography", "encryption"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Security :: Cryptography",
+]
+dependencies = ["gmssl>=3.2.2"]
+
+[project.urls]
+Homepage = "https://gitee.com/iilic/crossmool"
+Repository = "https://gitee.com/iilic/crossmool"
+
+[project.optional-dependencies]
+test = ["pytest>=7.0"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

crossmool-1.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

crossmool-1.3.0/src/crossmool/__init__.py

@@ -0,0 +1,11 @@
+from crossmool.sm2_util import SM2Util
+from crossmool.sm3_util import SM3Util
+from crossmool.sm4_util import SM4Util
+
+__all__ = [
+    "SM2Util",
+    "SM3Util",
+    "SM4Util",
+]
+
+__version__ = "1.3.0"

crossmool-1.3.0/src/crossmool/der.py

@@ -0,0 +1,84 @@
+"""
+Minimal DER reader to parse SPKI (X.509) and PKCS8 used by crossmool JS/Java utils.
+This is a small port of the project's JS `DerReader` used to extract raw EC keys.
+"""
+from typing import Tuple
+
+
+class DerReader:
+    def __init__(self, data: bytes):
+        self.data = data
+        self.pos = 0
+        self.len = len(data)
+
+    def _read_length(self) -> int:
+        first = self._read(1)[0]
+        if first & 0x80 == 0:
+            return first
+        num = first & 0x7F
+        val = 0
+        for _ in range(num):
+            val = (val << 8) | self._read(1)[0]
+        return val
+
+    def _read(self, n: int) -> bytes:
+        if self.pos + n > self.len:
+            raise ValueError('Truncated DER')
+        out = self.data[self.pos:self.pos + n]
+        self.pos += n
+        return out
+
+    def read_sequence(self) -> 'DerReader':
+        tag = self._read(1)[0]
+        if tag != 0x30:
+            raise ValueError('Expected SEQUENCE')
+        length = self._read_length()
+        content = self._read(length)
+        return DerReader(content)
+
+    def read_integer_bytes(self) -> bytes:
+        tag = self._read(1)[0]
+        if tag != 0x02:
+            raise ValueError('Expected INTEGER')
+        length = self._read_length()
+        return self._read(length)
+
+    def read_oid(self) -> str:
+        tag = self._read(1)[0]
+        if tag != 0x06:
+            raise ValueError('Expected OID')
+        length = self._read_length()
+        oid_bytes = self._read(length)
+        # decode OID
+        first = oid_bytes[0]
+        oid_nodes = [str(first // 40), str(first % 40)]
+        value = 0
+        for b in oid_bytes[1:]:
+            value = (value << 7) | (b & 0x7F)
+            if not (b & 0x80):
+                oid_nodes.append(str(value))
+                value = 0
+        return '.'.join(oid_nodes)
+
+    def read_bit_string(self) -> Tuple[int, bytes]:
+        tag = self._read(1)[0]
+        if tag != 0x03:
+            raise ValueError('Expected BIT STRING')
+        length = self._read_length()
+        content = self._read(length)
+        unused_bits = content[0]
+        data = content[1:]
+        return unused_bits, data
+
+    def read_octet_string(self) -> bytes:
+        tag = self._read(1)[0]
+        if tag != 0x04:
+            raise ValueError('Expected OCTET STRING')
+        length = self._read_length()
+        return self._read(length)
+
+    def read(self, n: int) -> bytes:
+        return self._read(n)
+
+    def eof(self) -> bool:
+        return self.pos >= self.len

crossmool-1.3.0/src/crossmool/encoding.py

@@ -0,0 +1,56 @@
+import base64
+import re
+
+
+def is_hex_string(s: str) -> bool:
+    if not isinstance(s, str):
+        return False
+    s = s.strip()
+    return bool(re.fullmatch(r"[0-9a-fA-F]+", s))
+
+
+def is_base64_string(s: str) -> bool:
+    if not isinstance(s, str):
+        return False
+    s = s.strip()
+    try:
+        # len check: base64 length divisible by 4 (with padding)
+        if len(s) % 4 != 0:
+            return False
+        base64.b64decode(s, validate=True)
+        return True
+    except Exception:
+        return False
+
+
+def hex_to_bytes(hex_str: str) -> bytes:
+    return bytes.fromhex(hex_str.strip())
+
+
+def bytes_to_hex(b: bytes) -> str:
+    return b.hex()
+
+
+def base64_to_bytes(s: str) -> bytes:
+    return base64.b64decode(s)
+
+
+def bytes_to_base64(b: bytes) -> str:
+    return base64.b64encode(b).decode('ascii')
+
+
+def detect_string_encoding(s: str) -> str:
+    s = s.strip()
+    if is_hex_string(s):
+        return 'hex'
+    if is_base64_string(s):
+        return 'base64'
+    return 'unknown'
+
+
+def utf8_to_bytes(s: str) -> bytes:
+    return s.encode('utf-8')
+
+
+def bytes_to_utf8(b: bytes) -> str:
+    return b.decode('utf-8')