testium-hil 0.4.2__tar.gz

testium_hil-0.4.2/LICENSE

@@ -0,0 +1,315 @@
+Copyright (c) 2025-2026 François Dausseur
+
+Licensed under the EUPL
+
+
+                       EUROPEAN UNION PUBLIC LICENCE v. 1.2
+                       EUPL © the European Union 2007, 2016
+
+This European Union Public Licence (the 'EUPL') applies to the Work (as
+defined below) which is provided under the terms of this Licence. Any use of
+the Work, other than as authorised under this Licence is prohibited (to the
+extent such use is covered by a right of the copyright holder of the Work).
+
+The Work is provided under the terms of this Licence when the Licensor (as
+defined below) has placed the following notice immediately following the
+copyright notice for the Work:
+
+        Licensed under the EUPL
+
+or has expressed by any other means his willingness to license under the EUPL.
+
+
+1. Definitions
+
+In this Licence, the following terms have the following meaning:
+
+- 'The Licence': this Licence.
+
+- 'The Original Work': the work or software distributed or communicated by the
+  Licensor under this Licence, available as Source Code and also as Executable
+  Code as the case may be.
+
+- 'Derivative Works': the works or software that could be created by the
+  Licensee, based upon the Original Work or modifications thereof. This Licence
+  does not define the extent of modification or dependence on the Original
+  Work required in order to classify a work as a Derivative Work; this extent
+  is determined by copyright law applicable in the country mentioned in
+  Article 15.
+
+- 'The Work': the Original Work or its Derivative Works.
+
+- 'The Source Code': the human-readable form of the Work which is the most
+  convenient for people to study and modify.
+
+- 'The Executable Code': any code which has generally been compiled and which
+  is meant to be interpreted by a computer as a program.
+
+- 'The Licensor': the natural or legal person that distributes or communicates
+  the Work under the Licence.
+
+- 'Contributor(s)': any natural or legal person who modifies the Work under
+  the Licence, or otherwise contributes to the creation of a Derivative Work.
+
+- 'The Licensee' or 'You': any natural or legal person who makes any usage of
+  the Work under the terms of the Licence.
+
+- 'Distribution' or 'Communication': any act of selling, giving, lending,
+  renting, distributing, communicating, transmitting, or otherwise making
+  available, online or offline, copies of the Work or providing access to its
+  essential functionalities at the disposal of any other natural or legal
+  person.
+
+
+2. Scope of the rights granted by the Licence
+
+The Licensor hereby grants You a worldwide, royalty-free, non-exclusive,
+sublicensable licence to do the following, for the duration of copyright
+vested in the Original Work:
+
+- use the Work in any circumstance and for all usage,
+- reproduce the Work,
+- modify the Work, and make Derivative Works based upon the Work,
+- communicate to the public, including the right to make available or display
+  the Work or copies thereof to the public and perform publicly, as the case
+  may be, the Work,
+- distribute the Work or copies thereof,
+- lend and rent the Work or copies thereof,
+- sublicense rights in the Work or copies thereof.
+
+Those rights can be exercised on any media, supports and formats, whether now
+known or later invented, as far as the applicable law permits so.
+
+In the countries where moral rights apply, the Licensor waives his right to
+exercise his moral right to the extent allowed by law in order to make
+effective the licence of the economic rights here above listed.
+
+The Licensor grants to the Licensee royalty-free, non-exclusive usage rights
+to any patents held by the Licensor, to the extent necessary to make use of
+the rights granted on the Work under this Licence.
+
+
+3. Communication of the Source Code
+
+The Licensor may provide the Work either in its Source Code form, or as
+Executable Code. If the Work is provided as Executable Code, the Licensor
+provides in addition a machine-readable copy of the Source Code of the Work
+along with each copy of the Work that the Licensor distributes or indicates,
+in a notice following the copyright notice attached to the Work, a repository
+where the Source Code is easily and freely accessible for as long as the
+Licensor continues to distribute or communicate the Work.
+
+
+4. Limitations on copyright
+
+Nothing in this Licence is intended to deprive the Licensee of the benefits
+from any exception or limitation to the exclusive rights of the rights owners
+in the Work, of the exhaustion of those rights or of other applicable
+limitations thereto.
+
+
+5. Obligations of the Licensee
+
+The grant of the rights mentioned above is subject to some restrictions and
+obligations imposed on the Licensee. Those obligations are the following:
+
+Attribution right: The Licensee shall keep intact all copyright, patent or
+trademarks notices and all notices that refer to the Licence and to the
+disclaimer of warranties. The Licensee must include a copy of such notices
+and a copy of the Licence with every copy of the Work he/she distributes or
+communicates. The Licensee must cause any Derivative Work to carry prominent
+notices stating that the Work has been modified and the date of modification.
+
+Copyleft clause: If the Licensee distributes or communicates copies of the
+Original Works or Derivative Works, this Distribution or Communication will
+be done under the terms of this Licence or of a later version of this Licence
+unless the Original Work is expressly distributed only under this version of
+the Licence — for example by communicating 'EUPL v. 1.2 only'. The Licensee
+(becoming Licensor) cannot offer or impose any additional terms or conditions
+on the Work or Derivative Work that alter or restrict the terms of the
+Licence.
+
+Compatibility clause: If the Licensee Distributes or Communicates Derivative
+Works or copies thereof based upon both the Work and another work licensed
+under a Compatible Licence, this Distribution or Communication can be done
+under the terms of this Compatible Licence. For the sake of this clause,
+'Compatible Licence' refers to the licences listed in the appendix attached
+to this Licence. Should the Licensee's obligations under the Compatible
+Licence conflict with his/her obligations under this Licence, the obligations
+of the Compatible Licence shall prevail.
+
+Provision of Source Code: When distributing or communicating copies of the
+Work, the Licensee will provide a machine-readable copy of the Source Code or
+indicate a repository where this Source will be easily and freely available
+for as long as the Licensee continues to distribute or communicate the Work.
+
+Legal Protection: This Licence does not grant permission to use the trade
+names, trademarks, service marks, or 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 copyright notice.
+
+
+6. Chain of Authorship
+
+The original Licensor warrants that the copyright in the Original Work
+granted hereunder is owned by him/her or licensed to him/her and that he/she
+has the power and authority to grant the Licence.
+
+Each Contributor warrants that the copyright in the modifications he/she
+brings to the Work are owned by him/her or licensed to him/her and that
+he/she has the power and authority to grant the Licence.
+
+Each time You accept the Licence, the original Licensor and subsequent
+Contributors grant You a licence to their contributions to the Work, under
+the terms of this Licence.
+
+
+7. Disclaimer of Warranty
+
+The Work is a work in progress, which is continuously improved by numerous
+Contributors. It is not a finished work and may therefore contain defects or
+'bugs' inherent to this type of development.
+
+For the above reason, the Work is provided under the Licence on an 'as is'
+basis and without warranties of any kind concerning the Work, including
+without limitation merchantability, fitness for a particular purpose, absence
+of defects or errors, accuracy, non-infringement of intellectual property
+rights other than copyright as stated in Article 6 of this Licence.
+
+This disclaimer of warranty is an essential part of the Licence and a
+condition for the grant of any rights to the Work.
+
+
+8. Disclaimer of Liability
+
+Except in the cases of wilful misconduct or damages directly caused to
+natural persons, the Licensor will in no event be liable for any direct or
+indirect, material or moral, damages of any kind, arising out of the Licence
+or of the use of the Work, including without limitation, damages for loss of
+goodwill, work stoppage, computer failure or malfunction, loss of data or any
+commercial damage, even if the Licensor has been advised of the possibility
+of such damage. However, the Licensor will be liable under statutory product
+liability laws as far such laws apply to the Work.
+
+
+9. Additional agreements
+
+While distributing the Work, You may choose to conclude an additional
+agreement, defining obligations or services consistent with this Licence.
+However, if accepting obligations, You may act only on your own behalf and on
+your sole responsibility, not on behalf of the original Licensor or 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 the fact You have accepted any warranty or
+additional liability.
+
+
+10. Acceptance of the Licence
+
+The provisions of this Licence can be accepted by clicking on an icon 'I
+agree' placed under the bottom of a window displaying the text of this
+Licence or by affirming consent in any other similar way, in accordance with
+the rules of applicable law. Clicking on that icon indicates your clear and
+irrevocable acceptance of this Licence and all of its terms and conditions.
+
+Similarly, you irrevocably accept this Licence and all of its terms and
+conditions by exercising any rights granted to You by Article 2 of this
+Licence, such as the use of the Work, the creation by You of a Derivative
+Work or the Distribution or Communication by You of the Work or copies
+thereof.
+
+
+11. Information to the public
+
+In case of any Distribution or Communication of the Work by means of
+electronic communication by You (for example, by offering to download the
+Work from a remote location) the distribution channel or media (for example,
+a website) must at least provide to the public the information requested by
+the applicable law regarding the Licensor, the Licence and the way it may be
+accessible, concluded, stored and reproduced by the Licensee.
+
+
+12. Termination of the Licence
+
+The Licence and the rights granted hereunder will terminate automatically
+upon any breach by the Licensee of the terms of the Licence.
+
+Such a termination will not terminate the licences of any person who has
+received the Work from the Licensee under the Licence, provided such persons
+remain in full compliance with the Licence.
+
+
+13. Miscellaneous
+
+Without prejudice of Article 9 above, the Licence represents the complete
+agreement between the Parties as to the Work.
+
+If any provision of the Licence is invalid or unenforceable under applicable
+law, this will not affect the validity or enforceability of the Licence as a
+whole. Such provision will be construed or reformed so as necessary to make
+it valid and enforceable.
+
+The European Commission may publish other linguistic versions or new versions
+of this Licence or updated versions of the Appendix, so far this is required
+and reasonable, without reducing the scope of the rights granted by the
+Licence. New versions of the Licence will be published with a unique version
+number.
+
+All linguistic versions of this Licence, approved by the European Commission,
+have identical value. Parties can take advantage of the linguistic version of
+their choice.
+
+
+14. Jurisdiction
+
+Without prejudice to specific agreement between parties,
+
+- any litigation resulting from the interpretation of this License, arising
+  between the European Union institutions, bodies, offices or agencies, as a
+  Licensor, and any Licensee, will be subject to the jurisdiction of the
+  Court of Justice of the European Union, as laid down in article 272 of the
+  Treaty on the Functioning of the European Union,
+
+- any litigation arising between other parties and resulting from the
+  interpretation of this License, will be subject to the exclusive
+  jurisdiction of the competent court where the Licensor resides or conducts
+  its primary business.
+
+
+15. Applicable Law
+
+Without prejudice to specific agreement between parties,
+
+- this Licence shall be governed by the law of the European Union Member
+  State where the Licensor has his seat, resides or has his registered
+  office,
+
+- this licence shall be governed by Belgian law if the Licensor has no seat,
+  residence or registered office inside a European Union Member State.
+
+
+                                  Appendix
+
+
+'Compatible Licences' according to Article 5 EUPL are:
+
+- GNU General Public License (GPL) v. 2, v. 3
+- GNU Affero General Public License (AGPL) v. 3
+- Open Software License (OSL) v. 2.1, v. 3.0
+- Eclipse Public License (EPL) v. 1.0
+- CeCILL v. 2.0, v. 2.1
+- Mozilla Public Licence (MPL) v. 2
+- GNU Lesser General Public Licence (LGPL) v. 2.1, v. 3
+- Creative Commons Attribution-ShareAlike v. 3.0 Unported (CC BY-SA 3.0) for
+  works other than software
+- European Union Public Licence (EUPL) v. 1.1, v. 1.2
+- Québec Free and Open-Source Licence — Reciprocity (LiLiQ-R) or Strong
+  Reciprocity (LiLiQ-R+).
+
+The European Commission may update this Appendix to later versions of the
+above licences without producing a new version of the EUPL, as long as they
+provide the rights granted in Article 2 of this Licence and protect the
+covered Source Code from exclusive appropriation.
+
+All other changes or additions to this Appendix require the production of a
+new EUPL version.

