xpath-builder

A fluent, type-safe Python DSL for building XPath 2.0 expressions.

xpath-builder helps you construct complex XPath queries programmatically without string concatenation, reducing errors and improving readability.

from xpath_builder import E, Pred

xpath = E("div").any().where(
    Pred.attr("class").contains.any_of("container")
)
print(xpath.compile())
# //div[contains(@class, 'container')]

Getting Started

• Installation
  • Requirements
• Quick Start
  • 1. Import the essentials
  • 2. Build an expression
  • 3. Compile to a string

User Guide

• Core Concepts
  • Node
  • Path
  • Positional Filtering
• Predicates
  • Attribute Operations
  • Text Content
  • String Matching
  • Numeric Comparisons
  • Case Insensitivity
  • Combining Predicates
• Chaining
• Examples
  • Finding Ad Elements
  • Finding Empty SVGs
  • Finding Framework-Generated IDs

Reference

• API Reference
  • Shortcuts
  • Node Methods
  • Path Methods
  • Pred Class Methods