ferogram 0.3.0__tar.gz → 0.4.0__tar.gz

ferogram-0.4.0/.github/workflows/compile-check.yml

@@ -0,0 +1,146 @@
+name: Compile Check
+
+on:
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: "Commit hash, branch, tag, or PR (e.g. abc1234 / main / refs/pull/12/head)"
+        required: false
+        default: "main"
+      target:
+        description: "Target platform to check"
+        required: true
+        default: linux-x86_64
+        type: choice
+        options:
+          - linux-x86_64
+          - linux-aarch64
+          - android-aarch64
+          - all
+
+jobs:
+
+  linux-x86_64:
+    if: inputs.target == 'linux-x86_64' || inputs.target == 'all'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          key: compile-check-x86_64
+
+      - name: Install maturin
+        run: pip install maturin
+
+      - name: Build (fast flags)
+        env:
+          RUSTFLAGS: "-C codegen-units=256 -C debuginfo=0"
+        run: maturin build --out dist
+
+      - name: Install wheel
+        run: pip install dist/*.whl --force-reinstall
+
+      - name: Smoke test
+        run: |
+          python3 -c "
+          from ferogram import (
+              Client, StopPropagation, ContinuePropagation, filters,
+              User, Dialog, ChatMember, Message,
+              InlineButton, InlineKeyboard,
+          )
+          print('imports ok')
+          "
+
+  linux-aarch64:
+    if: inputs.target == 'linux-aarch64' || inputs.target == 'all'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          key: compile-check-aarch64
+
+      - name: Install maturin
+        run: pip install maturin
+
+      - name: Build (fast flags)
+        env:
+          RUSTFLAGS: "-C codegen-units=256 -C debuginfo=0 -D__ARM_ARCH=8 -march=armv8-a"
+        run: maturin build --target aarch64-unknown-linux-gnu --out dist
+
+  android-aarch64:
+    if: inputs.target == 'android-aarch64' || inputs.target == 'all'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Setup Android NDK r26d
+        uses: nttld/setup-ndk@v1
+        id: ndk
+        with:
+          ndk-version: r26d
+          link-to-sdk: true
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          key: compile-check-android-aarch64
+
+      - name: Add Rust Android target
+        run: rustup target add aarch64-linux-android
+
+      - name: Install maturin
+        run: pip install maturin
+
+      - name: Fetch Termux libpython3.13
+        run: |
+          PKGS_URL="https://packages.termux.dev/apt/termux-main/dists/stable/main/binary-aarch64/Packages"
+          DEB_PATH=$(curl -sL "$PKGS_URL" | \
+            awk '/^Package: python$/{f=1} f && /^Filename:/{print $2; f=0}' | head -1)
+          mkdir -p /tmp/termux-py && cd /tmp/termux-py
+          curl -sL "https://packages.termux.dev/apt/termux-main/${DEB_PATH}" -o python.deb
+          ar x python.deb
+          tar xf data.tar.* --wildcards "*/libpython3.13*" 2>/dev/null || true
+          LIB_DIR=/tmp/termux-py/data/data/com.termux/files/usr/lib
+          if [ ! -f "$LIB_DIR/libpython3.13.so" ]; then
+            ln -sf "$(basename $(ls $LIB_DIR/libpython3.13.so* | head -1))" \
+                   "$LIB_DIR/libpython3.13.so"
+          fi
+          echo "TERMUX_LIBDIR=$LIB_DIR" >> $GITHUB_ENV
+
+      - name: Build Android wheel (fast flags)
+        env:
+          ANDROID_NDK_HOME: ${{ steps.ndk.outputs.ndk-path }}
+          ANDROID_API_LEVEL: "24"
+          PYO3_CROSS_PYTHON_VERSION: "3.13"
+          RUSTFLAGS: "-C codegen-units=256 -C debuginfo=0 -L native=${{ env.TERMUX_LIBDIR }}"
+        run: |
+          NDK_BIN=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin
+          export CC_aarch64_linux_android=$NDK_BIN/aarch64-linux-android24-clang
+          export CXX_aarch64_linux_android=$NDK_BIN/aarch64-linux-android24-clang++
+          export AR_aarch64_linux_android=$NDK_BIN/llvm-ar
+          export CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER=$NDK_BIN/aarch64-linux-android24-clang
+          maturin build \
+            --release \
+            --target aarch64-linux-android \
+            --compatibility off \
+            --out dist

