Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[0.2.3] - 2026-02-16

Added

• namespace-uri() and lang() XPath functions
• Namespace-aware node test matching for prefixed element queries

Changed

• id() and $variable now return explicit errors instead of silent empty results

[0.2.2] - 2026-02-16

Fixed

• XPath string functions (contains, starts-with, etc.) now work correctly on node-sets
• XPath comparisons (<, >, <=, >=) on node-sets no longer return NaN
• Malformed XPath expressions no longer crash the BEAM VM
• Reduced streaming buffer reallocation churn

Changed

• Faster node-set equality comparison
• Removed dead code
• Resolved all cargo clippy warnings

[0.2.1] - 2026-02-11

Fixed

• Alpine/musl compatibility — added local_dynamic_tls feature to mimalloc to ensure correct thread-local storage handling when loaded as a dynamic library (NIF) on Alpine Linux and other musl-based distributions.

[0.2.0] - 2026-02-04

Added

• Saxy drop-in replacement — full 1:1 API parity with Saxy
  • parse_string/4 — SAX parsing with handler callbacks
  • parse_stream/4 — streaming SAX with binary-encoded events
  • stream_events/2 — lazy stream of SAX events
  • encode!/2, encode_to_iodata/2 — XML encoding
  • RustyXML.Handler — behaviour (= Saxy.Handler)
  • RustyXML.Partial — incremental parsing (= Saxy.Partial)
  • RustyXML.SimpleForm — tuple tree output (= Saxy.SimpleForm)
  • RustyXML.XML — builder DSL (= Saxy.XML)
  • RustyXML.Builder — struct→XML protocol (= Saxy.Builder)
  • RustyXML.Encoder — XML string encoding
• Binary-encoded SAX events — NIF packs all events from a chunk into a single binary instead of ~1,700 BEAM tuples per 64 KB chunk; Elixir decodes one event at a time via pattern matching

Performance vs Saxy

Measured on Apple Silicon M1 Pro. Numbers vary between runs; treat as representative.

Streaming memory is bounded on both sides (~128–162 KB vs ~124–133 KB).

Migration

# From SweetXml — just change the import
sed -i 's/SweetXml/RustyXML/g' lib/**/*.ex

# From Saxy — just change the module name
sed -i 's/Saxy/RustyXML/g' lib/**/*.ex

[0.1.2] - 2026-02-04

Added

• Unified structural index — single zero-copy parse path replaces the old DOM
• UnifiedScanner with ScanHandler trait for extensible tokenization
• sax_parse/1 NIF for SAX event parsing
• xpath_text_list NIF for fast text extraction without building element tuples
• Lightweight validate_strict — checks well-formedness without allocating a DOM

Performance vs v0.1.1

Changed

• All parse NIFs now use the structural index (compact spans into original input)
• parse_strict/1 no longer builds then discards a full DOM

Fixed

• xpath/3 subspecs on document refs — was silently ignoring subspecs
• xmap/3 third argument — now accepts true for keyword list output
• parse/2 charlist support — accepts charlists in addition to binaries
• Lenient mode infinite loop on malformed markup like <1invalid/>

Removed

• parse_events/1 — redundant with structural index (was 7x slower, 4x more memory)

[0.1.1] - 2026-01-29

Changed

• Parse NIFs (parse/1, parse_strict/1, parse_and_xpath/2, xpath_with_subspecs/3, xpath_string_value/2, sax_parse/1) moved to dirty CPU schedulers
• Internal failures now return {:error, :mutex_poisoned} instead of silent nil/empty values
• Batch accessors (result_texts, result_attrs, result_extract) clamp ranges to actual result count

[0.1.0] - 2026-01-26

Added

• Purpose-built Rust NIF for XML parsing in Elixir
• SIMD-accelerated scanning via memchr
• Full XPath 1.0 — all 13 axes, 27+ functions, LRU expression cache
• SweetXml-compatible API — xpath/2,3, xmap/2,3, ~x sigil, stream_tags/3
• Lazy XPath (xpath_lazy/2) — results stay in Rust memory, 3x faster for partial access
• Parallel XPath (xpath_parallel/2) — multi-threaded query evaluation via Rayon
• Streaming parser with bounded memory for large files
• 100% W3C/OASIS XML Conformance — 1089/1089 applicable tests pass
• XXE immune, Billion Laughs immune, panic-safe NIFs, atom table safe