Script 'mail_helper' called by obssrc Hello community, here is the log from the commit of package openQA for openSUSE:Leap:16.0 checked in at 2025-08-07 09:07:26 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Leap:16.0/openQA (Old) and /work/SRC/openSUSE:Leap:16.0/.openQA.new.1085 (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "openQA" Thu Aug 7 09:07:26 2025 rev:27 rq:1298015 version:5.1754477962.22b1fea4 Changes: -------- --- /work/SRC/openSUSE:Leap:16.0/openQA/openQA.changes 2025-08-05 19:13:06.382991775 +0200 +++ /work/SRC/openSUSE:Leap:16.0/.openQA.new.1085/openQA.changes 2025-08-07 09:07:54.614647930 +0200 @@ -1,0 +2,6 @@ +Wed Aug 06 14:14:25 UTC 2025 - [email protected] + +- Update to version 5.1754477962.22b1fea4: + * Extend docs on lua test modules + +------------------------------------------------------------------- Old: ---- openQA-5.1754383059.0426baa1.obscpio New: ---- openQA-5.1754477962.22b1fea4.obscpio ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ openQA-client-test.spec ++++++ --- /var/tmp/diff_new_pack.6naMQd/_old 2025-08-07 09:07:55.034665445 +0200 +++ /var/tmp/diff_new_pack.6naMQd/_new 2025-08-07 09:07:55.034665445 +0200 @@ -18,7 +18,7 @@ %define short_name openQA-client Name: %{short_name}-test -Version: 5.1754383059.0426baa1 +Version: 5.1754477962.22b1fea4 Release: 0 Summary: Test package for %{short_name} License: GPL-2.0-or-later ++++++ openQA-devel-test.spec ++++++ --- /var/tmp/diff_new_pack.6naMQd/_old 2025-08-07 09:07:55.062666613 +0200 +++ /var/tmp/diff_new_pack.6naMQd/_new 2025-08-07 09:07:55.066666779 +0200 @@ -18,7 +18,7 @@ %define short_name openQA-devel Name: %{short_name}-test -Version: 5.1754383059.0426baa1 +Version: 5.1754477962.22b1fea4 Release: 0 Summary: Test package for %{short_name} License: GPL-2.0-or-later ++++++ openQA-test.spec ++++++ --- /var/tmp/diff_new_pack.6naMQd/_old 2025-08-07 09:07:55.090667780 +0200 +++ /var/tmp/diff_new_pack.6naMQd/_new 2025-08-07 09:07:55.094667947 +0200 @@ -18,7 +18,7 @@ %define short_name openQA Name: %{short_name}-test -Version: 5.1754383059.0426baa1 +Version: 5.1754477962.22b1fea4 Release: 0 Summary: Test package for openQA License: GPL-2.0-or-later ++++++ openQA-worker-test.spec ++++++ --- /var/tmp/diff_new_pack.6naMQd/_old 2025-08-07 09:07:55.122669115 +0200 +++ /var/tmp/diff_new_pack.6naMQd/_new 2025-08-07 09:07:55.122669115 +0200 @@ -18,7 +18,7 @@ %define short_name openQA-worker Name: %{short_name}-test -Version: 5.1754383059.0426baa1 +Version: 5.1754477962.22b1fea4 Release: 0 Summary: Test package for %{short_name} License: GPL-2.0-or-later ++++++ openQA.spec ++++++ --- /var/tmp/diff_new_pack.6naMQd/_old 2025-08-07 09:07:55.154670449 +0200 +++ /var/tmp/diff_new_pack.6naMQd/_new 2025-08-07 09:07:55.158670616 +0200 @@ -97,7 +97,7 @@ %define devel_requires %devel_no_selenium_requires chromedriver Name: openQA -Version: 5.1754383059.0426baa1 +Version: 5.1754477962.22b1fea4 Release: 0 Summary: The openQA web-frontend, scheduler and tools License: GPL-2.0-or-later ++++++ openQA-5.1754383059.0426baa1.obscpio -> openQA-5.1754477962.22b1fea4.obscpio ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/openQA-5.1754383059.0426baa1/docs/WritingTests.asciidoc new/openQA-5.1754477962.22b1fea4/docs/WritingTests.asciidoc --- old/openQA-5.1754383059.0426baa1/docs/WritingTests.asciidoc 2025-08-05 10:37:39.000000000 +0200 +++ new/openQA-5.1754477962.22b1fea4/docs/WritingTests.asciidoc 2025-08-06 12:59:22.000000000 +0200 @@ -260,6 +260,72 @@ `run_args` as error. This is because of the way `Inline::Python` does not pass references to complex Perl objects to Python. +=== Notes on the Lua API +[id="notes-lua-api"] + +The Lua integration that openQA offers through `Inline::Lua` also allows +the test modules to import other Perl modules via the `use()` function +which works similar to Perl's native `use` function. + +[source,lua] +------------------------------------------------------------------- +use("testapi") -- imports all functions that testapi.pm exports +use("testapi", {"check_screen"}) -- only imports the check_screen function from the testapi +------------------------------------------------------------------- + +NOTE: The `use()` function will import everything into the global scope. + +Libraries written in Lua can be placed as `.lua` files into the `tests/lib/` directory. + +[source,lua] +------------------------------------------------------------------- +-- example test library to be imported by lua test modules + +local modname = "luatestlib" +local M = {} +_G[modname] = M +package.loaded[modname] = M + +function M.testfunc3() + print("testfunc3") + return 44 +end +------------------------------------------------------------------- + +The above library can be imported from a Lua test using the `require` function. + +NOTE: Lua libraries are - other than perl libraries - imported into their own scope. + +[source,lua] +------------------------------------------------------------------- +require 'luatestlib' +luatestlib.testfunc3() -- returns 44 +------------------------------------------------------------------- + +Because of the way `Inline::Lua` binds Perl functions to Lua it is not +possible to use keywords arguments from Lua to Perl functions. They must be +passed as positional arguments of alternating key and value entries. + +See the following snippet of Perl code + +[source,perl] +------------------------------------------------------------------- +x11_start_program('vncviewer :0', + target_match => 'virtman-gnome_virt-install', + match_timeout => 100 +); +------------------------------------------------------------------- + +versus the equivalent Lua code: + +[source,lua] +------------------------------------------------------------------- +x11_start_program('vncviewer :0', + 'target_match', 'virtman-gnome_virt-install', + 'match_timeout', 100 +) +------------------------------------------------------------------- + === Example Perl test modules [id="testmodule_perl_examples"] ++++++ openQA.obsinfo ++++++ --- /var/tmp/diff_new_pack.6naMQd/_old 2025-08-07 09:08:09.759279472 +0200 +++ /var/tmp/diff_new_pack.6naMQd/_new 2025-08-07 09:08:09.767279806 +0200 @@ -1,5 +1,5 @@ name: openQA -version: 5.1754383059.0426baa1 -mtime: 1754383059 -commit: 0426baa1d7e492b00a29b6784501777668af3b24 +version: 5.1754477962.22b1fea4 +mtime: 1754477962 +commit: 22b1fea454ac331d490afe867bf939cd84cf0d6c
