substra 0.29.2

Substra CLI for interacting with substra-backend

CLI and SDK for interacting with Substra platform.

Documentation website

Table of contents

• Table of contents
• Install
• Running the Substra platform locally
• Usage
  • CLI
  • SDK
• Documentation
• Examples
• Contributing
  • Setup
  • Code formatting
  • Documentation
  • Deploy

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

Check out the open source setup guide or the close source setup guide

Before installing the different components of the platform, please have a look to the compatibility table

Usage

Credentials are required for using this tool.

CLI

substra --help

SDK

import substra

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

Open Source Documentation

• Documentation website
• Documentation repository
• Chat on Slack

Interacting with the Substra platform:

• Command line interface
• SDK

Implementing your assets in python (thanks to the substratools library)

• Dataset base class
• Algo base class
• Composite algo base class
• Aggregate algo base class

Examples

• Titanic
• Cross-validation
• Compute plan
• Debugging

Contributing

Setup

To setup the project in development mode, run:

pip install -e ".[dev]"

To run all tests, use the following command:

python setup.py test

Code formatting

You can opt into auto-formatting of code on pre-commit using Black.

This relies on hooks managed by pre-commit, which you can set up as follows.

Install pre-commit, then run:

pre-commit install

Documentation

To generate the command line interface documentation, sdk and schemas documentation, the python version must be 3.7. Run the following command:

make doc

Documentation will be available in the references/ 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