Metadata-Version: 2.1
Name: xoto3
Version: 1.10.1
Summary: High level utilities for a subset of boto3 operations common for AWS serverless development in Python.
Home-page: https://github.com/xoeye/xoto3
Author: Peter Gaultney
Author-email: pgaultney@xoi.io
License: UNKNOWN
Description: # xoto3
        
        `xoto3` (pronounced zoto-three) is a layer of useful micro-utilities
        for `boto3` (the AWS Python library) particularly suitable for
        serverless development.
        
        These come from years of experience developing a serverless platform
        at XOi Technologies, and represent real production code.
        
        ## Features
        
        Some of the features included:
        
        - A more general purpose `boto3` client API paginator.
        
        - Higher-level abstractions for DynamoDB, including:
        
          - pure data transformation safeguards against various sorts of data
            that DynamoDB won't accept.
          - a transactional single-item update that allows you to express your
            single-item update transformation in pure Python.
          - an multi-item, multi-table composable, retrying, transaction
            wrapper for TransactWriteItems, allowing arbitrary writes (up to
            the built in API limitations) to multiple databases to be
            expressed as pure Python.
          - transparent BatchGet and BatchWrite utilities that work around the
            many annoyances of `boto3` and DynamoDB itself.
          - composable query interfaces that make writing basic queries against DynamoDB fun.
        
          [see readme for examples](xoto3/dynamodb/README.md)
        
        - Cloudwatch Insights and Log Groups Query URL formatters.
        
        - General-purpose AWS Lambda finalization code, to make sure buffered
          IO gets a chance to flush before your Lambda gets paused.
        
        - Wrapper for SSM parameter puts and gets, including built-in support
          for parameter values larger than what SSM will accept by
          automatically splitting your values and reconstructing them on gets.
        
        Various other utilities are included as well - feel free to poke through the source code.
        
        None of these features "rely" on any of the others, so all of the
        power is left in your hands. This is not a framework; just a set of
        mostly pure-functional utilities, with a couple of handy wrappers for
        `boto3` functions that perform IO.
        
        ## Other Utilities
        
        Some fairly general-purpose utilities are also included. See [the readme](xoto3/utils/README.md) for more details.
        
        Some highlights:
        
        - `tree_map` - recursively map through a tree of Python builtins
        - `lazy` - general purpose lazy-loading container
        - Various serialization utilities (datetimes, decimals, JSON helpers)
        - `pipe_multiprocessing` - a Process Pool for places like AWS Lambda
          where Python's built-in shared memory-dependent Pool does not work.
        
        ## Testing
        
        You can run all unit tests with `pipenv run pytest tests`.
        
        You can additionally include all the DynamoDB integration tests by
        setting an environment variable that is the name of a DynamoDB table
        with a primary key that is a partition key of `id` and no range
        key. The name of the environment variable to be set is
        `XOTO3_INTEGRATION_TEST_DYNAMODB_ID_TABLE_NAME`.
        
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
