Add a Python SDK: flows declared in your own repository
A data scientist keeps their code where it is and decorates it: `@node` declares a function's ports beside the function, `Flow(name, nodes=[...])` says which of them make a flow, and `use(fn, wire=..., **settings)` rebinds one for a single flow. `fluksio sync` uploads the document plus a generated import shim per node, so the store still holds a complete, runnable, git-versioned definition while the code it imports stays theirs. `fluksio login|run|runs` and `flow.submit().wait()` are the client half, over the run endpoints that already existed. Runs record the user repository's commit beside the store's, so "what code produced this number" is answerable on the side that now holds the code. - `fluksio/sdk/`: ports, decorators, the flow builder and its checks, the shim generator, an HTTP client and sync. Standard library only at import, so `from fluksio import node` in a training script pulls in no engine. - `FlowDef.origin` marks a flow code-defined; `Run.origin_commit` carries the repository's commit; `POST /modules/refresh` retires the workers without an install, which every sync calls — a worker holds the imported package in memory, so an edit to it is invisible until the process goes. - The canvas shows a generated body read-only and names the repository to edit instead; a body edited there stops the next sync rather than being discarded. - The worker's reporter carries inert `Port`, `node`, `use` and `Flow`, since the shim imports a module whose first line declares them. - `examples/myresearch` is the worked example, `make sync-example` uploads it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012ue1tkFWB1bcGy3aWhCKpU
This commit is contained in:
@@ -3,7 +3,7 @@
|
||||
# The workspace root delegates to these (see ../Makefile).
|
||||
|
||||
.PHONY: dev-utils dev dev-local dev-lan up down update install dev-backend dev-frontend \
|
||||
generate-client seed-example seed-demo seed-house seed-aircon seed-tinyhouse seed-hosted-demo test test-backend test-frontend soak bench-startup lint lint-backend \
|
||||
generate-client seed-example seed-demo sync-example seed-house seed-aircon seed-tinyhouse seed-hosted-demo test test-backend test-frontend soak bench-startup lint lint-backend \
|
||||
lint-frontend format-frontend umami build docs docs-serve clean help
|
||||
|
||||
COMPOSE_ROOT := $(CURDIR)
|
||||
@@ -106,6 +106,12 @@ seed-example: ## Seed the querying-chart example (needs a running stack + Influ
|
||||
seed-demo: ## Seed the training-run example: a batch flow and its dashboard
|
||||
cd backend && uv run python ../scripts/seed_demo_training.py
|
||||
|
||||
sync-example: ## Upload `examples/myresearch` the way a data scientist would
|
||||
# The same command the docs give, against whichever engine `fluksio login`
|
||||
# last talked to. The nodes import the package from this checkout, so the
|
||||
# engine has to be one that can see this path.
|
||||
cd backend && uv run fluksio sync ../examples/myresearch
|
||||
|
||||
seed-house: ## Seed the house write-path rig (needs the real broker reachable)
|
||||
cd backend && uv run python ../scripts/seed_house_control.py
|
||||
|
||||
|
||||
Reference in New Issue
Block a user