xquery4 2.4.1
See the version list below for details.
dotnet tool install --global xquery4 --version 2.4.1
dotnet new tool-manifest
dotnet tool install --local xquery4 --version 2.4.1
#tool dotnet:?package=xquery4&version=2.4.1
nuke :add-package xquery4 --version 2.4.1
xquery
Command-line XQuery 3.1/4.0 processor for .NET. Query XML documents from the terminal using the PhoenixmlDb XQuery engine.
Installation
dotnet tool install -g xquery4
Usage
# Query an XML file
xquery '//book/title' library.xml
# Count elements
xquery 'count(//item)' catalog.xml
# Read from a query file
xquery -f transform.xq input.xml
# Query a directory of XML files
xquery 'collection()//product[price > 50]' ./data/
# JSON output
xquery -o json 'map { "count": count(//item) }' data.xml
# Read from stdin
cat data.xml | xquery '//item/@name'
# Show execution plan
xquery --plan 'for $x in 1 to 10 return $x * $x'
# Show timing breakdown
xquery --timing '//item' large-catalog.xml
Features
- XQuery 3.1/4.0 — FLWOR, maps/arrays, higher-order functions, string constructors
- Multiple output methods — adaptive, XML, text, JSON
- Context item — input XML is available as
.(standard XQuery) - Multiple sources — files, directories, URLs, stdin
- Full prolog support — namespaces, variable/function declarations, serialization options
- Execution plans — inspect how queries are compiled and optimized
- Timing — built-in performance profiling
Documentation
Full documentation at phoenixml.dev
License
Apache-2.0
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.6.0 | 55 | 10/6/2026 |
| 2.5.1 | 81 | 10/1/2026 |
| 2.4.1 | 82 | 9/28/2026 |
| 2.4.0 | 64 | 9/28/2026 |
| 2.2.0 | 286 | 9/25/2026 |
| 2.1.0 | 75 | 9/17/2026 |
| 2.0.0 | 76 | 9/15/2026 |
| 1.8.0 | 85 | 9/14/2026 |
| 1.7.0 | 80 | 9/11/2026 |
| 1.6.15 | 79 | 9/9/2026 |
| 1.6.14 | 96 | 9/7/2026 |
| 1.6.13 | 82 | 9/4/2026 |
| 1.6.12 | 81 | 9/1/2026 |
| 1.6.11 | 87 | 8/29/2026 |
| 1.6.10 | 87 | 8/29/2026 |
| 1.6.9 | 82 | 8/27/2026 |
| 1.6.8 | 79 | 8/26/2026 |
| 1.6.7 | 89 | 8/24/2026 |
| 1.6.6 | 85 | 8/23/2026 |
| 1.6.5 | 90 | 8/21/2026 |
A patch for a regression in 2.4.0 that **broke XSpec compilation** (phoenixmldb-xslt#191, reported
by Martin Honnen two hours after 2.4.0 shipped).
### Fixed
**A string subtype had no effective boolean value.** `if (xs:NCName('a'))` raised `FORG0006`
instead of returning true. The spec says a value of type `xs:string` or anything derived from it is
true when non-empty. This hole predates 2.4.0, but it was unreachable in practice until 2.4.0
correctly made `fn:prefix-from-QName` return `xs:NCName` (and `fn:default-language` return
`xs:language`). XSpec's compiler tests a prefix in an `if`, so every XSpec suite stopped compiling.
The same sweep found three other places that switched on runtime type with no string-subtype case:
- **Map keys.** An `xs:NCName` key and an equal `xs:string` were different keys, so lookups missed
and merges kept duplicates.
- **`fn:translate`** rejected a string subtype with `XPTY0004`.
- **`fn:collation-key`** (both arities) rejected it too.
49 operations on subtype values were checked in all; the rest were already correct.
### `xquery` CLI (ships on `cli-v2.4.1`)
Runs on PhoenixmlDb.Xslt 2.4.1, so an `xsl:if` or `xsl:when` test on a string subtype, a float
or a typed integer in a stylesheet called through `fn:transform` no longer raises `FORG0006`.
### Conformance
Per-case QT3 diff against 2.4.0: **no changes**. Neither suite has a case for these shapes, which
is why the regression shipped. XSpec compilation now gates every release.