用于按照约定方便地向resultsdb报告的模块
resultsdb-conventions的Python项目详细描述
resultsdb_约定是一个python库，它表示 向报告测试结果的约定 ResultsDB。它让你 报告结果容易，不需要很多样板，并且 相对有信心他们的resultsdb元数据将与 其他基本性质相同的结果。
安装
resultsdb_conventions包在fedora和 EPEL7个存储库。核心 包是python2-resultsdb_conventions，并且fedora模块 在包python2-resultsdb_conventions-fedora中。对于其他 发行版，或者如果您想使用git代码，您可以简单地 python路径中的库在某种程度上可供用户使用， 或者要在系统范围内安装库，只需运行 sudo python setup.py install。你需要cached-property 如果您希望使用 Fedora约定（它们都是为Fedora和Epel打包的）。为了 实际上提交结果时，需要ResultsDBapi类 来自resultsdb_api模块。
resultsdb_约定与python 2.6+和 当前的Python3。如果发现兼容性问题，请报告错误。
使用
使用resultsdb惯例的最简单方法是选择Result 子类，它最接近于您希望的结果类型 提交，用适当的参数实例化它，获取 ResultsDBapi，并运行report()方法。这将适用于 结果的“默认”元数据（基于结果的类型和 用于实例化的参数），并将其提交给 获取的API实例。Result子类都应该 它们的必需和可选参数。
对于提交的结果的简单修改，您可以简单地调整 extradata属性（它只是任意字符串的dict key：传递给resultsdb并按原样存储的值对 在运行report()之前获取实例。你也可以 通过包含一个iterable of group将结果添加到更多组中 在实例化 result类，或者通过调整实例的groups属性 直接的。
对于行为上更复杂的变化，您当然可以从 最相关的类并创建一个子类，然后将其调整为 适当的。子类应该如何 在Result类中记录了实现。如果你的子类是 可能在项目之外有实用程序，您可能需要提交 拉取请求，以便其他项目可以方便地报告结果 按照同样的惯例。
已经包含了一个简单的验证机制，但目前没有 包含的类实现任何重要的验证。这个 验证旨在强制执行正在编码的约定，而不是 对结果的有效性进行基本检查； resultsdb将拒绝任何完全无效的提交。请考虑 对您提交的任何请求执行验证。
错误、拉取请求等。
您可以在中的resultsdb_conventions project上提交问题和请求 帕古尔。
学分
Jan Sedlak和Josef Skladanka贡献了宝贵的灵感和想法 以及评论。
许可
在GPL版本3或任何 更高版本。副本包含在副本中。
欢迎加入QQ群-->： 979659372
