xquery4 1.4.2

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global xquery4 --version 1.4.2
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local xquery4 --version 1.4.2
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=xquery4&version=1.4.2
                    
nuke :add-package xquery4 --version 1.4.2
                    

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.4.6 0 6/17/2026
1.4.5 34 6/17/2026
1.4.4 58 6/14/2026
1.4.3 56 6/10/2026
1.4.2 64 6/6/2026
1.4.1 70 6/4/2026
1.3.15 83 5/22/2026
1.3.14 59 5/21/2026
1.3.13 70 5/20/2026
1.3.12 77 5/19/2026
1.3.11 73 5/18/2026
1.3.10 68 5/17/2026
1.3.9 61 5/15/2026
1.3.7 63 5/14/2026
1.3.6 63 5/13/2026
1.3.5 65 5/13/2026
1.3.4 71 5/12/2026
1.3.3.1 50 5/12/2026
1.3.3 70 5/11/2026
1.3.2 70 5/9/2026
Loading failed

Cost-based query optimizer foundation lands, plus a runtime hook for the storage layer to dispatch index lookups.
     Optimizer: new IContainerStatistics abstraction + CostModel (statistics-driven cost/cardinality for the physical operator surface).
     Optimizer: new IIndexCatalog + IndexAwareQueryPlanOptimizer — recognizes /element[@attr=literal] shapes and emits IndexLookupOperator when an index covers the path.
     Optimizer: FlworJoinReorderer topologically sorts multi-binding for clauses by cost, respecting data dependencies.
     Execution: IndexLookupOperator now falls back to QueryExecutionContext.IndexLookupResolver when its inline LookupAsync delegate is unset. New IIndexLookupResolver interface lets a host attach per-query dispatch without rewriting compiled plans.
     Fix: fn:serialize with output:indent and method=json now emits pretty-printed JSON (regression test added).
     See RELEASES.md for full notes.