Botoinator

0.0.6 verified Fri May 01 auth: no python

Botoinator is a decoration mechanism for boto3 that automatically decorates any and all boto3 clients and resources, allowing easy injection of cross-cutting concerns like logging, metrics, or custom behavior. The latest version is 0.0.6 (no recent updates). Release cadence is unknown.

pip install botoinator

Common errors

error No module named 'botoinator' ↓

cause botoinator is not installed or not in the current Python environment.

fix

Run 'pip install botoinator'.

error AttributeError: module 'botoinator' has no attribute 'enable_logging' ↓

cause Older version of botoinator might not have enable_logging; or import path is wrong.

fix

Ensure botoinator version >= 0.0.6 and use 'from botoinator import enable_logging'.

Warnings

gotcha botoinator must be imported before any boto3 clients or resources are created, otherwise those clients will not be decorated. ↓

fix Import botoinator at the top of your script, before any boto3 calls.

deprecated The library is very early stage (version 0.0.6) and may have API changes without notice. It may also be abandoned. ↓

fix Pin the version in your requirements and test upgrades carefully.

Imports

botoinator
```
import botoinator
```
No common wrong import.
enable_logging
```
from botoinator import enable_logging
```
Function to attach logging decorator.

Quickstart

Automatically decorates all boto3 clients and resources with logging.

import boto3
import botoinator

# Enable logging on all boto3 clients and resources
botoinator.enable_logging()

# Now any boto3 client/resource created will be automatically decorated with logging
s3 = boto3.client('s3')
response = s3.list_buckets()
print(response)