Metadata-Version: 1.1
Name: kiwitcms-junit.xml-plugin
Version: 8.3
Summary: junit.xml plugin for Kiwi TCMS test case management system
Home-page: https://github.com/kiwitcms/junit.xml-plugin
Author: Kiwi TCMS
Author-email: info@kiwitcms.org
License: GPLv3+
Description: junit.xml plugin for Kiwi TCMS
        ==============================
        
        .. image:: https://img.shields.io/pypi/v/kiwitcms-junit.xml-plugin.svg
            :target: https://pypi.org/project/kiwitcms-junit.xml-plugin
            :alt: PyPI version
        
        .. image:: https://travis-ci.org/kiwitcms/junit.xml-plugin.svg?branch=master
            :target: https://travis-ci.org/kiwitcms/junit.xml-plugin
            :alt: Travis CI
        
        .. image:: https://coveralls.io/repos/github/kiwitcms/junit.xml-plugin/badge.svg?branch=master
            :target: https://coveralls.io/github/kiwitcms/junit.xml-plugin?branch=master
            :alt: Code coverage
        
        .. image:: https://pyup.io/repos/github/kiwitcms/junit.xml-plugin/shield.svg
            :target: https://pyup.io/repos/github/kiwitcms/junit.xml-plugin/
            :alt: Python updates
        
        .. image:: https://img.shields.io/badge/kiwi%20tcms-results-9ab451.svg
            :target: https://tcms.kiwitcms.org/plan/7/
            :alt: TP for kiwitcms/junit.xml-plugin (master)
        
        .. image:: https://tidelift.com/badges/package/pypi/kiwitcms-junit.xml-plugin
            :target: https://tidelift.com/subscription/pkg/pypi-kiwitcms-junit.xml-plugin?utm_source=pypi-kiwitcms-junit.xml-plugin&utm_medium=github&utm_campaign=readme
            :alt: Tidelift
        
        .. image:: https://opencollective.com/kiwitcms/tiers/sponsor/badge.svg?label=sponsors&color=brightgreen
           :target: https://opencollective.com/kiwitcms#contributors
           :alt: Become a sponsor
        
        .. image:: https://img.shields.io/twitter/follow/KiwiTCMS.svg
            :target: https://twitter.com/KiwiTCMS
            :alt: Kiwi TCMS on Twitter
        
        
        This package allows you to read junit.xml files and
        send the results to `Kiwi TCMS <http://kiwitcms.org>`_.
        
        
        Installation
        ------------
        
        ::
        
            pip install kiwitcms-junit.xml-plugin
        
        
        Configuration and environment
        -----------------------------
        
        Minimal config file `~/.tcms.conf`::
        
            [tcms]
            url = https://tcms.server/xml-rpc/
            username = your-username
            password = your-password
        
        
        For more info see `tcms-api docs <https://tcms-api.readthedocs.io>`_.
        
        This plugin is only concerned with parsing the junit.xml format and executing
        `tcms-api` functions which will create/reuse test cases, test plans and test runs.
        `tcms-api` behavior is controlled via environment variables.
        
        For example this is how our own environment looks like::
        
            #!/bin/bash
            
            if [ "$TRAVIS_EVENT_TYPE" == "push" ]; then
                # same as $TRAVIS_TAG when building tags
                export TCMS_PRODUCT_VERSION=$TRAVIS_BRANCH
            fi
            
            if [ "$TRAVIS_EVENT_TYPE" == "pull_request" ]; then
                export TCMS_PRODUCT_VERSION="PR-$TRAVIS_PULL_REQUEST"
            fi
            
            export TCMS_BUILD="$TRAVIS_BUILD_NUMBER-$(echo $TRAVIS_COMMIT | cut -c1-7)"
        
        Further documentation and behavior specification can be found
        `here <https://tcms-api.readthedocs.io/en/latest/modules/tcms_api.plugin_helpers.html>`_.
        
        The above configuration creates a separate TestPlan for each branch, see
        `TP-7: [junit.xml] Plan for kiwitcms/junit.xml-plugin (master) <https://tcms.kiwitcms.org/plan/7/>`_,
        a separate TestPlan for each pull request (recording possible multiple test runs) and
        separate TestPlan and TestRun for each tag on GitHub! `tcms-api` has default behavior
        for Travis CI and Jenkins and allows endless configuration via environment variables.
        
        
        Usage
        -----
        
        ::
        
            # define environment variables
            tcms-junit.xml-plugin /path/to/junit.xml
        
        
        Changelog
        ---------
        
        v8.3 (10 Apr 2020)
        ~~~~~~~~~~~~~~~~~~
        
        - Update to
          `tcms-api v8.3.0 <https://github.com/kiwitcms/tcms-api/#v830-10-april-2020>`_
          which uses ``gssapi`` for Kerberos
        - Requires MIT Kerberos for Windows if installed on Windows
        
        
        v8.2 (03 Apr 2020)
        ~~~~~~~~~~~~~~~~~~
        
        This version works only with Kiwi TCMS v8.2 or later!
        
        - Update to tcms-api==8.2.0
        - Patch for changed return value in
          ``plugin_helpers.Backend.test_case_get_or_create()``
        - Call ``plugin_helpers.backend.finish_test_run()`` when done
        
        
        v8.0.1 (10 February 2020)
        ~~~~~~~~~~~~~~~~~~~~~~~~~
        
        This version works only with Kiwi TCMS v8.0 or later!
        
        - Adjust plugin due to API changes in Kiwi TCMS v8.0
        - Require tcms-api==8.0.1
        
        
        v0.5 (07 January 2020)
        ~~~~~~~~~~~~~~~~~~~~~~
        
        - Update junitparser from 1.3.4 to 1.41
        
        
        v0.4 (20 September 2019)
        ~~~~~~~~~~~~~~~~~~~~~~~~
        
        - Update junitparser from 1.3.2 to 1.3.4
        - Support XML files with <testsuites> root tag (Katalon Studio).
          Fixes `Issue #9 <https://github.com/kiwitcms/junit.xml-plugin/issues/9>`_
        
        
        v0.3 (10 April 2019)
        ~~~~~~~~~~~~~~~~~~~~
        
        - Works with Kiwi TCMS v6.7 or newer
        - Uses new names of API methods
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
