Introduction
============

What is botowrap?
----------------

Botowrap is a modular framework for extending boto3 clients with automatic enhancements, wrappers, and developer-friendly features. It provides a structured way to add functionality to the standard boto3 clients.

Key Features
-----------

* **Modular Extension System**: Easily add or remove features from boto3 clients
* **Type-Safe**: Full type annotations for better IDE integration
* **DynamoDB Enhancement**: Includes a powerful DynamoDB document client with:
   * Python↔DynamoDB (de)serialization
   * Auto‐CreatedAt/UpdatedAt timestamps
   * Jittered exponential backoff on throttling
   * query_all/scan_all pagination helpers
   * ConsumedCapacity logging

Design Philosophy
---------------

Botowrap is designed to be:

1. **Non-intrusive**: It enhances boto3 clients without changing their core behavior
2. **Modular**: Extensions can be added or removed independently
3. **Transparent**: The enhanced clients behave just like standard boto3 clients, but with extra features
4. **Typed**: Full type annotations provide excellent IDE integration and type safety

Use Cases
--------

* Simplifying DynamoDB interaction by automatically handling serialization/deserialization
* Adding automatic timestamps for data auditing
* Implementing consistent retry logic across your application
* Standardizing logging and monitoring of AWS resource usage