nitrate 1.9.0

描述

python-nitrate是硝酸盐测试用例管理系统的Python接口。该软件包包含一个高级Python模块（提供自然对象接口）、一个低级驱动程序（允许直接访问硝酸盐的xmlrpc API）和一个命令行解释器（用于快速调试和实验）。

特性

python-nitrate的最基本特性包括

• 自然且简洁的Python接口

• 自定义缓存和日志级别

• 自动状态着色

• 集成测试套件

• 实用函数

主要动机是在可能的情况下尽可能隐藏不必要的实现细节，以便使用API尽可能简洁。

导入python-nitrate的脚本可以利用几个有用的辅助函数，包括info()用于将日志记录到stderr，listed()将列表转换为易读的格式，color()用于着色，当然还有log.{debug,info,warn,error}用于日志记录。

示例

初始化或创建对象

testcase = TestCase(1234)
testrun = TestRun(testplan=<plan>, summary=<summary>)

为所有容器对象提供默认迭代器

for case in TestRun(1234):
    if case.automated:
        case.status = Status("RUNNING")
        case.update()

将用例链接到计划就像向集合中添加一个项目一样简单

testplan.testcases.add(testcase)
testplan.update()

然而，当某些特定功能尚未实现或效率不足时，仍然可以使用低级驱动程序

inject = Nitrate()._server.TestCase.get(46490)

为了快速入门，您可以在示例目录中找到一些灵感。'matrix.py' 脚本演示了如何轻松显示特定测试计划的测试运行结果矩阵视图。'create.py' 脚本提供了更广泛的概述，涵盖了对象创建、属性设置、调整日志和缓存。

安装

使用yum或dnf直接从Fedora/Copr存储库安装

yum install python-nitrate

或使用PIP（如果不是在虚拟环境中，则需要sudo权限）

pip install nitrate

请注意，为了成功安装pip，需要一些额外的依赖项

yum install gcc python-devel krb5-devel postgresql-devel

以下是Debian系统所需包的列表

apt install gcc python-dev libkrb5-dev libpq-dev

配置

要能够联系Nitrate服务器，必须在用户主目录中提供最小用户配置文件~/.nitrate

[nitrate]
url = https://nitrate.server/xmlrpc/

测试套件

高级接口集成了测试套件，可以轻松地针对阶段服务器实例运行。为此，需要准备并已在服务器上存在的几个对象，以便我们可以检查有效结果。有关需要准备的数据的详细信息，请参阅模块文档。

链接

项目页面：https://github.com/psss/python-nitrate

下载：https://github.com/psss/python-nitrate/releases

Copr存储库：http://copr.fedoraproject.org/coprs/psss/python-nitrate/

PyPI：https://pypi.python.org/pypi/nitrate

报告错误：https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=python-nitrate

Nitrate：https://fedorahosted.org/nitrate/

另请参阅

包含命令行解释器和发行说明的手册页面

nitrate
nitrate-notes

有关所有可用nitrate模块功能的更详细和最新描述，请参阅Python在线文档

pydoc nitrate

有关特定区域的具体信息，请参阅相应的模块文档

nitrate.base ......... Nitrate class, search support
nitrate.cache ........ Persistent cache, multicall support
nitrate.config ....... Configuration, logging, coloring, caching
nitrate.containers ... Container classes implementation
nitrate.immutable .... Immutable Nitrate objects
nitrate.mutable ...... Mutable Nitrate objects
nitrate.teiid ........ Teiid support
nitrate.tests ........ Test suite
nitrate.utils ........ Utilities
nitrate.xmlrpc ....... XMLRPC driver

作者

高级Python模块：Petr Šplíchal，Zbyšek Mráz，Martin Kyral，Lukáš Zachar，Filip Holec，Aleš Zelinka，Miroslav Vadkerti，Leoš Pol，Iveta Wiedermann，Martin Frodl，Alexander Todorov，Robbie Harwood，Martin Zelený和Lumír Balhar。

低级XMLRPC驱动程序：Airal Hapairai，David Malcolm，Will Woods，Bill Peck，Chenxiong Qi，Tang Chaobin，Yuguang Wang和Xuqing Kuang。

希望这个库能为您节省时间，并在编写与Nitrate服务器交互的脚本时带来一些乐趣。期待您的反馈、评论、建议和补丁；-)

Petr Šplíchal <psplicha@redhat.com>

版权

版权所有 (c) 2012 Red Hat, Inc. 保留所有权利。

此库是免费软件；您可以在自由软件基金会发布的GNU Lesser General Public License的条款和条件下重新分发和/或修改它；许可证版本2.1或（根据您的选择）任何更高版本。