PyTestLog2DB 0.3.1__py3-none-any.whl → 0.4.0__py3-none-any.whl

PyTestLog2DB/__init__.py

@@ -1,4 +1,4 @@
-#  Copyright 2020-2023 Robert Bosch GmbH
+#  Copyright 2020-2026 Robert Bosch GmbH
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
 #  you may not use this file except in compliance with the License.

PyTestLog2DB/__main__.py

@@ -1,4 +1,4 @@
-#  Copyright 2020-2023 Robert Bosch GmbH
+#  Copyright 2020-2026 Robert Bosch GmbH
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
 #  you may not use this file except in compliance with the License.

PyTestLog2DB/pytestlog2db.py

@@ -1,4 +1,4 @@
-#  Copyright 2020-2023 Robert Bosch GmbH
+#  Copyright 2020-2026 Robert Bosch GmbH
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
 #  you may not use this file except in compliance with the License.
@@ -37,13 +37,13 @@ import colorama as col
 import json
 from lxml import etree
 from datetime import datetime, timedelta
+from dateutil import parser
 import platform
 from pkg_resources import get_distribution
 
 from TestResultDBAccess import DBAccessFactory
 from PyTestLog2DB.version import VERSION, VERSION_DATE
 
-PYTEST_DATETIME_FORMAT = "%Y-%m-%dT%H:%M:%S.%f"
 DB_DATETIME_FORMAT = "%Y-%m-%d %H:%M:%S"
 
 def __current_user():
@@ -305,6 +305,7 @@ Avalable arguments in command line:
    - `--versions` : metadata: Versions (Software;Hardware;Test) to be set for this import.
    - `--config` : configuration json file for component mapping information.
    - `--interface` : database access interface.
+   - `--testrunurl`: link to test execution job: Jenkins job, Gitlab CI/CD pipeline, ...
 
 **Arguments:**
 
@@ -337,6 +338,7 @@ Avalable arguments in command line:
    cmdlineparser.add_argument('--versions', type=str, help='metadata: Versions (Software;Hardware;Test) to be set for this import (semicolon separated).')
    cmdlineparser.add_argument('--config', type=str, help='configuration json file for component mapping information.')
    cmdlineparser.add_argument('--interface', choices=['db', 'rest'], default='db', help='database access interface.')
+   cmdlineparser.add_argument('--testrunurl', type=str, default="", help='link to test execution job: Jenkins job, Gitlab CI/CD pipeline, ...')
 
    return cmdlineparser.parse_args()
 
@@ -583,13 +585,13 @@ Besides, `starttime` and `endtime` are also calculated and added in the merged r
          if oMergedTree == None:
             oMergedTree = oTree
             sStartTime  = oMergedTree.getchildren()[0].get("timestamp")
-            dtStartTime = datetime.strptime(sStartTime, PYTEST_DATETIME_FORMAT)
+            dtStartTime = parser.parse(sStartTime)
             dtEndTime   = dtStartTime + timedelta(seconds=float(oMergedTree.getchildren()[0].get("time")))
          else:
             oAdditionalTree = etree.parse(item)
             for oSuite in oAdditionalTree.getroot().iterchildren("testsuite"):
                oMergedTree.append(oSuite)
-               dtTimestamp = datetime.strptime(oSuite.get("timestamp"), PYTEST_DATETIME_FORMAT)
+               dtTimestamp = parser.parse(oSuite.get("timestamp"))
 
                # check starttime and endtime for the execution result
                if dtTimestamp < dtStartTime:
@@ -939,8 +941,8 @@ Process to the lowest suite level (test file):
    _tbl_file_id = None
    _tbl_file_tester_account = dConfig["tester"]
    _tbl_file_tester_machine = suite.get("hostname")
-   _tbl_file_time_start = suite.get("timestamp")
-   test_start_time      = datetime.strptime(_tbl_file_time_start, PYTEST_DATETIME_FORMAT)
+   test_start_time      = parser.parse(suite.get("timestamp"))
+   _tbl_file_time_start = datetime.strftime(test_start_time, DB_DATETIME_FORMAT)
    _tbl_file_time_end   = datetime.strftime(test_start_time + timedelta(seconds=float(suite.get("time"))), DB_DATETIME_FORMAT)
 
    test_number = 1
