././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3658788 os-testr-3.0.0/0000775000175000017500000000000000000000000013315 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/.coveragerc0000664000175000017500000000016200000000000015435 0ustar00zuulzuul00000000000000[run] branch = True source = os_testr omit = os_testr/tests/*,os_testr/openstack/* [report] ignore_errors = True ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/.mailmap0000664000175000017500000000013100000000000014731 0ustar00zuulzuul00000000000000# Format is: # # ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/.stestr.conf0000664000175000017500000000005600000000000015567 0ustar00zuulzuul00000000000000[DEFAULT] test_path=os_testr/tests top_dir=./ ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/.zuul.yaml0000664000175000017500000000023200000000000015253 0ustar00zuulzuul00000000000000- project: templates: - check-requirements - openstack-python3-jobs - publish-openstack-docs-pti - release-notes-jobs-python3 ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/AUTHORS0000664000175000017500000000356300000000000014374 0ustar00zuulzuul00000000000000Anand Bhat Andreas Jaeger Assaf Muller Attila Fazekas Christian Berendt Corey Bryant Davanum Srinivas Divyansh Acharya Dong Ma Doug Hellmann Ghanshyam Mann Hervé Beraud Jake Yip James Page John Griffith Kun Huang Luigi Toscano Lukas Piwowarski Luz Cazares Manik Bindlish Martin Kopec Masayuki Igawa Masayuki Igawa Masayuki Igawa Masayuki Igawa Matthew Treinish Monty Taylor Shu Muto Szymon Datko TerryHowe Thomas Bechtold Tim Burke Tony Breeds Yushiro FURUKAWA ZhijunWei ZhongShengping caoyuan dengzhaosen guo yunxian huang.zhiping jacky06 janonymous lkuchlan maaoyu melanie witt melissaml qingszhao ricolin step6829 tushargite96 yangyawei zhangboye ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/CONTRIBUTING.rst0000664000175000017500000000113700000000000015760 0ustar00zuulzuul00000000000000The source repository for this project can be found at: https://opendev.org/openstack/os-testr Pull requests submitted through GitHub are not monitored. To start contributing to OpenStack, follow the steps in the contribution guide to set up and use Gerrit: https://docs.openstack.org/contributors/code-and-documentation/quick-start.html Bugs should be filed on Launchpad: https://bugs.launchpad.net/os-testr For more specific information about contributing to this repository, see the os-testr contributor guide: https://docs.openstack.org/os-testr/latest/contributor/contributing.html ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/ChangeLog0000664000175000017500000001503400000000000015072 0ustar00zuulzuul00000000000000CHANGES ======= 3.0.0 ----- * Remove the deprecated ostestr command * Update CI to use unversioned jobs template * Test python3.9 as voting job * Switch testing to Yoga testing runtime 2.0.1 ----- * Update IRC network to OFTC * setup.cfg: Replace dashes with underscores * Use py3 as the default runtime for tox * Ussuri+ is python3 only and update python to python3 * Switch testing to Xena testing runtime * Changed minversion in tox to 3.18.0 * Create tox environment to build pdf documentation * Remove install unnecessary packages * Remove install unnecessary packages * Switch testing to Victoria testing runtime * Stop to use the \_\_future\_\_ module * Use unittest.mock instead of third party mock * Switch to newer openstackdocstheme and reno versions * Fix hacking min version to 3.0.1 * [ussuri][goal] Update contributor documentation * Update to hacking 3.0 2.0.0 ----- * [ussuri][goal] Drop python 2.7 support and testing * subunit2html dealing with incorrect data format * Add Python 3 Train unit tests 1.1.0 ----- * Update hacking version * Replace git.openstack.org URLs with opendev.org URLs * Deprecate ostestr command * Fix warning message with double "to" * Dropping the py35 testing * OpenDev Migration Patch * Default concurrency to 0 to avoid TypeError in stestr * add python 3.7 unit test job * Removed older version of python3.4 from setup.cfg * Change openstack-dev to openstack-discuss * Update the home-page URL * Use updated hacking url link * add python 3.6 unit test job * switch documentation job to new PTI * import zuul job settings from project-config * fix tox python3 overrides * Trivial: Update pypi url to new url * Updated from global requirements * Fix load command in pdb/no-discover path * Avoid tox\_install.sh for constraints support * Remove useless links and indentations * Fix regex builder * Updated from global requirements * Updated from global requirements * Fix .testr.conf detection: test path follows discover 1.0.0 ----- * Switch to stestr under the covers * Just changed the opening of the file * Updated from global requirements * Switch from oslosphinx to openstackdocstheme * update doc URL to the new location in the readme * rearrange content to fit the new standard layout * Turn on warning-is-error in sphinx build * Fail when no test case selected * Updated from global requirements 0.8.2 ----- * Updated from global requirements * Remove unused Babel setup 0.8.1 ----- * Updated from global requirements * [Fix gate]Update test requirement * Fix error when without --regex option * Updated from global requirements * Add Constraints support * Fix typo and change regexp to regex * Track failures during sorting of test results 0.8.0 ----- * Updated from global requirements * Handle overlapping black regexes * Updated from global requirements * Update home-page url * Add ostestr as a function * Error on invalid list parameter combination * Use dash instead of underscore in args * Add --black-regex/-B option * Allow to specifiy black/white list at the same time * Make the listbuilder the default strategy * Construct a list of test cases instead of passing a regexp * Add support for Python versions * Delete openstack/common in flake8 exclude list * Save subunit results file when using --no-discover * Simplify logic in \_get\_test\_list * Remove discover from test-requirements * Make subprocess outputs to text for Python 3 * Fix doc warnings and disable smarty-pants * Updated from global requirements * Remove the TODO file * Make unexpected success as fail * Add documentation for generate-subunit * Sort failed tests at the top on HTML result page 0.7.0 ----- * Add whitelist file to ostestr docs * Seperate regex builder logic into a seperate module * Split functionality out of main * Updated from global requirements * Fix docs typos * Updated from global requirements * Fix coverage option and execution * Add version option for ostestr and subunit-trace * Remove openstack-common.conf * Add pypi download + version badges into README.rst * remove python 3.3 trove classifier * Treat xfail output like success * Updated from global requirements * correct typo * Enable testr run passthrough arguments * Updated from global requirements * Add unit test for colorizer 0.6.0 ----- * Support comments in whitelist files * Add tool to create a subunit stream * py26/py33 are no longer supported by Infra's CI * remove python 2.6 trove classifier 0.5.0 ----- * Add support to ostestr to use subunit-trace color * Add subunit\_trace --color option's doc * Fix documentation typos * Fix coverage section in tox.ini * Add delete \*.pyc command before executing ostestr * Change to always parsing classes from test\_id * Add colored output feature to subunit-trace * Add \*.egg\* to .gitignore * Fail if no tests were successfully executed * Fix syntax of the README file 0.4.2 ----- * Force utf8 encoding on subunit attachments output 0.4.1 ----- * Better blacklist - tested with Nova 0.4.0 ----- * Add whitelist file support * Fix issues with the blacklist file regex generation * Use test\_to\_run var in no-discover * Minor refactoring to make os\_testr more testable * Switch to using autogenerated ChangeLog in docs * Change ignore-errors to ignore\_errors * Handle a skipped test without a reason message * Minimize output when --abbreviate is used * Make use of argparse groups and add some tests 0.3.0 ----- * Convert file names to regular expressions * Handle incomplete subunit streams * Set min pbr version in setup\_requires * update requirements * Add TODO entry for moving away from subprocess in ostestr * Improved docs for os-testr commands 0.2.0 ----- * Dogfood things for unit tests * Disable printing percent change on run time by default * Misc Python 3 compatibility fixes * Catch exception trying to extract test time * Fix ValueError in subunit\_trace * Add support for having comments in the exclude file * Add TODO file to os-testr 0.1.0 ----- * Fix pep8 issues and add apache header to subunit2html * Flush out the readme in preparation for the first release * Add subunit2html from jenkins slave scripts * Ensure failure is printed with --until-failure in pretty mode * Add --until-failure option to ostestr * Add basic unit tests to check ostestr return codes * Add percent change to duration on subunit-trace output * Use python APIs to call run modules in ostestr * Add ostestr options to control parallelism * Fix the testr init subprocess call * Improve the arguments for ostestr * Fix pep8 issues * Fix return code on test run failure * Add --pdb flag and fix --no-discover flag * Add subunit-trace and ostestr * Initial Cookiecutter Commit ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/HACKING.rst0000664000175000017500000000021200000000000015106 0ustar00zuulzuul00000000000000os-testr Style Commandments =========================== Read the OpenStack Style Commandments https://docs.openstack.org/hacking/latest/ ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/LICENSE0000664000175000017500000002363700000000000014335 0ustar00zuulzuul00000000000000 Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/MANIFEST.in0000664000175000017500000000013600000000000015053 0ustar00zuulzuul00000000000000include AUTHORS include ChangeLog exclude .gitignore exclude .gitreview global-exclude *.pyc ././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3658788 os-testr-3.0.0/PKG-INFO0000664000175000017500000000366700000000000014426 0ustar00zuulzuul00000000000000Metadata-Version: 1.2 Name: os-testr Version: 3.0.0 Summary: A testr wrapper to provide functionality for OpenStack projects Home-page: https://docs.openstack.org/os-testr/latest/ Author: OpenStack Author-email: openstack-discuss@lists.openstack.org License: UNKNOWN Description: ======== os-testr ======== .. image:: https://img.shields.io/pypi/v/os-testr.svg :target: https://pypi.org/project/os-testr/ :alt: Latest Version .. image:: https://img.shields.io/pypi/dm/os-testr.svg :target: https://pypi.org/project/os-testr/ :alt: Downloads A testr wrapper to provide functionality for OpenStack projects. * Free software: Apache license * Documentation: https://docs.openstack.org/os-testr/ * Source: https://opendev.org/openstack/os-testr * Bugs: https://bugs.launchpad.net/os-testr Features -------- * ``subunit-trace``: an output filter for a subunit stream which provides useful information about the run * ``subunit2html``: generates a test results html page from a subunit stream * ``generate-subunit``: generate a subunit stream for a single test .. _stestr: https://stestr.readthedocs.io/ Platform: UNKNOWN Classifier: Environment :: OpenStack Classifier: Intended Audience :: Information Technology Classifier: Intended Audience :: System Administrators Classifier: License :: OSI Approved :: Apache Software License Classifier: Operating System :: POSIX :: Linux Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: Implementation :: CPython Requires-Python: >=3.8 ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/README.rst0000664000175000017500000000151300000000000015004 0ustar00zuulzuul00000000000000======== os-testr ======== .. image:: https://img.shields.io/pypi/v/os-testr.svg :target: https://pypi.org/project/os-testr/ :alt: Latest Version .. image:: https://img.shields.io/pypi/dm/os-testr.svg :target: https://pypi.org/project/os-testr/ :alt: Downloads A testr wrapper to provide functionality for OpenStack projects. * Free software: Apache license * Documentation: https://docs.openstack.org/os-testr/ * Source: https://opendev.org/openstack/os-testr * Bugs: https://bugs.launchpad.net/os-testr Features -------- * ``subunit-trace``: an output filter for a subunit stream which provides useful information about the run * ``subunit2html``: generates a test results html page from a subunit stream * ``generate-subunit``: generate a subunit stream for a single test .. _stestr: https://stestr.readthedocs.io/ ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/babel.cfg0000664000175000017500000000002100000000000015034 0ustar00zuulzuul00000000000000[python: **.py] ././@PaxHeader0000000000000000000000000000003300000000000011451 xustar000000000000000027 mtime=1649075773.353879 os-testr-3.0.0/doc/0000775000175000017500000000000000000000000014062 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/requirements.txt0000664000175000017500000000053200000000000017346 0ustar00zuulzuul00000000000000# The order of packages is significant, because pip processes them in the order # of appearance. Changing the order has an impact on the overall integration # process, which may cause wedges in the gate later. openstackdocstheme>=2.2.1 # Apache-2.0 reno>=3.1.0 # Apache-2.0 sphinx>=2.0.0,!=2.1.0 # BSD sphinxcontrib-svg2pdfconverter>=0.1.0 # BSD ././@PaxHeader0000000000000000000000000000003300000000000011451 xustar000000000000000027 mtime=1649075773.353879 os-testr-3.0.0/doc/source/0000775000175000017500000000000000000000000015362 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/conf.py0000775000175000017500000000721600000000000016672 0ustar00zuulzuul00000000000000# -*- coding: utf-8 -*- # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or # implied. # See the License for the specific language governing permissions and # limitations under the License. import os import sys sys.path.insert(0, os.path.abspath('../..')) # -- General configuration ---------------------------------------------------- # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones. extensions = [ 'sphinx.ext.autodoc', # 'sphinx.ext.intersphinx', 'openstackdocstheme', 'sphinxcontrib.rsvgconverter' ] # openstackdocstheme options openstackdocs_repo_name = 'openstack/os-testr' openstackdocs_auto_name = False openstackdocs_bug_project = 'os-testr' openstackdocs_bug_tag = '' openstackdocs_pdf_link = True # autodoc generation is a bit aggressive and a nuisance when doing heavy # text edit cycles. # execute "export SPHINX_DEBUG=1" in your terminal to disable # The suffix of source filenames. source_suffix = '.rst' # The master toctree document. master_doc = 'index' # General information about the project. project = u'os-testr' copyright = u'2015, Matthew Treinish' # If true, '()' will be appended to :func: etc. cross-reference text. add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). add_module_names = True # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'native' # -- Options for HTML output -------------------------------------------------- # The theme to use for HTML and HTML Help pages. Major themes that come with # Sphinx are currently 'default' and 'sphinxdoc'. # html_theme_path = ["."] html_theme = 'openstackdocs' # html_static_path = ['static'] # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. html_use_smartypants = False # Output file base name for HTML help builder. htmlhelp_basename = '%sdoc' % project # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, author, documentclass # [howto/manual]). latex_documents = [ ('index', '%s.tex' % project, u'%s Documentation' % project, u'Matthew Treinish', 'manual'), ] man_pages = [('ostestr', 'ostestr', 'tooling to run OpenStack tests', ['Matthew Treinish'], 1), ('subunit_trace', 'subunit-trace', 'pretty output filter for ' 'subunit streams', ['Matthew Treinish'], 1), ('subunit2html', 'subunit2html', 'generate a html results page ' 'from a subunit stream', ['Matthew Treinish'], 1)] # Example configuration for intersphinx: refer to the Python standard library. # intersphinx_mapping = {'http://docs.python.org/': None} # -- Options for LaTeX output ------------------------------------------------- # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, author, documentclass # [howto/manual]). latex_documents = [ ('index', 'doc-os-testr.tex', u'Os-testr', u'OpenStack Foundation', 'manual'), ] # Disable usage of xindy https://bugzilla.redhat.com/show_bug.cgi?id=1643664 latex_use_xindy = False latex_elements = { 'extraclassoptions': 'openany,oneside' } ././@PaxHeader0000000000000000000000000000003300000000000011451 xustar000000000000000027 mtime=1649075773.353879 os-testr-3.0.0/doc/source/contributor/0000775000175000017500000000000000000000000017734 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/contributor/contributing.rst0000664000175000017500000000435700000000000023206 0ustar00zuulzuul00000000000000============================ So You Want to Contribute... ============================ For general information on contributing to OpenStack, please check out the `contributor guide `_ to get started. It covers all the basics that are common to all OpenStack projects: the accounts you need, the basics of interacting with our Gerrit review system, how we communicate as a community, etc. Below will cover the more project specific information you need to get started with os-testr. Communication ~~~~~~~~~~~~~ * IRC channel ``#openstack-qa`` at OFTC * Mailing list (prefix subjects with ``[qa]`` for faster responses) http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss Contacting the Core Team ~~~~~~~~~~~~~~~~~~~~~~~~ Please refer to the `os-testr Core Team `_ contacts. New Feature Planning ~~~~~~~~~~~~~~~~~~~~ If you want to propose a new feature please read `Feature Proposal Process`_ os-testr features are tracked on `Launchpad BP `_. Task Tracking ~~~~~~~~~~~~~ We track our tasks in `Launchpad `_. If you're looking for some smaller, easier work item to pick up and get started on, search for the 'low-hanging-fruit' tag. Reporting a Bug ~~~~~~~~~~~~~~~ You found an issue and want to make sure we are aware of it? You can do so on `Launchpad `__. More info about Launchpad usage can be found on `OpenStack docs page `_ Getting Your Patch Merged ~~~~~~~~~~~~~~~~~~~~~~~~~ All changes proposed to the os-testr require two ``Code-Review +2`` votes from os-testr core reviewers before one of the core reviewers can approve the patch by giving ``Workflow +1`` vote. Project Team Lead Duties ~~~~~~~~~~~~~~~~~~~~~~~~ All common PTL duties are enumerated in the `PTL guide `_. The Release Process for QA is documented in `QA Release Process `_. .. _Feature Proposal Process: https://wiki.openstack.org/wiki/QA#Feature_Proposal_.26_Design_discussions ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/index.rst0000664000175000017500000000154300000000000017226 0ustar00zuulzuul00000000000000Welcome to os-testr's documentation! ==================================== .. image:: https://img.shields.io/pypi/v/os-testr.svg :target: https://pypi.org/project/os-testr/ :alt: Latest Version .. image:: https://img.shields.io/pypi/dm/os-testr.svg :target: https://pypi.org/project/os-testr/ :alt: Downloads A testr wrapper to provide functionality for OpenStack projects. * Free software: Apache license * Documentation: https://docs.openstack.org/os-testr/ * Source: https://opendev.org/openstack/os-testr * Bugs: https://bugs.launchpad.net/os-testr * Contributing: If you are a new contributor to os-testr please refer: :doc:`contributor/contributing` Contents ======== .. toctree:: :maxdepth: 2 install/index user/index .. toctree:: :hidden: contributor/contributing Indices and tables ================== * :ref:`search` ././@PaxHeader0000000000000000000000000000003300000000000011451 xustar000000000000000027 mtime=1649075773.353879 os-testr-3.0.0/doc/source/install/0000775000175000017500000000000000000000000017030 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/install/index.rst0000664000175000017500000000030100000000000020663 0ustar00zuulzuul00000000000000============ Installation ============ At the command line:: $ pip install os-testr Or, if you have virtualenvwrapper installed:: $ mkvirtualenv os-testr $ pip install os-testr ././@PaxHeader0000000000000000000000000000003300000000000011451 xustar000000000000000027 mtime=1649075773.357879 os-testr-3.0.0/doc/source/user/0000775000175000017500000000000000000000000016340 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/user/generate_subunit.rst0000664000175000017500000000402000000000000022431 0ustar00zuulzuul00000000000000.. generate_subunit: generate-subunit ================ generate-subunit is a simple tool to, as its name implies, generate a subunit stream. It will generate a stream with a single test result to STDOUT. The subunit protocol lets you concatenate multiple streams together so if you want to generate a stream with multiple just append the output of multiple executions of generate-subunit. Summary ------- :: generate-subunit timestamp secs [status] [test_id] Usage ----- generate-subunit has 2 mandatory arguments. These are needed to specify when the "test" started running and how long it took. The first argument is a POSIX timestamp (which can returned by the date util using ``date +%s``) for when it started running. The second argument is the number of seconds it took for the execution to finish. For example:: $ generate-subunit $(date +%s) 42 will generate a stream with the test_id 'devstack' successfully running for 42 secs starting when the command was executed. This leads into the 2 optional arguments. The first optional argument is for specifying the status. This must be the 3rd argument when calling generate-subunit. Valid status options can be found in the `testtools documentation`_. If status is not specified it will default to success. For example:: $ generate-subunit $(date +%s) 42 fail will be the same as the previous example except that it marks the test as failing. .. _testtools documentation: http://testtools.readthedocs.io/en/latest/api.html#testtools.StreamResult.status The other optional argument is the test_id (aka test name) and is used to identify the "test" being run. For better or worse this defaults to *devstack*. (which is an artifact of why this tool was originally created) Note, this must be the 4th argument when calling generate-subunit. This means you also must specify a status if you want to set your own test_id. For example:: $ generate-subunit %(date +%s) 42 fail my_little_test will generate a subunit stream as before except instead the test will be named my_little_test. ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/user/history.rst0000664000175000017500000000004000000000000020565 0ustar00zuulzuul00000000000000.. include:: ../../../ChangeLog ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/user/index.rst0000664000175000017500000000030100000000000020173 0ustar00zuulzuul00000000000000===== Usage ===== This section contains the documentation for each of tools packaged in os-testr .. toctree:: :maxdepth: 2 subunit_trace subunit2html generate_subunit history ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/user/subunit2html.rst0000664000175000017500000000162400000000000021535 0ustar00zuulzuul00000000000000.. _subunit2html: subunit2html ============ subunit2html is a tool that takes in a subunit stream file and will output an html page Summary ------- :: subunit2html subunit_stream [output] Usage ----- subunit2html takes in 1 mandatory argument. This is used to specify the location of the subunit stream file. For example:: $ subunit2html subunit_stream By default subunit2html will store the generated html results file at results.html file in the current working directory. An optional second argument can be provided to set the output path of the html results file that is generated. If it is provided this will be the output path for saving the generated file, otherwise results.html in the current working directory will be used. For example:: $ subunit2html subunit_stream test_results.html will write the generated html results file to test_results.html in the current working directory ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/doc/source/user/subunit_trace.rst0000664000175000017500000001077600000000000021754 0ustar00zuulzuul00000000000000.. _subunit_trace: subunit-trace ============= subunit-trace is an output filter for subunit streams. It is often used in conjunction with test runners that emit subunit to enable a consistent and useful realtime output from a test run. Summary ------- :: subunit-trace [--fails|-f] [--failonly] [--perc-diff|-d] [--no-summary] [--diff-threshold|-t ] [--color] Options ------- --no-failure-debug, -n Disable printing failure debug information in realtime --fails, -f Print failure debug information after the stream is processed --failonly Don't print success items --perc-diff, -d Print percent change in run time on each test --diff-threshold THRESHOLD, -t THRESHOLD Threshold to use for displaying percent change from the avg run time. If one is not specified the percent change will always be displayed. --no-summary Don't print the summary of the test run after completes --color Print result with colors Usage ----- subunit-trace will take a subunit stream in via STDIN. This is the only input into the tool. It will then print on STDOUT the formatted test result output for the test run information contained in the stream. A subunit v2 stream must be passed into subunit-trace. If only a subunit v1 stream is available you must use the subunit-1to2 utility to convert it before passing the stream into subunit-trace. For example this can be done by chaining pipes:: $ cat subunit_v1 | subunit-1to2 | subunit-trace Adjusting per test output ^^^^^^^^^^^^^^^^^^^^^^^^^ subunit-trace provides several options to customize it's output. This allows users to customize the output from subunit-trace to suit their needs. The output from subunit-trace basically comes in 2 parts, the per test output, and the summary at the end. By default subunit-trace will print failure messages during the per test output, meaning when a test fails it will also print the message and any traceback and other attachments at that time. However this can be disabled by using --no-failure-debug, -n. For example:: $ testr run --subunit | subunit-trace --no-failure-debug Here is also the option to print all failures together at the end of the test run before the summary view. This is done using the --fails/-f option. For example:: $ testr run --subunit | subunit-trace --fails Often the --fails and --no-failure-debug options are used in conjunction to only print failures at the end of a test run. This is useful for large test suites where an error message might be lost in the noise. To do this :: $ testr run --subunit | subunit-trace --fails --no-failure-debug By default subunit-trace will print a line for each test after it completes with the test status. However, if you only want to see the run time output for failures and not any other test status you can use the --failonly option. For example:: $ testr run --subunit | subunit-trace --failonly The last output option provided by subunit-trace is to disable the summary view of the test run which is normally displayed at the end of a run. You can do this using the --no-summary option. For example:: $ testr run --subunit | subunit-trace --no-summary Show per test run time percent change ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ subunit-trace provides an option to display the percent change in run time from the previous run. To do this subunit-trace leverages the testr internals a bit. It uses the times.dbm database which, the file repository type in testrepository will create, to get the previous run time for a test. If testr hasn't ever been used before or for whatever reason subunit-trace is unable to find the times.dbm file from testr no percentages will be displayed even if it's enabled. Additionally, if a test is run which does not have an entry in the times.dbm file will not have a percentage printed for it. To enable this feature you use --perc-diff/-d, for example:: $ testr run --subunit | subunit-trace --perc-diff There is also the option to set a threshold value for this option. If used it acts as an absolute value and only percentage changes that exceed it will be printed. Use the --diff-threshold/-t option to set a threshold, for example:: $ testr run --subunit | subunit-trace --perc-diff --threshold 45 This will only display percent differences when the change in run time is either >=45% faster or <=45% slower. ././@PaxHeader0000000000000000000000000000003300000000000011451 xustar000000000000000027 mtime=1649075773.357879 os-testr-3.0.0/os_testr/0000775000175000017500000000000000000000000015157 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/__init__.py0000664000175000017500000000123000000000000017264 0ustar00zuulzuul00000000000000# -*- coding: utf-8 -*- # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. import pbr.version __version__ = pbr.version.VersionInfo( 'os_testr').version_string() ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/generate_subunit.py0000775000175000017500000000312700000000000021102 0ustar00zuulzuul00000000000000#!/usr/bin/env python3 # Copyright 2015 Hewlett-Packard Development Company, L.P. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. import datetime import sys import pbr.version import subunit from subunit import iso8601 __version__ = pbr.version.VersionInfo('os_testr').version_string() def main(): if '--version' in sys.argv: print(__version__) exit(0) start_time = datetime.datetime.fromtimestamp(float(sys.argv[1])).replace( tzinfo=iso8601.UTC) elapsed_time = datetime.timedelta(seconds=int(sys.argv[2])) stop_time = start_time + elapsed_time if len(sys.argv) > 3: status = sys.argv[3] else: status = 'success' if len(sys.argv) > 4: test_id = sys.argv[4] else: test_id = 'devstack' # Write the subunit test output = subunit.v2.StreamResultToBytes(sys.stdout) output.startTestRun() output.status(timestamp=start_time, test_id=test_id) # Write the end of the test output.status(test_status=status, timestamp=stop_time, test_id=test_id) output.stopTestRun() if __name__ == '__main__': main() ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/subunit2html.py0000775000175000017500000005565000000000000020207 0ustar00zuulzuul00000000000000#!/usr/bin/python # # Copyright 2012-2013 Hewlett-Packard Development Company, L.P. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. """ Utility to convert a subunit stream to an html results file. Code is adapted from the pyunit Html test runner at http://tungwaiyip.info/software/HTMLTestRunner.html Takes two arguments. First argument is path to subunit log file, second argument is path of desired output file. Second argument is optional, defaults to 'results.html'. Original HTMLTestRunner License: ------------------------------------------------------------------------ Copyright (c) 2004-2007, Wai Yip Tung All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name Wai Yip Tung nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. """ import codecs import collections import datetime import io import sys import traceback from xml.sax import saxutils import pbr.version import subunit import testtools __version__ = pbr.version.VersionInfo('os_testr').version_string() class TemplateData(object): """Define a HTML template for report customerization and generation. Overall structure of an HTML report HTML +------------------------+ | | | | | | | STYLESHEET | | +----------------+ | | | | | | +----------------+ | | | | | | | | | | | | HEADING | | +----------------+ | | | | | | +----------------+ | | | | REPORT | | +----------------+ | | | | | | +----------------+ | | | | ENDING | | +----------------+ | | | | | | +----------------+ | | | | | | | +------------------------+ """ STATUS = { 0: 'pass', 1: 'fail', 2: 'error', 3: 'skip', } DEFAULT_TITLE = 'Unit Test Report' DEFAULT_DESCRIPTION = '' # ------------------------------------------------------------------------ # HTML Template HTML_TMPL = r""" %(title)s %(stylesheet)s %(heading)s %(report)s %(ending)s """ # variables: (title, generator, stylesheet, heading, report, ending) # ------------------------------------------------------------------------ # Stylesheet # # alternatively use a for external style sheet, e.g. # STYLESHEET_TMPL = """ """ # ------------------------------------------------------------------------ # Heading # HEADING_TMPL = """

%(title)s

%(parameters)s

%(description)s

""" # variables: (title, parameters, description) HEADING_ATTRIBUTE_TMPL = """

%(name)s: %(value)s

""" # variables: (name, value) # ------------------------------------------------------------------------ # Report # REPORT_TMPL = """

Show Summary Failed All

%(test_list)s
Test Group/Test case Count Pass Fail Error Skip View
Total %(count)s %(Pass)s %(fail)s %(error)s %(skip)s    
""" # variables: (test_list, count, Pass, fail, error) REPORT_CLASS_TMPL = r""" %(desc)s %(count)s %(Pass)s %(fail)s %(error)s %(skip)s Detail """ # variables: (style, desc, count, Pass, fail, error, cid) REPORT_TEST_WITH_OUTPUT_TMPL = r"""
%(desc)s
%(status)s """ # variables: (tid, Class, style, desc, status) REPORT_TEST_NO_OUTPUT_TMPL = r"""
%(desc)s
%(status)s """ # variables: (tid, Class, style, desc, status) REPORT_TEST_OUTPUT_TMPL = r""" %(id)s: %(output)s """ # variables: (id, output) # ------------------------------------------------------------------------ # ENDING # ENDING_TMPL = """
 
""" # -------------------- The end of the Template class ------------------- class ClassInfoWrapper(object): def __init__(self, name, mod): self.name = name self.mod = mod def __repr__(self): return "%s" % (self.name) class HtmlOutput(testtools.TestResult): """Output test results in html.""" def __init__(self, html_file='result.html'): super(HtmlOutput, self).__init__() self.success_count = 0 self.failure_count = 0 self.error_count = 0 self.skip_count = 0 self.result = [] self.html_file = html_file def addSuccess(self, test): self.success_count += 1 output = test.shortDescription() if output is None: output = test.id() self.result.append((0, test, output, '')) def addSkip(self, test, err): output = test.shortDescription() if output is None: output = test.id() self.skip_count += 1 self.result.append((3, test, output, '')) def addError(self, test, err): output = test.shortDescription() if output is None: output = test.id() # Skipped tests are handled by SkipTest Exceptions. # if err[0] == SkipTest: # self.skip_count += 1 # self.result.append((3, test, output, '')) else: self.error_count += 1 _exc_str = self.formatErr(err) self.result.append((2, test, output, _exc_str)) def addFailure(self, test, err): print(test) self.failure_count += 1 _exc_str = self.formatErr(err) output = test.shortDescription() if output is None: output = test.id() self.result.append((1, test, output, _exc_str)) def formatErr(self, err): exctype, value, tb = err return ''.join(traceback.format_exception(exctype, value, tb)) def stopTestRun(self): super(HtmlOutput, self).stopTestRun() self.stopTime = datetime.datetime.now() report_attrs = self._getReportAttributes() generator = 'subunit2html %s' % __version__ heading = self._generate_heading(report_attrs) report = self._generate_report() ending = self._generate_ending() output = TemplateData.HTML_TMPL % dict( title=saxutils.escape(TemplateData.DEFAULT_TITLE), generator=generator, stylesheet=TemplateData.STYLESHEET_TMPL, heading=heading, report=report, ending=ending, ) if self.html_file: with open(self.html_file, 'wb') as html_file: html_file.write(output.encode('utf8')) def _getReportAttributes(self): """Return report attributes as a list of (name, value).""" status = [] if self.success_count: status.append('Pass %s' % self.success_count) if self.failure_count: status.append('Failure %s' % self.failure_count) if self.error_count: status.append('Error %s' % self.error_count) if self.skip_count: status.append('Skip %s' % self.skip_count) if status: status = ' '.join(status) else: status = 'none' return [ ('Status', status), ] def _generate_heading(self, report_attrs): a_lines = [] for name, value in report_attrs: line = TemplateData.HEADING_ATTRIBUTE_TMPL % dict( name=saxutils.escape(name), value=saxutils.escape(value), ) a_lines.append(line) heading = TemplateData.HEADING_TMPL % dict( title=saxutils.escape(TemplateData.DEFAULT_TITLE), parameters=''.join(a_lines), description=saxutils.escape(TemplateData.DEFAULT_DESCRIPTION), ) return heading def _generate_report(self): rows = [] sortedResult = self._sortResult(self.result) for cid, (cls, cls_results) in enumerate(sortedResult): # subtotal for a class np = nf = ne = ns = 0 for n, t, o, e in cls_results: if n == 0: np += 1 elif n == 1: nf += 1 elif n == 2: ne += 1 else: ns += 1 # format class description if cls.mod == "__main__": name = cls.name else: name = "%s" % (cls.name) doc = cls.__doc__ and cls.__doc__.split("\n")[0] or "" desc = doc and '%s: %s' % (name, doc) or name row = TemplateData.REPORT_CLASS_TMPL % dict( style=(ne > 0 and 'errorClass' or nf > 0 and 'failClass' or 'passClass'), desc=desc, count=np + nf + ne + ns, Pass=np, fail=nf, error=ne, skip=ns, cid='c%s' % (cid + 1), ) rows.append(row) for tid, (n, t, o, e) in enumerate(cls_results): self._generate_report_test(rows, cid, tid, n, t, o, e) report = TemplateData.REPORT_TMPL % dict( test_list=''.join(rows), count=str(self.success_count + self.failure_count + self.error_count + self.skip_count), Pass=str(self.success_count), fail=str(self.failure_count), error=str(self.error_count), skip=str(self.skip_count), ) return report def _sortResult(self, result_list): # unittest does not seems to run in any particular order. # Here at least we want to group them together by class. rmap = {} classes = [] # Differentiate between classes that have test failures so we can sort # them at the top of the html page for easier troubleshooting clsmap_has_failure = collections.defaultdict(bool) def track_has_failure(name, n): if n == 1 or n == 2: clsmap_has_failure[name] = True for n, t, o, e in result_list: if hasattr(t, '_tests'): for inner_test in t._tests: name = self._add_cls(rmap, classes, inner_test, (n, inner_test, o, e)) track_has_failure(name, n) else: name = self._add_cls(rmap, classes, t, (n, t, o, e)) track_has_failure(name, n) failclasses = [] passclasses = [] for cls in classes: append_to = (failclasses if clsmap_has_failure[str(cls)] else passclasses) append_to.append(cls) classort = lambda s: str(s) sortedfailclasses = sorted(failclasses, key=classort) sortedpassclasses = sorted(passclasses, key=classort) sortedclasses = sortedfailclasses + sortedpassclasses r = [(cls, rmap[str(cls)]) for cls in sortedclasses] return r def _add_cls(self, rmap, classes, test, data_tuple): if hasattr(test, 'test'): test = test.test if test.__class__ == subunit.RemotedTestCase: cl = test._RemotedTestCase__description.rsplit('.', 1)[0] else: cl = test.id().rsplit('.', 1)[0] mod = cl.rsplit('.', 1)[0] cls = ClassInfoWrapper(cl, mod) if not str(cls) in rmap: rmap[str(cls)] = [] classes.append(cls) rmap[str(cls)].append(data_tuple) return str(cls) def _generate_report_test(self, rows, cid, tid, n, t, o, e): # e.g. 'pt1.1', 'ft1.1', etc # ptx.x for passed/skipped tests and ftx.x for failed/errored tests. has_output = bool(o or e) tid = ((n == 0 or n == 3) and 'p' or 'f') + 't%s.%s' % (cid + 1, tid + 1) name = t.id().split('.')[-1] # if shortDescription is not the function name, use it if t.shortDescription().find(name) == -1: doc = t.shortDescription() else: doc = None desc = doc and ('%s: %s' % (name, doc)) or name tmpl = (has_output and TemplateData.REPORT_TEST_WITH_OUTPUT_TMPL or TemplateData.REPORT_TEST_NO_OUTPUT_TMPL) try: output = saxutils.escape(o + e) # We expect to get this exception in python2. except UnicodeDecodeError: e = codecs.decode(e, 'utf-8') output = saxutils.escape(o + e) script = TemplateData.REPORT_TEST_OUTPUT_TMPL % dict( id=tid, output=output, ) row = tmpl % dict( tid=tid, Class=((n == 0 or n == 3) and 'hiddenRow' or 'none'), style=(n == 2 and 'errorCase' or (n == 1 and 'failCase' or 'none')), desc=desc, script=script, status=TemplateData.STATUS[n], ) rows.append(row) if not has_output: return def _generate_ending(self): return TemplateData.ENDING_TMPL def startTestRun(self): super(HtmlOutput, self).startTestRun() class FileAccumulator(testtools.StreamResult): def __init__(self): super(FileAccumulator, self).__init__() self.route_codes = collections.defaultdict(io.BytesIO) def status(self, **kwargs): if kwargs.get('file_name') != 'stdout': return file_bytes = kwargs.get('file_bytes') if not file_bytes: return route_code = kwargs.get('route_code') stream = self.route_codes[route_code] stream.write(file_bytes) def main(): if '--version' in sys.argv: print(__version__) exit(0) if len(sys.argv) < 2: print("Need at least one argument: path to subunit log.") exit(1) subunit_file = sys.argv[1] if len(sys.argv) > 2: html_file = sys.argv[2] else: html_file = 'results.html' html_result = HtmlOutput(html_file) stream = open(subunit_file, 'rb') # Feed the subunit stream through both a V1 and V2 parser. # Depends on having the v2 capable libraries installed. # First V2. # Non-v2 content and captured non-test output will be presented as file # segments called stdout. suite = subunit.ByteStreamToStreamResult(stream, non_subunit_name='stdout') # The HTML output code is in legacy mode. result = testtools.StreamToExtendedDecorator(html_result) # Divert non-test output accumulator = FileAccumulator() result = testtools.StreamResultRouter(result) result.add_rule(accumulator, 'test_id', test_id=None) result.startTestRun() suite.run(result) # Now reprocess any found stdout content as V1 subunit for bytes_io in accumulator.route_codes.values(): bytes_io.seek(0) suite = subunit.ProtocolTestCase(bytes_io) suite.run(html_result) result.stopTestRun() if __name__ == '__main__': main() ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/subunit_trace.py0000775000175000017500000003447100000000000020414 0ustar00zuulzuul00000000000000#!/usr/bin/env python3 # Copyright 2014 Hewlett-Packard Development Company, L.P. # Copyright 2014 Samsung Electronics # All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. """Trace a subunit stream in reasonable detail and high accuracy.""" import argparse import datetime import functools import os import re import sys import pbr.version import subunit import testtools from os_testr.utils import colorizer # NOTE(mtreinish) on python3 anydbm was renamed dbm and the python2 dbm module # was renamed to dbm.ndbm, this block takes that into account try: import anydbm as dbm except ImportError: import dbm DAY_SECONDS = 60 * 60 * 24 FAILS = [] RESULTS = {} def total_seconds(timedelta): # NOTE(mtreinish): This method is built-in to the timedelta class in # python >= 2.7 it is here to enable it's use on older versions return ((timedelta.days * DAY_SECONDS + timedelta.seconds) * 10 ** 6 + timedelta.microseconds) / 10 ** 6 def cleanup_test_name(name, strip_tags=True, strip_scenarios=False): """Clean up the test name for display. By default we strip out the tags in the test because they don't help us in identifying the test that is run to it's result. Make it possible to strip out the testscenarios information (not to be confused with tempest scenarios) however that's often needed to indentify generated negative tests. """ if strip_tags: tags_start = name.find('[') tags_end = name.find(']') if tags_start > 0 and tags_end > tags_start: newname = name[:tags_start] newname += name[tags_end + 1:] name = newname if strip_scenarios: tags_start = name.find('(') tags_end = name.find(')') if tags_start > 0 and tags_end > tags_start: newname = name[:tags_start] newname += name[tags_end + 1:] name = newname return name def get_duration(timestamps): start, end = timestamps if not start or not end: duration = '' else: delta = end - start duration = '%d.%06ds' % ( delta.days * DAY_SECONDS + delta.seconds, delta.microseconds) return duration def find_worker(test): """Get the worker number. If there are no workers because we aren't in a concurrent environment, assume the worker number is 0. """ for tag in test['tags']: if tag.startswith('worker-'): return int(tag[7:]) return 0 # Print out stdout/stderr if it exists, always def print_attachments(stream, test, all_channels=False): """Print out subunit attachments. Print out subunit attachments that contain content. This runs in 2 modes, one for successes where we print out just stdout and stderr, and an override that dumps all the attachments. """ channels = ('stdout', 'stderr') for name, detail in test['details'].items(): # NOTE(sdague): the subunit names are a little crazy, and actually # are in the form pythonlogging:'' (with the colon and quotes) name = name.split(':')[0] if detail.content_type.type == 'test': detail.content_type.type = 'text' if (all_channels or name in channels) and detail.as_text(): title = "Captured %s:" % name stream.write("\n%s\n%s\n" % (title, ('~' * len(title)))) # indent attachment lines 4 spaces to make them visually # offset for line in detail.as_text().split('\n'): line = line.encode('utf8') stream.write(" %s\n" % line) def find_test_run_time_diff(test_id, run_time): times_db_path = os.path.join(os.path.join(os.getcwd(), '.testrepository'), 'times.dbm') if os.path.isfile(times_db_path): try: test_times = dbm.open(times_db_path) except Exception: return False try: avg_runtime = float(test_times.get(str(test_id), False)) except Exception: try: avg_runtime = float(test_times[str(test_id)]) except Exception: avg_runtime = False if avg_runtime and avg_runtime > 0: run_time = float(run_time.rstrip('s')) perc_diff = ((run_time - avg_runtime) / avg_runtime) * 100 return perc_diff return False def show_outcome(stream, test, print_failures=False, failonly=False, enable_diff=False, threshold='0', abbreviate=False, enable_color=False): global RESULTS status = test['status'] # TODO(sdague): ask lifeless why on this? if status == 'exists': return worker = find_worker(test) name = cleanup_test_name(test['id']) duration = get_duration(test['timestamps']) if worker not in RESULTS: RESULTS[worker] = [] RESULTS[worker].append(test) # don't count the end of the return code as a fail if name == 'process-returncode': return for color in [colorizer.AnsiColorizer, colorizer.NullColorizer]: if not enable_color: color = colorizer.NullColorizer(stream) break if color.supported(): color = color(stream) break if status == 'fail' or status == 'uxsuccess': FAILS.append(test) if abbreviate: color.write('F', 'red') else: stream.write('{%s} %s [%s] ... ' % ( worker, name, duration)) color.write('FAILED', 'red') stream.write('\n') if not print_failures: print_attachments(stream, test, all_channels=True) elif not failonly: if status == 'success' or status == 'xfail': if abbreviate: color.write('.', 'green') else: out_string = '{%s} %s [%s' % (worker, name, duration) perc_diff = find_test_run_time_diff(test['id'], duration) if enable_diff: if perc_diff and abs(perc_diff) >= abs(float(threshold)): if perc_diff > 0: out_string = out_string + ' +%.2f%%' % perc_diff else: out_string = out_string + ' %.2f%%' % perc_diff stream.write(out_string + '] ... ') color.write('ok', 'green') stream.write('\n') print_attachments(stream, test) elif status == 'skip': if abbreviate: color.write('S', 'blue') else: reason = test['details'].get('reason', '') if reason: reason = ': ' + reason.as_text() stream.write('{%s} %s ... ' % ( worker, name)) color.write('SKIPPED', 'blue') stream.write('%s' % (reason)) stream.write('\n') else: if abbreviate: stream.write('%s' % test['status'][0]) else: stream.write('{%s} %s [%s] ... %s\n' % ( worker, name, duration, test['status'])) if not print_failures: print_attachments(stream, test, all_channels=True) stream.flush() def print_fails(stream): """Print summary failure report. Currently unused, however there remains debate on inline vs. at end reporting, so leave the utility function for later use. """ if not FAILS: return stream.write("\n==============================\n") stream.write("Failed %s tests - output below:" % len(FAILS)) stream.write("\n==============================\n") for f in FAILS: stream.write("\n%s\n" % f['id']) stream.write("%s\n" % ('-' * len(f['id']))) print_attachments(stream, f, all_channels=True) stream.write('\n') def count_tests(key, value): count = 0 for k, v in RESULTS.items(): for item in v: if key in item: if re.search(value, item[key]): count += 1 return count def run_time(): runtime = 0.0 for k, v in RESULTS.items(): for test in v: test_dur = get_duration(test['timestamps']).strip('s') # NOTE(toabctl): get_duration() can return an empty string # which leads to a ValueError when casting to float if test_dur: runtime += float(test_dur) return runtime def worker_stats(worker): tests = RESULTS[worker] num_tests = len(tests) stop_time = tests[-1]['timestamps'][1] start_time = tests[0]['timestamps'][0] if not start_time or not stop_time: delta = 'N/A' else: delta = stop_time - start_time return num_tests, str(delta) def print_summary(stream, elapsed_time): stream.write("\n======\nTotals\n======\n") stream.write("Ran: %s tests in %.4f sec.\n" % ( count_tests('status', '.*'), total_seconds(elapsed_time))) stream.write(" - Passed: %s\n" % count_tests('status', '^success$')) stream.write(" - Skipped: %s\n" % count_tests('status', '^skip$')) stream.write(" - Expected Fail: %s\n" % count_tests('status', '^xfail$')) stream.write(" - Unexpected Success: %s\n" % count_tests('status', '^uxsuccess$')) stream.write(" - Failed: %s\n" % count_tests('status', '^fail$')) stream.write("Sum of execute time for each test: %.4f sec.\n" % run_time()) # we could have no results, especially as we filter out the process-codes if RESULTS: stream.write("\n==============\nWorker Balance\n==============\n") for w in range(max(RESULTS.keys()) + 1): if w not in RESULTS: stream.write( " - WARNING: missing Worker %s! " "Race in testr accounting.\n" % w) else: num, time = worker_stats(w) out_str = " - Worker %s (%s tests) => %s" % (w, num, time) if time.isdigit(): out_str += 's' out_str += '\n' stream.write(out_str) __version__ = pbr.version.VersionInfo('os_testr').version_string() def parse_args(): parser = argparse.ArgumentParser() parser.add_argument('--version', action='version', version='%s' % __version__) parser.add_argument('--no-failure-debug', '-n', action='store_true', dest='print_failures', help='Disable printing failure ' 'debug information in realtime') parser.add_argument('--fails', '-f', action='store_true', dest='post_fails', help='Print failure debug ' 'information after the stream is proccesed') parser.add_argument('--failonly', action='store_true', dest='failonly', help="Don't print success items", default=( os.environ.get('TRACE_FAILONLY', False) is not False)) parser.add_argument('--abbreviate', '-a', action='store_true', dest='abbreviate', help='Print one character status' 'for each test') parser.add_argument('--perc-diff', '-d', action='store_true', dest='enable_diff', help="Print percent change in run time on each test ") parser.add_argument('--diff-threshold', '-t', dest='threshold', help="Threshold to use for displaying percent change " "from the avg run time. If one is not specified " "the percent change will always be displayed") parser.add_argument('--no-summary', action='store_true', help="Don't print the summary of the test run after " " completes") parser.add_argument('--color', action='store_true', help="Print results with colors") return parser.parse_args() def trace(stdin, stdout, print_failures=False, failonly=False, enable_diff=False, abbreviate=False, color=False, post_fails=False, no_summary=False): stream = subunit.ByteStreamToStreamResult( stdin, non_subunit_name='stdout') outcomes = testtools.StreamToDict( functools.partial(show_outcome, stdout, print_failures=print_failures, failonly=failonly, enable_diff=enable_diff, abbreviate=abbreviate, enable_color=color)) summary = testtools.StreamSummary() result = testtools.CopyStreamResult([outcomes, summary]) result = testtools.StreamResultRouter(result) cat = subunit.test_results.CatFiles(stdout) result.add_rule(cat, 'test_id', test_id=None) start_time = datetime.datetime.utcnow() result.startTestRun() try: stream.run(result) finally: result.stopTestRun() stop_time = datetime.datetime.utcnow() elapsed_time = stop_time - start_time if count_tests('status', '.*') == 0: print("The test run didn't actually run any tests") return 1 if post_fails: print_fails(stdout) if not no_summary: print_summary(stdout, elapsed_time) # NOTE(mtreinish): Ideally this should live in testtools streamSummary # this is just in place until the behavior lands there (if it ever does) if count_tests('status', '^success$') == 0: print("\nNo tests were successful during the run") return 1 return 0 if summary.wasSuccessful() else 1 def main(): args = parse_args() exit(trace(sys.stdin, sys.stdout, args.print_failures, args.failonly, args.enable_diff, args.abbreviate, args.color, args.post_fails, args.no_summary)) if __name__ == '__main__': main() ././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3618789 os-testr-3.0.0/os_testr/tests/0000775000175000017500000000000000000000000016321 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/__init__.py0000664000175000017500000000000000000000000020420 0ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/base.py0000664000175000017500000000143200000000000017605 0ustar00zuulzuul00000000000000# -*- coding: utf-8 -*- # Copyright 2010-2011 OpenStack Foundation # Copyright (c) 2013 Hewlett-Packard Development Company, L.P. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. from oslotest import base class TestCase(base.BaseTestCase): """Test case base class for all unit tests.""" ././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3618789 os-testr-3.0.0/os_testr/tests/files/0000775000175000017500000000000000000000000017423 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/files/__init__.py0000664000175000017500000000000000000000000021522 0ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/files/failing-tests0000664000175000017500000000147400000000000022125 0ustar00zuulzuul00000000000000# Copyright 2013 IBM Corp. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. import testtools class FakeTestClass(testtools.TestCase): def test_pass(self): self.assertTrue(False) def test_pass_list(self): test_list = ['test', 'a', 'b'] self.assertIn('fail', test_list) ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/files/passing-tests0000664000175000017500000000147300000000000022157 0ustar00zuulzuul00000000000000# Copyright 2013 IBM Corp. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. import testtools class FakeTestClass(testtools.TestCase): def test_pass(self): self.assertTrue(True) def test_pass_list(self): test_list = ['test', 'a', 'b'] self.assertIn('test', test_list) ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/files/setup.cfg0000664000175000017500000000114700000000000021247 0ustar00zuulzuul00000000000000[metadata] name = tempest_unit_tests version = 1 summary = Fake Project for testing wrapper scripts author = OpenStack author-email = openstack-discuss@lists.openstack.org home-page = https://www.openstack.org/ classifier = Intended Audience :: Information Technology Intended Audience :: System Administrators Intended Audience :: Developers License :: OSI Approved :: Apache Software License Operating System :: POSIX :: Linux Programming Language :: Python Programming Language :: Python :: 2 Programming Language :: Python :: 2.7 [global] setup-hooks = pbr.hooks.setup_hook ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/files/stestr-conf0000664000175000017500000000006400000000000021615 0ustar00zuulzuul00000000000000[DEFAULT] test_path=./tests group_regex=([^\.]*\.)* ././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3618789 os-testr-3.0.0/os_testr/tests/sample_streams/0000775000175000017500000000000000000000000021340 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/sample_streams/all_skips.subunit0000664000175000017500000000462500000000000024743 0ustar00zuulzuul00000000000000ł+@\VK¬ÎۧX€@IsetUpClass (tempest.api.data_processing.test_data_sources.DataSourceTest)1`Ł’ł+p@–VK¬ÎۧX€@IsetUpClass (tempest.api.data_processing.test_data_sources.DataSourceTest)text/plain;charset=utf8reasonSahara support is requiredűkůÎł+…@fVK¬ÎۧX€@IsetUpClass (tempest.api.data_processing.test_data_sources.DataSourceTest)worker-1đ°+ęł+@LVK¬ÎŰ®ć:setUpClass (tempest.api.data_processing.test_jobs.JobTest)Dť-Tł+p@†VK¬ÎŰ®ć:setUpClass (tempest.api.data_processing.test_jobs.JobTest)text/plain;charset=utf8reasonSahara support is required[×lKł+…@VVK¬ÎŰ®ć:setUpClass (tempest.api.data_processing.test_jobs.JobTest)worker-1Ď›™Čł+@fVK¬ÎçÚŞĐ@SsetUpClass (tempest.api.data_processing.test_cluster_templates.ClusterTemplateTest)„‘ł+p@ VK¬ÎçÚŞĐ@SsetUpClass (tempest.api.data_processing.test_cluster_templates.ClusterTemplateTest)text/plain;charset=utf8reasonSahara support is requiredŻ=wŢł+…@pVK¬ÎçÚŞĐ@SsetUpClass (tempest.api.data_processing.test_cluster_templates.ClusterTemplateTest)worker-3“Ü8!ł+@kVK¬Îőš+@XsetUpClass (tempest.api.data_processing.test_job_binary_internals.JobBinaryInternalTest)Ôshł+p@ĄVK¬Îőš+@XsetUpClass (tempest.api.data_processing.test_job_binary_internals.JobBinaryInternalTest)text/plain;charset=utf8reasonSahara support is requiredÁV¤ł+…@uVK¬Îőš+@XsetUpClass (tempest.api.data_processing.test_job_binary_internals.JobBinaryInternalTest)worker-2>ö˙ł+@kVK¬ÎőŁ¨°@XsetUpClass (tempest.api.data_processing.test_node_group_templates.NodeGroupTemplateTest)sZUł+p@ĄVK¬ÎőŁ¨°@XsetUpClass (tempest.api.data_processing.test_node_group_templates.NodeGroupTemplateTest)text/plain;charset=utf8reasonSahara support is requiredq\aZł+…@uVK¬ÎőŁ¨°@XsetUpClass (tempest.api.data_processing.test_node_group_templates.NodeGroupTemplateTest)worker-2×Ďăęł+@[VK¬Đň Č@HsetUpClass (tempest.api.data_processing.test_job_binaries.JobBinaryTest),ył+p@•VK¬Đň Č@HsetUpClass (tempest.api.data_processing.test_job_binaries.JobBinaryTest)text/plain;charset=utf8reasonSahara support is requiredM[ľł+…@eVK¬Đň Č@HsetUpClass (tempest.api.data_processing.test_job_binaries.JobBinaryTest)worker-0T§ Fł+@TVK¬Đň®¸@AsetUpClass (tempest.api.data_processing.test_plugins.PluginsTest)]Q$ţł+p@ŽVK¬Đň®¸@AsetUpClass (tempest.api.data_processing.test_plugins.PluginsTest)text/plain;charset=utf8reasonSahara support is requiredj9ćł+…@^VK¬Đň®¸@AsetUpClass (tempest.api.data_processing.test_plugins.PluginsTest)worker-0YĐ®Ň././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/sample_streams/successful.subunit0000664000175000017500000003042300000000000025134 0ustar00zuulzuul00000000000000ł+@JV&`Ţ‹¸8os_testr.tests.test_os_testr.TestGetParser.test_parallelJ”˝Ţł+pBV&`ŢśłP8os_testr.tests.test_os_testr.TestGetParser.test_paralleltext/plain;charset="utf8"stderrA˛usage: run.py [-h] [--blacklist_file BLACKLIST_FILE] [--regex REGEX | --path FILE_OR_DIRECTORY | --no-discover TEST_ID] [--pretty | --no-pretty] [--subunit] [--list] [--slowest | --no-slowest] [--pdb TEST_ID] [--parallel | --serial] [--concurrency WORKERS] [--until-failure] [--print-exclude] run.py: error: argument --serial: not allowed with argument --parallel ܱW?ł+p@lV&`ŢśłP8os_testr.tests.test_os_testr.TestGetParser.test_paralleltext/plain;charset="utf8"stdoutŢł+@VV&bĹŞl:os_testr.tests.test_return_codes.TestReturnCodes.test_listworker-6´W9'ł+@^V&aă°@Kos_testr.tests.test_return_codes.TestReturnCodes.test_testr_subunit_passingŕö ‹ł+p@€V&bÎGh@Kos_testr.tests.test_return_codes.TestReturnCodes.test_testr_subunit_passingtext/plain;charset="utf8"stderrĆś/Jł+p@€V&bÎGh@Kos_testr.tests.test_return_codes.TestReturnCodes.test_testr_subunit_passingtext/plain;charset="utf8"stdoutú4~-ł+@hV&bÎGh@Kos_testr.tests.test_return_codes.TestReturnCodes.test_testr_subunit_passingworker-7‰‰W–././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/test_subunit2html.py0000664000175000017500000000717700000000000022406 0ustar00zuulzuul00000000000000# Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. import sys from ddt import data from ddt import ddt from subunit import RemotedTestCase from testtools import PlaceHolder from os_testr import subunit2html from os_testr.tests import base @ddt class TestSubunit2html(base.TestCase): @data(RemotedTestCase, PlaceHolder) def test_class_parsing(self, test_cls): """Tests that the class paths are parsed for v1 & v2 tests""" test_ = test_cls("example.path.to.test.method") obj_ = subunit2html.HtmlOutput() cls_ = [] obj_._add_cls({}, cls_, test_, ()) self.assertEqual("example.path.to.test", cls_[0].name) @data(RemotedTestCase, PlaceHolder) def test_result_sorting(self, test_cls): tests = [] for i in range(9): tests.append(test_cls('example.path.to.test%d.method' % i)) # addFailure, addError, and addSkip need the real exc_info try: raise Exception('fake') except Exception: err = sys.exc_info() obj = subunit2html.HtmlOutput() obj.addSuccess(tests[3]) obj.addSuccess(tests[1]) # example.path.to.test2 has a failure obj.addFailure(tests[2], err) obj.addSkip(tests[0], err) obj.addSuccess(tests[8]) # example.path.to.test5 has a failure (error) obj.addError(tests[5], err) # example.path.to.test4 has a failure obj.addFailure(tests[4], err) obj.addSuccess(tests[7]) # example.path.to.test6 has a success, a failure, and a success obj.addSuccess(tests[6]) obj.addFailure(tests[6], err) obj.addSuccess(tests[6]) sorted_result = obj._sortResult(obj.result) # _sortResult returns a list of results of format: # [(class, [test_result_tuple, ...]), ...] # sorted by str(class) # # Classes with failures (2, 4, 5, and 6) should be sorted separately # at the top. The rest of the classes should be in sorted order after. expected_class_order = ['example.path.to.test2', 'example.path.to.test4', 'example.path.to.test5', 'example.path.to.test6', 'example.path.to.test0', 'example.path.to.test1', 'example.path.to.test3', 'example.path.to.test7', 'example.path.to.test8'] for i, r in enumerate(sorted_result): self.assertEqual(expected_class_order[i], str(r[0])) @data(RemotedTestCase, PlaceHolder) def test_generate_report_with_no_ascii_characters(self, test_cls): # The test examines a case where an error containing no ascii # characters is received. test = test_cls(u'example.path.to.test1.method') try: raise Exception('\xe2\x82\xa5') except Exception: err = sys.exc_info() obj = subunit2html.HtmlOutput() # Add failure that contains no ascii characters obj.addFailure(test, err) obj._generate_report() ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/test_subunit_trace.py0000664000175000017500000000641100000000000022603 0ustar00zuulzuul00000000000000# Copyright 2015 SUSE Linux GmbH # All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. from datetime import datetime as dt import io import os import subprocess import sys from unittest.mock import patch from ddt import data from ddt import ddt from ddt import unpack import six from os_testr import subunit_trace from os_testr.tests import base @ddt class TestSubunitTrace(base.TestCase): @data(([dt(2015, 4, 17, 22, 23, 14, 111111), dt(2015, 4, 17, 22, 23, 14, 111111)], "0.000000s"), ([dt(2015, 4, 17, 22, 23, 14, 111111), dt(2015, 4, 17, 22, 23, 15, 111111)], "1.000000s"), ([dt(2015, 4, 17, 22, 23, 14, 111111), None], "")) @unpack def test_get_durating(self, timestamps, expected_result): self.assertEqual(subunit_trace.get_duration(timestamps), expected_result) @data(([dt(2015, 4, 17, 22, 23, 14, 111111), dt(2015, 4, 17, 22, 23, 14, 111111)], 0.0), ([dt(2015, 4, 17, 22, 23, 14, 111111), dt(2015, 4, 17, 22, 23, 15, 111111)], 1.0), ([dt(2015, 4, 17, 22, 23, 14, 111111), None], 0.0)) @unpack def test_run_time(self, timestamps, expected_result): patched_res = { 0: [ {'timestamps': timestamps} ] } with patch.dict(subunit_trace.RESULTS, patched_res, clear=True): self.assertEqual(subunit_trace.run_time(), expected_result) def test_return_code_all_skips(self): skips_stream = os.path.join( os.path.dirname(os.path.abspath(__file__)), 'sample_streams/all_skips.subunit') p = subprocess.Popen(['subunit-trace'], stdin=subprocess.PIPE) with open(skips_stream, 'rb') as stream: p.communicate(stream.read()) self.assertEqual(1, p.returncode) def test_return_code_normal_run(self): regular_stream = os.path.join( os.path.dirname(os.path.abspath(__file__)), 'sample_streams/successful.subunit') p = subprocess.Popen(['subunit-trace'], stdin=subprocess.PIPE) with open(regular_stream, 'rb') as stream: p.communicate(stream.read()) self.assertEqual(0, p.returncode) def test_trace(self): regular_stream = os.path.join( os.path.dirname(os.path.abspath(__file__)), 'sample_streams/successful.subunit') bytes_ = io.BytesIO() with open(regular_stream, 'rb') as stream: bytes_.write(six.binary_type(stream.read())) bytes_.seek(0) stdin = io.TextIOWrapper(io.BufferedReader(bytes_)) returncode = subunit_trace.trace(stdin, sys.stdout) self.assertEqual(0, returncode) ././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3618789 os-testr-3.0.0/os_testr/tests/utils/0000775000175000017500000000000000000000000017461 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/utils/__init__.py0000664000175000017500000000000000000000000021560 0ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/tests/utils/test_colorizer.py0000664000175000017500000000474600000000000023115 0ustar00zuulzuul00000000000000# Copyright 2016 Hewlett Packard Enterprise Development LP # All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. import six import sys from ddt import data from ddt import ddt from ddt import unpack from os_testr.tests import base from os_testr.utils import colorizer @ddt class TestNullColorizer(base.TestCase): @data(None, "foo", sys.stdout, ) def test_supported_always_true(self, stream): self.assertTrue(colorizer.NullColorizer.supported(stream)) @data(("foo", "red"), ("foo", "bar")) @unpack def test_write_string_ignore_color(self, text, color): output = six.StringIO() c = colorizer.NullColorizer(output) c.write(text, color) self.assertEqual(text, output.getvalue()) @data((None, "red"), (None, None)) @unpack def test_write_none_exception(self, text, color): c = colorizer.NullColorizer(sys.stdout) self.assertRaises(TypeError, c.write, text, color) @ddt class TestAnsiColorizer(base.TestCase): def test_supported_false(self): # NOTE(masayukig): This returns False because our unittest env isn't # interactive self.assertFalse(colorizer.AnsiColorizer.supported(sys.stdout)) @data(None, "foo") def test_supported_error(self, stream): self.assertRaises(AttributeError, colorizer.AnsiColorizer.supported, stream) @data(("foo", "red", "31"), ("foo", "blue", "34")) @unpack def test_write_string_valid_color(self, text, color, color_code): output = six.StringIO() c = colorizer.AnsiColorizer(output) c.write(text, color) self.assertIn(text, output.getvalue()) self.assertIn(color_code, output.getvalue()) @data(("foo", None), ("foo", "invalid_color")) @unpack def test_write_string_invalid_color(self, text, color): output = six.StringIO() c = colorizer.AnsiColorizer(output) self.assertRaises(KeyError, c.write, text, color) ././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3618789 os-testr-3.0.0/os_testr/utils/0000775000175000017500000000000000000000000016317 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/utils/__init__.py0000664000175000017500000000000000000000000020416 0ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/os_testr/utils/colorizer.py0000664000175000017500000000716500000000000020712 0ustar00zuulzuul00000000000000# Copyright 2015 NEC Corporation # All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. # # Colorizer Code is borrowed from Twisted: # Copyright (c) 2001-2010 Twisted Matrix Laboratories. # # Permission is hereby granted, free of charge, to any person obtaining # a copy of this software and associated documentation files (the # "Software"), to deal in the Software without restriction, including # without limitation the rights to use, copy, modify, merge, publish, # distribute, sublicense, and/or sell copies of the Software, and to # permit persons to whom the Software is furnished to do so, subject to # the following conditions: # # The above copyright notice and this permission notice shall be # included in all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. import sys class AnsiColorizer(object): """A colorizer is an object that loosely wraps around a stream allowing callers to write text to the stream in a particular color. Colorizer classes must implement C{supported()} and C{write(text, color)}. """ _colors = dict(black=30, red=31, green=32, yellow=33, blue=34, magenta=35, cyan=36, white=37) def __init__(self, stream): self.stream = stream @classmethod def supported(cls, stream=sys.stdout): """Check the current platform supports coloring terminal output A class method that returns True if the current platform supports coloring terminal output using this method. Returns False otherwise. """ if not stream.isatty(): return False # auto color only on TTYs try: import curses except ImportError: return False else: try: try: return curses.tigetnum("colors") > 2 except curses.error: curses.setupterm() return curses.tigetnum("colors") > 2 except Exception: # guess false in case of error return False def write(self, text, color): """Write the given text to the stream in the given color. @param text: Text to be written to the stream. @param color: A string label for a color. e.g. 'red', 'white'. """ color = self._colors[color] self.stream.write('\x1b[%s;1m%s\x1b[0m' % (color, text)) class NullColorizer(object): """See _AnsiColorizer docstring.""" def __init__(self, stream): self.stream = stream @classmethod def supported(cls, stream=sys.stdout): return True def write(self, text, color): self.stream.write(text) ././@PaxHeader0000000000000000000000000000003300000000000011451 xustar000000000000000027 mtime=1649075773.357879 os-testr-3.0.0/os_testr.egg-info/0000775000175000017500000000000000000000000016651 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/os_testr.egg-info/PKG-INFO0000664000175000017500000000366700000000000017762 0ustar00zuulzuul00000000000000Metadata-Version: 1.2 Name: os-testr Version: 3.0.0 Summary: A testr wrapper to provide functionality for OpenStack projects Home-page: https://docs.openstack.org/os-testr/latest/ Author: OpenStack Author-email: openstack-discuss@lists.openstack.org License: UNKNOWN Description: ======== os-testr ======== .. image:: https://img.shields.io/pypi/v/os-testr.svg :target: https://pypi.org/project/os-testr/ :alt: Latest Version .. image:: https://img.shields.io/pypi/dm/os-testr.svg :target: https://pypi.org/project/os-testr/ :alt: Downloads A testr wrapper to provide functionality for OpenStack projects. * Free software: Apache license * Documentation: https://docs.openstack.org/os-testr/ * Source: https://opendev.org/openstack/os-testr * Bugs: https://bugs.launchpad.net/os-testr Features -------- * ``subunit-trace``: an output filter for a subunit stream which provides useful information about the run * ``subunit2html``: generates a test results html page from a subunit stream * ``generate-subunit``: generate a subunit stream for a single test .. _stestr: https://stestr.readthedocs.io/ Platform: UNKNOWN Classifier: Environment :: OpenStack Classifier: Intended Audience :: Information Technology Classifier: Intended Audience :: System Administrators Classifier: License :: OSI Approved :: Apache Software License Classifier: Operating System :: POSIX :: Linux Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3 :: Only Classifier: Programming Language :: Python :: Implementation :: CPython Requires-Python: >=3.8 ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/os_testr.egg-info/SOURCES.txt0000664000175000017500000000313600000000000020540 0ustar00zuulzuul00000000000000.coveragerc .mailmap .stestr.conf .zuul.yaml AUTHORS CONTRIBUTING.rst ChangeLog HACKING.rst LICENSE MANIFEST.in README.rst babel.cfg requirements.txt setup.cfg setup.py test-requirements.txt tox.ini doc/requirements.txt doc/source/conf.py doc/source/index.rst doc/source/contributor/contributing.rst doc/source/install/index.rst doc/source/user/generate_subunit.rst doc/source/user/history.rst doc/source/user/index.rst doc/source/user/subunit2html.rst doc/source/user/subunit_trace.rst os_testr/__init__.py os_testr/generate_subunit.py os_testr/subunit2html.py os_testr/subunit_trace.py os_testr.egg-info/PKG-INFO os_testr.egg-info/SOURCES.txt os_testr.egg-info/dependency_links.txt os_testr.egg-info/entry_points.txt os_testr.egg-info/not-zip-safe os_testr.egg-info/pbr.json os_testr.egg-info/requires.txt os_testr.egg-info/top_level.txt os_testr/tests/__init__.py os_testr/tests/base.py os_testr/tests/test_subunit2html.py os_testr/tests/test_subunit_trace.py os_testr/tests/files/__init__.py os_testr/tests/files/failing-tests os_testr/tests/files/passing-tests os_testr/tests/files/setup.cfg os_testr/tests/files/stestr-conf os_testr/tests/sample_streams/all_skips.subunit os_testr/tests/sample_streams/successful.subunit os_testr/tests/utils/__init__.py os_testr/tests/utils/test_colorizer.py os_testr/utils/__init__.py os_testr/utils/colorizer.py releasenotes/notes/deprecate-ostestr-command-3ac0bff93265fa09.yaml releasenotes/notes/drop-py-2-7-4a9c5b4ae0bbeb98.yaml releasenotes/notes/remove-ostestr-command-2cbe2a3254ba4adb.yaml releasenotes/source/conf.py releasenotes/source/index.rst releasenotes/source/unreleased.rst././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/os_testr.egg-info/dependency_links.txt0000664000175000017500000000000100000000000022717 0ustar00zuulzuul00000000000000 ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/os_testr.egg-info/entry_points.txt0000664000175000017500000000023300000000000022145 0ustar00zuulzuul00000000000000[console_scripts] generate-subunit = os_testr.generate_subunit:main subunit-trace = os_testr.subunit_trace:main subunit2html = os_testr.subunit2html:main ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/os_testr.egg-info/not-zip-safe0000664000175000017500000000000100000000000021077 0ustar00zuulzuul00000000000000 ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/os_testr.egg-info/pbr.json0000664000175000017500000000005600000000000020330 0ustar00zuulzuul00000000000000{"git_version": "0e7ac78", "is_release": true}././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/os_testr.egg-info/requires.txt0000664000175000017500000000007200000000000021250 0ustar00zuulzuul00000000000000pbr!=2.1.0,>=2.0.0 python-subunit>=1.0.0 testtools>=2.2.0 ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075773.0 os-testr-3.0.0/os_testr.egg-info/top_level.txt0000664000175000017500000000001100000000000021373 0ustar00zuulzuul00000000000000os_testr ././@PaxHeader0000000000000000000000000000003300000000000011451 xustar000000000000000027 mtime=1649075773.349879 os-testr-3.0.0/releasenotes/0000775000175000017500000000000000000000000016006 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3618789 os-testr-3.0.0/releasenotes/notes/0000775000175000017500000000000000000000000017136 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/releasenotes/notes/deprecate-ostestr-command-3ac0bff93265fa09.yaml0000664000175000017500000000042600000000000027370 0ustar00zuulzuul00000000000000--- deprecations: - | The ``ostestr`` command is now deprecated explicitly. We already switched to use ``stestr`` command instead. And we haven't maintained this command recently. For more information about stestr, see https://stestr.readthedocs.io/en/latest/ ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/releasenotes/notes/drop-py-2-7-4a9c5b4ae0bbeb98.yaml0000664000175000017500000000030400000000000024347 0ustar00zuulzuul00000000000000--- upgrade: - | Python 2.7 support has been dropped. Last release of os-testr to support python 2.7 is 1.1.0. The minimum version of Python now supported by os-testr is Python 3.6. ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/releasenotes/notes/remove-ostestr-command-2cbe2a3254ba4adb.yaml0000664000175000017500000000042400000000000027044 0ustar00zuulzuul00000000000000--- upgrade: - | The deprecated ``ostestr`` command is now removed. This has been deprecated for more than a year and most of the users have been switched to ``stestr`` command. For more information about stestr, see https://stestr.readthedocs.io/en/latest/ ././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3658788 os-testr-3.0.0/releasenotes/source/0000775000175000017500000000000000000000000017306 5ustar00zuulzuul00000000000000././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/releasenotes/source/conf.py0000664000175000017500000000611600000000000020611 0ustar00zuulzuul00000000000000# Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or # implied. # See the License for the specific language governing permissions and # limitations under the License. # Configuration file for the Sphinx documentation builder. # # This file only contains a selection of the most common options. For a full # list see the documentation: # http://www.sphinx-doc.org/en/master/config # -- Path setup -------------------------------------------------------------- # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. # # import os # import sys # sys.path.insert(0, os.path.abspath('.')) # -- Project information ----------------------------------------------------- project = 'ostestr Release Notes' copyright = '2019, ostestr Developers' author = 'ostestr Developers' # -- General configuration --------------------------------------------------- # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ 'openstackdocstheme', 'reno.sphinxext', ] # openstackdocstheme options openstackdocs_repo_name = 'openstack/os-testr' openstackdocs_auto_name = False openstackdocs_bug_project = 'os-testr' openstackdocs_bug_tag = '' # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] # The suffix of source filenames. source_suffix = '.rst' # The encoding of source files. # source_encoding = 'utf-8-sig' # The master toctree document. master_doc = 'index' # Release do not need a version number in the title, they # cover multiple versions. # The full version, including alpha/beta/rc tags. release = '' # The short X.Y version. version = '' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. # This pattern also affects html_static_path and html_extra_path. exclude_patterns = [] # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'native' # -- Options for HTML output ------------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. # html_theme = 'openstackdocs' # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". # html_static_path = ['_static'] # Output file base name for HTML help builder. htmlhelp_basename = 'ostestrReleaseNotesdoc' ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/releasenotes/source/index.rst0000664000175000017500000000027400000000000021152 0ustar00zuulzuul00000000000000====================== os-testr Release Notes ====================== .. toctree:: :maxdepth: 1 unreleased Indices and tables ================== * :ref:`genindex` * :ref:`search` ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/releasenotes/source/unreleased.rst0000664000175000017500000000015300000000000022166 0ustar00zuulzuul00000000000000============================ Current Series Release Notes ============================ .. release-notes:: ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/requirements.txt0000664000175000017500000000046100000000000016602 0ustar00zuulzuul00000000000000# The order of packages is significant, because pip processes them in the order # of appearance. Changing the order has an impact on the overall integration # process, which may cause wedges in the gate later. pbr!=2.1.0,>=2.0.0 # Apache-2.0 python-subunit>=1.0.0 # Apache-2.0/BSD testtools>=2.2.0 # MIT ././@PaxHeader0000000000000000000000000000003400000000000011452 xustar000000000000000028 mtime=1649075773.3658788 os-testr-3.0.0/setup.cfg0000664000175000017500000000174700000000000015147 0ustar00zuulzuul00000000000000[metadata] name = os-testr summary = A testr wrapper to provide functionality for OpenStack projects description_file = README.rst author = OpenStack author_email = openstack-discuss@lists.openstack.org home_page = https://docs.openstack.org/os-testr/latest/ python_requires = >=3.8 classifier = Environment :: OpenStack Intended Audience :: Information Technology Intended Audience :: System Administrators License :: OSI Approved :: Apache Software License Operating System :: POSIX :: Linux Programming Language :: Python Programming Language :: Python :: 3 Programming Language :: Python :: 3.8 Programming Language :: Python :: 3.9 Programming Language :: Python :: 3 :: Only Programming Language :: Python :: Implementation :: CPython [files] packages = os_testr [entry_points] console_scripts = subunit-trace = os_testr.subunit_trace:main subunit2html = os_testr.subunit2html:main generate-subunit = os_testr.generate_subunit:main [egg_info] tag_build = tag_date = 0 ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/setup.py0000664000175000017500000000137600000000000015036 0ustar00zuulzuul00000000000000# Copyright (c) 2013 Hewlett-Packard Development Company, L.P. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or # implied. # See the License for the specific language governing permissions and # limitations under the License. # THIS FILE IS MANAGED BY THE GLOBAL REQUIREMENTS REPO - DO NOT EDIT import setuptools setuptools.setup( setup_requires=['pbr>=2.0.0'], pbr=True) ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/test-requirements.txt0000664000175000017500000000062700000000000017563 0ustar00zuulzuul00000000000000# The order of packages is significant, because pip processes them in the order # of appearance. Changing the order has an impact on the overall integration # process, which may cause wedges in the gate later. hacking>=3.0.1,<3.1.0 # Apache-2.0 coverage!=4.4,>=4.0 # Apache-2.0 oslotest>=3.2.0 # Apache-2.0 stestr>=1.0.0 # Apache-2.0 testscenarios>=0.4 # Apache-2.0/BSD ddt>=1.0.1 # MIT six>=1.10.0 # MIT ././@PaxHeader0000000000000000000000000000002600000000000011453 xustar000000000000000022 mtime=1649075735.0 os-testr-3.0.0/tox.ini0000664000175000017500000000410600000000000014631 0ustar00zuulzuul00000000000000[tox] minversion = 3.18.0 envlist = py3,pypy,pep8 # Need to set to False to have CHANGES generated skipsdist = false ignore_basepython_conflict = True [testenv] basepython = python3 usedevelop = True setenv = VIRTUAL_ENV={envdir} OS_STDOUT_CAPTURE=1 OS_STDERR_CAPTURE=1 OS_TEST_TIMEOUT=500 allowlist_externals = find deps = -c{env:UPPER_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master} -r{toxinidir}/requirements.txt -r{toxinidir}/test-requirements.txt commands = find . -type f -name "*.pyc" -delete stestr run {posargs} [testenv:pep8] commands = flake8 [testenv:venv] commands = {posargs} [testenv:cover] setenv = VIRTUAL_ENV={envdir} PYTHON=coverage run --source os_testr --parallel-mode commands = stestr run {posargs} coverage combine coverage html -d cover coverage xml -o cover/coverage.xml [testenv:docs] deps = -c{env:UPPER_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master} -r{toxinidir}/doc/requirements.txt commands = sphinx-build -W --keep-going -b html -d doc/build/doctrees doc/source doc/build/html [testenv:pdf-docs] deps = {[testenv:docs]deps} allowlist_externals = make commands = sphinx-build -W -b latex doc/source doc/build/pdf make -C doc/build/pdf [testenv:debug] commands = oslo_debug_helper {posargs} [testenv:releasenotes] deps = -c{env:UPPER_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master} -r{toxinidir}/doc/requirements.txt commands = rm -rf releasenotes/build sphinx-build -a -E -W -d releasenotes/build/doctrees \ -b html releasenotes/source releasenotes/build/html allowlist_externals = rm [flake8] # E123, E125 skipped as they are invalid PEP-8. # E731 skipped as assign a lambda expression # H405 skipped as it wrongly recognizes a multiline string as docstring # W504 line break after binary operator (W503 and W504 are incompatible # and we need to choose one of them. show-source = True ignore = E123,E125,E731,H405,W504 builtins = _ exclude=.venv,.git,.tox,dist,doc,*lib/python*,*egg,build