flo-python 0.1.0__tar.gz → 0.1.0.dev3__tar.gz

flo_python-0.1.0.dev3/.gitignore

@@ -0,0 +1,142 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.log
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# ruff
+.ruff_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store

flo_python-0.1.0.dev3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Flo Team
+
+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.

{flo_python-0.1.0 → flo_python-0.1.0.dev3}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: flo-python
-Version: 0.1.0
+Version: 0.1.0.dev3
 Summary: Python SDK for the Flo distributed systems platform
 Project-URL: Homepage, https://github.com/floruntime/flo-python
 Project-URL: Documentation, https://github.com/floruntime/flo-python#readme
 Project-URL: Repository, https://github.com/floruntime/flo-python
 Author: Flo Team
 License-Expression: MIT
+License-File: LICENSE
 Keywords: async,distributed-systems,flo,kv-store,queue
 Classifier: Development Status :: 3 - Alpha
 Classifier: Framework :: AsyncIO
@@ -320,7 +321,7 @@ for record in result.records:
     try:
         process(record.payload)
         # Acknowledge successful processing
-        await client.stream.group_ack("events", "processors", [record.offset])
+        await client.stream.group_ack("events", "processors", [record.id])
     except Exception:
         # Record will be redelivered to another consumer
         pass
@@ -452,43 +453,49 @@ await client.worker.touch(
 
 ```python
 import asyncio
-from flo import FloClient, WorkerAwaitOptions, WorkerFailOptions
+from flo import FloClient
 
 async def run_worker():
-    async with FloClient("localhost:9000") as client:
-        worker_id = "worker-1"
-        task_types = ["process-image"]
-
-        # Register the worker
-        await client.worker.register(worker_id, task_types)
-
-        while True:
-            # Wait for tasks
-            result = await client.worker.await_task(
-                worker_id,
-                task_types,
-                WorkerAwaitOptions(block_ms=30000)
-            )
-
-            if not result.task:
-                continue
-
-            task = result.task
-            try:
-                # Process task
-                output = await process_image(task.input)
-                await client.worker.complete(worker_id, task.task_id, output)
-            except Exception as e:
-                await client.worker.fail(
-                    worker_id,
-                    task.task_id,
-                    str(e),
-                    WorkerFailOptions(retry=True)
-                )
+    async with FloClient("localhost:9000", namespace="myapp") as client:
+        # Create an action worker from the client
+        worker = client.new_action_worker(concurrency=5)
+
+        @worker.action("process-image")
+        async def process_image(ctx):
+            data = ctx.json()
+            result = await do_processing(data)
+            return ctx.to_bytes({"status": "done"})
+
+        await worker.start()
 
 asyncio.run(run_worker())
 ```
 
+### StreamWorker Example
+
+```python
+import asyncio
+from flo import FloClient, StreamContext
+
+async def process_event(ctx: StreamContext) -> None:
+    event = ctx.json()
+    print(f"Got event: {event}")
+    # Return normally → auto-ack
+    # Raise an exception → auto-nack (redelivery)
+
+async def run_stream_worker():
+    async with FloClient("localhost:9000", namespace="myapp") as client:
+        worker = client.new_stream_worker(
+            stream="events",
+            group="processors",
+            handler=process_event,
+            concurrency=5,
+        )
+        await worker.start()
+
+asyncio.run(run_stream_worker())
+```
+
 ## Configuration
 
 ### Client Options

{flo_python-0.1.0 → flo_python-0.1.0.dev3}/README.md

@@ -291,7 +291,7 @@ for record in result.records:
     try:
         process(record.payload)
         # Acknowledge successful processing
-        await client.stream.group_ack("events", "processors", [record.offset])
+        await client.stream.group_ack("events", "processors", [record.id])
     except Exception:
         # Record will be redelivered to another consumer
         pass
@@ -423,43 +423,49 @@ await client.worker.touch(
 
 ```python
 import asyncio
-from flo import FloClient, WorkerAwaitOptions, WorkerFailOptions
+from flo import FloClient
 
 async def run_worker():
-    async with FloClient("localhost:9000") as client:
-        worker_id = "worker-1"
-        task_types = ["process-image"]
-
-        # Register the worker
-        await client.worker.register(worker_id, task_types)
-
-        while True:
-            # Wait for tasks
-            result = await client.worker.await_task(
-                worker_id,
-                task_types,
-                WorkerAwaitOptions(block_ms=30000)
-            )
-
-            if not result.task:
-                continue
-
-            task = result.task
-            try:
-                # Process task
-                output = await process_image(task.input)
-                await client.worker.complete(worker_id, task.task_id, output)
-            except Exception as e:
-                await client.worker.fail(
-                    worker_id,
-                    task.task_id,
-                    str(e),
-                    WorkerFailOptions(retry=True)
-                )
+    async with FloClient("localhost:9000", namespace="myapp") as client:
+        # Create an action worker from the client
+        worker = client.new_action_worker(concurrency=5)
+
+        @worker.action("process-image")
+        async def process_image(ctx):
+            data = ctx.json()
+            result = await do_processing(data)
+            return ctx.to_bytes({"status": "done"})
+
+        await worker.start()
 
 asyncio.run(run_worker())
 ```
 
+### StreamWorker Example
+
+```python
+import asyncio
+from flo import FloClient, StreamContext
+
+async def process_event(ctx: StreamContext) -> None:
+    event = ctx.json()
+    print(f"Got event: {event}")
+    # Return normally → auto-ack
+    # Raise an exception → auto-nack (redelivery)
+
+async def run_stream_worker():
+    async with FloClient("localhost:9000", namespace="myapp") as client:
+        worker = client.new_stream_worker(
+            stream="events",
+            group="processors",
+            handler=process_event,
+            concurrency=5,
+        )
+        await worker.start()
+
+asyncio.run(run_stream_worker())
+```
+
 ## Configuration
 
 ### Client Options

flo_python-0.1.0.dev3/examples/stream_worker.py

@@ -0,0 +1,76 @@
+"""Example: StreamWorker usage with the Flo Python SDK
+
+Demonstrates how to use StreamWorker to process stream records
+via consumer groups with automatic ack/nack handling.
+"""
+
+import asyncio
+import logging
+import os
+import signal
+
+from flo import FloClient, StreamContext
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+)
+logger = logging.getLogger(__name__)
+
+
+async def process_event(ctx: StreamContext) -> None:
+    """Process a stream record.
+
+    Return normally to auto-ack. Raise an exception to auto-nack
+    (the record will be redelivered).
+    """
+    event = ctx.json()
+    logger.info(
+        f"Processing event (stream={ctx.stream}, id={ctx.stream_id}): {event}"
+    )
+
+    # Simulate work
+    await asyncio.sleep(0.1)
+
+    # If processing fails, just raise — the worker will nack for you:
+    # raise RuntimeError("transient failure")
+
+
+async def main():
+    client = FloClient(
+        os.getenv("FLO_ENDPOINT", "localhost:3000"),
+        namespace=os.getenv("FLO_NAMESPACE", "myapp"),
+        debug=os.getenv("FLO_DEBUG", "").lower() in ("1", "true"),
+    )
+    await client.connect()
+
+    worker = client.new_stream_worker(
+        stream="events",
+        group="processors",
+        handler=process_event,
+        concurrency=5,
+        batch_size=10,
+    )
+
+    # Handle shutdown signals
+    def signal_handler():
+        logger.info("Received shutdown signal")
+        worker.stop()
+
+    loop = asyncio.get_running_loop()
+    for sig in (signal.SIGINT, signal.SIGTERM):
+        loop.add_signal_handler(sig, signal_handler)
+
+    logger.info("Starting stream worker...")
+    try:
+        await worker.start()
+    except KeyboardInterrupt:
+        logger.info("Interrupted")
+    finally:
+        await worker.close()
+        await client.close()
+        logger.info("Stream worker shutdown complete")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

flo_python-0.1.0.dev3/examples/test_decorator.py

@@ -0,0 +1,44 @@
+"""Minimal test: register an action using only the @worker.action decorator."""
+import asyncio
+import logging
+import signal
+from flo import FloClient, ActionContext
+
+logging.basicConfig(level=logging.DEBUG, format="%(asctime)s %(levelname)s %(name)s: %(message)s")
+
+
+async def main():
+    client = FloClient("localhost:9000", namespace="default", debug=True)
+    await client.connect()
+    print(f"Connected: {client.is_connected}")
+
+    worker = client.new_action_worker(concurrency=1)
+
+    @worker.action("health-check")
+    async def health_check(ctx: ActionContext) -> bytes:
+        return ctx.to_bytes({"status": "healthy"})
+
+    stop = asyncio.Event()
+
+    def on_signal():
+        print("Shutting down...")
+        worker.stop()
+        stop.set()
+
+    loop = asyncio.get_running_loop()
+    for sig in (signal.SIGINT, signal.SIGTERM):
+        loop.add_signal_handler(sig, on_signal)
+
+    print("Starting worker with @worker.action('health-check')...")
+    try:
+        await worker.start()
+    except KeyboardInterrupt:
+        pass
+    finally:
+        await worker.close()
+        await client.close()
+        print("Done.")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{flo_python-0.1.0 → flo_python-0.1.0.dev3}/examples/worker.py

@@ -9,7 +9,7 @@ import os
 import signal
 from dataclasses import dataclass
 
-from flo import ActionContext, Worker
+from flo import ActionContext, FloClient
 
 # Configure logging
 logging.basicConfig(
@@ -158,13 +158,18 @@ async def generate_report(ctx: ActionContext) -> bytes:
 
 
 async def main():
-    # Create worker with configuration
-    worker = Worker(
-        endpoint=os.getenv("FLO_ENDPOINT", "localhost:3000"),
+    # Create and connect client (shared configuration)
+    client = FloClient(
+        os.getenv("FLO_ENDPOINT", "localhost:3000"),
         namespace=os.getenv("FLO_NAMESPACE", "myapp"),
+        debug=os.getenv("FLO_DEBUG", "").lower() in ("1", "true"),
+    )
+    await client.connect()
+
+    # Create a worker from the client
+    worker = client.new_action_worker(
         concurrency=5,
         action_timeout=300,  # 5 minutes
-        debug=os.getenv("FLO_DEBUG", "").lower() in ("1", "true"),
     )
 
     # Register action handlers using register_action()
@@ -202,6 +207,7 @@ async def main():
         logger.info("Interrupted")
     finally:
         await worker.close()
+        await client.close()
         logger.info("Worker shutdown complete")
 
 

{flo_python-0.1.0 → flo_python-0.1.0.dev3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "flo-python"
-version = "0.1.0"
+version = "0.1.0.dev3"
 description = "Python SDK for the Flo distributed systems platform"
 readme = "README.md"
 license = "MIT"
@@ -45,6 +45,8 @@ packages = ["src/flo"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
 testpaths = ["tests"]
 
 [tool.mypy]