Endless Python SDK

This provides basic functionalities to interact with Endless. Get started here.

Currently, this is still in development and may not be suitable for production purposes.

Note: The sync client is deprecated, please only start new projects using the async client. Feature contributions to the sync client will be rejected.

Requirements

This SDK uses Poetry for packaging and dependency management:

curl -sSL https://install.python-poetry.org | python3 -
poetry install

Unit testing

make test

E2E testing and Using the Endless CLI

• Download and install the Endless CLI.
• Set the environment variable ENDLESS_CLI_PATH to the full path of the CLI.
• Retrieve the Endless Core Github Repo (git clone https://github.com/endless-labs/endless-move-framework.git)
• Set the environment variable ENDLESS_CORE_REPO to the full path of the Repository.
• make integration_test

You can do this a bit more manually by:

First, run a local testnet (run this from the root of endless-framework):

endless node run-local-testnet --force-restart --assume-yes --with-indexer-api

Next, tell the end-to-end tests to talk to this locally running testnet:

export ENDLESS_CORE_REPO="/path/to/repo"
export ENDLESS_FAUCET_URL="http://127.0.0.1:8081"
export ENDLESS_INDEXER_URL="https://idx-test.endless.link/api/v1"
export ENDLESS_NODE_URL="https://rpc-test.endless.link/v1"

Finally run the tests:

make examples

Integration Testing Using the Endless CLI:

make integration_test

[!NOTE] The Python SDK does not require the Indexer, if you would prefer to test without it, unset or do not set the environmental variable ENDLESS_INDEXER_URL and exclude --with-indexer-api from running the endless node software.

Autoformatting

make fmt

Autolinting

make lint

Package Publishing

• Download the ENDLESS CLI.
• Set the environment variable ENDLESS_CLI_PATH to the full path of the CLI.
• poetry run python -m endless_sdk.cli and set the appropriate command-line parameters

Semantic versioning

This project follows semver as closely as possible