zotero api的python包装器
Pyzotero的Python项目详细描述
pyzotero:zotero api的api客户机
快速启动
pip install pyzotero
或conda config --add channels conda-forge && conda install pyzotero
- 您需要要访问的个人或组库的ID:
- 您的personal library id可以在^{cd3>} 部分找到here
- 对于组库,可以通过打开组的页面
https://www.zotero.org/groups/groupname
,并将鼠标悬停在group settings
链接上来找到IDid是/groups/
之后的整数。
- 您还需要来获取API密钥here
- 你在访问你自己的Zotero图书馆吗?
library_type
是'user'
- 您正在访问共享组库吗?
library_type
是'group'
。
然后:
frompyzoteroimportzoterozot=zotero.Zotero(library_id,library_type,api_key)items=zot.top(limit=5)# we've retrieved the latest five top-level items in our library# we can print each item's item type and IDforiteminitems:print('Item: %s | Key: %s'%(item['data']['itemType'],item['data']['key']))
文档
有关可用pyzotero方法、代码示例和示例输出的完整文档可在Read The Docs上找到。
安装
- 使用pip:
pip install pyzotero
(它可用作一个轮子,在python 2.7、3.5、3.6和3.7上进行测试) - 从本地克隆,如果您希望从特定分支安装pyzotero:
示例:
git clone git://github.com/urschrei/pyzotero.git
cd pyzotero
git checkout dev
pip install .
测试
在pyzotero/test目录中运行test_zotero.py
,或者使用Nose2,从顶层目录中运行nose2
。
问题
最新的提交可以在dev branch上找到,尽管新功能目前很少如果遇到错误,请打开一个问题
拉取请求
欢迎拉取请求。请阅读contribution guidelines特别是,请将您的PR建立在dev
分支上。
版本控制
从v1.0.0开始,Pyzotero根据Semver进行版本控制;版本增量执行如下:
- 主版本将随着不兼容的API更改而增加,
- 当以向后兼容的方式添加功能时,次要版本将增加,并且
- 修补程序版本将随着向后兼容的错误修复而增加。
引文
Pyzotero有一个DOI:
你也可以用CITATION.bib来引用pyzotero。
引用样本(APA第6版)可能如下:
Stephan Hügel, The Pyzotero Authors (2019, May 18). urschrei/pyzotero: Version v1.3.15. http://doi.org/10.5281/zenodo.2917290
许可证
Pyzotero是根据MIT license授权的有关详细信息,请参见license.txt。
严格来说,这不是真的:您只需要个人库和非公共组库的api密钥。