###########################
Overview of Dynamodb-mapper
###########################

.. include:: ../_include/intro.rst

Requirements
============

 - Boto = 2.6.0
 - AWS account

Features
========

- Python <--> DynamoDB type mapping
- dict and lists serialization
- default values
- Multi-target transaction support with auto-retry (new in 1.6.0)
- Sub-transactions (new in 1.6.2)
- Single object migration engine (new in 1.7.0)
- Auto-inc hash_key
- Protection against the 'lost update' syndrom (refactored in 1.7.0)
- Full low-level chunking abstraction for ``scan``, ``query`` and ``get_batch``
- New table creation
- Framework agnostic
- Log all successful database access

.. TODO: add links to related documentation

Logging
=======

Dynamodb-mapper uses 3 "logging" loggers:

- model
- model.database-access
- transactions

.. example de parametrage de la sortie

Known limitations
=================

- Dates nested in a dict or set can not be saved as ``datetime`` does not support JSON serialization. (issue #7)