Skip to main content
PyPI PyPI - Python Version Gitlab pipeline status slack

Ionburst SDK for Python

The Ionburst SDK for Python enables developers to easily integrate with Ionburst Cloud, building in ultra-secure and private object storage to their applications.

Getting Started

Installation

pip3 install ionburst-sdk-python
# OR
pip3 install ionburst-sdk-python --user

Configuration

The Ionburst SDK can get its configuration (ionburst_id, ionburst_key, ionburst_uri) from the following three files.

If ionburst_id and ionburst_key are not specified by environment variable, they are obtained from the credentials file with information from the config.json file.

If ionburst_uri is not specified in Ionburst constructor, it’ll first check config.json, and then the credentials file.

Environment Variables
IONBURST_ID=IB******************
IONBURST_KEY=eW91aGF2ZXRvb211Y2h0aW1lb255b3VyaGFuZHMh
config.json file
{
  "Ionburst": {
    "Profile": "example",
    "IonburstUri": "https://api.example.ionburst.cloud/",
    "TraceCredentialsFile": "OFF"
  }
}
Credentials file
[example]
ionburst_id=IB******************
ionburst_key=eW91aGF2ZXRvb211Y2h0aW1lb255b3VyaGFuZHMh
ionburst_uri=https://api.example.ionburst.cloud/

Usage

Initialise
from Ionburst import Ionburst
ionburst = Ionburst()

or

from Ionburst import Ionburst
ionburst = Ionburst("https://api.example.ionburst.cloud/")
Upload Data
result = ionburst.put({
  id: '...',
  data: '...',
  classstr: '...' // Not Required
})
Download Data
result = ionburst.get(id)
Delete Data
result = ionburst.delete(id)
Upload Data Deferred
token = ionburst.startDeferredAction({
  action: 'PUT',
  id: '...',
  data: '...',
  classstr: '...'  // Not Required
})
Download Data Deferred
token = ionburst.startDeferredAction({
  action: 'GET',
  id: '...'
})
Check Data Deferred
result = ionburst.checkDeferred(token)
Fetch Data Deferred
result = ionburst.fetch(token)
Get Classifcations
data = ionburst.getClassifications()

Getting Help

Please use the following community resources to get help. We use Gitlab issues to track bugs and feature requests.

  • Join the Ionburst Cloud community on Slack

  • Get in touch with Ionburst Support

  • If it turns out that you may have found a bug, please open an issue

Opening Issues

If you find a bug, or have an issue with the Ionburst SDK for Python we would like to hear about it. Check the existing issues and try to make sure your problem doesn’t already exist before opening a new issue. It’s helpful if you include the version of ionburst-sdk-python and the OS you’re using. Please include a stack trace and reduced repro case when appropriate, too.

The Gitlab issues are intended for bug reports and feature requests. For help and questions with using the Ionburst SDK for Python please make use of the resources listed in the Getting Help section. There are limited resources available for handling issues and by keeping the list of open issues clean we can respond in a timely manner.

SDK Change Log

The change log for the SDK can be found in the Gitlab Releases page

Contributors

A massive thanks to Costin Botez for developing this SDK.

Tests

Dependencies

Release files for ionburst-sdk-python 1.1.1

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

Source distribution (sdist)

Source distribution for ionburst-sdk-python 1.1.1
File Size Uploaded
ionburst-sdk-python-1.1.1.tar.gz 9.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ionburst-sdk-python 1.1.1
File Interpreter ABI Platform
ionburst_sdk_python-1.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 19.0 kB

Release files / ionburst-sdk-python-1.1.1.tar.gz

Download URL ionburst-sdk-python-1.1.1.tar.gz
Size 9.5 kB
Tags Source
SHA-256 checksum
How to use checksums
50503848e4489816b91c403461cfdd69ffa20290f8dd006c0aca19321d9be718
BLAKE2b-256 checksum
How to use checksums
21213ecc7fcb8e7440ff7b577d6e31b2821d492d14e9a14e00d276326084f2b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.3 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.10 tqdm/4.64.0 importlib-metadata/4.8.3 keyring/23.4.1 rfc3986/1.5.0 colorama/0.4.5 CPython/3.6.9

Release files / ionburst_sdk_python-1.1.1-py3-none-any.whl

Download URL ionburst_sdk_python-1.1.1-py3-none-any.whl
Size 9.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1224b0381faea2c933f5b4ba1afd93b243a9266f667ffe98330706ededd8b08e
BLAKE2b-256 checksum
How to use checksums
c7d919c50f507a07f2d18511973645d426cedbc0c8df9867f46dfa6390b66a53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.3 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.10 tqdm/4.64.0 importlib-metadata/4.8.3 keyring/23.4.1 rfc3986/1.5.0 colorama/0.4.5 CPython/3.6.9

Release history Release notifications | RSS feed

This release

1.1.1 This release

2 release files

1.1.0

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

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