time2relax 0.5.2

time2relax:python couchdb驱动程序

python的couchdb驱动程序。

time2relax是一个python驱动程序，它试图在您和couchdb之间提供最低级别的抽象。

基本插入用法：

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

• 功能支持
• 安装
• 文档
  • 创建数据库
  • 删除数据库
  • 创建/更新文档
  • 获取文档
  • 删除文档
  • 创建/更新一批文档
  • 获取一批文档
  • 复制数据库
  • 保存附件
  • 获取附件
  • 删除附件
  • 获取数据库信息
  • 压缩数据库
  • 运行列表函数
  • 运行显示功能
  • 运行视图功能
• 如何贡献

<；small>；使用markdown-toc生成的目录<；/small>；

功能支持

受pouchdb和couchdb nanoapi的启发，它的特点是：

• 在引擎盖下的请求（人类的http）。
• 透明的URL和参数编码。
• 根据couchdb建模的http异常错误代码
• 支持CouchDB 1.7.x.

time2relax正式支持python 2.7和3.6+

安装

要安装Time2Relax，只需运行：

$ pip install -U time2relax
✨?✨

文档

有关详细文档，请访问https://time2relax.readthedocs.org" rel="nofollow">https://time2relax.readthedocs.org

在项目中使用time2relax：

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')

大部分api公开为db.function（*args，**kwargs），其中**kwargs是可选参数，可以接受请求。session.request请求。

创建数据库

最初，couchdb对象将检查数据库是否存在，如果不存在，则尝试创建数据库。您可以使用create_db=false跳过此步骤：

>>>db=CouchDB('http://localhost:5984/dbname',create_db=False)

删除数据库

删除数据库：

>>>db.destroy()<Response[200]>

使用couchdb对象的进一步请求应引发time2relax.resourcenotfound：

>>>db.info()ResourceNotFound:({'error':'not_found','reason':'missing'},<Response[404]>)

创建/更新文档

注意：对文档的有效属性名有一些couchdb限制。

创建新文档：

>>>db.insert({'_id':'docid','title':'Heros'})<Response[201]>

创建新文档并让couchdb自动为其生成\u id：

>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

如果文档已存在，则必须指定其修订版\u rev，否则将发生冲突。您可以使用\u rev：

>>>result=db.get('docid').json()>>>db.insert({'_id':result['_id'],'_rev':result['_rev'],'title':'Dance'})<Response[201]>

获取文档

检索文档：

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

删除文档

您必须提供现有文档的\u rev。

删除文档：

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

您还可以使用time2relax.couchdb.insert和{"u deleted"：true}：

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

创建/更新一批文档

创建多个文档：

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

如果忽略给定文档上的\u id参数，数据库将创建一个新文档并为您分配id:

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

要更新文档，必须同时包含一个\u id参数和一个\u rev参数，该参数应与更新所依据的文档的id和修订相匹配：

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

最后，要删除文档，请包含一个值为true的参数：

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

>>>fromtime2relaximportCouchDB>>>db=CouchDB('http://localhost:5984/dbname')>>>db.insert({'title':'Ziggy Stardust'})<Response[201]>

$ pip install -U time2relax
✨?✨

$ pip install -U time2relax
✨?✨

$ pip install -U time2relax
✨?✨

$ pip install -U time2relax
✨?✨

$ pip install -U time2relax
✨?✨

$ pip install -U time2relax
✨?✨

$ pip install -U time2relax
✨?✨

$ pip install -U time2relax
✨?✨

$ pip install -U time2relax
✨?✨