Bolt Python SDK
Project description
Bolt SDK
This SDK provides an authentication and authorization solution for programatically interacting with Bolt. It wraps the
boto3 interface so project wide integration is as easy as refactoring import boto3
to import bolt as boto3
.
The package affects the signing and routing protocol of the boto3 S3 client, therefore any non S3 clients created through this SDK will be un-affected by the wrapper.
Prerequisites
The minimum supported version of Python is version 3.
Installation
python3 -m pip install bolt-sdk
Configuration
For the client to work it must have knowledge of Bolt's region and url
The URL must be formatted as follows:
https://<subdomain>{region}<domain>
An example is:
https://bolt.{region}.google.com
Where the {region}
within the URL is a string literal placeholder that will be replaced by the python sdk
There are two ways to expose Bolt's URL to the SDK:
- With the ENV variable:
BOLT_URL
export BOLT_URL="<url>"
- By passing in the argument
bolt_url
to either of these functions. (Will override ENV variable)
import bolt as boto3
boto3.client('s3', bolt_url='<url>')
# or
boto3.Session().client('s3', bolt_url='<url>')
There are two ways to expose Bolt's region to the SDK:
- If running on an EC2 instance the SDK will by default use that EC2s region
- With the ENV variable:
AWS_REGION
.
export AWS_REGION='<region>'
Debugging
Import the default logger and set its level to DEBUG
logging.getLogger().setLevel(logging.DEBUG)
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.