January 2026 - BaseX-Talk - mailman.uni-konstanz.de

job:execute with unit:test stalls
by Lizzi, Vincent 04 Feb '26

04 Feb '26

Hi BaseX team, The new job:execute function in BaseX 12 is incredibly useful. Using job:execute, it's now possible to have a query that fetches data, dynamically computes the names of databases, creates the databases, populates the databases, and then reads from the same databases, all contained in one query or module!!! This can greatly simplify processes that previously required multiple steps. I'm running into trouble when trying to use %unit:test to test code that uses job:execute. Running the test causes a deadlock, even though the code works correctly when run on its own. Here is a small example based on the example in the documentation https://docs.basex.org/main/Job_Functions#job:execute This query produces "true" when run in BaseX GUI. job:execute('db:create("test")'), job:execute('db:put-value("test", 1 to 10, "numbers")'), job:execute('db:get-value("test", "numbers")') = (1 to 10) After adding %unit:test and unit:assert, when this test is run in BaseX GUI it stalls (until I click Stop to interrupt the process). module namespace t = "test"; declare %unit:test function t:test01 () { job:execute('db:create("test")'), job:execute('db:put-value("test", 1 to 10, "numbers")'), unit:assert(job:execute('db:get-value("test", "numbers")') = (1 to 10)) }; Should this work, or am I missing something? The documentation mentions to be careful to avoid deadlocks with updating queries. I've also found that a deadlock can occur when the main query uses fn:doc even if unrelated to job:execute, but this can be solved by wrapping fn:doc in job:execute. I haven't found a way to work around deadlocks that occur with %unit:test. I'm using BaseX version 12.2. Many thanks, Vincent ______________________________________________ Vincent M. Lizzi Head of Information Standards | Taylor & Francis Group E-Mail: vincent.lizzi(a)taylorandfrancis.com<mailto:vincent.lizzi@taylorandfrancis.com> Web: www.tandfonline.com<http://www.tandfonline.com/> Time zone: US Eastern Taylor & Francis is a trading name of Informa UK Limited, registered in England under no. 1072954 "Everything should be made as simple as possible, but not simpler." [cid:498c7d70-ddef-4485-9ad7-484411b1c0f5]<https://outlook.office.com/bookwithme/user/aa80d42cbb5b46dba06a5ad241d7665b…> Book time to meet with me<https://outlook.office.com/bookwithme/user/aa80d42cbb5b46dba06a5ad241d7665b…> Information Classification: General

2 4

C++ Client, Access to port 1984 denied after crash
by Ben Engbers 03 Feb '26

03 Feb '26

Hi, When using localhome, my libBasexTest executes this test without problems: cout << "\n4 Add content from a directory" << endl; string path; path.append(filesystem::read_symlink(exe_path).parent_path()).append("/src/extdata/xml_files"); for (const auto & entry : filesystem::directory_iterator(path)) { Session.Add("Add_XML_3", entry.path()); }; And 12 xml-files are added. But when I connect to a remote linux-based basexserver, I have to add: int limit = 11; int count = 0; for (const auto & entry : filesystem::directory_iterator(path)) { if (count > limit) break; Session.Add("Add_XML_3", entry.path()); count++; }; Without the 'if (count > limit) break;' libBasexTest crashes. And without test \n4 there are no errors. Strange... This is not the biggest problem. After crashing, on the remote server access to port 1984 is denied. I can't restart basexhttp nor basexserver. Both commands abort with the message that access to port 1984 is denied. Deleting the basex-tree and rebooting the remote machine is the only way to restart one off both services. What is the best way to resore connection to port 1984? Ben PS. After starting basexhttp - without a trailing & - I don't return to the prompt. Is this intentional? -- Ben Engbers Grietjeshof 77 6721 VH Bennekom +31 6 23634840

1 1

Unexpected result with simple mapping operator and sequence of maps
by Amanda Galtman 30 Jan '26

30 Jan '26

