balena-sdk-python

KO | EN

gitlite — search

#hacktoberfest #react #ai #llm #machine-learning #rust #macos #windows #awesome #cli #awesome-list #pytorch #ios #openai

balena-sdk-python

(★ 71)

The SDK to make balena powered Python applications

balena-sdk-python Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Balena SDK
---------

The official [balena](https://balena.io/) 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
```

Example of installing on a Debian container:
```
FROM balenalib/amd64-debian:stretch

# Install python 3 and balena SDK dependencies.
RUN install_packages build-essential python3 python3-pip python3-setuptools \
    python3-dev libffi-dev libssl-dev

# Install balena python SDK in python 3.
RUN pip3 install balena-sdk
```

Example of installing on a Alpine Linux container:
```
FROM balenalib/amd64-alpine:3.9

# Install python 3 and balena SDK dependencies.
RUN install_packages build-base python3 py3-setuptools python3-dev libffi-dev openssl-dev

# Install balena python SDK in python 3.
RUN pip3 install balena-sdk
```

Platforms
---------

We also support [NodeJS SDK](https://github.com/balena-io/balena-sdk).

Basic Usage
-----------

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

Documentation
-------------

We generate markdown documentation and automatically import it into our [documentation](https://docs.balena.io/reference/sdk/python-sdk/latest).

To generate the documentation run:
```bash
python docs_generator.py > DOCUMENTATION.md
```

Deprecation policy
------------------

The balena SDK for Python uses [semver versioning](https://semver.org/), with the concepts of major, minor and patch version releases.

The latest release of the previous major version of the balena SDK will remain compatible with the balenaCloud backend services for one year from the date when the next major version is released.
For example, balena SDK v8.1.1, as the latest v8 release, would remain compatible with the balenaCloud backend for one year from the date when v9.0.0 is released.

At the end of this period, the older major version is considered deprecated and some of the functionality that depends on balenaCloud services may stop working at any time.
Users are encouraged to regularly update the balena SDK to the latest version.

Developing locally
-----
This project uses [poetry](https://python-poetry.org/) for dependency management. In order to install all the needed dependencies please run `poetry install`.

Linting and Formatting
-----
This project uses [black](https://pypi.org/project/black/) for code formatting and [flake8](https://flake8.pycqa.org/en/latest/) for linting.

To format this project please use `poetry run black . -l 120`
To verify linting you can run `poetry run flake8 --max-line-length=120`

Tests
-----

To run the tests, first create a `.env` file with your test user configuration, like below. **Do not** use credentials for users with active fleets, as the tests may be destructive.

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

[Member]
member_email=my_member_user+testsdk@balena.io
member_username=my_member_user
member_password=123456my_member_password
```

The `[Member]` section is required for membership tests. This should be a second test user that will be added to applications. The member must be manually added to the main test user's organization before running the tests. All emails must include `+testsdk` to avoid accidental deletion.

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

Then run `poetry run python -m unittest discover tests -v`. Use of poetry to run tests ensures use of its virtual environment.

Support
-------

If you're having any problem, please [raise an issue](https://github.com/balena-io/balena-sdk-python/issues/new) on GitHub and the balena team will be happy to help.

Contribute
----------

- Issue Tracker: [github.com/balena-io/balena-sdk-python/issues](https://github.com/balena-io/balena-sdk-python/issues)
- Source Code: [github.com/balena-io/balena-sdk-python](https://github.com/balena-io/balena-sdk-python)

License
-------

The project is licensed under the MIT license.

balena-sdk-python

balena-sdk-python Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

balena-sdk-python

balena-sdk-python Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README