Skip to main content

Substra CLI for interacting with substra-backend

Project description

Substra

CLI and SDK for interacting with Substra platform.

Table of contents

Install

To install the command line interface and the python sdk, run the following command:

pip install substra

To enable Bash completion, you need to put into your .bashrc:

eval "$(_SUBSTRA_COMPLETE=source substra)"

For zsh users add this to your .zshrc:

eval "$(_SUBSTRA_COMPLETE=source_zsh substra)"

From this point onwards, substra command line interface will have autocompletion enabled.

Running the Substra platform locally

You can run the Substra platform locally on your machine using one of the two following methods:

Usage

Credentials are required for using this tool.

CLI

substra --help

SDK

import substra

client = substra.Client()
# enjoy...

Documentation

Interacting with the Substra platform:

Implementing your assets in python:

Learning about the Substra platform:

Examples

Contributing

Setup

To setup the project in development mode, run:

pip install -e .[test]

To run all tests, use the following command:

python setup.py test

Documentation

To generate the command line interface documentation, run the following command:

python bin/generate_cli_documentation.py

Use the following command to generate the python sdk documentation:

pydocmd simple substra.sdk+ substra.sdk.Client+ > references/sdk.md

Documentation will be available in docs/ directory.

Deploy

Deployment to pypi.org should be automatic thanks to Travis but if you need to do it manually, here is what you need to do:

rm -rf dist/*
python3 setup.py sdist bdist_wheel
twine upload dist/* --verbose

Project details


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

substra-0.3.0.tar.gz (36.0 kB view details)

Uploaded Source

Built Distribution

substra-0.3.0-py3-none-any.whl (36.6 kB view details)

Uploaded Python 3

File details

Details for the file substra-0.3.0.tar.gz.

File metadata

  • Download URL: substra-0.3.0.tar.gz
  • Upload date:
  • Size: 36.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.7.1

File hashes

Hashes for substra-0.3.0.tar.gz
Algorithm Hash digest
SHA256 137130ae2e2b90813d4d631fab79429a422c442643692b5741e240ff8940fde9
MD5 dde4e009b5c14bcd846645cb29ee908e
BLAKE2b-256 36353256dbb424982f51fcc34eefc9c43c0109124ad81a5afb325ee14f714590

See more details on using hashes here.

File details

Details for the file substra-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: substra-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 36.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.7.1

File hashes

Hashes for substra-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 73de374852137facfa935f7e3b1a024a354b0fd37939090c62271fe81fa031b2
MD5 25cee551d877db19eae775e2050f3077
BLAKE2b-256 352848f68fd2353c605ba5758b0f639bbcbbb0e11cfb92c86e1a06b09df9a961

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page