thez-org / sandcage-api-python Goto Github PK

sandcage-api-python is a python library for interfacing with SandCage's API. The API documentation can be found at SandCage's API documentation

• Requirements
• Installation
• Usage
• Examples
• Contributing
• Contact Us

• certifi
• requests

In order to use the library you need a SandCage API Key. Once logged into SandCage, you can get your API Key from here.

Using pip:

pip install sandcage

or alternatively clone and install:

git clone https://github.com/sandcage/sandcage-api-python
cd sandcage-api-python
python setup.py install

Simply:

from sandcage import SandCage

sc = SandCage('[YOUR_SANDCAGE_API_KEY]')
sc.list_files_service()

See more examples

To not include YOUR_SANDCAGE_API_KEY into your code you can for example save it as a file named SANDCAGE_API_KEY into your home directory:

cd ~
echo YOUR_SANDCAGE_API_KEY > SANDCAGE_API_KEY

and then use the following code to initialize SandCage:

import os.path
from sandcage import SandCage

api_key_dir = os.path.expanduser('~')
api_key_file = os.path.join(api_key_dir, 'SANDCAGE_API_KEY')
with open(api_key_file, 'r') as f:
    api_key = f.readline()

sc = SandCage(api_key=api_key)

We are open to suggestions and code revisions, however there are some rules and limitations that you might want to consider first.

• Code that you contribute will automatically be licensed under the Apache License Version 2.0.
• Third party code will be reviewed, tested and possibly modified before being released.

These basic rules help ensure that this code remains Open Source and compatible with Apache 2.0 license. All contributions will be added to the changelog and appear in every release.