atomstorage 0.1.2.1

本模块定义了一个简单的API，用于在不同存储后端中存储和检索Atom条目。条目使用类似JSON的语法定义

>>> import datetime
>>> entry = {'id'     : 'http://example.com/1',
...          'title'  : 'My first entry',
...          'updated': datetime.datetime.utcnow(),
...         }

该模块自带一个shelve后端

>>> from atomstorage import EntryManager
>>> em = EntryManager('shelve://file.db')
>>> em.create_entry(entry)
{'updated': datetime.datetime(2006, 8, 15, 16, 27, 7, 960677),
 'id': 'http://example.com/1',
 'title': 'My first entry'}

可以通过创建一个模块并设置一个atomstorage.backend入口点轻松添加新后端。目前正在开发SQLite后端。

API定义了条目管理器应该具有的一些方法。要检索所有条目，按时间排序（从最后到第一个）

>>> entries = em.get_entries()

最后10个条目

>>> entries = em.get_entries(10)

检索ID为“1”的条目

>>> entry = em.get_entry("1")

删除相同的条目

>>> em.delete_entry("1")

获取2006年8月的所有条目

>>> entries = em.get_entries_by_date(2006, 8)

或从“技术”类别中获取

>>> entries = em.get_entries_by_category("tech")

要搜索提及“Python”的条目

>>> entries = em.search("Python")

API绝对不是最终的。欢迎评论、建议、补丁和批评。