invenio-devserver 0.13

关于
-----
``invenio-devserver'' 是一个带有自动代码重载的Invenio HTTP服务器，
在为 [[http://invenio-software.org/][Invenio]] 开发时非常有用。它还包括一个邮件调试服务器，
该服务器将所有传入的邮件打印到控制台。

Invenio 是一套免费软件，使您能够在网络上运行自己的数字图书馆
或文档存储库。更多关于 http://invenio-software.org/。

安装
------------
您可以使用 ``pip install invenio-devserver'' 安装 invenio-devserver，或者
您可以使用 ``easy_install''。

要求
------------
* `Invenio <http://invenio-software.org/wiki/Installation>`_
* ``Werkzeug''
* ``mock''（可选）：截获错误并在标准输出上显示它们

使用 PIP 时，将自动安装 ``Werkzeug'' 和 ``mock''。

配置
-------------
您需要告诉 ``invenio-devserver'' 您的 Invenio 源代码和
安装所在的路径。将 config_local.py 添加到您的 site-packages 目录中，
如下所示：

SRC_PATH = [
"~/src/invenio",
"~/src/inspire"，# （如果有多个项目，则必须使用）
]
INSTALL_PATH = "/opt/invenio"

如果没有指定 ``SRC_PATH'' 或 ``INSTALL_PATH''，则会自动猜测

* 如果你在一个激活的虚拟环境中，``INSTALL_PATH'' 被设置为
``VIRTUAL_ENV'' 环境变量。
* ``SRC_PATH'' 默认为 ``~/src/invenio/''。
* 如果你使用 ``invenio-devscripts''，``SRC_PATH'' 和 ``INSTALL_PATH''
将被设置为环境变量 ``CFG_INVENIO_SRC'' 和
``CFG_INVENIO_PREFIX''。

请参阅 ``src/invenio_devserver/config.py'' 了解更多可能的设置。

使用 ``serve''
---------------
如果 Invenio 安装在虚拟环境中，请激活它并运行：

$ serve
带有重新加载模式的 HTTP 服务器模式
* 运行在 http://localhost:4000/
* 启动工作进程
* 准备就绪

如果 Invenio 安装在你的用户下，请运行：

$ python serve.py

如果 Invenio 安装在其他用户（例如 wwww）下，可以使用

$ sudo -u www python serve.py

``serve'' 的以下选项可用：

$ serve --help
用法: python serve.py [-bp]

Invenio 开发用网络服务器

选项
-h, --help 显示此帮助信息并退出
-b 绑定地址 绑定的地址
-p 绑定端口 绑定的端口
--no-reload 禁用当源文件更改时的自动重新加载
--no-http 禁用 http 服务器，仅更新 Invenio 安装
--pdb 出错时进入 Python 调试器
-s 源文件夹（一个或多个）
-o 安装路径 Invenio 安装的路径。


使用 ``mailserve''
-------------------
如果 Invenio 安装在虚拟环境中，请激活它并运行：

$ mailserve
请记住在 invenio-local.conf 中设置以下两个设置

CFG_MISCUTIL_SMTP_HOST=127.0.0.1
CFG_MISCUTIL_SMTP_PORT=1025

现在在 127.0.0.1:1025 接受邮件（按 CONTROL-C 停止）


``mailserve'' 的以下选项可用：
用法: mailserve [-bp]

Invenio 开发用邮件服务器

选项
-h, --help 显示此帮助信息并退出
-b 绑定地址 绑定的地址
-p 绑定端口 绑定的端口