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

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

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

The documentation currently assumes that you're running Boto 2.3.0 or later.
If you're not, then the API for query and scan changes. You will have to supply
raw condition dicts, as is done in boto itself.

Also note that Boto 2.3.1 or later is required for autoincrement_int hash keys.
Earlier versions will fail.

Features
========

- Python <--> DynamoDB type mapping
- dict and lists serialization
- default values
- Multi-target transaction support with auto-retry (new in 1.6.0)
- Auto-inc hash_key
- Protection against the 'lost update' syndrom
- 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)