aiogram-cmds 0.2.0__tar.gz → 0.3.0__tar.gz

{aiogram_cmds-0.2.0 → aiogram_cmds-0.3.0}/.github/workflows/ci.yml

@@ -39,7 +39,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python: ['3.10', '3.11', '3.12', '3.13']
+        python: ['3.10', '3.11', '3.12', '3.13', '3.14']
     steps:
       - uses: actions/checkout@v6
       - uses: astral-sh/setup-uv@v7
@@ -138,7 +138,7 @@ jobs:
           for artifact in dist/*.whl dist/*.tar.gz; do
             target=$(mktemp -d)
             uv venv "$target/env" --python '${{ matrix.python }}'
-            uv pip install --python "$target/env/bin/python" "$artifact" '${{ matrix.aiogram }}' pytest '${{ matrix.asyncio }}' pytest-mock babel tomli
+            uv pip install --python "$target/env/bin/python" "$artifact" '${{ matrix.aiogram }}' pytest '${{ matrix.asyncio }}' pytest-mock babel tomli hypothesis
             uv pip check --python "$target/env/bin/python"
             cp -R tests examples "$target/"
             cp pyproject.toml "$target/"

aiogram_cmds-0.3.0/.github/workflows/native.yml

@@ -0,0 +1,88 @@
+name: Native candidate
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: native-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  wheels:
+    strategy:
+      fail-fast: false
+      max-parallel: 5
+      matrix:
+        include:
+          - {os: ubuntu-latest, target: x86_64, manylinux: '2014'}
+          - {os: ubuntu-24.04-arm, target: aarch64, manylinux: '2014'}
+          - {os: ubuntu-latest, target: x86_64-unknown-linux-musl, manylinux: musllinux_1_2}
+          - {os: ubuntu-24.04-arm, target: aarch64-unknown-linux-musl, manylinux: musllinux_1_2}
+          - {os: macos-15-intel, target: x86_64, manylinux: auto}
+          - {os: macos-latest, target: aarch64, manylinux: auto}
+          - {os: windows-latest, target: x86_64, manylinux: auto}
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          manylinux: ${{ matrix.manylinux }}
+          args: --release --locked --manifest-path native/Cargo.toml --out native-dist
+      - if: matrix.manylinux == 'musllinux_1_2'
+        shell: bash
+        run: |
+          for version in 3.10 3.11 3.12 3.13 3.14; do
+            docker run --rm -v "$PWD:/work" -w /work "python:$version-alpine" sh -c 'pip install native-dist/*.whl && python tools/smoke_native.py'
+          done
+      - uses: actions/upload-artifact@v6
+        with:
+          name: native-${{ matrix.os }}-${{ matrix.target }}
+          path: native-dist/*.whl
+  runtime:
+    needs: wheels
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      max-parallel: 5
+      matrix:
+        python: ['3.10', '3.11', '3.12', '3.13', '3.14']
+        os: [ubuntu-latest, ubuntu-24.04-arm, macos-15-intel, macos-latest, windows-latest]
+        include:
+          - {os: ubuntu-latest, target: x86_64}
+          - {os: ubuntu-24.04-arm, target: aarch64}
+          - {os: macos-15-intel, target: x86_64}
+          - {os: macos-latest, target: aarch64}
+          - {os: windows-latest, target: x86_64}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: actions/download-artifact@v6
+        with:
+          name: native-${{ matrix.os }}-${{ matrix.target }}
+          path: native-dist
+      - run: uv sync --frozen --all-extras --all-groups
+      - run: uv pip install native-dist/*.whl
+        shell: bash
+      - run: uv run --no-sync python tools/smoke_native.py
+      - run: uv run --no-sync pytest tests/unit tests/integration --cov=aiogram_cmds --cov-fail-under=80
+  rust:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - run: cargo test --locked --manifest-path native/Cargo.toml
+      - run: cargo clippy --locked --manifest-path native/Cargo.toml --all-targets -- -D warnings
+  source:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --manifest-path native/Cargo.toml --out native-dist
+      - uses: actions/upload-artifact@v6
+        with:
+          name: native-source
+          path: native-dist/*.tar.gz

aiogram_cmds-0.3.0/.github/workflows/publish-native.yml

@@ -0,0 +1,65 @@
+name: Publish verified native companion
+
+on:
+  workflow_dispatch:
+    inputs:
+      manifest_sha256:
+        description: SHA256 of the independently reviewed native release SHA256SUMS
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-native-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  verify:
+    if: github.ref_type == 'tag' && startsWith(github.ref_name, 'native-v')
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: '3.12'
+      - name: Download exact reviewed native artifacts
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release download "$GITHUB_REF_NAME" --pattern '*.whl' --pattern '*.tar.gz' --pattern SHA256SUMS --dir native-dist
+      - name: Validate exact identity, versions, checksums and complete wheel matrix
+        env:
+          MANIFEST_SHA256: ${{ inputs.manifest_sha256 }}
+        run: >-
+          uv run --no-project python tools/verify_native_artifacts.py
+          --directory native-dist --tag "$GITHUB_REF_NAME"
+          --manifest-sha256 "$MANIFEST_SHA256"
+      - run: uvx twine check native-dist/*.whl native-dist/*.tar.gz
+      - run: uvx abi3audit --strict native-dist/*.whl
+      - uses: actions/upload-artifact@v6
+        with:
+          name: verified-native-distributions
+          path: |
+            native-dist/*.whl
+            native-dist/*.tar.gz
+          if-no-files-found: error
+  publish:
+    needs: verify
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v7
+        with:
+          name: verified-native-distributions
+          path: native-dist
+      - name: Publish verified companion using Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: native-dist/

{aiogram_cmds-0.2.0 → aiogram_cmds-0.3.0}/.gitignore

@@ -232,3 +232,7 @@ dump.rdb
 
 # Static analysis cache
 .ruff_cache/
+
+# Optional native build outputs
+native/target/
+native/dist/

{aiogram_cmds-0.2.0 → aiogram_cmds-0.3.0}/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 <!-- towncrier release notes start -->
 
+## [0.3.0] - Unreleased
+
+- Add explicitly revisioned immutable compiled command profiles and resolved batch
+  payloads. Preserve dynamic translator evaluation for existing live APIs.
+- Optimize Python profile resolution and reuse canonical compiled command JSON.
+- Add an explicit optional Rust engine candidate with ABI validation, independent
+  native packaging and parity tests. Python remains the default; companion
+  publication was withheld after the serial performance gate failed. No native
+  tag or dependency extra is released; the candidate remains buildable source.
+- Add installed-package CPU/latency evidence, pyperf and Criterion benchmarks,
+  and Python 3.14 / native platform CI.
+
 ## [0.2.0] - 2026-11-10
 
 ### Features

{aiogram_cmds-0.2.0 → aiogram_cmds-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: aiogram-cmds
-Version: 0.2.0
+Version: 0.3.0
 Summary: Command management library for aiogram v3
 Project-URL: Homepage, https://github.com/ArmanAvanesyan/aiogram-cmds
 Project-URL: Repository, https://github.com/ArmanAvanesyan/aiogram-cmds
@@ -17,6 +17,7 @@ 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
 Classifier: Topic :: Communications :: Chat
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
@@ -28,8 +29,12 @@ Requires-Dist: babel>=2.16; extra == 'dev'
 Requires-Dist: bandit>=1.7.0; extra == 'dev'
 Requires-Dist: black>=23.0.0; extra == 'dev'
 Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: hypothesis>=6; extra == 'dev'
 Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: orjson>=3.10; extra == 'dev'
 Requires-Dist: pip-audit>=2.9.0; (python_version >= '3.11') and extra == 'dev'
+Requires-Dist: psutil>=6; extra == 'dev'
+Requires-Dist: pyperf>=2.9; extra == 'dev'
 Requires-Dist: pyright>=1.1.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
 Requires-Dist: pytest-benchmark>=4.0.0; extra == 'dev'
@@ -312,3 +317,10 @@ locale/menu slots, default-language fallback, explicit language cleanup,
 confirmed payload fingerprints and partial batch outcomes. Run
 `uv run python examples/application_profiles.py --dry-run` for a network-free
 example. The library never configures application logging.
+
+Compiled immutable profiles and explicit optional engines are described in [performance guidance](docs/compiled-profiles.md). Python remains the default; native publication is benchmark-gated.
+
+The 0.3.0 native candidate **did not pass its release performance gate**. Native
+publication, native tags and a dependency extra are withheld. Rust code remains
+available to build from source; the Python 0.3.0 distribution can release
+independently. Use compiled Python profiles for explicit snapshot reuse.

{aiogram_cmds-0.2.0 → aiogram_cmds-0.3.0}/README.md

@@ -267,3 +267,10 @@ locale/menu slots, default-language fallback, explicit language cleanup,
 confirmed payload fingerprints and partial batch outcomes. Run
 `uv run python examples/application_profiles.py --dry-run` for a network-free
 example. The library never configures application logging.
+
+Compiled immutable profiles and explicit optional engines are described in [performance guidance](docs/compiled-profiles.md). Python remains the default; native publication is benchmark-gated.
+
+The 0.3.0 native candidate **did not pass its release performance gate**. Native
+publication, native tags and a dependency extra are withheld. Rust code remains
+available to build from source; the Python 0.3.0 distribution can release
+independently. Use compiled Python profiles for explicit snapshot reuse.

aiogram_cmds-0.3.0/benchmarks/pyperf_suite.py

@@ -0,0 +1,24 @@
+"""Calibrated subprocess pyperf Runner suite against the installed distribution."""
+
+import pyperf
+from run import workloads
+
+
+def command_line(command, args):
+    command.extend(["--engine", args.engine, "--workload", args.workload])
+
+
+runner = pyperf.Runner(add_cmdline_args=command_line)
+runner.argparser.add_argument("--engine", choices=["python", "rust"], default="python")
+runner.argparser.add_argument(
+    "--workload", default="", help="Optional workload name substring"
+)
+args = runner.parse_args()
+runner.metadata["engine"] = args.engine
+runner.metadata["seed"] = 1729
+for name, function, _loops, _counters, _new_only in workloads(args.engine, False):
+    if "fake_telegram" not in name and args.workload in name:
+        if "confirmation_hit" in name:
+            runner.bench_async_func(name, function)
+        else:
+            runner.bench_func(name, function)