ciphertoken 0.1.6__tar.gz → 0.1.8__tar.gz

ciphertoken-0.1.8/.github/workflows/docs.yml

@@ -0,0 +1,29 @@
+name: Documentation
+on:
+  push:
+    branches:
+      - master
+      - main
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/configure-pages@v6
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - run: pip install zensical
+      - run: zensical build --clean
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: site
+      - uses: actions/deploy-pages@v5
+        id: deployment

ciphertoken-0.1.8/.gitignore

@@ -0,0 +1,18 @@
+venv
+/.env
+r.txt
+/target/
+/dist/
+/*.whl
+/*.tar.gz
+*.so
+*.abi3.so
+ciphertoken/*.abi3.so
+.venv-py312/
+.venv/
+.venv
+__pycache__/
+__pycache__/*
+.pytest_cache
+.ruff_cache
+.ruff_cache/

ciphertoken-0.1.8/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.13.0
+    hooks:
+      - id: ruff-check
+        args: ['--ignore', 'F401', '--exclude', '.*\\.pyi']
+      - id: ruff-format
+        exclude: '.*\\.pyi'
+
+  - repo: local
+    hooks:
+      - id: cargo-fmt
+        name: cargo fmt
+        entry: cargo fmt --check
+        language: system
+        pass_filenames: false
+
+      - id: cargo-clippy
+        name: cargo clippy
+        entry: cargo clippy -- -D warnings
+        language: system
+        pass_filenames: false
+
+      - id: pytest
+        name: pytest
+        entry: .venv/bin/pytest
+        language: system
+        pass_filenames: false

ciphertoken-0.1.8/.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "python.defaultInterpreterPath": "./.venv/bin/python",
+    "python.analysis.autoCompleteExtraPaths": ["./ciphertoken"],
+    "python.analysis.stubPath": "./typings",
+    "python.languageServer": "Pylance"
+}

{ciphertoken-0.1.6 → ciphertoken-0.1.8}/Cargo.lock

@@ -56,7 +56,7 @@ checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
 
 [[package]]
 name = "ciphertoken"
-version = "0.1.6"
+version = "0.1.8"
 dependencies = [
  "base64 0.21.7",
  "jsonwebtoken",

{ciphertoken-0.1.6 → ciphertoken-0.1.8}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ciphertoken"
-version = "0.1.6"
+version = "0.1.8"
 edition = "2021"
 readme = "README.md"
 

ciphertoken-0.1.8/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cipher-Unit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ciphertoken-0.1.8/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: ciphertoken
+Version: 0.1.8
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Rust
+Classifier: Operating System :: OS Independent
+Requires-Dist: pre-commit ; extra == 'test'
+Requires-Dist: pytest ; extra == 'test'
+Requires-Dist: pytest-asyncio ; extra == 'test'
+Provides-Extra: test
+License-File: LICENSE
+Summary: High-performance token and crypto utilities written in Rust with PyO3
+Author: Cipher-Unit
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+<img src="https://github.com/cipherunits/CipherToken/blob/main/logo.png" width=100>
+
+<!--
+description: High-performance Python JWT library built with Rust. Fast token generation, validation, and key management.
+keywords: jwt, python, rust, cryptography, security, authentication, hs256, rs256, eddsa
+-->
+
+# CipherToken
+
+**CipherToken** is a **next-generation** token engine built for developers who demand speed, security, and reliability. Currently focused on **JWT**, it provides a complete token lifecycle — from key generation and token minting to verification, rotation, and expiry tracking — all backed by the raw performance of **Rust**.
+
+- Python 3.8+
+- HMAC, RSA, ECDSA, RSA-PSS, EdDSA
+- Sync and Async APIs via **Tokio**
+
+Built by **[Cipher-Unit](https://cipherunit.xyz/)**.
+
+---
+
+## Documentation
+
+📖 **Official Documentation:** [https://cipherunits.github.io/CipherToken/](https://cipherunits.github.io/CipherToken/)
+
+---
+
+## Installation
+
+```bash
+pip install ciphertoken
+```
+
+---
+
+## Quick Example
+
+```python
+from ciphertoken import CipherToken
+from ciphertoken.algorithms import HS256
+from ciphertoken.time import minutes, days
+from ciphertoken.jwt import access, refresh, rotation
+
+token = CipherToken(
+    secret="your-strong-secret-key",
+    algorithm=HS256,
+    access_ttl=minutes(10),
+    refresh_ttl=days(7),
+)
+
+access_token = access(token, payload={"user_id": 42})
+refresh_token = refresh(token, payload={"user_id": 42})
+new_access, new_refresh = rotation(token, refresh_token)
+
+print(token.verify(access_token))  # True
+print(token.decode(access_token))
+```
+
+---
+
+## Contribute
+
+Contributions are welcome! Whether it's bug fixes, new algorithms, documentation improvements, or feature suggestions — feel free to open an issue or pull request.
+
+- **Repository:** [https://github.com/cipherunits/CipherToken](https://github.com/cipherunits/CipherToken)
+- **Issues:** [https://github.com/cipherunits/CipherToken/issues](https://github.com/cipherunits/CipherToken/issues)
+
+Please read the code of conduct and contribution guidelines before submitting. All contributions must follow the MIT license.
+
+---
+
+## License
+
+**MIT** — see [LICENSE](LICENSE) for details.
+

ciphertoken-0.1.8/README.md

@@ -0,0 +1,72 @@
+<img src="https://github.com/cipherunits/CipherToken/blob/main/logo.png" width=100>
+
+<!--
+description: High-performance Python JWT library built with Rust. Fast token generation, validation, and key management.
+keywords: jwt, python, rust, cryptography, security, authentication, hs256, rs256, eddsa
+-->
+
+# CipherToken
+
+**CipherToken** is a **next-generation** token engine built for developers who demand speed, security, and reliability. Currently focused on **JWT**, it provides a complete token lifecycle — from key generation and token minting to verification, rotation, and expiry tracking — all backed by the raw performance of **Rust**.
+
+- Python 3.8+
+- HMAC, RSA, ECDSA, RSA-PSS, EdDSA
+- Sync and Async APIs via **Tokio**
+
+Built by **[Cipher-Unit](https://cipherunit.xyz/)**.
+
+---
+
+## Documentation
+
+📖 **Official Documentation:** [https://cipherunits.github.io/CipherToken/](https://cipherunits.github.io/CipherToken/)
+
+---
+
+## Installation
+
+```bash
+pip install ciphertoken
+```
+
+---
+
+## Quick Example
+
+```python
+from ciphertoken import CipherToken
+from ciphertoken.algorithms import HS256
+from ciphertoken.time import minutes, days
+from ciphertoken.jwt import access, refresh, rotation
+
+token = CipherToken(
+    secret="your-strong-secret-key",
+    algorithm=HS256,
+    access_ttl=minutes(10),
+    refresh_ttl=days(7),
+)
+
+access_token = access(token, payload={"user_id": 42})
+refresh_token = refresh(token, payload={"user_id": 42})
+new_access, new_refresh = rotation(token, refresh_token)
+
+print(token.verify(access_token))  # True
+print(token.decode(access_token))
+```
+
+---
+
+## Contribute
+
+Contributions are welcome! Whether it's bug fixes, new algorithms, documentation improvements, or feature suggestions — feel free to open an issue or pull request.
+
+- **Repository:** [https://github.com/cipherunits/CipherToken](https://github.com/cipherunits/CipherToken)
+- **Issues:** [https://github.com/cipherunits/CipherToken/issues](https://github.com/cipherunits/CipherToken/issues)
+
+Please read the code of conduct and contribution guidelines before submitting. All contributions must follow the MIT license.
+
+---
+
+## License
+
+**MIT** — see [LICENSE](LICENSE) for details.

ciphertoken-0.1.8/ciphertoken/.gitignore

@@ -0,0 +1,7 @@
+
+__pycache__
+__pycache__/*
+
+ciphertoken.abi3.so
+*.abi3.so
+

ciphertoken-0.1.8/ciphertoken/__init__.py

@@ -0,0 +1,72 @@
+"""Public Python API for ciphertoken."""
+
+from .algorithms import (
+    EDDSA,
+    ES256,
+    ES384,
+    HS256,
+    HS384,
+    HS512,
+    PS256,
+    PS384,
+    PS512,
+    RS256,
+    RS384,
+    RS512,
+)
+from .ciphertoken import CipherToken, is_jwt_format, validate_jwt_format
+from .jwt import TOKEN_ACCESS, TOKEN_REFRESH
+from .jwt import access, refresh, rotation
+from .jwt import (
+    access_async,
+    refresh_async,
+    rotation_async,
+)
+from .secret import (
+    generate_hmac_secret,
+    generate_hmac_secret_async,
+    generate_rsa_keypair,
+    secret_key,
+    secret_key_with_size,
+)
+from .time import days, hours, minutes, now, seconds, weeks
+from .utils import DEFAULT_SECRET_SIZE, MIN_SECRET_SIZE
+
+__all__ = [
+    "CipherToken",
+    "is_jwt_format",
+    "validate_jwt_format",
+    "EDDSA",
+    "ES256",
+    "ES384",
+    "HS256",
+    "HS384",
+    "HS512",
+    "PS256",
+    "PS384",
+    "PS512",
+    "RS256",
+    "RS384",
+    "RS512",
+    "JWT_TOKEN_ACCESS",
+    "JWT_TOKEN_REFRESH",
+    "jwt_access",
+    "jwt_refresh",
+    "jwt_rotation",
+    "jwt_access_async",
+    "jwt_refresh_async",
+    "jwt_rotation_async",
+    "generate_hmac_secret",
+    "generate_hmac_secret_async",
+    "generate_rsa_keypair",
+    "secret_key",
+    "secret_key_with_size",
+    "days",
+    "hours",
+    "minutes",
+    "now",
+    "seconds",
+    "weeks",
+    "DEFAULT_SECRET_SIZE",
+    "MIN_SECRET_SIZE",
+]

ciphertoken-0.1.8/ciphertoken/__init__.pyi

@@ -0,0 +1,79 @@
+from typing import Any, Dict, Optional, Tuple
+from typing_extensions import ParamSpec
+
+P = ParamSpec("P")
+
+# Algorithm constants
+HS256: str
+HS384: str
+HS512: str
+RS256: str
+RS384: str
+RS512: str
+ES256: str
+ES384: str
+PS256: str
+PS384: str
+PS512: str
+EDDSA: str
+
+# JWT module constants (aliased)
+JWT_TOKEN_ACCESS: str
+JWT_TOKEN_REFRESH: str
+
+# JWT functions (module-level wrappers)
+def jwt_access(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def jwt_refresh(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def jwt_rotation(token_instance: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+async def jwt_access_async(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def jwt_refresh_async(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def jwt_rotation_async(token_instance: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+
+# Secret functions
+def secret_key() -> str: ...
+def secret_key_with_size(size: int) -> str: ...
+def generate_hmac_secret(size: int) -> str: ...
+async def generate_hmac_secret_async(size: int) -> str: ...
+def generate_rsa_keypair(bits: Optional[int] = None) -> Tuple[str, str]: ...
+
+# Time functions
+def now() -> int: ...
+def seconds(n: int) -> int: ...
+def minutes(n: int) -> int: ...
+def hours(n: int) -> int: ...
+def days(n: int) -> int: ...
+def weeks(n: int) -> int: ...
+
+# Utils constants
+DEFAULT_SECRET_SIZE: int
+MIN_SECRET_SIZE: int
+
+# JWT format functions
+def is_jwt_format(token: str) -> bool: ...
+def validate_jwt_format(token: str) -> bool: ...
+
+# CipherToken class
+class CipherToken:
+    """High-performance JWT token handler with support for multiple algorithms."""
+    
+    secret: str
+    access_ttl: int
+    refresh_ttl: int
+    
+    def __init__(self, secret: str, algorithm: str, access_ttl: int, refresh_ttl: int) -> None: ...
+    
+    def create_token(self, ttl_time: int, token_type: str, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def access(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def refresh(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def decode(self, token: str) -> Dict[str, Any]: ...
+    def verify(self, token: str) -> bool: ...
+    def inspect(self, token: str) -> Dict[str, Any]: ...
+    def rotation(self, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+    def remaining_time(self, token: str) -> Optional[int]: ...
+    def algorithm_name(self) -> str: ...
+    
+    async def access_async(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def refresh_async(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def decode_async(self, token: str) -> Dict[str, Any]: ...
+    async def verify_async(self, token: str) -> bool: ...
+    async def rotation_async(self, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...

{ciphertoken-0.1.6 → ciphertoken-0.1.8}/ciphertoken/algorithms.py

@@ -15,4 +15,17 @@ PS384 = _algorithms.PS384
 PS512 = _algorithms.PS512
 EDDSA = _algorithms.EDDSA
 
-__all__ = ["HS256", "HS384", "HS512", "RS256", "RS384", "RS512", "ES256", "ES384", "PS256", "PS384", "PS512", "EDDSA"]
+__all__ = [
+    "HS256",
+    "HS384",
+    "HS512",
+    "RS256",
+    "RS384",
+    "RS512",
+    "ES256",
+    "ES384",
+    "PS256",
+    "PS384",
+    "PS512",
+    "EDDSA",
+]

ciphertoken-0.1.8/ciphertoken/ciphertoken.pyi

@@ -0,0 +1,48 @@
+from typing import Any, Dict, Optional, Tuple
+
+# CipherToken class stub
+class CipherToken:
+    def __init__(
+        self,
+        secret: str,
+        algorithm: str,
+        access_ttl: int,
+        refresh_ttl: int,
+    ) -> None: ...
+
+    def create_token(
+        self,
+        ttl_time: int,
+        token_type: str,
+        payload: Optional[Dict[str, Any]] = None,
+    ) -> str: ...
+
+    def access(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def refresh(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def decode(self, token: str) -> Dict[str, Any]: ...
+    def verify(self, token: str) -> bool: ...
+    def inspect(self, token: str) -> Dict[str, Any]: ...
+    def rotation(
+        self, refresh_token: str, payload: Optional[Dict[str, Any]] = None
+    ) -> Tuple[str, str]: ...
+    def remaining_time(self, token: str) -> Optional[int]: ...
+    def algorithm_name(self) -> str: ...
+
+    @property
+    def secret(self) -> str: ...
+    @property
+    def access_ttl(self) -> int: ...
+    @property
+    def refresh_ttl(self) -> int: ...
+
+    async def access_async(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def refresh_async(self, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def decode_async(self, token: str) -> Dict[str, Any]: ...
+    async def verify_async(self, token: str) -> bool: ...
+    async def rotation_async(
+        self, refresh_token: str, payload: Optional[Dict[str, Any]] = None
+    ) -> Tuple[str, str]: ...
+
+
+def is_jwt_format(token: str) -> bool: ...
+def validate_jwt_format(token: str) -> bool: ...

ciphertoken-0.1.8/ciphertoken/jwt.py

@@ -0,0 +1,25 @@
+"""Python wrapper for Rust jwt submodule."""
+
+from .ciphertoken import jwt as _jwt
+
+TOKEN_ACCESS = _jwt.TOKEN_ACCESS
+TOKEN_REFRESH = _jwt.TOKEN_REFRESH
+
+access = _jwt.access
+refresh = _jwt.refresh
+rotation = _jwt.rotation
+
+access_async = _jwt.access_async
+refresh_async = _jwt.refresh_async
+rotation_async = _jwt.rotation_async
+
+__all__ = [
+    "TOKEN_ACCESS",
+    "TOKEN_REFRESH",
+    "access",
+    "refresh",
+    "rotation",
+    "access_async",
+    "refresh_async",
+    "rotation_async",
+]

ciphertoken-0.1.8/ciphertoken/jwt.pyi

@@ -0,0 +1,11 @@
+from typing import Any, Dict, Optional
+
+def access(token: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def refresh(token: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def rotation(token: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> tuple[str, str]: ...
+async def access_async(token: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def refresh_async(token: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def rotation_async(token: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> tuple[str, str]: ...
+
+TOKEN_ACCESS: str
+TOKEN_REFRESH: str

{ciphertoken-0.1.6 → ciphertoken-0.1.8}/ciphertoken/secret.pyi

@@ -1,7 +1,7 @@
-from typing import Optional, Tuple
+from typing import Tuple
 
 def secret_key() -> str: ...
 def secret_key_with_size(size: int) -> str: ...
 def generate_hmac_secret(size: int) -> str: ...
 async def generate_hmac_secret_async(size: int) -> str: ...
-def generate_rsa_keypair(bits: Optional[int] = 2048) -> Tuple[str, str]: ...
+def generate_rsa_keypair(bits: int = ...) -> Tuple[str, str]: ...

ciphertoken-0.1.8/ciphertoken.pyi

@@ -0,0 +1,88 @@
+from typing import Any, Dict, Optional, Tuple
+
+# Algorithm constants
+HS256: str
+HS384: str
+HS512: str
+RS256: str
+RS384: str
+RS512: str
+ES256: str
+ES384: str
+PS256: str
+PS384: str
+PS512: str
+EDDSA: str
+
+# JWT module constants
+JWT_TOKEN_ACCESS: str
+JWT_TOKEN_REFRESH: str
+
+# JWT functions
+def access(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def refresh(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+def rotation(token_instance: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+async def access_async(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def refresh_async(token_instance: Any, payload: Optional[Dict[str, Any]] = None) -> str: ...
+async def rotation_async(token_instance: Any, refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+
+# Secret functions
+def secret_key() -> str: ...
+def secret_key_with_size(size: int) -> str: ...
+def generate_hmac_secret(size: int) -> str: ...
+async def generate_hmac_secret_async(size: int) -> str: ...
+def generate_rsa_keypair(bits: Optional[int] = None) -> Tuple[str, str]: ...
+
+# Time functions
+def now() -> int: ...
+def seconds(n: int) -> int: ...
+def minutes(n: int) -> int: ...
+def hours(n: int) -> int: ...
+def days(n: int) -> int: ...
+def weeks(n: int) -> int: ...
+
+# Utils constants
+DEFAULT_SECRET_SIZE: int
+MIN_SECRET_SIZE: int
+TOKEN_ACCESS: str
+TOKEN_REFRESH: str
+
+# JWT format functions
+def is_jwt_format(token: str) -> bool: ...
+def validate_jwt_format(token: str) -> bool: ...
+
+# CipherToken class with full autocomplete support
+class CipherToken:
+    def __init__(self, secret: str, algorithm: str, access_ttl: int, refresh_ttl: int) -> None: ...
+    
+    # Token creation
+    def create_token(self,ttl_time: int, token_type: str, payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def access(self,payload: Optional[Dict[str, Any]] = None) -> str: ...
+    def refresh(self,payload: Optional[Dict[str, Any]] = None) -> str: ...
+    
+    # Token inspection/decoding
+    def decode(self,token: str) -> Dict[str, Any]: ...
+    def verify(self,token: str) -> bool: ...
+    def inspect(self,token: str) -> Dict[str, Any]: ...
+    
+    # Token rotation
+    def rotation(self,refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...
+    
+    # Utility methods
+    def remaining_time(self,token: str) -> Optional[int]: ...
+    def algorithm_name(self,) -> str: ...
+    
+    # Properties
+    @property
+    def secret(self) -> str: ...
+    @property
+    def access_ttl(self) -> int: ...
+    @property
+    def refresh_ttl(self) -> int: ...
+    
+    # Async methods
+    async def access_async(self,payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def refresh_async(self,payload: Optional[Dict[str, Any]] = None) -> str: ...
+    async def decode_async(self,token: str) -> Dict[str, Any]: ...
+    async def verify_async(self,token: str) -> bool: ...
+    async def rotation_async(self,refresh_token: str, payload: Optional[Dict[str, Any]] = None) -> Tuple[str, str]: ...