Metadata-Version: 2.1
Name: substra
Version: 0.7.1
Summary: Substra CLI for interacting with substra-backend
Home-page: https://github.com/SubstraFoundation/substra
Author: Owkin
Author-email: fldev@owkin.com
License: Apache 2.0
Description: # ![Substra](./substra-logo.svg)
        
        CLI and SDK for interacting with Substra platform.
        
        [Documentation website](https://doc.substra.ai/)
        
        ## Table of contents
        
        - [Install](#install)
        - [Running the Substra platform locally](#running-the-substra-platform-locally)
        - [Usage](#usage)
          - [CLI](#cli)
          - [SDK](#sdk)
        - [Documentation](#documentation)
        - [Examples](#examples)
        - [Compatibility table](#compatibility-table)
        - [Contributing](#contributing)
          - [Setup](#setup)
          - [Documentation](#documentation-1)
          - [Deploy](#deploy)
        
        ## Install
        
        To install the command line interface and the python sdk, run the following command:
        
        ```sh
        pip install substra
        ```
        
        To enable Bash completion, you need to put into your .bashrc:
        
        ```sh
        eval "$(_SUBSTRA_COMPLETE=source substra)"
        ```
        
        For zsh users add this to your .zshrc:
        
        ```sh
        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 [setup guide](https://doc.substra.ai/setup/local_install_skaffold.html).
        
        ## Usage
        
        Credentials are required for using this tool.
        
        ### CLI
        
        ```sh
        substra --help
        ```
        
        ### SDK
        
        ```python
        import substra
        
        client = substra.Client()
        # enjoy...
        ```
        
        ## Documentation
        
        - Documentation [website](https://doc.substra.ai)
        - Documentation [repository](https://github.com/SubstraFoundation/substra-documentation)
        - Chat on [Slack](https://substra-workspace.slack.com)
        
        Interacting with the Substra platform:
        
        - [Command line interface](./references/cli.md)
        - [SDK](./references/sdk.md)
        
        Implementing your assets in python (thanks to [the substratools library](https://github.com/substrafoundation/substra-tools))
        
        - [Objective base class](https://github.com/SubstraFoundation/substra-tools/blob/master/docs/api.md#metrics)
        - [Dataset base class](https://github.com/SubstraFoundation/substra-tools/blob/master/docs/api.md#opener)
        - [Algo base class](https://github.com/SubstraFoundation/substra-tools/blob/master/docs/api.md#algo)
        - [Composite algo base class](https://github.com/SubstraFoundation/substra-tools/blob/master/docs/api.md#compositealgo)
        - [Aggregate algo base class](https://github.com/SubstraFoundation/substra-tools/blob/master/docs/api.md#aggregatealgo)
        
        ## Examples
        
        - [Titanic](./examples/titanic/README.md)
        - [Cross-validation](./examples/cross_val/README.md)
        - [Compute plan](./examples/compute_plan/README.md)
        - [Debugging](./examples/debugging/README.md)
        
        ## Compatibility table
        
        These sets of versions have been tested for compatilibility:
        
        | substra  | substra-chaincode  | substra-backend  | substra-tests  | hlf-k8s  | substra-frontend  | substra-tools |
        |---|---|---|---|---|---| --- |
        | [`0.4.0-alpha.3`](https://github.com/SubstraFoundation/substra/releases/tag/0.4.0-alpha.3) | [`0.0.8-alpha.6`](https://github.com/SubstraFoundation/substra-chaincode/releases/tag/0.0.8-alpha.6) | [`0.0.12-alpha.13`](https://github.com/SubstraFoundation/substra-backend/releases/tag/0.0.12-alpha.13) | [`0.2.0-alpha.1`](https://github.com/SubstraFoundation/substra-tests/releases/tag/0.2.0-alpha.1) | [`0.0.11-alpha.1`](https://github.com/SubstraFoundation/hlf-k8s/releases/tag/0.0.11-alpha.1) | [`0.0.16`](https://github.com/SubstraFoundation/substra-frontend/releases/tag/0.0.16) | |
        | [`0.4.0-alpha.4`](https://github.com/SubstraFoundation/substra/releases/tag/0.4.0-alpha.4) | [`0.0.8-alpha.9`](https://github.com/SubstraFoundation/substra-chaincode/releases/tag/0.0.8-alpha.9) | [`0.0.12-alpha.20`](https://github.com/SubstraFoundation/substra-backend/releases/tag/0.0.12-alpha.20) | [`0.2.0-alpha.2`](https://github.com/SubstraFoundation/substra-tests/releases/tag/0.2.0-alpha.2) | [`0.0.11-alpha.1`](https://github.com/SubstraFoundation/hlf-k8s/releases/tag/0.0.11-alpha.1) | [`0.0.16`](https://github.com/SubstraFoundation/substra-frontend/releases/tag/0.0.16) | |
        | [`0.4.0`](https://github.com/SubstraFoundation/substra/releases/tag/0.4.0) | [`0.0.8`](https://github.com/SubstraFoundation/substra-chaincode/releases/tag/0.0.8) | [`0.0.12`](https://github.com/SubstraFoundation/substra-backend/releases/tag/0.0.12) | [`0.2.0`](https://github.com/SubstraFoundation/substra-tests/releases/tag/0.2.0) | [`0.0.11`](https://github.com/SubstraFoundation/hlf-k8s/releases/tag/0.0.11) | [`0.0.16`](https://github.com/SubstraFoundation/substra-frontend/releases/tag/0.0.16) | |
        | [`0.5.0`](https://github.com/SubstraFoundation/substra/releases/tag/0.5.0) | [`0.0.8`](https://github.com/SubstraFoundation/substra-chaincode/releases/tag/0.0.8) | [`0.0.14`](https://github.com/SubstraFoundation/substra-backend/releases/tag/0.0.14) | [`0.3.0`](https://github.com/SubstraFoundation/substra-tests/releases/tag/0.3.0) | [`0.0.12`](https://github.com/SubstraFoundation/hlf-k8s/releases/tag/0.0.12) | [`0.0.16`](https://github.com/SubstraFoundation/substra-frontend/releases/tag/0.0.16) | [`0.5.0`](https://github.com/SubstraFoundation/substra-tools/releases/tag/0.5.0) |
        | [`0.6.0`](https://github.com/SubstraFoundation/substra/releases/tag/0.6.0) | [`0.0.10`](https://github.com/SubstraFoundation/substra-chaincode/releases/tag/0.0.10) | [`0.0.19`](https://github.com/SubstraFoundation/substra-backend/releases/tag/0.0.19) | [`0.4.0`](https://github.com/SubstraFoundation/substra-tests/releases/tag/0.4.0) | [`0.0.12`](https://github.com/SubstraFoundation/hlf-k8s/releases/tag/0.0.12) | [`0.0.17`](https://github.com/SubstraFoundation/substra-frontend/releases/tag/0.0.17) | [`0.5.0`](https://github.com/SubstraFoundation/substra-tools/releases/tag/0.5.0) |
        | [`0.7.0`](https://github.com/SubstraFoundation/substra/releases/tag/0.7.0) | [`0.0.11`](https://github.com/SubstraFoundation/substra-chaincode/releases/tag/0.0.11) | [`0.1.2`](https://github.com/SubstraFoundation/substra-backend/releases/tag/0.1.2) <br>[`helm chart 1.4.0`](https://hub.helm.sh/charts/substra/substra-backend/1.4.0) | [`0.5.0`](https://github.com/SubstraFoundation/substra-tests/releases/tag/0.5.0) | [`0.0.13`](https://github.com/SubstraFoundation/hlf-k8s/releases/tag/0.0.13) <br>[`helm chart 3.0.1`](https://hub.helm.sh/charts/substra/hlf-k8s/3.0.1) | [`0.0.19`](https://github.com/SubstraFoundation/substra-frontend/releases/tag/0.0.19) <br>[`helm chart 1.0.0-alpha.2`](https://hub.helm.sh/charts/substra/substra-frontend/1.0.0-alpha.2) | [`0.6.1`](https://github.com/SubstraFoundation/substra-tools/releases/tag/0.6.1) |
        | [`0.7.1`](https://github.com/SubstraFoundation/substra/releases/tag/0.7.1) | [`0.0.11`](https://github.com/SubstraFoundation/substra-chaincode/releases/tag/0.0.11) | [`0.1.2`](https://github.com/SubstraFoundation/substra-backend/releases/tag/0.1.2) <br>[`helm chart 1.4.0`](https://hub.helm.sh/charts/substra/substra-backend/1.4.0) | [`0.5.0`](https://github.com/SubstraFoundation/substra-tests/releases/tag/0.5.0) | [`0.0.13`](https://github.com/SubstraFoundation/hlf-k8s/releases/tag/0.0.13) <br>[`helm chart 3.0.1`](https://hub.helm.sh/charts/substra/hlf-k8s/3.0.1) | [`0.0.19`](https://github.com/SubstraFoundation/substra-frontend/releases/tag/0.0.19) <br>[`helm chart 1.0.0-alpha.2`](https://hub.helm.sh/charts/substra/substra-frontend/1.0.0-alpha.2) | [`0.6.1`](https://github.com/SubstraFoundation/substra-tools/releases/tag/0.6.1) |
        
        
        **Adding entries to the compatibility table**
        
        - Please ensure that all the tests from [`substra-tests`](https://github.com/SubstraFoundation/substra-tests/) pass
        
        ```sh
        $ cd substra-tests
        $ make test
        ```
        
        ## Contributing
        
        ### Setup
        
        To setup the project in development mode, run:
        
        ```sh
        pip install -e .[test]
        ```
        
        To run all tests, use the following command:
        
        ```sh
        python setup.py test
        ```
        
        ### Documentation
        
        To generate the command line interface documentation, sdk and schemas documentation, the `python` version
        must be 3.7. Run the following command:
        
        ```sh
        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:
        
        ```sh
        rm -rf dist/*
        python3 setup.py sdist bdist_wheel
        twine upload dist/* --verbose
        ```
        
Keywords: cli,substra
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6
Description-Content-Type: text/markdown
