Official Python SDK for the Wandelbots
Project description
wandelbots-nova
This library provides an SDK for the Wandelbots NOVA API.
The SDK will help you to build your own apps and services on top of NOVA and makes programming a robot as easy as possible.
Requirements
This library requires
- Python >=3.10
Installation
To use the library, first install it using the following command
pip install wandelbots-nova
Usage
Import the library in your code to get started.
from nova import Nova
The SDK also includes an auto-generated API client for the NOVA API. You can access the API client using the api module.
from nova import api
Checkout the 01_basic and 02_plan_and_execute examples to learn how to use the library.
In the this directory are more examples to explain the advanced usage of the SDK.
Development
To install the development dependencies, run the following command
poetry install
Environment Variables for NOVA Configuration
- Copy the Template: Make a copy of the provided
.env.templatefile and rename it to.envwithcp .env.template .env. - Fill in the Values: Open the
.envfile in a text editor and provide the necessary values for each variable. The table below describes each variable and its usage.
| Variable | Description | Required | Default | Example |
|---|---|---|---|---|
NOVA_API |
The base URL or hostname of the NOVA server instance. | Yes | None | https://nova.example.com or http://172.0.0.1 |
NOVA_USERNAME |
The username credential used for authentication with the NOVA service. | Yes* | None | my_username |
NOVA_PASSWORD |
The password credential used in conjunction with NOVA_USERNAME. |
Yes* | None | my_password |
NOVA_ACCESS_TOKEN |
A pre-obtained access token for NOVA if using token-based authentication. | Yes* | None | eyJhbGciOi... |
Note on Authentication: You can authenticate with NOVA using either username/password credentials or a pre-obtained access token, depending on your setup and security model:
- If using username/password: Ensure both
NOVA_USERNAMEandNOVA_PASSWORDare set, and leaveNOVA_ACCESS_TOKENunset.- If using an access token: Ensure
NOVA_ACCESS_TOKENis set, and leaveNOVA_USERNAMEandNOVA_PASSWORDunset.Only one method should be used at a time. If both methods are set, the token-based authentication (
NOVA_ACCESS_TOKEN) will typically take precedence.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file wandelbots_nova-0.17.0.tar.gz.
File metadata
- Download URL: wandelbots_nova-0.17.0.tar.gz
- Upload date:
- Size: 24.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
87a6347c2e73d713717b1ba8412c59f71287c970bbf4db799f35c2b3a76bdc8e
|
|
| MD5 |
c9531b1ba3b9d347441358277c846fbb
|
|
| BLAKE2b-256 |
c72ba096060c547b59255aea384ba4a6b7258661b76435cbe45dd92d64b3357b
|
File details
Details for the file wandelbots_nova-0.17.0-py3-none-any.whl.
File metadata
- Download URL: wandelbots_nova-0.17.0-py3-none-any.whl
- Upload date:
- Size: 28.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6e763bc982073a2e102e743039cb32f8a3c0d4cbdd43147cf8977d98c99568f3
|
|
| MD5 |
c73b79dd81caa488a742f56fefe88897
|
|
| BLAKE2b-256 |
ad55c8b7b0002b4706900168cef18860cf762ce317c7f85cf01b53cd6a55f6aa
|
