Metadata-Version: 2.4
Name: littlehorse-client
Version: 0.15.0
Summary: LittleHorse is a high-performance microservice orchestration engine that allows developers to build scalable, maintainable, and observable applications
License: AGPLv3
Keywords: littlehorse
Author: LittleHorse
Author-email: engineering@littlehorse.io
Requires-Python: >=3.10,<3.14
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: authlib (>=1.6,<1.7)
Requires-Dist: grpcio (==1.69.0)
Requires-Dist: jproperties (>=2.1,<2.2)
Requires-Dist: protobuf (==6.32.1)
Requires-Dist: requests (>=2.32,<2.33)
Project-URL: Documentation, https://littlehorse.io/docs/server
Project-URL: Homepage, https://littlehorse.io
Project-URL: Repository, https://github.com/littlehorse-enterprises/littlehorse
Project-URL: issues, https://github.com/littlehorse-enterprises/littlehorse/issues
Description-Content-Type: text/markdown

# LittleHorse Python SDK

For documentation on how to use this library, please go to [the LittleHorse website](https://littlehorse.io).

For examples go to the [examples](./examples/) folder.

## Dependencies

- Install python.
- Install [pipx](https://github.com/pypa/pipx): `brew install pipx`
- Install [poetry](https://python-poetry.org/): `pipx install poetry`
- Install [poetry shell plugin](https://github.com/python-poetry/poetry-plugin-shell): `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
```

## 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 . 
```
