Skip to main content

SBG API python client bindings

Project description

sevenbridges-python

PyPI version Documentation Licence

CHANGELOG

sevenbridges-python is a Python library that provides an interface for the Seven Bridges Platform the Cancer Genomics Cloud and Cavatica public APIs. It works with Python versions 3.6+.

The Seven Bridges Platform is a cloud-based environment for conducting bioinformatic analyses. It is a central hub for teams to store, analyze, and jointly interpret their bioinformatic data. The Platform co-locates analysis pipelines alongside the largest genomic datasets to optimize processing, allocating storage and compute resources on demand.

The The Cancer Genomics Cloud (CGC), powered by Seven Bridges, is also a cloud-based computation environment. It was built as one of three pilot systems funded by the National Cancer Institute to explore the paradigm of colocalizing massive genomics datasets, like The Cancer Genomics Atlas (TCGA), alongside secure and scalable computational resources to analyze them. The CGC makes more than a petabyte of multi-dimensional data available immediately to authorized researchers. You can add your own data to analyze alongside TCGA using predefined analytical workflows or your own tools.

The Cavatica, powered by Seven Bridges, is a data analysis and sharing platform designed to accelerate discovery in a scalable, cloud-based compute environment where data, results, and workflows are shared among the world's research community. Cavatica is built in collaboration with the Children Hospital of Philadelphia and it is focused on pediatric data.

Documentation

The latest documentation can be found on readthedocs.

Installation

The easiest way to install sevenbridges-python is using pip:

$ pip install sevenbridges-python

Get the Code

sevenbridges-python is actively developed on GitHub, where the code is always available.

The easiest way to obtain the source is to clone the public repository :

$ git clone git://github.com/sbg/sevenbridges-python.git

Once you have a copy of the source, you can embed it in your Python package, or install it into your site-packages by invoking: :

$ python setup.py install

If you are interested in reviewing this documentation locally, clone this repository, position yourself in the docs directory and after installing requirements-dev.txt, invoke:

$ make html

Run Tests

In order to run tests clone this repository, position yourself in the root of the cloned project and after installing requirements-dev.txt, invoke:

$ pytest

Authentication and Configuration

In order to authenticate with the API, you should pass the following items to sevenbridges-python:

(a) Your authentication token (b) The API endpoint you will be interacting with. This is either the endpoint for the Seven Bridges Platform or for the Seven Bridges Cancer Genomics Cloud (CGC) or for CAVATICA.

You can find your authentication token on the respective pages:

The API endpoints for each environment are:

For more information about the API, including details of the available parameters for each API call, you should check the API documentation before using this library:

Initialize configuration using the configuration file

Once you obtain your authentication token, you can pass it to the Config object. You can instantiate the API object by passing the appropriate configuration. There are three ways you can pass configure the library:

  1. Pass parameters url and token explicitly when initializing the config object.
  2. Put the API endpoint and token in the environment variables API_URL and AUTH_TOKEN respectively.
  3. Use the configuration file $HOME/.sevenbridges/credentials with defined parameters.

Explicit initialization

import sevenbridges as sbg
api = sbg.Api(url='https://api.sbgenomics.com/v2', token='<TOKEN_HERE>')

Initialization via environment variables

import os
import sevenbridges as sbg

# Usually these would be set in the shell beforehand
os.environ['SB_API_ENDPOINT'] = 'https://api.sbgenomics.com/v2'
os.environ['SB_AUTH_TOKEN'] = '<TOKEN_HERE>'

api = sbg.Api()

Initialization via config file

import sevenbridges as sbg
config = sbg.Config(profile='cgc')
api = sbg.Api(config=config)

Notes on config file format

The $HOME/.sevenbridges/credentials file has a simple .ini file format, for example:

[default]
api_endpoint = https://api.sbgenomics.com/v2
auth_token = <TOKEN_HERE>

[cgc]
api_endpoint = https://cgc-api.sbgenomics.com/v2
auth_token = <TOKEN_HERE>

[cavatica]
api_endpoint = https://cavatica-api.sbgenomics.com/v2
auth_token = <TOKEN_HERE>

Initializing the sevenbridges-python library

The API object represents the central resource for querying, saving and performing all other actions on your resources. Once you have instantiated the configuration class, pass it to the API class constructor.

import sevenbridges as sbg
api_config = sbg.Config()  # Or any other choice of initialization method
api = sbg.Api(config=api_config)

Examples

The following code illustrates the way the library should be used. For more detailed examples consult the documentation, hosted on readthedocs.

import sevenbridges as sbg

api_config = sbg.Config()  # Or any other choice of initialization method
api = sbg.Api(config=api_config)

# Get current user
user = api.users.me()

# Query your projects
projects = api.projects.query(limit=100)

# Fetch project files
project = projects[0]
files = project.get_files()

Contributing

Contributions, bug reports and issues are very welcome.

You can make your own contributions by forking the develop branch of this repository, making your changes, and issuing pull request on the develop branch. Contributors should read the Seven Bridges Notice to Contributors and sign the Seven Bridges Contributor Agreement before submitting a pull request.

Copyright

Copyright (c) 2020 Seven Bridges Genomics, Inc. All rights reserved.

This project is open-source via the Apache 2.0 License.

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

sevenbridges-python-2.11.1.tar.gz (66.7 kB view details)

Uploaded Source

Built Distribution

sevenbridges_python-2.11.1-py3-none-any.whl (102.5 kB view details)

Uploaded Python 3

File details

Details for the file sevenbridges-python-2.11.1.tar.gz.

File metadata

  • Download URL: sevenbridges-python-2.11.1.tar.gz
  • Upload date:
  • Size: 66.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for sevenbridges-python-2.11.1.tar.gz
Algorithm Hash digest
SHA256 94f8bdd3755bbe8a461311d6281bc9cb6e5ba4861b1b99eef53b53efebe2c691
MD5 3d59156d4481d4c60750567efdeac9e1
BLAKE2b-256 9e7015477ca1a5256d9c3e5b0f269aba7a4f9c59870449099ac4138971d19612

See more details on using hashes here.

File details

Details for the file sevenbridges_python-2.11.1-py3-none-any.whl.

File metadata

File hashes

Hashes for sevenbridges_python-2.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7c722f610a67f7298f360494cf5a75ff0f2193bb48d69fe04000b8bd95080e02
MD5 2fbbb435ca349ac4f04c811f95dcd8a5
BLAKE2b-256 6fb8d1da4f74ced27be5cfe3d6602e4c85a7941441ca98bd5abc60e74fd89a35

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