pyxsql 1.7.0

SQL-style querying for static HTML with a deterministic node model.

MarkQL

MarkQL is a C++20 SQL-style query engine for HTML. It treats HTML elements as rows and lets you query them with familiar SELECT ... FROM ... WHERE ... syntax.

Quick Start

Prerequisites:

• CMake 3.16+
• A C++20 compiler
• Optional dependencies: libxml2, curl, nlohmann_json, arrow/parquet

Build (project default):

./build.sh

Minimal build when optional dependencies are unavailable:

cmake -S . -B build \
  -DXSQL_WITH_LIBXML2=OFF \
  -DXSQL_WITH_CURL=OFF \
  -DXSQL_WITH_ARROW=OFF
cmake --build build

Run one query:

./build/markql --query "SELECT div FROM doc LIMIT 5;" --input ./data/index.html

Run interactive REPL:

./build/markql --interactive --input ./data/index.html

CLI Notes

• Primary CLI binary is ./build/markql.
• Legacy compatibility binary ./build/xsql is still generated.
• doc and document are both valid sources in FROM.
• If --input is omitted, the CLI reads HTML from stdin.
• URL sources (FROM 'https://...') require XSQL_WITH_CURL=ON.
• TO PARQUET(...) requires XSQL_WITH_ARROW=ON.
• INNER_HTML(...) returns minified HTML by default. Use RAW_INNER_HTML(...) for unmodified raw output.

Testing

C++ tests:

cmake --build build --target xsql_tests
ctest --test-dir build --output-on-failure

Benchmark harness (inner_html minified vs raw):

./build/markql_bench_inner_html 10000

Python package/tests (optional):

./install_python.sh
./test_python.sh

Documentation

• Book (chapter path + verified examples): docs/book/SUMMARY.md
• Canonical tutorial: docs/markql-tutorial.md
• Docs index: docs/README.md
• Changelog: CHANGELOG.md

License

Apache License 2.0. See LICENSE.