为ipython/jupyter提供Postgres支持的内容管理器。
pgcontents的Python项目详细描述
pgcontents是一个postgresql支持的IPEP 27实现。它的目标是成为ipython标准的文件系统支持的存储系统的一个透明的、可直接插入的替代品。pgcontents'postgrescontentsmanager类可用于将所有本地文件系统存储替换为数据库支持的存储,而其postgrescheckpoints类可用于仅替换ipython的检查点存储。在您无法访问或不信任笔记本服务器本地文件系统可靠性的环境中运行ipython时,这些功能非常有用。
这个存储库作为Quantopian Research Environment的一部分正在开发中,目前处于开放测试阶段。
开始
- 先决条件:
- 对空PostgreSQL数据库的写访问。
- 使用IPython3.x的python安装 或者Jupyter Notebook>;=4.0。
安装:
- 从pypi通过pip install pgcontents[ipy4]安装pgcontents。(这将以与最近的jupyter笔记本版本兼容的方式安装pgcontents。要安装支持旧式ipython 3.x系列的pgcontents,请运行pip install pgcontents[ipy3])。
- 运行pgcontents init来配置数据库。系统将提示您输入用于存储的pgcontents的数据库url。(或者,可以设置pgcontents_db_url环境变量,或在命令行上传递–db url)。
- 将ipython/jupyter配置为使用pgcontents作为其存储后端。这可以通过命令行或修改笔记本配置文件来完成。对于类unix系统上的ipython 3.x,notebok配置将位于~/.ipython/profile_default/ipython_notebook_config.py。对于jupyter笔记本,它将位于~/.jupyter/jupyter_notebook_config.py。有关配置文件的示例,请参见examples目录。
- 享受您的文件系统免费的ipython体验!