duo 0.3.2

严厉警告：

不，说真的，这是一个很轻的包装 boto.dynamodb.layer2。如果你超出了使用示例的范围 下面，您最好熟悉boto的dynamodb api。The docs很好。阅读duo’s source也可能有帮助。是的 因为这个原因而保持简短。

用法：

duo由一个模块组成：

>>> import duo

模块不是很大（在撰写本文时，大约700 行）。如果你想知道一些东西是如何工作的，you should read it。

在aws控制台中预先创建表，然后编写简单的类 去接近他们。duo.Table自动注册子类 使用数据库：

>>> class MyHashKeyTable(duo.Table):
...     table_name = 'my_hashkey_table'
...     hash_key_name = 'slug'
...     range_key_name = None  # Implicit default

duo.Item是围绕boto.dynamodb.items.Item的薄包装，具有 大量的语法糖。duo.Item子类是自动的 在数据库中注册：

>>> import datetime

>>> class MyHashKeyItem(duo.Item):
...     table_name = 'my_hashkey_table'
...     hash_key_name = 'slug'
...
...     slug = duo.UnicodeField()
...     my_field = duo.UnicodeField(default='foo')
...     on_this_date = duo.DateField(default=lambda o: datetime.date.today())

数据库和表使用类似dict的访问语法：

>>> db = duo.DynamoDB(key='access_key', secret='secret_key')

>>> # The correct Table sub-class is matched by table name:
>>> table = duo.DynamoDB['my_hashkey_table']

>>> # The correct Item sub-class is matched by table name:
>>> item = table['new-item']

>>> # Items are actually dict subclasses, but that's not where the
>>> # fun is. They can only store unicode strings and integers:
>>> item['slug']
'new-item'

指定项子类上的字段以获取有用的数据类型：

>>> item.is_new
True

>>> # A field doesn't exist initially...
>>> item['my_field']
Traceback (most recent call last):
  File "...", line 1, in <module>
    item['my_field']
KeyError: 'my_field'

>>> # But we specified a default.
>>> item.my_field
'foo'

>>> # The default, once accessed, gets populated:
>>> item['my_field']
'foo'

>>> # Or we can set our own value...
>>> item.my_field = 'bar'

>>> item['my_field']
'bar'

>>> # Finally, we save it to DynamoDB.
>>> item.put()

>>> item.is_new
False

缓存：

duo与实现python-memcached兼容接口的任何缓存集成，即：

import pylibmc
cache = pylibmc.Client(['127.0.0.1'])
cache.get(<keyname>)
cache.set(<keyname>, <duration-in-seconds>)
cache.delete(<keyname>)

通过将缓存传递给db构造函数来集成缓存：

>>> import duo
>>> db = duo.DynamoDB(key='access_key', secret='secret_key', cache=cache)

还可以按表或按项指定缓存对象：

>>> class MyHashKeyTable(duo.Table):
 ...     cache = pylibmc.Client(['127.0.0.1'])
 ...
 ...     table_name = 'my_hashkey_table'
 ...     hash_key_name = 'slug'
 ...     range_key_name = None  # Implicit default

默认情况下，缓存处于关闭状态，但可以通过指定 acache_duration作为整数（0是永远的）：

>>> class MyHashKeyItem(duo.Item):
...     cache_duration = 30  # 30 seconds
...
...     table_name = 'my_hashkey_table'
...     hash_key_name = 'slug'
...
...     slug = duo.UnicodeField()
...     my_field = duo.UnicodeField(default='foo')
...     on_this_date = duo.DateField(default=lambda o: datetime.date.today())

缓存键由哈希键、范围键和缓存前缀确定 （放在桌子上）。默认情况下，缓存前缀是表名：

>>> table = duo.DynamoDB['my_hashkey_table']
>>> item = table['new-item']
>>> item.cache_prefix is None
True
>>>item._cache_key
'my_hashkey_table_new-item'
>>> MyHashKeyTable.cache_prefix = 'hello_world'
>>> item._get_cache_key()
'hello_world_new-item'

更改日志