Hi, BaseX folks. In BaseX 12.1, Query A below returns (false, false), but I expected (true, false). Query B returns true, as I expected. Query C returns (true, false) as expected. Query A let $map1 := map{'key1': 'string'} let $map2 := map{'key1': [] } return ($map1, $map2) ! (. instance of map(xs:string, xs:anyAtomicType) ) Query B let $map1 := map{'key1': 'string'} return $map1 ! (. instance of map(xs:string, xs:anyAtomicType) ) Query C let $map1 := map{'key1': 'string'} return ($map1, 0) ! (. instance of map(xs:string, xs:anyAtomicType) ) Am I missing something, or is the Query A behavior a bug? Thanks, Amanda

2 2

c++ howto create and use a websocket to a remote machine
by Ben Engbers 28 Jan '26

28 Jan '26

Hi, Thanks to an increasing number of grandchildren, as a retiree I have had little time in recent years to continue working on my C++ client for Basex. It therefore took a lot of time to find and fix a very persistent memory leak, but I finally succeeded. On a local machine, running basexserver, the entire server protocol can be handled without error messages. The only thing I couldn't test yet was the use of a websocket to a remote machine, and that now appears to be causing problems. On an old PC, I installed a minimal version of Fedora 43 that does not use GNOME. Basexserver runs without any problems and I can create new users in basexclient. Local use of my client does not cause any problems. But when I want to create a websocket to the test machine, I get the error message “setsockopt: Bad file descriptor”. After several attempts using the IP address instead of the machine name, both my laptop and the test PC crashed, and I had to reinstall basex. In C++, I use the following code to create a socket (the starting point for this code was Alexander Holupirek's C code “basexdbc.c”): BasexSocket & BasexSocket::CreateSocket (string host, string port) { // @suppress("Name convention for function") cout << __FUNCTION__ << " : " << host << " | " << port << " | " << endl; if (host.empty () || port.empty ()) { cout << "ERROR: Invalid hostname/port\n" << endl; exit(0); } /* if (host.empty () || port.empty ()) { Master_sfd = -1; return *this; } */ struct addrinfo hints; struct addrinfo * result = NULL, *rp; memset (&hints, 0, sizeof (struct addrinfo)); // Initialize hints hints.ai_family = AF_INET; // Accept both AF_INET and AF_INET6 hints.ai_socktype = SOCK_STREAM; hints.ai_flags = AI_NUMERICSERV; // Port must be specified as number int rc; rc = getaddrinfo (host.c_str (), port.c_str (), &hints, &result); if (rc != 0) perror (gai_strerror (rc)); for (rp = result; rp != NULL; rp = rp->ai_next) { // result is a linked list of address structures. Master_sfd = socket (rp->ai_family, rp->ai_socktype, rp->ai_protocol); if (Master_sfd == -1) continue; if (connect (Master_sfd, rp->ai_addr, rp->ai_addrlen) != -1) break; // Try to connect. Return the first successfull connect or abort close (Master_sfd); } set_nonblock_flag (Master_sfd, 1); int opt = true; if (setsockopt (Master_sfd, SOL_SOCKET, SO_REUSEADDR, (char *) &opt, sizeof (opt)) < 0) { perror ("setsockopt"); exit (EXIT_FAILURE); } if (rp == NULL) { warnx ("Can not connect to Basex server"); } freeaddrinfo (result); cout << "Master_sfd: " << Master_sfd << endl; return *this; }; Can anyone explain to me how I can successfully build a websocket to the test PC? Ben

2 4

Web pages rendering issue on https://files.basex.org
by Yitzhak Khabinsky 28 Jan '26

28 Jan '26

Hello, Lately we have quite a few new threads dedicated to UI improvements. Here is one more. Two web pages, accessible from https://basex.org/download/: · Latest developer snapshot (https://files.basex.org/releases/latest/) · Previous versions (https://files.basex.org/releases/) are not displaying correctly links while Dark Theme is used in (1) MS Edge and (2) Brave browsers. A white band is overlapping/hiding actual links for the files. Steps to turn on a Dark Theme in the Brave browser: - Type brave://flags into the address bar and press Enter. - Search for "Auto Dark Mode for Web Contents" or "Force Dark Mode for Web Contents". - Change the dropdown from "Default" to "Enabled" or select a specific inversion style (like "Enabled with selective inversion"). - Relaunch the browser when prompted. If needed, I can provide screen shots. Thank you in advance. Regards, Yitzhak Khabinsky

1 1

changing the BaseX GUI menu font
by Graydon Saunders 26 Jan '26

26 Jan '26

Hello -- So I've successfully added the JTattoo themes mentioned in the documentation https://jtattoo.de/index.html These work, in that new theme names appear and the BaseX GUI application looks different when I select different themes from the list. What they don't seem to do is provide any way to change the font size of the menus or the editor tabs with the file name in them. (The JTattoo themes do provide antialiasing, which is welcome.) It's a high resolution monitor and a notional 40 point font in the editor looks about right; the 11 or 12 point font to which the tabs and menus default is hard to read. I am forming the impression that there might be some sort of global base font setting somewhere but I have no idea where I'd even start looking. (The themes that appear built in to the BaseX GUI also work; I presume those live in the JDK somewhere?) Is there some sort of -Djdk.controlFont.size setting available? I'm using Linux (with LXQt as the window manager); I'm using OpenJDK 25.0.1 and BaseX 12.2. Thanks! Graydon

3 9

JDBC drivers location
by Yitzhak Khabinsky 21 Jan '26

21 Jan '26

Hello, Congrats on the BaseX 12.2 release! It seems that I bumped into a minor issue on a machine with MS Windows OS. My XQuery is using SQL module, and for that I am using Microsoft JDBC Driver for SQL Server. In particular, its mssql-jdbc-13.2.1.jre11.jar file needs to be in the ~basex\lib directory. It looks like that in-place update from the BaseX 12.1 to BaseX 12.2 deleted the ~basex\lib\mssql-jdbc-13.2.1.jre11.jar file. I received an error message. The solution was very simple, I copied the missing mssql-jdbc-13.2.1.jre11.jar file to the same location, restarted the BaseX GUI, and database calls started to work again. As a test, I deleted Microsoft jar in the ~\basex\lib\ and copied it to the ~\basex\lib\custom\ And database calls started to work again. The documentation says the following: "..If you work with the full distributions of BaseX, you can copy the driver into the lib directory..." https://docs.basex.org/main/SQL_Functions IMHO, it is better to update BaseX documentation, and recommend to copy JDBC *.jar files to the ~\basex\lib\custom\ directory. This way JDBC drivers will survive BaseX updates in-place. Regards, Yitzhak Khabinsky

2 1

the right way to respond to JAXP00010001
by Graydon Saunders 08 Jan '26

08 Jan '26

Hello (and Happy New Year!) I'm on Linux (Fedora) using BaseX 12.1 and OpenJDK Runtime Environment (Red_Hat-25.0.1.0.8-3) (build 25.0.1+8) I've got some data, which I want BaseX to load by the individual document using the doc() function. On one of these documents I get a parsing failure that reports JAXP00010001; if I look that up, I find https://www.oracle.com/java/technologies/javase/24-relnote-issues.html which says this limit changed (from a traditional larger number) to 2500, so now the error text is `JAXP00010001: The parser has encountered more than "2500" entity expansions in this document; this is the limit imposed by the JDK` It's a large file and I can't do anything about that part, nor can I do anything about the number of entity references these files happen to have when I get them. (In this particular case, a bit more than five thousand.) The Oracle page lists a bunch of options for how to set a different entity expansion limit. In context of BaseX, what's the right way to adjust the entity expansion limit (in my case, generally the BaseX GUI) so these files will parse? Thanks! Graydon

3 6