Balena SDK

The official balena SDK for python.

Role

The intention of this module is to provide developers a nice API to integrate their python applications with balena.

Installation

Install the balena SDK:

From Source:

https://github.com/balena-io/balena-sdk-python

From git:

pip install git+https://github.com/balena-io/balena-sdk-python.git

Platforms

We also support NodeJS SDK.

Basic Usage

>>> from balena import Balena
>>> balena = Balena()
>>> credentials = {'username':<your email>, 'password':<your password>}
>>> balena.auth.login(**credentials)
...

Documentation

We generate markdown documentation in DOCUMENTATION.md.

To generate the documentation:

python docs_generator.py > DOCUMENTATION.md

Tests

To run the tests, first create a .env file with your test user configuration, e.g.:

[Credentials]
email=my_test_user@balena.io
user_id=my_test_user
password=123456my_password

You can optionally change the target API endpoint too, e.g. api_endpoint=https://api.balena-cloud.com.

Then run python -m unittest discover tests -v.

Support

If you're having any problem, please raise an issue on GitHub and the balena team will be happy to help.

Contribute

• Issue Tracker: github.com/balena-io/balena-sdk-python/issues
• Source Code: github.com/balena-io/balena-sdk-python

License

The project is licensed under the MIT license.