littlehorse-client 1.1.0

LittleHorse is a high-performance microservice orchestration engine that allows developers to build scalable, maintainable, and observable applications

LittleHorse Python SDK

For documentation on how to use this library, please go to the LittleHorse website.

For examples go to the examples folder.

Dependencies

• Install python.
• Install pipx: brew install pipx
• Install poetry: pipx install poetry
• Install poetry shell plugin: poetry self add poetry-plugin-shell

Initialize

poetry install

Protobuf Compilation

../local-dev/compile-proto.sh

Run tests

poetry shell
python -m unittest discover -v

Validate Indentations

poetry run ruff check .

Validate types

poetry run mypy .

Useful Commands

Set python version:

poetry env use python3.9

Worker shutdown on Windows

littlehorse.start(...) installs shutdown hooks for SIGTERM and SIGINT. On runtimes that do not support asyncio signal handlers (for example, Windows event loops), the SDK falls back to signal.signal(...) when available. If a signal cannot be registered in the current runtime/thread, startup still continues and workers can be stopped by calling worker.stop().

Types Map

Task arguments type reference:

VariableType.JSON_OBJ: dict[str, Any]
VariableType.JSON_ARR: list[Any]
VariableType.DOUBLE:   float
VariableType.BOOL:     bool
VariableType.STR:      str
VariableType.INT:      int
VariableType.BYTES:    bytes

Python Code Formatter

poetry shell
black .