fluxqueue 0.2.0__tar.gz → 0.2.1__tar.gz

{fluxqueue-0.2.0 → fluxqueue-0.2.1}/Cargo.lock

@@ -263,7 +263,7 @@ dependencies = [
 
 [[package]]
 name = "fluxqueue-worker"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "anyhow",
  "chrono",
@@ -286,7 +286,7 @@ dependencies = [
 
 [[package]]
 name = "fluxqueue_core"
-version = "0.2.0"
+version = "0.2.1"
 dependencies = [
  "deadpool-redis",
  "fluxqueue-common",

fluxqueue-0.2.1/Cargo.toml

@@ -0,0 +1,12 @@
+[workspace]
+members = ["crates/*"]
+resolver = "3"
+
+[workspace.package]
+edition = "2024"
+repository = "https://github.com/CCXLV/fluxqueue"
+homepage = "https://fluxqueue.ccxlv.dev"
+authors = ["Giorgi Merebashvili <mereba2627@gmail.com>"]
+
+[workspace.dependencies]
+fluxqueue-common = { path = "./crates/fluxqueue-common" }

{fluxqueue-0.2.0 → fluxqueue-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fluxqueue
-Version: 0.2.0
+Version: 0.2.1
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
@@ -31,6 +31,7 @@ Provides-Extra: tests
 License-File: LICENSE
 Summary: A lightweight, resource-efficient, high-throughput task queue for Python, written in Rust.
 Keywords: task-queue,queue,redis,async,background-tasks,worker,rust,fluxqueue
+Home-Page: https://fluxqueue.ccxlv.dev
 Author-email: Giorgi Merebashvili <mereba2627@gmail.com>
 License-Expression: Apache-2.0
 Requires-Python: >=3.11, <3.15

fluxqueue-0.2.1/crates/fluxqueue-core/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "fluxqueue_core"
+version = "0.2.1"
+repository.workspace = true
+homepage.workspace = true
+authors.workspace = true
+edition.workspace = true
+
+[dependencies]
+pyo3 = { version = "0.27.2", features = ["experimental-async"] }
+pyo3-async-runtimes = { version = "0.27.0", features = ["tokio-runtime"] }
+tokio = { version = "1.49.0", features = ["rt-multi-thread", "sync"] }
+deadpool-redis = { version = "0.22.1", features = ["rt_tokio_1"] }
+fluxqueue-common.workspace = true

{fluxqueue-0.2.0 → fluxqueue-0.2.1/crates/fluxqueue-core}/src/lib.rs

@@ -75,7 +75,7 @@ impl FluxQueueCore {
 }
 
 #[pymodule]
-fn fluxqueue_core(m: &Bound<'_, PyModule>) -> PyResult<()> {
+fn _core(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_class::<FluxQueueCore>()?;
     Ok(())
 }

{fluxqueue-0.2.0 → fluxqueue-0.2.1}/pyproject.toml

@@ -55,8 +55,9 @@ docs = [
 build = ["maturin"]
 
 [tool.maturin]
-python-source = "."
-module-name = "fluxqueue.fluxqueue_core"
+module-name = "fluxqueue._core"
+python-source = "python"
+manifest-path = "crates/fluxqueue-core/Cargo.toml"
 
 [tool.ruff]
 line-length = 88

fluxqueue-0.2.1/python/fluxqueue/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["FluxQueue"]
+
+from .client import FluxQueue

fluxqueue-0.2.0/fluxqueue/core.py → fluxqueue-0.2.1/python/fluxqueue/client.py

@@ -1,13 +1,12 @@
 import inspect
-from collections.abc import Callable
+from collections.abc import Callable, Coroutine
 from functools import wraps
-from typing import Any, ParamSpec, TypeAlias, cast
+from typing import Any, ParamSpec, cast, get_type_hints, overload
 
-from .fluxqueue_core import FluxQueueCore
+from ._core import FluxQueueCore
 from .utils import get_task_name
 
 P = ParamSpec("P")
-TaskDecorator: TypeAlias = Callable[[Callable[P, Any]], Callable[P, Any]]
 
 
 class FluxQueue:
@@ -30,7 +29,7 @@ class FluxQueue:
         name: str | None = None,
         queue: str = "default",
         max_retries: int = 3,
-    ) -> TaskDecorator[P]:
+    ):
         """
         Mark a function as a FluxQueue task.
 
@@ -52,7 +51,23 @@ class FluxQueue:
             before treating it as dead.
         """
 
-        def decorator(func: Callable[P, Any]) -> Callable[P, Any]:
+        @overload
+        def decorator(func: Callable[P, None]) -> Callable[P, None]: ...
+
+        @overload
+        def decorator(
+            func: Callable[P, Coroutine[Any, Any, None]],
+        ) -> Callable[P, Coroutine[Any, Any, None]]: ...
+
+        def decorator(
+            func: Callable[P, None | Coroutine[Any, Any, None]],
+        ) -> Callable[P, None | Coroutine[Any, Any, None]]:
+            type_hints = get_type_hints(func)
+            return_type = type_hints.get("return")
+
+            if return_type and return_type is not type(None):
+                raise TypeError(f"Task function must return None, got {return_type}")
+
             is_async = inspect.iscoroutinefunction(func)
             task_name = get_task_name(func, name)
 

fluxqueue-0.2.0/.github/actions/build-package/action.yml

@@ -1,39 +0,0 @@
-name: "Build Python Package"
-description: "Build and package the library"
-inputs:
-  python-version:
-    description: "Python version"
-    required: true
-
-runs:
-  using: composite
-  steps:
-    - uses: actions/checkout@v4
-    - uses: actions/setup-python@v5
-      with:
-        python-version: ${{ inputs.python-version }}
-    - name: Set target based on OS and arch
-      shell: bash
-      run: |
-        if [[ "${RUNNER_OS}" == "Linux" ]]; then
-          echo "TARGET=x86_64-unknown-linux-gnu" >> $GITHUB_ENV
-        elif [[ "${RUNNER_OS}" == "macOS" ]]; then
-          if [[ "${RUNNER_ARCH}" == "ARM64" ]]; then
-            echo "TARGET=aarch64-apple-darwin" >> $GITHUB_ENV
-          else
-            echo "TARGET=x86_64-apple-darwin" >> $GITHUB_ENV
-          fi
-        elif [[ "${RUNNER_OS}" == "Windows" ]]; then
-          echo "TARGET=x86_64-pc-windows-msvc" >> $GITHUB_ENV
-        fi
-    - name: Build wheels
-      uses: PyO3/maturin-action@v1
-      with:
-        target: ${{ env.TARGET }}
-        args: --release --out dist --find-interpreter
-        sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
-    - name: Upload wheels
-      uses: actions/upload-artifact@v4
-      with:
-        name: wheels-${{ inputs.python-version }}-${{ env.TARGET }}
-        path: dist

fluxqueue-0.2.0/.github/actions/build-worker/action.yml

@@ -1,75 +0,0 @@
-name: "Build Worker"
-description: "Build worker"
-inputs:
-  python-version:
-    description: "Python version to use"
-    required: true
-
-runs:
-  using: composite
-  steps:
-    - name: Checkout repository
-      uses: actions/checkout@v4
-
-    - name: Set target based on OS and arch
-      shell: bash
-      run: |
-        if [[ "${RUNNER_OS}" == "Linux" ]]; then
-          echo "TARGET=x86_64-unknown-linux-gnu" >> $GITHUB_ENV
-        elif [[ "${RUNNER_OS}" == "macOS" ]]; then
-          if [[ "${RUNNER_ARCH}" == "ARM64" ]]; then
-            echo "TARGET=aarch64-apple-darwin" >> $GITHUB_ENV
-          else
-            echo "TARGET=x86_64-apple-darwin" >> $GITHUB_ENV
-          fi
-        elif [[ "${RUNNER_OS}" == "Windows" ]]; then
-          echo "TARGET=x86_64-pc-windows-msvc" >> $GITHUB_ENV
-        fi
-
-    - name: Set up Python ${{ inputs.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ inputs.python-version }}
-
-    - name: Install Rust
-      uses: dtolnay/rust-toolchain@stable
-
-    - name: Cache Rust
-      uses: Swatinem/rust-cache@v2
-
-    - name: Build
-      shell: bash -euxo pipefail {0}
-      run: scripts/build-worker.sh ${{ env.TARGET }}
-
-    - name: Package the worker (Linux)
-      if: runner.os == 'Linux'
-      shell: bash -euxo pipefail {0}
-      run: |
-        cd dist
-        mv fluxqueue-worker-${{ env.TARGET }} fluxqueue-worker
-        tar -czvf fluxqueue-${{ github.ref_name }}-py${{ inputs.python-version }}-linux-x86_64.tar.gz fluxqueue-worker
-        rm fluxqueue-worker
-
-    - name: Package the worker (macOS)
-      if: runner.os == 'macOS'
-      shell: bash -euxo pipefail {0}
-      run: |
-        cd dist
-        mv fluxqueue-worker-${{ env.TARGET }} fluxqueue-worker
-        zip fluxqueue-${{ github.ref_name }}-py${{ inputs.python-version }}-${{ env.TARGET }}.zip fluxqueue-worker
-        rm fluxqueue-worker
-
-    - name: Package the worker (Windows)
-      if: runner.os == 'Windows'
-      shell: pwsh
-      run: |
-        cd dist
-        mv fluxqueue-worker-${{ env.TARGET }}.exe fluxqueue-worker.exe
-        Compress-Archive -Path fluxqueue-worker.exe -DestinationPath fluxqueue-${{ github.ref_name }}-py${{ inputs.python-version }}-windows-x86_64.zip 
-        rm fluxqueue-worker.exe
-
-    - name: Upload build artifact
-      uses: actions/upload-artifact@v4
-      with:
-        name: fluxqueue-worker-${{ env.TARGET }}-py${{ inputs.python-version }}
-        path: dist/*

fluxqueue-0.2.0/.github/actions/tests/action.yml

@@ -1,33 +0,0 @@
-name: "Run Python and Rust Tests"
-description: "Standardized test suite with strict shell"
-inputs:
-  python-version:
-    description: "Python version to use"
-    required: true
-
-runs:
-  using: composite
-  steps:
-    - name: Set up Python ${{ inputs.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ inputs.python-version }}
-        cache: pip
-
-    - name: Install dependencies
-      shell: bash -euxo pipefail {0}
-      run: |
-        python -m pip install --upgrade pip
-        pip install -e .[tests]
-
-    - name: Set up Rust
-      uses: dtolnay/rust-toolchain@stable
-
-    - name: Rust Cache
-      uses: Swatinem/rust-cache@v2
-
-    - name: Run Tests
-      shell: bash -euxo pipefail {0}
-      run: |
-        pytest tests/
-        cargo test --workspace --locked

fluxqueue-0.2.0/.github/workflows/deploy-docs.yml

@@ -1,33 +0,0 @@
-name: Deploy Docs
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  deploy-docs:
-    if: (github.repository_owner == 'ccxlv')
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-
-      - name: Setup Python3.13
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.13"
-
-      - name: Install Dependencies
-        run: pip install -e .[docs]
-
-      - name: Build Docs
-        run: mkdocs build
-
-      - name: Deploy Docs
-        uses: cloudflare/wrangler-action@v3
-        with:
-          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
-          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
-          command: pages deploy site/ --project-name=fluxqueue

fluxqueue-0.2.0/.github/workflows/publish.yml

@@ -1,68 +0,0 @@
-# This file is autogenerated by maturin v1.10.2
-# To update, run
-#
-#    maturin generate-ci github
-#
-name: Publish to PyPI
-
-on:
-  release:
-    types: [published]
-
-permissions:
-  contents: read
-
-jobs:
-  build:
-    if: github.repository_owner == 'ccxlv' && startsWith(github.event.release.tag_name, 'v')
-    name: ${{ matrix.os }} (Py ${{ matrix.python-version }})
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, macos-15-intel, windows-latest]
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-      - name: Run Build Suite
-        uses: ./.github/actions/build-package
-        with:
-          python-version: ${{ matrix.python-version }}
-
-  sdist:
-    if: github.repository_owner == 'ccxlv' && startsWith(github.event.release.tag_name, 'v')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - 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:
-    if: github.repository_owner == 'ccxlv' && startsWith(github.event.release.tag_name, 'v')
-    name: Release
-    runs-on: ubuntu-latest
-    needs: [build, sdist]
-    permissions:
-      id-token: write
-      contents: write
-      attestations: write
-    steps:
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
-      - name: Download artifacts
-        uses: actions/download-artifact@v4
-        with:
-          path: dist
-      - name: Generate artifact attestation
-        uses: actions/attest-build-provenance@v2
-        with:
-          subject-path: "dist/**/*"
-      - name: Publish to PyPI
-        run: uv publish "dist/**/*"

fluxqueue-0.2.0/.github/workflows/release-worker.yml

@@ -1,55 +0,0 @@
-name: Release Worker
-
-on:
-  push:
-    tags:
-      - worker-v*
-
-jobs:
-  check-main:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-      - name: Ensure tag is on main
-        run: |
-          git fetch origin main
-          git merge-base --is-ancestor "$GITHUB_SHA" origin/main
-
-  build:
-    if: github.repository_owner == 'ccxlv'
-    name: ${{ matrix.os }} (Py ${{ matrix.python-version }})
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, macos-15-intel, windows-latest]
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-      - name: Run Build Suite
-        uses: ./.github/actions/build-worker
-        with:
-          python-version: ${{ matrix.python-version }}
-
-  release:
-    if: github.repository_owner == 'ccxlv'
-    needs: [build]
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Download artifacts
-        uses: actions/download-artifact@v4
-        with:
-          path: artifacts
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: ${{ github.ref_name }}
-          name: ${{ github.ref_name }}
-          files: artifacts/**/*
-          draft: false
-          prerelease: false

fluxqueue-0.2.0/.github/workflows/tests.yml

@@ -1,68 +0,0 @@
-name: Tests
-
-on:
-  pull_request:
-    branches:
-      - "**"
-  push:
-    branches:
-      - main
-
-jobs:
-  # TODO: Add another job that will determine which tests to run based on push types and the changes that were made.
-  check-style:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-      - uses: Swatinem/rust-cache@v2
-      - uses: pnpm/action-setup@v4
-        with:
-          version: 9
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.13"
-      - run: |
-          pip install -e .[dev]
-          scripts/check-prettier.sh
-          ruff check .
-          cargo fmt --all -- --check
-          cargo clippy --workspace -- -D warnings
-
-  tests:
-    name: ${{ matrix.os }} (Py ${{ matrix.python-version }})
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, macos-15-intel]
-        python-version: ["3.11", "3.12", "3.13", "3.14"]
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install Redis (Linux)
-        if: runner.os == 'Linux'
-        shell: bash -euxo pipefail {0}
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y redis-server
-          sudo systemctl start redis-server
-
-      - name: Install Redis (macOS)
-        if: runner.os == 'macOS'
-        shell: bash -euxo pipefail {0}
-        run: |
-          brew install redis
-          brew services start redis
-
-      - name: Run Test Suite
-        uses: ./.github/actions/tests
-        with:
-          python-version: ${{ matrix.python-version }}
-
-  tests-pass:
-    if: (github.repository_owner == 'ccxlv')
-    needs: [check-style, tests]
-    runs-on: ubuntu-latest
-    steps:
-      - run: echo "All tests passed ✅"

fluxqueue-0.2.0/.gitignore

@@ -1,13 +0,0 @@
-target/
-_tests/
-
-.venv*
-.env
-
-fluxqueue_core.cp**
-__pycache__/
-.ruff_cache/
-.pytest_cache/
-
-site/
-dist/

fluxqueue-0.2.0/Cargo.toml

@@ -1,28 +0,0 @@
-[workspace]
-members = ["crates/fluxqueue-common"]
-
-[workspace.package]
-repository = "https://github.com/CCXLV/fluxqueue"
-homepage = "https://fluxqueue.ccxlv.dev"
-authors = ["Giorgi Merebashvili <mereba2627@gmail.com>"]
-edition = "2024"
-
-[package]
-name = "fluxqueue_core"
-version = "0.2.0"
-edition = "2024"
-readme = "README.md"
-
-[lib]
-name = "fluxqueue_core"
-crate-type = ["cdylib"]
-
-[dependencies]
-pyo3 = { version = "0.27.2", features = ["experimental-async"] }
-pyo3-async-runtimes = { version = "0.27.0", features = ["tokio-runtime"] }
-tokio = { version = "1.49.0", features = ["rt-multi-thread", "sync"] }
-deadpool-redis = { version = "0.22.1", features = ["rt_tokio_1"] }
-fluxqueue-common = { path = "./crates/fluxqueue-common" }
-
-[workspace.dependencies]
-fluxqueue-common = { path = "./crates/fluxqueue-common" }

fluxqueue-0.2.0/docs/about.md

@@ -1,5 +0,0 @@
-# About
-
-FluxQueue is created and maintained by [CCXLV](https://github.com/CCXLV).
-
-You can find more about me and my work at [ccxlv.dev](https://ccxlv.dev).

fluxqueue-0.2.0/docs/api/environment.md

@@ -1,10 +0,0 @@
-# Environment Variables (Worker)
-
-These environment variables configure the worker and are equivalent to the CLI flags documented in the worker tutorial:
-
-- `FLUXQUEUE_CONCURRENCY` – number of tasks processed in parallel.
-- `FLUXQUEUE_REDIS_URL` – Redis connection URL.
-- `FLUXQUEUE_TASKS_MODULE_PATH` – Python module path where tasks are exposed.
-- `FLUXQUEUE_QUEUE` – queue name to listen on.
-
-See the [**Worker**](../tutorial/worker.md) tutorial for detailed behavior and examples.

fluxqueue-0.2.0/docs/api/fluxqueue.md

@@ -1,14 +0,0 @@
-# `FluxQueue` class
-
-This page documents the main Python entry point for FluxQueue.  
-`FluxQueue` is the object you create in your app to enqueue work into Redis for the worker to process.
-
-You can import the `FluxQueue` class from `fluxqueue`:
-
-```python
-from fluxqueue import FluxQueue
-```
-
-::: fluxqueue.FluxQueue
-options:
-members: - task

fluxqueue-0.2.0/docs/api/index.md

@@ -1,7 +0,0 @@
-# API Reference
-
-This section documents the public Python API exposed by FluxQueue.  
-It focuses on what is available (classes, methods, environment variables), not on step-by-step usage.
-
-If you are looking for how to install and use FluxQueue in a project, start with the
-[Installation](../tutorial/installation.md) and [Quick Start](../tutorial/quickstart.md) guides instead.