numerous-com / numerous-sdk

Numerous SDK and CLI. Use the SDK for integrating your Python apps with Numerous so you can share them with users and use the features of the Numerous platform.

Home Page:https://www.numerous.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Numerous Software Development Kit

πŸ’« The python SDK for developing apps for the numerous platform.

πŸ“₯ Simply install the SDK into your python environment with:

pip install numerous

πŸ›  And then you can simply enter the following command, to get a list of possible commands.

numerous

πŸ‘©πŸΌβ€πŸŽ“ See the numerous documentation for more information!

Badges

pypi badge CICD badge cli coverage badge sdk coverage badge

Development

Most common tasks are defined in the Makefile. Use make help to get an overview.

In order to setup pre-commit hooks, use pre-commit to to setup hooks for linters and tests. This requires pre-commit to be installed of course, and it is included in the python SDK development dependencies.

To install pre-commit and pre-push hooks

pre-commit install

And you can run them on demand

pre-commit run --all

Development of python SDK 🐍

Create a virtual environment and activate it

python -m venv ./venv
./venv/bin/activate

Install the package in editable mode (including development dependencies)

pip install -e ./python[dev]

Run the tests

make sdk-test

And the linters

make sdk-lint

Development of go CLI 🐹

The numerous CLI enables tool development.

Building and running

To build simply run make build without arguments, and the executable is stored as cli/build/numerous

Development

While developing you can run the CLI like below, inside the cli folder.

go run .

# e.g.
go run . init
go run . dev

From the root folder, you can lint with:

make cli-lint

And you can run tests with

make cli-test

Trying out Numerous app engine development

In the examples/numerous folder are two apps action.py (containing ActionTool), and parameters.py (containing ParameterTool). These can be used to test the Numerous app engine development features.

Note: You need an activate python environment with the python SDK installed. See the python sdk development section for information about how to install it.

For example, if you built using make cli-build, you can run

./cli/build/numerous dev examples/numerous/parameters.py:ParameterApp

About

Numerous SDK and CLI. Use the SDK for integrating your Python apps with Numerous so you can share them with users and use the features of the Numerous platform.

https://www.numerous.com


Languages

Language:Go 66.7%Language:Python 32.0%Language:Makefile 1.0%Language:Batchfile 0.2%Language:HTML 0.1%