---
id: botoinator
version: "0.0.6"
license: Apache 2.0
license_treatment: permissive
maintenance: abandoned
---

# botoinator — A decoration mechanism for boto3 that allows automatic decoration of any and all boto3 clients and resources

License: permissive · Maintenance: abandoned · Downloads: 74.8K/mo

## What it is and what it does

Botoinator is a thin wrapper that intercepts the creation of boto3 clients and resources, allowing you to register decorators that will be applied to specific methods. You can decorate methods on a per-session basis (affecting only clients created from that session) or globally (affecting all future clients and resources across any session). This is useful when you want to add cross-cutting behavior—such as logging, metrics, or request transformation—to AWS API calls without modifying your application code at each call site.

The package works by hooking into session objects. You call methods like `register_client_decorator()` or `register_resource_decorator()` to attach a decorator function to a service method, then create clients or resources normally; the decorator is applied automatically. You can also unregister decorators to stop applying them to future clients while leaving already-decorated clients untouched. Because it has no runtime dependencies and is pure Python, installation is straightforward, but the project has not been maintained since June 2020.

Use it for:

- Add request/response logging to all S3 or DynamoDB calls across your application without wrapping each call site.
- Implement automatic retry logic with exponential backoff for transient AWS API failures at the decorator level.
- Inject metrics or tracing into method calls for observability without modifying application code.
- Enforce request validation or sanitization on calls before they reach AWS.
- Apply rate limiting or quota enforcement to specific methods across your codebase.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Botoinator lets you attach decorators to boto3 client and resource methods at the session or global level, enabling cross-cutting concerns like logging or monitoring on AWS API calls.

No. While the concept is sound and the package is license-permissive, it has been abandoned since June 2020 with no maintenance. There is no guarantee the decorator mechanism remains compatible with current versions of its underlying dependencies. Use only if you are locked into an old environment and cannot upgrade; otherwise, implement decorator logic directly in your code.

## Install

pip install botoinator
uv add botoinator
poetry add botoinator

## Installing botoinator

Before you install: Installation is frictionless—a pure-Python wheel with no runtime dependencies. However, the project has been abandoned since June 2020, so expect no maintenance, bug fixes, or compatibility patches.

License in practice: Licensed under Apache 2.0 (permissive), so you can use, modify, and distribute it freely in commercial and open-source projects without restriction.

Quickstart:

import botoinator

def my_decorator(func):
    def wrapper(*args, **kwargs):
        print(f"Calling {func.__name__}")
        return func(*args, **kwargs)
    return wrapper

session.register_client_decorator('s3', 'put_object', my_decorator)

Requires a boto3 session object to be available; no guarantee of compatibility with versions released after June 2020.

Verify before relying:

- Whether the decorator mechanism remains compatible with boto3 versions released after June 2020.
- Whether the package works correctly with Python versions beyond 3.7 (the only version listed in classifiers).
- Whether the package has any undiscovered security issues despite zero OSV records as of August 2026.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 74.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

boto3 method decoration, aws client interceptor, boto3 decorator framework, apply decorators to boto3, boto3 session decorator, aws api call wrapper, boto3 method wrapping, aws-integration, decorator-framework, abandoned

[View on SkillFed](https://skillfed.io/packages/botoinator) · [View on PyPI](https://pypi.org/project/botoinator/)