{ferogram-0.3.0 → ferogram-0.4.0}/CHANGELOG.md

@@ -1,3 +1,43 @@
+## 0.4.0 (2026-06-01)
+
+### Added
+
+- **Session backends** - `FileSession`, `MemorySession`, `StringSession`, `SqliteSession`, `LibSqlSession`, and `CustomSession` are now first-class types importable from `ferogram`. Pass any of them as the `session` argument to `Client`. Plain string names still work as before.
+  - `SqliteSession("name")` stores the session in a SQLite database.
+  - `MemorySession()` keeps the session in memory only; nothing is written to disk.
+  - `StringSession("AQA...")` resumes from a base64 string, useful for serverless or env-var based deployments.
+  - `LibSqlSession.local/remote/replica/memory(...)` targets a local file, remote Turso database, embedded replica, or in-memory libSQL database.
+  - `CustomSession(obj)` wraps any Python object implementing `save(bytes)`, `load() -> bytes | None`, and `delete()`.
+- **`channel_kind()` on Message** - `await msg.channel_kind()` returns `"megagroup"`, `"broadcast"`, `"gigagroup"`, or `None`. Uses the peer cache; no RPC.
+- **`is_megagroup()` on Message** - `await msg.is_megagroup()` returns `True` for supergroups.
+- **`is_broadcast()` on Message** - `await msg.is_broadcast()` returns `True` for broadcast channels.
+- **`StopPropagation` and `ContinuePropagation`** - two exceptions exported from `ferogram` to control handler dispatch. `StopPropagation` stops all further group processing. `ContinuePropagation` skips the current handler and continues to the next match in the same group.
+- **Handler groups** - all `on_*` decorators now accept `group: int = 0`. Handlers run in ascending group order; lower group numbers run first.
+- **`add_handler` / `remove_handler`** - register and deregister handlers at runtime without decorators.
+- **Worker pool** - a fixed pool of `workers` coroutines (default 4) now dispatches updates from a bounded `asyncio.Queue`. Replaces the old unbounded `asyncio.create_task` approach. Provides natural backpressure under load.
+- **`workers` kwarg on `Client`** - controls pool size.
+- **`parse_mode` kwarg on `Client`** - sets a global default parse mode applied to every `send_message` call that does not pass its own `parse_mode`.
+- **`flood_sleep_threshold` kwarg on `Client`** - maps to the `AutoSleep` retry policy in the Rust core. Flood waits under this value are slept through automatically; waits above it are raised as exceptions.
+- **`download_with_progress(peer, msg_id, path, on_progress)`** - download media with a progress callback `on_progress(done, total)`.
+- **`upload_with_progress(path, on_progress)`** - upload a file with a progress callback. Returns a handle string accepted by `send_file`.
+- **`ferogram` 0.6.0 as core dependency** - includes `Client.channel_kind_of(channel_id)` which backs the new `Message` methods above.
+
+### Changed
+
+- `no_webpage` now defaults to `True` in `send_message` and `edit_message`.
+- `upload_file(data, name, mime)` replaced by `upload(Cursor(data), name)` internally; no change to the Python API.
+- Session resolution order is now `session_string > session object`. `in_memory=True` is deprecated in favor of `MemorySession()`.
+- Handler storage changed from `list` to `dict[group, list]`; dispatch now iterates groups in sorted order.
+- `_resolve_pm` is now used internally to merge per-call and global `parse_mode`.
+
+### Fixed
+
+- `channel_kind`, `is_megagroup`, `is_broadcast` on `Message` no longer call `get_chat_full` (an RPC) on every invocation. They read from the peer cache via `Client.channel_kind_of`.
+- Unnecessary `as i64` casts removed from `message.rs`.
+- Nested `if let` blocks collapsed to `if let ... && ...`.
+- `match ... { Some(m) => m, None => return None }` replaced with `as_ref()?`.
+
+
 ## 0.3.0 (2026-05-16)
 
 ### ferogram core upgraded to 0.5.0