QuickStatements客户端

QuickStatements的QuickStatements数据模型和客户端。

💪 快速入门

以下是如何快速构建一些QuickStatements的方法

import datetime
from quickstatements_client import DateQualifier, EntityQualifier, TextQualifier, EntityLine

subject_qid = "Q47475003"  # Charles Tapley Hoyt
subject_orcid = "0000-0003-4423-4370"
reference_url_qualifier = TextQualifier(
   predicate="S854", target=f"https://orcid.org/0000-0003-4423-4370"
)
start_date = datetime.datetime(year=2021, day=15, month=2)
start_date_qualifier = DateQualifier.start_time(start_date)
position_held_qualifier = EntityQualifier(predicate="P39", target="Q1706722")
employment_line = EntityLine(
   subject=subject_qid,
   predicate="P108",  # employer
   target="Q49121",  # Harvard medical school
   qualifiers=[reference_url_qualifier, start_date_qualifier, position_held_qualifier],
)

>>> employment_line.get_line()
'Q47475003|P108|Q49121|S854|"https://orcid.org/0000-0003-4423-4370"|P580|+2021-02-15T00:00:00Z/11|P39|Q1706722',

如何将一些QuickStatements发送到API

from quickstatements_client import QuickStatementsClient

lines = [
   employment_line,
   ...
]

client = QuickStatementsClient(token=..., username=...)
res = client.post(lines, batch_name="Test Batch")
# see also res.batch_id

import webbrowser
webbrowser.open_new_tab(res.batch_url)

注意：如果未提供，则使用pystow自动查找token和username。具体来说，使用pystow.get_config("quickstatements", "token")和pystow.get_config("quickstatements", "username")。

🚀 安装

最新版本可以通过PyPI安装

$ pip install quickstatements_client

最新代码和数据可以直接从GitHub安装

$ pip install git+https://github.com/cthoyt/quickstatements-client.git

👐 贡献

无论是通过提交问题、提交拉取请求还是进行分叉，贡献都是受欢迎的。有关参与的信息，请参阅CONTRIBUTING.md。

👋 稿件归属

此代码最初是作为对 PyORCIDator 的贡献而编写的。特别感谢 Tiago Lubiana [@lubianat] 和 João Vitor [@jvfe] 在讨论和测试中的帮助。

⚖️ 许可证

本包中的代码采用 MIT 许可证授权。

🍪 Cookiecutter

本包是用 @audreyfeldroy 的 cookiecutter 包以及 @cthoyt 的 cookiecutter-snekpack 模板创建的。

🛠️ 开发者

$ git clone git+https://github.com/cthoyt/quickstatements-client.git
$ cd quickstatements-client
$ pip install -e .

$ tox

$ git clone git+https://github.com/cthoyt/quickstatements-client.git
$ cd quickstatements-client
$ tox -e docs
$ open docs/build/html/index.html

$ tox -e finish