testium_hil-0.4.2/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: testium-hil
+Version: 0.4.2
+Summary: YAML-driven test sequencer for hardware-in-the-loop and integration testing
+Author-email: François Dausseur <francois.dausseur@gmail.com>
+License-Expression: EUPL-1.2
+Project-URL: Homepage, https://github.com/testium-HIL/testium
+Project-URL: Repository, https://github.com/testium-HIL/testium
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools
+Requires-Dist: pyside6
+Requires-Dist: pyyaml
+Requires-Dist: pyserial
+Requires-Dist: colorama
+Requires-Dist: matplotlib
+Requires-Dist: telnetlib3
+Requires-Dist: jinja2
+Requires-Dist: pexpect
+Requires-Dist: gitpython
+Requires-Dist: junit-xml
+Requires-Dist: lxml
+Provides-Extra: lsp
+Requires-Dist: pygls>=1.3; extra == "lsp"
+Dynamic: license-file
+
+# testium
+
+testium is a YAML-driven test sequencer for hardware-in-the-loop and
+integration testing. A test campaign is described in a `.tum` file as a tree
+of items (checks, console interactions, Python/Lua functions, parallel blocks,
+dialogs, …); testium executes the tree, captures results, and produces
+reports in several formats.
+
+![testium running a test session](https://raw.githubusercontent.com/testium-HIL/testium/main/doc/testium_session.gif)
+
+```sh
+pip install testium-hil
+testium              # GUI mode
+testium -b test.tum  # batch mode
+```
+
+Documentation, tutorials and pre-built binaries:
+<https://github.com/testium-HIL/testium>

testium_hil-0.4.2/README.md

@@ -0,0 +1,18 @@
+# testium
+
+testium is a YAML-driven test sequencer for hardware-in-the-loop and
+integration testing. A test campaign is described in a `.tum` file as a tree
+of items (checks, console interactions, Python/Lua functions, parallel blocks,
+dialogs, …); testium executes the tree, captures results, and produces
+reports in several formats.
+
+![testium running a test session](https://raw.githubusercontent.com/testium-HIL/testium/main/doc/testium_session.gif)
+
+```sh
+pip install testium-hil
+testium              # GUI mode
+testium -b test.tum  # batch mode
+```
+
+Documentation, tutorials and pre-built binaries:
+<https://github.com/testium-HIL/testium>

testium_hil-0.4.2/VERSION

@@ -0,0 +1 @@
+0.4.2

testium_hil-0.4.2/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name="testium-hil"
+description = "YAML-driven test sequencer for hardware-in-the-loop and integration testing"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [
+  {name = "François Dausseur", email = "francois.dausseur@gmail.com"},
+]
+license = "EUPL-1.2"
+license-files = ["LICENSE"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Programming Language :: Python",
+]
+dependencies = [
+    "setuptools",
+    "pyside6",
+    "pyyaml",
+    "pyserial",
+    "colorama",
+    "matplotlib",
+    "telnetlib3",
+    "jinja2",
+    "pexpect",
+    "gitpython",
+    "junit-xml",
+    "lxml",
+]
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://github.com/testium-HIL/testium"
+Repository = "https://github.com/testium-HIL/testium"
+
+[project.optional-dependencies]
+# `pip install "testium-hil[lsp]"` adds the language-server dependencies. The
+# stdio-only LSP server (`testium lsp`) reuses the schema export from the
+# core install; pygls is the only marginal cost.
+lsp = ["pygls>=1.3"]
+
+[project.scripts]
+testium = "testium:main"
+
+[tool.setuptools.packages.find]
+where=["."]
+# Keep stale in-place `src/build/` trees out of the wheel.
+exclude=["build", "build.*"]
+
+# Top-level alias of testium/runtime/testium_report.py so plugin authors can
+# `from testium_report import Exporter` in their dev venv with a plain
+# `pip install testium-hil`. At run time under testium the copy shipped in
+# runtime/ wins (the export worker's directory precedes site-packages).
+[tool.setuptools]
+py-modules = ["testium_report"]
+
+[tool.setuptools.package-data]
+"testium.lua_func" = ["*.lua"]
+
+[tool.setuptools.dynamic]
+version = {file = ["VERSION"]}

testium_hil-0.4.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

testium_hil-0.4.2/testium/__init__.py

@@ -0,0 +1,149 @@
+#!/usr/bin/env python
+import sys
+import os
+import multiprocessing
+from pathlib import Path
+
+ourpath = Path(__file__)
+ourpath = ourpath.resolve()
+sys.path.append(os.path.abspath(ourpath.parent))
+
+import interpreter.utils.constants as cst
+
+def main():
+    # Force UTF-8 on stdout/stderr so the runner's output survives a legacy
+    # console code page (Windows cp1252 can't encode box-drawing/accented
+    # chars). Only the stream encoders change; the locale default used for
+    # config files is untouched.
+    for _stream in (sys.stdout, sys.stderr):
+        try:
+            _stream.reconfigure(encoding="utf-8")
+        except (AttributeError, ValueError):
+            pass  # no stdout (frozen GUI) or non-reconfigurable stream
+
+    # Subcommand dispatch (must run *before* argparse so neither 'schema' nor
+    # 'lsp' has to share the GUI/batch flag surface). The subcommands also
+    # skip the multiprocessing 'spawn' setup which is only meaningful for the
+    # main runtime — schema is a pure stdout dump and lsp speaks JSON-RPC
+    # over stdio without ever forking a test process.
+    if len(sys.argv) >= 2 and sys.argv[1] in ("schema", "lsp"):
+        sub = sys.argv[1]
+        if sub == "schema":
+            from lsp.schema import dump_jsonschema_json
+            print(dump_jsonschema_json())
+            return
+        # lsp
+        try:
+            from lsp.server import serve
+        except ImportError as e:
+            print(
+                f"testium lsp: language server dependencies missing ({e.name}). "
+                "Install with: pip install 'testium[lsp]'",
+                file=sys.stderr,
+            )
+            sys.exit(2)
+        serve()
+        return
+
+    # This line sets the method for the "Process" function. It is required for Linux
+    # support of the test dialogs.
+    multiprocessing.set_start_method('spawn')
+
+    import argparse
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--version",
+                        help="Returns the version of testium", action='store_true')
+    parser.add_argument("-b", "--batch-execution",
+                        help="Executes the test in batch mode", action='store_true')
+    parser.add_argument("-o", "--no-color",
+                        help="Deactivates stdout colors in batch mode", action='store_true')
+    parser.add_argument("-c", "--config-file", help="Configuration file",
+                        nargs='+',
+                        default=[])
+    parser.add_argument("-r", "--run-and-close", action='store_true',
+                        help="Runs the test then closes the application",
+                        required=False)
+    parser.add_argument("-l", "--log-file", help="log file name", default='')
+    parser.add_argument("-d", "--define",
+                        help="Configuration passed to the executed tests.",
+                        nargs='+',
+                        type=str,
+                        action='append',
+                        default=[])
+    parser.add_argument("-p", "--report-file",
+                        help="report file name", default='')
+    parser.add_argument("-t", "--report-type", help="report file type",
+                        choices=cst.REP_TYPES,
+                        default='')
+    parser.add_argument("-n", "--report-pattern", help="report file pattern",
+                        nargs='+',
+                        default=[])
+    parser.add_argument("-i", "--include-path",
+                        help="Python modules search path",
+                        nargs='+',
+                        default=[])
+    parser.add_argument("-g", "--dev-debug", "--debug", action='store_true',
+                        dest="debug",
+                        help="attach a debugger to testium itself "
+                             "(development, see CONTRIBUTING.md)",
+                        required=False)
+
+    parser.add_argument(
+        'test_file', help='the test script file', nargs='?', default='')
+    args = parser.parse_args()
+
+    if len(args.include_path)>0:
+        for p in args.include_path:
+            sys.path.append(p)
+
+    defines = {}
+    defs = []
+    for define in args.define:
+        defs += define
+    for define in defs:
+        d = define.split('=', 1)
+        if d[0].strip() != '':
+            if len(d) > 1:
+                defines.update({d[0].strip(): d[1]})
+            else:
+                defines.update({d[0].strip(): True})
+
+    cf = []
+    for c in args.config_file:
+        conf = c.strip('\"').strip("\'")
+        if not os.path.isabs(conf):
+            conf = os.path.join(os.getcwd(), conf)
+        cf.append(conf)
+    tf = args.test_file.strip('\"').strip("\'")
+    rf = args.report_file.strip('\"').strip("\'")
+    lf = args.log_file.strip('\"').strip("\'")
+    pn = []
+    for p in args.report_pattern:
+        pn.append(p.strip('\"').strip("\'"))
+
+    if args.version:
+        # initilization of the settings (used to know if git supported)
+        import interpreter.utils.settings as prefs
+        prefs.init()
+
+        from interpreter.utils.version import get_testium_version
+        print(get_testium_version())
+
+    elif args.batch_execution:
+        if (lf != ''):
+            print('"-l" option is not supported in this mode.')
+
+        from interpreter.batch import Batch
+        b = Batch(tf, cf, defines, rf, args.report_type, pn, args.no_color, text_mode=True)
+        sys.exit(0 if b.success else 1)
+
+    else:
+        from main_win.testium_win import MainWin
+        MainWin(tf, config_files=cf,
+                run=args.run_and_close,
+                log_file=lf,
+                defines=defines,
+                report=rf,
+                report_type=args.report_type,
+                report_pattern=pn,
+                debug=args.debug)

testium_hil-0.4.2/testium/__main__.py

@@ -0,0 +1,20 @@
+import os, sys
+import traceback
+import multiprocessing
+
+def exception_handler(typ_exc, value, trbk):
+    """Testium Exception handling"""
+    print(f"Critical failure : '{value}'.")
+    tb = traceback.format_exception(typ_exc, value, trbk)
+    print("".join(tb[-4:]))
+
+sys.excepthook = exception_handler
+
+sys.path.append(os.path.join(os.path.dirname(os.path.abspath(__file__)), '..'))
+
+from testium import main
+
+if __name__ == '__main__':
+    if getattr(sys, 'frozen', False):
+        multiprocessing.freeze_support()
+    main()