Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

REANA-Client

https://img.shields.io/pypi/pyversions/reana-client.svg https://img.shields.io/travis/reanahub/reana-client.svg https://readthedocs.org/projects/reana-client/badge/?version=latest https://img.shields.io/coveralls/reanahub/reana-client.svg https://badges.gitter.im/Join%20Chat.svg https://img.shields.io/github/license/reanahub/reana.svg https://img.shields.io/badge/code%20style-black-000000.svg

About

REANA-Client is a component of the REANA reusable and reproducible research data analysis platform. It provides a command-line tool that allows researchers to submit, run, and manage their computational workflows.

  • seed workspace with input code and data

  • run computational workflows on remote compute clouds

  • list submitted workflows and enquire about their statuses

  • download results of finished workflows

Installation

$ # create new virtual environment
$ virtualenv ~/.virtualenvs/reana
$ source ~/.virtualenvs/reana/bin/activate
$ # install reana-client
$ pip install reana-client

Usage

The detailed information on how to install and use REANA can be found in docs.reana.io.

Changes

Version master (UNRELEASED)

  • Adds option to filter job logs according to compute backend, docker image, status and steps.

  • Enriches disk usage output format.

  • Adds new command to restart workflows.

  • Optimizes CLI performance.

  • Adds option to get logs of a specific step.

  • Enhances logs formatting using marks and colors.

  • Switches from Bravado to requests to perform better performant downloads.

  • Validates user access token and improves output of ping command.

  • Accepts both reana.yaml and reana.yml filenames.

  • Includes better formatting for diff command.

  • Prevents including a dot as part of the workflow name.

  • Allows passing workflow operational options in the reana.yaml.

  • Adds Black formatter support.

Version 0.6.1 (2020-06-09)

  • Fixes installation troubles for REANA 0.6.x release series by pinning several dependencies.

Version 0.6.0 (2019-12-27)

  • Introduces user secrets management commands secrets-add, secrets-list and secrets-delete.

  • Enhances run and create commands to allow specifying workfow via the --workflow flag.

  • Introduces new command version to report client version.

  • Fixes upload command behaviour for uploading very large files.

  • Simplifies run command by removing free upload parameters.

  • Upgrades cwltool to 1.0.20191022103248.

  • Disables SSL verification warnings when talking to self-signed server certificates.

Version 0.5.0 (2019-04-24)

  • Introduces new resources field in reana.yaml specification file allowing to declare computing resources needed for workflow runs, such as the CVMFS repositories via cvmfs subfield.

  • Improves reana-client embedded command-line documentation (-help) by grouping commands and providing concrete usage examples for all commands.

  • Enhances workflow start command allowing to override input parameters (--parameter) and to specify additional operational options (--option).

  • Introduces new workflow run wrapper command that creates workflow, uploads its input data and code and starts its execution.

  • Introduces new workflow stop command for stopping a running workflow.

  • Enhances workflow logs command output capabilities via new --json option.

  • Introduces new workflow diff command for comparing two workflow runs.

  • Introduces new workflow delete command for deleting one or more workflow runs.

  • Introduces new session open command allowing to run interactive sessions such as Jupyter notebook upon workflow workspace.

  • Introduces new session close command for closing interactive sessions.

  • Renames past workflows command to list allowing to list both workflow runs and interactive sessions.

  • Introduces new workspace du command for checking workspace disk usage.

  • Introduces new workspace mv command for moving files within workspace.

  • Introduces new workspace rm command for removing files within workspace.

  • Renames past workspace list command to ls allowing to list workspace files. Enhances its output capabilities via new --format option.

  • Introduces new API function create_workflow_from_json() which allows developers and third-party systems to create workflows directly from JSON specification.

Version 0.4.0 (2018-11-07)

  • Enhances test suite and increases code coverage.

  • Changes license to MIT.

Version 0.3.1 (2018-09-25)

  • Amends upload and download commands that will now upload/download all the files specified in reana.yaml in case no arguments are provided.

  • Fixes status command’s JSON output mode.

  • Upgrades CWL reference implementation to version 1.0.20180912090223.

  • Renames Serial workflow operational parameter from CACHING``to ``CACHE.

  • Adds support for Python 3.7.

Version 0.3.0 (2018-08-10)

  • Adds support for Serial workflows.

  • CLI refactored to a flat design:
    • inputs/outputs/code removed, everything is a file managed with upload/download/list commands.

    • Removes workflow command, workflows are managed with create/start/status.

  • Removes analyes command, now validate is first level command.

  • status now shows the selected workflow progress and current command on verbose mode.

  • Requires the usage of an access token to talk to REANA Server.

  • Fixes bug when uploading binary files.

  • Supports addition of workflow engine parameters when using start for serial workflows.

  • Improves error messages.

Version 0.2.0 (2018-04-20)

  • Adds support for Common Workflow Language workflows.

  • Adds support for persistent user-selected workflow names.

  • Enables file and directory input uploading using absolute paths.

  • Adds new status command to display the current status of the client.

  • Reduces verbosity level for commands and improves error messages.

Version 0.1.0 (2018-01-30)

  • Initial public release.

Metadata

Release files for reana-client 0.7.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reana-client 0.7.0a1
File Size Uploaded Provenance Actions
reana-client-0.7.0a1.tar.gz 49.6 kB Without provenance Details for reana-client-0.7.0a1.tar.gz

Release files / reana-client-0.7.0a1.tar.gz

Download URL reana-client-0.7.0a1.tar.gz
Size 49.6 kB
Tags Source
SHA-256 checksum
How to use checksums
e96f0b047e66d1ee00ce2f81866f853dc5722a9ca57875a1ffcc8e503ecf1a3f
BLAKE2b-256 checksum
How to use checksums
b6dc2f708278cb089a1d90642e6fa0485134f24bb2793968d825d1d4904851a4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.3.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

Security for reana-client 0.7.0a1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page