@@ -1076,6 +1078,7 @@ Flow to import PyTest results to database:
    * `variant` : variant name to be set for this import.
    * `versions` : metadata: Versions (Software;Hardware;Test) to be set for this import.
    * `config` : configuration json file for component mapping information.
+   * `testrunurl`: link to test execution job: Jenkins job, Gitlab CI/CD pipeline, ...
 
 **Returns:**
 
@@ -1176,7 +1179,7 @@ Flow to import PyTest results to database:
       # Set version as start time of the execution if not provided in metadata
       # Format: %Y%m%d_%H%M%S from %Y-%m-%d %H:%M:%S
       if _tbl_result_version_sw_target=="":
-         _tbl_result_version_sw_target = datetime.strftime(datetime.strptime(pytest_result.get("starttime"), DB_DATETIME_FORMAT), "%Y%m%d_%H%M%S")
+         _tbl_result_version_sw_target = datetime.strftime(parser.parse(pytest_result.get("starttime")), "%Y%m%d_%H%M%S")
 
       if not args.append:
          Logger.log(f"Set project/variant to '{sVariant}' ({sMsgVarirantSetBy})")
@@ -1199,7 +1202,7 @@ Flow to import PyTest results to database:
 
       # Process other info
       _tbl_result_interpretation = ""
-      _tbl_result_jenkinsurl     = ""
+      _tbl_result_jenkinsurl     = args.testrunurl
       _tbl_result_reporting_qualitygate = ""
 
       # Check the UUID is existing or not

PyTestLog2DB/version.py

@@ -1,6 +1,6 @@
 # **************************************************************************************************************
 #
-#  Copyright 2020-2023 Robert Bosch GmbH
+#  Copyright 2020-2026 Robert Bosch GmbH
 #
 #  Licensed under the Apache License, Version 2.0 (the "License");
 #  you may not use this file except in compliance with the License.
@@ -18,6 +18,5 @@
 #
 # Version and date of PyTestLog2DB
 #
-VERSION      = "0.3.1"
-VERSION_DATE = "20.05.2024"
-
+VERSION      = "0.4.0"
+VERSION_DATE = "23.03.2026"

pytestlog2db-0.4.0.dist-info/METADATA

