tryx 0.2.0__tar.gz → 0.4.0__tar.gz

tryx-0.4.0/.github/workflows/CI.yml

@@ -0,0 +1,203 @@
+name: CI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  quality:
+    name: Quality Checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v5
+      - name: Install dev dependencies
+        run: uv sync --group dev --no-install-project
+      - name: Ruff lint
+        run: uv run --no-project --with ruff==0.11.4 ruff check .
+      - name: Ruff format check
+        run: uv run --no-project --with ruff==0.11.4 ruff format --check .
+      - name: Validate stub parity
+        run: uv run python scripts/check_stub_parity.py
+
+  linux:
+    name: Linux manylinux wheels
+    needs: quality
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Workaround ring ARM asm macro in cross builds
+        if: matrix.platform.target == 'aarch64'
+        run: echo "CFLAGS_aarch64_unknown_linux_gnu=-D__ARM_ARCH=8" >> "$GITHUB_ENV"
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') && matrix.platform.target != 'aarch64' }}
+          manylinux: auto
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux-${{ matrix.platform.target }}
+          path: dist
+
+  windows:
+    name: Windows wheels
+    needs: quality
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: windows-latest
+            target: x64
+            python_arch: x64
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          architecture: ${{ matrix.platform.python_arch }}
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows-${{ matrix.platform.target }}
+          path: dist
+
+  macos:
+    name: macOS wheels
+    needs: quality
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - runner: macos-15-intel
+            target: x86_64
+          - runner: macos-latest
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-${{ matrix.platform.target }}
+          path: dist
+
+  sdist:
+    name: Source distribution
+    needs: quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  release:
+    name: Publish to PyPI
+    if: ${{ startsWith(github.ref, 'refs/tags/v') }}
+    needs: [linux, windows, macos, sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Log release context
+        run: |
+          echo "event=${GITHUB_EVENT_NAME}"
+          echo "ref=${GITHUB_REF}"
+          echo "sha=${GITHUB_SHA}"
+
+      - name: Download wheel artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+
+      - name: Ensure PyPI token exists
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          if [ -z "${UV_PUBLISH_TOKEN}" ]; then
+            echo "::error::Missing PYPI_API_TOKEN secret."
+            exit 1
+          fi
+
+      - name: Validate release artifacts
+        run: |
+          set -euo pipefail
+          shopt -s nullglob
+          files=(dist/*)
+          if [ ${#files[@]} -eq 0 ]; then
+            echo "::error::No artifacts found in dist/."
+            exit 1
+          fi
+          printf '%s\n' "${files[@]}"
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Publish artifacts
+        run: uv publish dist/*
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

{tryx-0.2.0 → tryx-0.4.0}/.github/workflows/docs.yml

@@ -3,7 +3,7 @@ name: Documentation
 on:
   push:
     branches:
-      - main
+      - master
     paths:
       - "docs/**"
       - "mkdocs.yml"
@@ -45,7 +45,7 @@ jobs:
 
   deploy:
     name: Deploy docs
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
     needs: build
     runs-on: ubuntu-latest
     environment:

{tryx-0.2.0 → tryx-0.4.0}/.github/workflows/release.yml

@@ -2,6 +2,17 @@ name: Semantic Release
 
 on:
   workflow_dispatch:
+    inputs:
+      release_type:
+        description: "Version bump strategy"
+        required: true
+        default: auto
+        type: choice
+        options:
+          - auto
+          - patch
+          - minor
+          - major
 
 permissions:
   contents: write
@@ -21,6 +32,7 @@ jobs:
           echo "ref=${GITHUB_REF}"
           echo "actor=${GITHUB_ACTOR}"
           echo "default_branch=${{ github.event.repository.default_branch }}"
+          echo "release_type=${{ github.event.inputs.release_type || 'auto' }}"
 
       - uses: actions/checkout@v4
         with:
@@ -49,7 +61,13 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: uv run --no-project --with python-semantic-release==9.21.1 semantic-release version
+          RELEASE_TYPE: ${{ github.event.inputs.release_type || 'auto' }}
+        run: |
+          if [ "${RELEASE_TYPE}" = "auto" ]; then
+            uv run --no-project --with python-semantic-release==9.21.1 semantic-release version --no-vcs-release
+          else
+            uv run --no-project --with python-semantic-release==9.21.1 semantic-release version --no-vcs-release --"${RELEASE_TYPE}"
+          fi
 
       - name: Push release commit and tags
         run: git push --follow-tags origin HEAD:${{ github.event.repository.default_branch }}
@@ -72,6 +90,7 @@ jobs:
           if [ "${after_sha}" = "${{ steps.baseline.outputs.sha }}" ] && [ "${after_tag}" = "${{ steps.baseline.outputs.tag }}" ]; then
             echo "released=false" >> "$GITHUB_OUTPUT"
             echo "No new release generated in this run."
+            echo "Tip: use release_type=patch/minor/major to force a release when needed."
           else
             echo "released=true" >> "$GITHUB_OUTPUT"
             echo "Release generated. Latest tag: ${after_tag:-none}"

{tryx-0.2.0 → tryx-0.4.0}/CHANGELOG.md

@@ -1,6 +1,35 @@
 # CHANGELOG
 
 
+## v0.4.0 (2026-04-01)
+
+### Bug Fixes
+
+- **client**: Callback params
+  ([`b133efe`](https://github.com/krypton-byte/tryx/commit/b133efe7580636a27a87889d4000fb039e3d7e31))
+
+- **workflow**: Update branch references from 'main' to 'master' in documentation workflow
+  ([`9d64aa2`](https://github.com/krypton-byte/tryx/commit/9d64aa25963d42cb0f410bc0bae42f9469af5d5b))
+
+### Chores
+
+- **deps**: Update tryx version from 0.2.0 to 0.3.0 in Cargo.lock
+  ([`c0b7ab7`](https://github.com/krypton-byte/tryx/commit/c0b7ab71958c2749124da415302ddaee38c404c0))
+
+### Refactoring
+
+- **CI**: Streamline platform matrix and remove musllinux configuration
+  ([`2c2be2f`](https://github.com/krypton-byte/tryx/commit/2c2be2ff5c54601ade1c99efd715e41b5d7c53fb))
+
+
+## v0.3.0 (2026-04-01)
+
+### Features
+
+- **ci**: Reintroduce Linux and Windows wheel builds with updated configurations
+  ([`b30808f`](https://github.com/krypton-byte/tryx/commit/b30808fea71d0e95fa4c9de5ae7a3b2190eb6949))
+
+
 ## v0.2.0 (2026-04-01)
 
 ### Bug Fixes
@@ -14,9 +43,23 @@
 - **release**: Update default branch references in workflow and documentation
   ([`bc5a5cc`](https://github.com/krypton-byte/tryx/commit/bc5a5ccc1cb037cf813998d0ad865d66c30c6ae5))
 
+- **release**: Update default branch references in workflow and documentation
+  ([`3bb0cb2`](https://github.com/krypton-byte/tryx/commit/3bb0cb250dd8281a27707e39a181731ff6d2b3f2))
+
 - **test**: Update workflows for commit message validation and release automation
   ([`b940d91`](https://github.com/krypton-byte/tryx/commit/b940d91d89969590af84b56a52316803174c4f65))
 
+- **workflow**: Remove duplicate ref line in release workflow
+  ([`2e3667a`](https://github.com/krypton-byte/tryx/commit/2e3667a8a2801c8fb083a6e38b8d28cc8379ef49))
+
+- **workflow**: Update branch references from 'main' to 'master' in documentation workflow
+  ([`0d9ecc6`](https://github.com/krypton-byte/tryx/commit/0d9ecc63ed4ba76424e1f40e2086e1864ee0f07e))
+
+### Chores
+
+- **deps**: Update tryx version from 0.2.0 to 0.3.0 in Cargo.lock
+  ([`6bd891e`](https://github.com/krypton-byte/tryx/commit/6bd891e87b8befcf3468bd516d5f2ad403320e86))
+
 ### Documentation
 
 - Update contributing guidelines to clarify release automation and required secrets
@@ -27,9 +70,23 @@
 
 ### Features
 
+- **ci**: Reintroduce Linux and Windows wheel builds with updated configurations
+  ([`bb74fd2`](https://github.com/krypton-byte/tryx/commit/bb74fd227019c298853fe8bc038bb7424eba1d58))
+
+- **release**: Enhance workflow dispatch with release type options and improve documentation
+  ([`b477e44`](https://github.com/krypton-byte/tryx/commit/b477e44ac37b3f5b2d200de9cd5e46155094de3a))
+
+- **release**: Enhance workflow dispatch with release type options and improve documentation
+  ([`fb67cf9`](https://github.com/krypton-byte/tryx/commit/fb67cf9f01736ec55fbb97f54845b82a05e3b782))
+
 - **test**: Test
   ([`3bc6c04`](https://github.com/krypton-byte/tryx/commit/3bc6c04f8ce84802947c45ad9e9b8735ec615918))
 
+### Refactoring
+
+- **README**: Streamline content and enhance clarity by removing redundant sections
+  ([`32fcaec`](https://github.com/krypton-byte/tryx/commit/32fcaec8caf5d074ee257c4d29762645f0233cec))
+
 
 ## v0.1.0 (2026-04-01)
 

{tryx-0.2.0 → tryx-0.4.0}/CONTRIBUTING.md

@@ -94,7 +94,8 @@ Include:
 - If commits qualify (`feat`, `fix`, `perf`, or breaking), version and changelog are updated and a new tag (`vX.Y.Z`) is created.
 - If commits do not qualify (for example docs/chore only), release is a no-op and no publish is triggered.
 - After a tag is created, GitHub Release notes are generated automatically.
-- CI is then triggered on that tag to build artifacts and publish to PyPI.
+- CI release pipeline is tag-driven (`vX.Y.Z`) to build artifacts and publish to PyPI.
+- Workflow dispatch is kept only as internal fallback trigger from `Semantic Release` automation.
 
 ## Simple Trigger Guide
 
@@ -108,10 +109,11 @@ Use this rule of thumb for automatic versioning:
 How to trigger semantic release until publish to PyPI:
 
 1. Push commits to default branch (direct push or merged PR), using Conventional Commit messages.
-2. Open GitHub Actions and run `Semantic Release` on default branch.
-3. Workflow evaluates commits and creates tag `vX.Y.Z` when releasable commits exist.
-4. Workflow creates the corresponding GitHub Release.
-5. CI workflow runs on that tag and publishes artifacts to PyPI.
+2. Open GitHub Actions and run `Semantic Release` on the default branch.
+3. Choose `release_type`: `auto` (default) for commit-based bump, or `patch`/`minor`/`major` to force bump manually.
+4. Workflow evaluates commits and creates tag `vX.Y.Z` when releasable commits exist.
+5. Workflow creates the corresponding GitHub Release.
+6. CI workflow runs on that tag and publishes artifacts to PyPI.
 
 Manual fallback (if needed):
 

{tryx-0.2.0 → tryx-0.4.0}/Cargo.lock

@@ -2224,7 +2224,7 @@ dependencies = [
 
 [[package]]
 name = "tryx"
-version = "0.2.0"
+version = "0.4.0"
 dependencies = [
  "async-trait",
  "chrono",

{tryx-0.2.0 → tryx-0.4.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "tryx"
-version = "0.2.0"
+version = "0.4.0"
 edition = "2024"
 readme = "README.md"
 

tryx-0.4.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: tryx
+Version: 0.4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Rust
+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: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Dist: protobuf>=5.29.6
+License-File: LICENSE
+Summary: Rust-powered Python SDK for async WhatsApp automation with typed bindings and event-driven APIs
+Keywords: whatsapp,automation,rust,pyo3,async,tokio,bot,protobuf
+Author: krypton-byte
+Maintainer: krypton-byte
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Documentation, https://krypton-byte.github.io/tryx/
+Project-URL: Homepage, https://github.com/krypton-byte/tryx
+Project-URL: Issues, https://github.com/krypton-byte/tryx/issues
+Project-URL: Repository, https://github.com/krypton-byte/tryx
+
+# Tryx
+
+[![CI](https://img.shields.io/github/actions/workflow/status/krypton-byte/tryx/CI.yml?label=CI&style=for-the-badge&logo=githubactions)](https://github.com/krypton-byte/tryx/actions/workflows/CI.yml)
+[![Release](https://img.shields.io/github/actions/workflow/status/krypton-byte/tryx/release.yml?label=Release&style=for-the-badge&logo=githubactions)](https://github.com/krypton-byte/tryx/actions/workflows/release.yml)
+[![Docs](https://img.shields.io/badge/Docs-Live-0ea5e9?style=for-the-badge&logo=readthedocs&logoColor=white)](http://krypton-byte.tech/tryx/)
+[![Python](https://img.shields.io/badge/Python-3.8%2B-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
+[![Rust](https://img.shields.io/badge/Rust-Stable-000000?style=for-the-badge&logo=rust)](https://www.rust-lang.org/)
+[![Typed](https://img.shields.io/badge/Typing-PEP%20561-0ea5e9?style=for-the-badge)](https://peps.python.org/pep-0561/)
+[![License](https://img.shields.io/github/license/krypton-byte/tryx?style=for-the-badge)](LICENSE)
+
+Tryx is a Rust-powered Python SDK for building WhatsApp automations with an async-first API, strong typing, and production-focused performance.
+
+It combines:
+
+- Rust for protocol and runtime-heavy paths
+- PyO3 for Python bindings
+- Tokio for async orchestration
+- Typed Python package distribution (`.pyi` + `py.typed`)
+
+> Note: This project is an independent developer SDK and is not affiliated with WhatsApp or Meta.
+
+## Why Tryx
+
+- Async-first architecture for event-driven bots
+- Python-friendly API with namespace-based clients
+- High-performance native core for protocol and transport workloads
+- Typed interfaces for better editor support and safer integrations
+- Supports both async and blocking runtime styles
+
+## Quick Links
+
+- Documentation: http://krypton-byte.tech/tryx/
+- Contributing Guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Command Bot Example: [examples/command_bot.py](examples/command_bot.py)
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8+
+- Rust stable toolchain
+- `uv`
+
+### Development Install (Editable)
+
+```bash
+uv sync --group dev
+uv run maturin develop
+```
+
+### Build Wheels
+
+```bash
+uv run maturin build --release
+```
+
+## Quick Start
+
+```python
+import asyncio
+from tryx.backend import SqliteBackend
+from tryx.client import Tryx, TryxClient
+from tryx.events import EvMessage
+from tryx.waproto.whatsapp_pb2 import Message
+
+backend = SqliteBackend("whatsapp.db")
+bot = Tryx(backend)
+
+@bot.on(EvMessage)
+async def on_message(client: TryxClient, event: EvMessage) -> None:
+    text = event.data.get_text() or "<non-text>"
+    chat = event.data.message_info.source.chat
+    await client.send_message(chat, Message(conversation=f"Echo: {text}"))
+
+async def main() -> None:
+    await bot.run()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Feature Overview
+
+- Event-based handlers via `@bot.on(...)`
+- Runtime client namespaces:
+  - `contact`, `chat_actions`, `community`, `newsletter`, `groups`
+  - `status`, `chatstate`, `blocking`, `polls`, `presence`, `privacy`, `profile`
+- Media upload/download and message sending helpers
+- Typed helper utilities under `tryx.helpers`
+
+For complete API coverage, see the docs site and generated API pages.
+
+## Project Layout
+
+- `src/`: Rust core bindings and runtime integration
+- `python/tryx/`: Python package surface and type stubs
+- `python/tryx/waproto/`: generated protobuf Python modules
+- `examples/`: runnable usage examples
+- `docs/`: MkDocs sources
+
+## Development Workflow
+
+```bash
+# Lint and format check
+uv run ruff check .
+uv run ruff format --check .
+
+# Validate stubs
+uv run python scripts/check_stub_parity.py
+
+# Build docs locally
+uv sync --group docs
+uv run mkdocs serve
+```
+
+## Release Workflow (Maintainers)
+
+- Release is triggered manually via GitHub Actions (`Semantic Release`).
+- Version bump is automatic from Conventional Commits:
+  - `feat` -> minor
+  - `fix` / `perf` -> patch
+  - breaking change -> major
+- The workflow creates a Git tag (`vX.Y.Z`), creates a GitHub Release, then triggers CI for publish.
+
+## Troubleshooting
+
+### Native Module Import Error
+
+If you see `ModuleNotFoundError: No module named 'tryx._tryx'`:
+
+```bash
+uv run maturin develop --release
+```
+
+### Bot Not Running
+
+Ensure the bot runtime is started (`run` or `run_blocking`) before calling runtime client methods.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution and release guidelines.
+
+## License
+
+This project is licensed under the terms in [LICENSE](LICENSE).
+