@@ -0,0 +1,346 @@
+Metadata-Version: 2.4
+Name: PyTestLog2DB
+Version: 0.4.0
+Summary: Imports pytest result(s) to TestResultWebApp database
+Author-email: Tran Duy Ngoan <Ngoan.TranDuy@vn.bosch.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://pypi.org/project/PyTestLog2DB/
+Project-URL: Documentation, https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/PyTestLog2DB/PyTestLog2DB.pdf
+Project-URL: Readme, https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/README.rst
+Project-URL: Repository, https://github.com/test-fullautomation/python-pytestlog2db
+Project-URL: Issues, https://github.com/test-fullautomation/python-pytestlog2db/issues
+Keywords: pytest,testresults,database
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: docutils>=0.22.4
+Requires-Dist: colorama
+Requires-Dist: TestResultDBAccess
+Requires-Dist: lxml
+Requires-Dist: PythonExtensionsCollection
+Requires-Dist: GenPackageDoc
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=3.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: docutils>=0.22.4; extra == "docs"
+Dynamic: license-file
+
+PyTestLog2DB
+============
+
+Table of Contents
+-----------------
+
+-  `Getting Started <#getting-started>`__
+
+   -  `How to install <#how-to-install>`__
+-  `Usage <#usage>`__
+-  `Example <#example>`__
+-  `Contribution <#contribution>`__
+-  `Sourcecode Documentation <#sourcecode-documentation>`__
+-  `Feedback <#feedback>`__
+-  `About <#about>`__
+
+   -  `Maintainers <#maintainers>`__
+   -  `Contributors <#contributors>`__
+   -  `License <#license>`__
+
+Getting Started
+---------------
+
+**PyTestLog2DB** is a command-line tool that enables you to import pytest_ XML
+result files into TestResultWebApp_'s database for presenting an overview about
+the whole test execution and detail of each test result.
+
+**PyTestLog2DB** tool is operating system independent and only works with
+Python 3.
+
+How to install
+~~~~~~~~~~~~~~
+
+**PyTestLog2DB** can be installed in two different ways.
+
+The **PyTestLog2DB** can be installed in two different ways.
+
+1. Installation via PyPi (recommended for users)
+
+   .. code::
+
+      pip install PyTestLog2DB
+
+   `PyTestLog2DB in PyPi <https://pypi.org/project/PyTestLog2DB/>`_
+
+2. Installation via GitHub (recommended for developers)
+
+   * Clone the **python-pytestlog2db** repository to your machine.
+
+     .. code::
+
+        git clone https://github.com/test-fullautomation/python-pytestlog2db.git
+
+     `PyTestLog2DB in GitHub <https://github.com/test-fullautomation/python-PyTestLog2DB>`_
+
+   * Use the following command to install **PyTestLog2DB** (executed in repository main folder):
+
+     .. code::
+
+        python -m pip install .
+
+     Or:
+
+     .. code::
+
+        python -m pip install --proxy <proxy> .
+
+     This command will also download and install all dependencies that are required to work with the source files in the current repository.
+     After the initial installation of **PyTestLog2DB** is done, you have the following two possibilities:
+
+     1. *Clean the previous installation*:
+
+        .. code::
+
+           python "./cleanup_installation.py"
+
+        ``cleanup_installation.py`` explicitly deletes all files and folders within the component installation folder under
+        ``site-packages`` and also deletes local build artefacts.
+
+     2. *Render the component documentation*:
+
+        .. code::
+
+           python "./genpackagedoc.py"
+
+        This would e.g. be required in case of changes in the interface of **PyTestLog2DB**.
+
+        The documentation is rendered by a separate application called **GenPackageDoc**, that is part
+        of the build dependencies and runtime dependencies of **PyTestLog2DB**.
+
+        **GenPackageDoc** needs to be configured. Details about how to do this, can be found in the
+        `README.rst <https://github.com/test-fullautomation/python-genpackagedoc/blob/develop/README.rst>`_
+        (sections *Install dependencies* and *Configure dependencies*).
+
+   * Use the following command to build **PyTestLog2DB** (executed in repository main folder):
+
+     .. code::
+
+        python -m build .
+
+     Or:
+
+     .. code::
+
+        python -m pip config set global.proxy <proxy>
+        python -m build .
+
+After succesful installation, the executable file **PyTestLog2DB** will be
+available (under *Scripts* folder of Python on Windows and *~/.local/bin/*
+folder on Linux).
+
+In case above location is added to **PATH** environment variable then you can
+run it directly as operation system's command.
+
+Usage
+-----
+
+**PyTestLog2DB** requires the pytest_ result file(s) which contains the test
+result in *JUnit XML* format and TestResultWebApp_'s database information for
+importing.
+
+Use below command to get tools's usage
+
+::
+
+   PyTestLog2DB -h
+
+
+The usage should be showed as below:
+
+::
+
+   usage: PyTestLog2DB (PyTestXMLReport to TestResultWebApp importer) [-h] [-v] [--recursive] [--dryrun] [--append] [--UUID UUID] [--variant VARIANT] [--versions VERSIONS] [--config CONFIG]
+                                                                      resultxmlfile server user password database
+
+   PyTestLog2DB imports pytest JUnit XML report file(s)generated by pytest into a WebApp database.
+
+   positional arguments:
+   resultxmlfile        absolute or relative path to the pytest JUnit XML report file or directory of report files to be imported.
+   server               server which hosts the database (IP or URL).
+   user                 user for database login.
+   password             password for database login.
+   database             database schema for database login.
+
+   optional arguments:
+   -h, --help           show this help message and exit
+   -v, --version        version of the PyTestLog2DB importer.
+   --recursive          if set, then the path is searched recursively for output files to be imported.
+   --dryrun             if set, then verify all input arguments (includes DB connection) and show what would be done.
+   --append             is used in combination with --UUID <UUID>. If set, allow to append new result(s) to existing execution result UUID in --UUID argument.
+   --UUID UUID          UUID used to identify the import and version ID on webapp. If not provided PyTestLog2DB will generate an UUID for the whole import.
+   --variant VARIANT    variant name to be set for this import.
+   --versions VERSIONS  metadata: Versions (Software;Hardware;Test) to be set for this import (semicolon separated).
+   --config CONFIG      configuration json file for component mapping information.
+   --interface {db,rest}
+                        database access interface.
+   --testrunurl TESTRUNURL
+                        link to test execution job: Jenkins job, Gitlab CI/CD pipeline, ...
+
+The below command is simple usage with all required arguments to import
+pytest_ results into TestResultWebApp's database:
+
+::
+
+   PyTestLog2DB <resultxmlfile> <server> <user> <password> <database>
+
+Besides the executable file, you can also run tool as a Python module
+
+::
+
+   python -m PyTestLog2DB <resultxmlfile> <server> <user> <password> <database>
+
+Example
+-------
+
+In order the import the robot result(s) to TestResultWebApp's database,
+we need the pytest_ result file in *JUnit XML* format.
+
+So, firstly execute the pytest_ testcase(s) to get the result file(s). But the
+***.xml** result file is not generated by default.
+
+We need to specify the argument *--junit-xml=<path>* when executing pytest_
+to get the generated *JUnit XML* report file at given path.
+
+E.g:
+::
+
+   pytest --junit-xml=path/to/result.xml pytest/folder
+
+After that, the ***.xml** result file will be available at **path/to/result.xml**
+and can be used for importing to TestResultWebApp_ with command:
+
+::
+
+   PyTestLog2DB path/to/result.xml localhost test_user test_pw test_db
+
+Then, open TestResultWebApp with your favourite browser and you will see how
+wonderful the execution result is displayed as below figures:
+
+Dashboard view:
+
+.. image:: https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/packagedoc/additional_docs/pictures/Dashboard.png?raw=true
+   :alt: Dashboard view
+
+Datatable view:
+
+.. image:: https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/packagedoc/additional_docs/pictures/Datatable.png?raw=true
+   :alt: Datatable view
+
+Notes:
+~~~~~~
+
+   The ***.xml** report file generated by pytest contains only the testcase
+   result(s) and less metadata information about the test execution such as
+   *project/variant*, *software version*, *tester* , *component*, ...
+   which are required by TestResultWebApp_.
+
+   So that, **PyTestLog2DB** will handle those information with the default values.
+
+   But you can use the optional argument *--config CONFIG* to specify those
+   information when importing to TestResultWebApp_'s database.
+
+   Sample configuration file:
+
+   ::
+
+      {
+         "variant"   : "MyProject",
+         "version_sw": "0.1.1",
+         "components": {
+            "Testsuite1"       : "test-data.test_tsclass.TestSuite1",
+            "Testsuite2"       : "test-data.test_tsclass.TestSuite2",
+            "Others"          : [
+               "test-data.test_ts1",
+               "test-data.test_ts2"
+            ]
+         },
+         "tester"    : "Tran Duy Ngoan"
+      }
+
+   Please refer `PyTestLog2DB tool’s Documentation`_ for more detail about default
+   values and the configuration json file.
+
+Contribution
+------------
+We are always searching support and you are cordially invited to help to improve
+**PyTestLog2DB** tool.
+
+Sourcecode Documentation
+------------------------
+To understand more detail about the tool's features, parameters and how pytest
+result(s) will be displayed on TestResultWebApp, please refer to
+`PyTestLog2DB tool’s Documentation`_.
+
+Feedback
+--------
+Please feel free to give any feedback to us via
+
+Email to: `Thomas Pollerspöck`_
+
+Issue tracking: `PyTestLog2DB Issues`_
+
+About
+-----
+
+Maintainers
+~~~~~~~~~~~
+`Thomas Pollerspöck`_
+
+`Holger Queckenstedt`_
+
+`Tran Duy Ngoan`_
+
+Contributors
+~~~~~~~~~~~~
+
+`Nguyen Huynh Tri Cuong`_
+
+`Mai Dinh Nam Son`_
+
+`Tran Hoang Nguyen`_
+
+License
+~~~~~~~
+
+Copyright 2020-2023 Robert Bosch GmbH
+
+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
+
+    |License: Apache v2|
+
+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.
+
+
+.. |License: Apache v2| image:: https://img.shields.io/pypi/l/robotframework.svg
+   :target: http://www.apache.org/licenses/LICENSE-2.0.html
+.. _pytest: https://docs.pytest.org
+.. _JUnit XML: https://llg.cubic.org/docs/junit
+.. _PyTestLog2DB: https://github.com/test-fullautomation/python-pytestlog2db
+.. _TestResultWebApp: https://github.com/test-fullautomation/TestResultWebApp
+.. _PyPI: https://pypi.org/
+.. _Thomas Pollerspöck: mailto:Thomas.Pollerspoeck@de.bosch.com
+.. _Tran Duy Ngoan: mailto:Ngoan.TranDuy@vn.bosch.com
+.. _Nguyen Huynh Tri Cuong: mailto:Cuong.NguyenHuynhTri@vn.bosch.com
+.. _Mai Dinh Nam Son: mailto:Son.MaiDinhNam@vn.bosch.com
+.. _Tran Hoang Nguyen: mailto:Nguyen.TranHoang@vn.bosch.com
+.. _Holger Queckenstedt: mailto:Holger.Queckenstedt@de.bosch.com
+.. _PyTestLog2DB tool’s Documentation: https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/PyTestLog2DB/PyTestLog2DB.pdf
+.. _PyTestLog2DB Issues: https://github.com/test-fullautomation/python-pytestlog2db/issues

pytestlog2db-0.4.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+PyTestLog2DB/PyTestLog2DB.pdf,sha256=xNHY2lBGVklJkxaHwe1mIHUtNH8nkUGtKXBSpkS2XZs,517552
+PyTestLog2DB/__init__.py,sha256=QGox2k2vxlv4xBA8Q82Elqn9X8gf47khen7co4L3fVI,596
+PyTestLog2DB/__main__.py,sha256=r7Rk90uYaxB5ML9NTpYXdXcxL-3Sw7g2m4lCU8xRS08,693
+PyTestLog2DB/pytestlog2db.py,sha256=vZb6IzbywP839B0cCFSsO8w1D2R9KQglJB0-NjNLDMY,43947
+PyTestLog2DB/version.py,sha256=tiaaaicbE4AgDXG4lN0vWS-JNHFapl3ciGZYNbCUG2U,916
+PyTestLog2DB/xsd/junit.xsd,sha256=16vVXGy8p1afl2YbgX61g528x4x8Vy3Lf0qqKY9IAZs,6847
+pytestlog2db-0.4.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+pytestlog2db-0.4.0.dist-info/METADATA,sha256=KfGqdTBp4BlnetRY-EEC6DGYLuJHeVWbMAcz3CuC008,11863
+pytestlog2db-0.4.0.dist-info/WHEEL,sha256=kIt4MnNJDJ26dPfzNiSjgFHPBc-JaVd9TwMdICBRasQ,90
+pytestlog2db-0.4.0.dist-info/entry_points.txt,sha256=loulU5_oxKt-J6om9TPOGuk_riltUcIvUNG0XKpHtis,72
+pytestlog2db-0.4.0.dist-info/top_level.txt,sha256=WN8NnXKE7lkjhVq7yi3WQwIh54rVKUQdecci-Yy4pog,13
+pytestlog2db-0.4.0.dist-info/RECORD,,

{PyTestLog2DB-0.3.1.dist-info → pytestlog2db-0.4.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (0.4.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pytestlog2db-0.4.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+PyTestLog2DB = PyTestLog2DB.pytestlog2db:PyTestLog2DB

PyTestLog2DB-0.3.1.dist-info/METADATA

@@ -1,308 +0,0 @@
-Metadata-Version: 2.1
-Name: PyTestLog2DB
-Version: 0.3.1
-Summary: Imports pytest result(s) to TestResultWebApp database
-Home-page: https://github.com/test-fullautomation/python-pytestlog2db
-Author: Tran Duy Ngoan
-Author-email: Ngoan.TranDuy@vn.bosch.com
-License: UNKNOWN
-Platform: UNKNOWN
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development
-Requires-Python: >=3.0
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: colorama
-Requires-Dist: TestResultDBAccess
-Requires-Dist: lxml
-
-PyTestLog2DB
-============
-
-Table of Contents
------------------
-
--   [Getting Started](#getting-started)
-    -   [How to install](#how-to-install)
--   [Usage](#usage)
--   [Example](#example)
--   [Contribution](#contribution)
--   [Sourcecode Documentation](#sourcecode-documentation)
--   [Feedback](#feedback)
--   [About](#about)
-    -   [Maintainers](#maintainers)
-    -   [Contributors](#contributors)
-    -   [License](#license)
-
-Getting Started
----------------
-
-**PyTestLog2DB** is a command-line tool that enables you to import
-[pytest](https://docs.pytest.org) XML result files into
-[TestResultWebApp](https://github.com/test-fullautomation/TestResultWebApp)\'s
-database for presenting an overview about the whole test execution and
-detail of each test result.
-
-**PyTestLog2DB** tool is operating system independent and only works
-with Python 3.
-
-### How to install
-
-**PyTestLog2DB** can be installed in two different ways.
-
-1.  Installation via PyPi (recommended for users)
-
-    ``` {.}
-    pip install PyTestLog2DB
-    ```
-
-    [PyTestLog2DB in PyPi](https://pypi.org/project/PyTestLog2DB/)
-
-2.  Installation via GitHub (recommended for developers)
-
-    -   Clone the **python-pytestlog2db** repository to your machine.
-
-        ``` {.}
-        git clone https://github.com/test-fullautomation/python-pytestlog2db.git
-        ```
-
-        [PyTestLog2DB in
-        GitHub](https://github.com/test-fullautomation/python-pytestlog2db)
-
-    -   Install dependencies
-
-        **PyTestLog2DB** requires some additional Python libraries.
-        Before you install the cloned repository sources you have to
-        install the dependencies manually. The names of all related
-        packages you can find in the file `requirements.txt` in the
-        repository root folder. Use pip to install them:
-
-        ``` {.}
-        pip install -r ./requirements.txt
-        ```
-
-        Additionally install **LaTeX** (recommended: TeX Live). This is
-        used to render the documentation.
-
-    -   Configure dependencies
-
-        The installation of **PyTestLog2DB** includes to generate the
-        documentation in PDF format. This is done by an application
-        called **GenPackageDoc**, that is part of the installation
-        dependencies (see `requirements.txt`).
-
-        **GenPackageDoc** uses **LaTeX** to generate the documentation
-        in PDF format. Therefore **GenPackageDoc** needs to know where
-        to find **LaTeX**. This is defined in the **GenPackageDoc**
-        configuration file
-
-        ``` {.}
-        packagedoc\packagedoc_config.json
-        ```
-
-        Before you start the installation you have to introduce the
-        following environment variable, that is used in
-        `packagedoc_config.json`:
-
-        -   `GENDOC_LATEXPATH` : path to `pdflatex` executable
-
-    -   Use the following command to install **PyTestLog2DB**:
-
-        ``` {.}
-        python setup.py install
-        ```
-
-After succesful installation, the executable file **PyTestLog2DB** will
-be available (under *Scripts* folder of Python on Windows and
-*\~/.local/bin/* folder on Linux).
-
-In case above location is added to **PATH** environment variable then
-you can run it directly as operation system\'s command.
-
-Usage
------
-
-**PyTestLog2DB** requires the [pytest](https://docs.pytest.org) result
-file(s) which contains the test result in *JUnit XML* format and
-[TestResultWebApp](https://github.com/test-fullautomation/TestResultWebApp)\'s
-database information for importing.
-
-Use below command to get tools\'s usage
-
-    PyTestLog2DB -h
-
-The usage should be showed as below:
-
-    usage: PyTestLog2DB (PyTestXMLReport to TestResultWebApp importer) [-h] [-v] [--recursive] [--dryrun] [--append] [--UUID UUID] [--variant VARIANT] [--versions VERSIONS] [--config CONFIG]
-                                                                       resultxmlfile server user password database
-
-    PyTestLog2DB imports pytest JUnit XML report file(s)generated by pytest into a WebApp database.
-
-    positional arguments:
-    resultxmlfile        absolute or relative path to the pytest JUnit XML report file or directory of report files to be imported.
-    server               server which hosts the database (IP or URL).
-    user                 user for database login.
-    password             password for database login.
-    database             database schema for database login.
-
-    optional arguments:
-    -h, --help           show this help message and exit
-    -v, --version        version of the PyTestLog2DB importer.
-    --recursive          if set, then the path is searched recursively for output files to be imported.
-    --dryrun             if set, then verify all input arguments (includes DB connection) and show what would be done.
-    --append             is used in combination with --UUID <UUID>. If set, allow to append new result(s) to existing execution result UUID in --UUID argument.
-    --UUID UUID          UUID used to identify the import and version ID on webapp. If not provided PyTestLog2DB will generate an UUID for the whole import.
-    --variant VARIANT    variant name to be set for this import.
-    --versions VERSIONS  metadata: Versions (Software;Hardware;Test) to be set for this import (semicolon separated).
-    --config CONFIG      configuration json file for component mapping information.
-    --interface {db,rest}
-                         database access interface.
-
-The below command is simple usage with all required arguments to import
-[pytest](https://docs.pytest.org) results into TestResultWebApp\'s
-database:
-
-    PyTestLog2DB <resultxmlfile> <server> <user> <password> <database>
-
-Besides the executable file, you can also run tool as a Python module
-
-    python -m PyTestLog2DB <resultxmlfile> <server> <user> <password> <database>
-
-Example
--------
-
-In order the import the robot result(s) to TestResultWebApp\'s database,
-we need the [pytest](https://docs.pytest.org) result file in *JUnit XML*
-format.
-
-So, firstly execute the [pytest](https://docs.pytest.org) testcase(s) to
-get the result file(s). But the **\*.xml** result file is not generated
-by default.
-
-We need to specify the argument *\--junit-xml=\<path\>* when executing
-[pytest](https://docs.pytest.org) to get the generated *JUnit XML*
-report file at given path.
-
-E.g: :
-
-    pytest --junit-xml=path/to/result.xml pytest/folder
-
-After that, the **\*.xml** result file will be available at
-**path/to/result.xml** and can be used for importing to
-[TestResultWebApp](https://github.com/test-fullautomation/TestResultWebApp)
-with command:
-
-    PyTestLog2DB path/to/result.xml localhost test_user test_pw test_db
-
-Then, open TestResultWebApp with your favourite browser and you will see
-how wonderful the execution result is displayed as below figures:
-
-Dashboard view:
-
-![Dashboard view](https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/packagedoc/additional_docs/pictures/Dashboard.png?raw=true)
-
-Datatable view:
-
-![Datatable view](https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/packagedoc/additional_docs/pictures/Datatable.png?raw=true)
-
-### Notes:
-
-> The **\*.xml** report file generated by pytest contains only the
-> testcase result(s) and less metadata information about the test
-> execution such as *project/variant*, *software version*, *tester* ,
-> *component*, \... which are required by
-> [TestResultWebApp](https://github.com/test-fullautomation/TestResultWebApp).
->
-> So that, **PyTestLog2DB** will handle those information with the
-> default values.
->
-> But you can use the optional argument *\--config CONFIG* to specify
-> those information when importing to
-> [TestResultWebApp](https://github.com/test-fullautomation/TestResultWebApp)\'s
-> database.
->
-> Sample configuration file:
->
->     {
->        "variant"   : "MyProject",
->        "version_sw": "0.1.1",
->        "components": {
->           "Testsuite1"       : "test-data.test_tsclass.TestSuite1",
->           "Testsuite2"       : "test-data.test_tsclass.TestSuite2",
->           "Others"          : [
->              "test-data.test_ts1",
->              "test-data.test_ts2"
->           ]
->        },
->        "tester"    : "Tran Duy Ngoan"
->     }
->
-> Please refer [PyTestLog2DB tool's
-> Documentation](https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/PyTestLog2DB/PyTestLog2DB.pdf)
-> for more detail about default values and the configuration json file.
-
-Contribution
-------------
-
-We are always searching support and you are cordially invited to help to
-improve **PyTestLog2DB** tool.
-
-Sourcecode Documentation
-------------------------
-
-To understand more detail about the tool\'s features, parameters and how
-pytest result(s) will be displayed on TestResultWebApp, please refer to
-[PyTestLog2DB tool's
-Documentation](https://github.com/test-fullautomation/python-pytestlog2db/blob/develop/PyTestLog2DB/PyTestLog2DB.pdf).
-
-Feedback
---------
-
-Please feel free to give any feedback to us via
-
-Email to: [Thomas Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)
-
-Issue tracking: [PyTestLog2DB
-Issues](https://github.com/test-fullautomation/python-pytestlog2db/issues)
-
-About
------
-
-### Maintainers
-
-[Thomas Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)
-
-[Holger Queckenstedt](mailto:Holger.Queckenstedt@de.bosch.com)
-
-[Tran Duy Ngoan](mailto:Ngoan.TranDuy@vn.bosch.com)
-
-### Contributors
-
-[Nguyen Huynh Tri Cuong](mailto:Cuong.NguyenHuynhTri@vn.bosch.com)
-
-[Mai Dinh Nam Son](mailto:Son.MaiDinhNam@vn.bosch.com)
-
-[Tran Hoang Nguyen](mailto:Nguyen.TranHoang@vn.bosch.com)
-
-### License
-
-Copyright 2020-2023 Robert Bosch GmbH
-
-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
-
-> [![License: Apache
-> v2](https://img.shields.io/pypi/l/robotframework.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
-
-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.
-
-

PyTestLog2DB-0.3.1.dist-info/RECORD

@@ -1,11 +0,0 @@
-PyTestLog2DB/PyTestLog2DB.pdf,sha256=_SWxi7NpwGw5B5ST_PYTRlG3ThL9ZgDnogMXqeS1caw,520598
-PyTestLog2DB/__init__.py,sha256=YKDTJjDsnQkr5X-gjjO8opwKUVKm6kc8sIUpURYMk48,596
-PyTestLog2DB/__main__.py,sha256=YCrS2paaKQlHRlq2d_HKHnsQHs9uVudKN51L84mKd74,693
-PyTestLog2DB/pytestlog2db.py,sha256=uy8brtKt54b2SeDylFrcPL5HvbOKZ0Ip0GVUsZcBe80,43712
-PyTestLog2DB/version.py,sha256=CTc-wU56FDKToufjb5eraZi_hMlI64EDwByvf6UVPZE,917
-PyTestLog2DB/xsd/junit.xsd,sha256=16vVXGy8p1afl2YbgX61g528x4x8Vy3Lf0qqKY9IAZs,6847
-PyTestLog2DB-0.3.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-PyTestLog2DB-0.3.1.dist-info/METADATA,sha256=23IYCfYo0G4XywE-RkoF33A4lcTr35Ev9YO_Hgy8r5s,10956
-PyTestLog2DB-0.3.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-PyTestLog2DB-0.3.1.dist-info/top_level.txt,sha256=WN8NnXKE7lkjhVq7yi3WQwIh54rVKUQdecci-Yy4pog,13
-PyTestLog2DB-0.3.1.dist-info/RECORD,,