ParseHub DSL

ParseHub DSL is a compiler and Playwright runtime for declarative browser extraction programs. Programs use the .ph extension and are compiled through parsing, name resolution, type checking, and verified IR before execution.

Install

python -m pip install -e .
playwright install chromium

Run a program

parsehub run example_simple.ph

Validate or format a program without running a browser:

parsehub check example_simple.ph
parsehub fmt example_simple.ph --check
parsehub fmt example_simple.ph --write

Run with parameters and persist the collected rows:

parsehub run examples/parameter_demo.ph \
  --param query="browser automation" \
  --param max_results=5 \
  --output json \
  --output-file results.json

Documentation

• Documentation index
• DSL syntax reference
• Capabilities
• Parameters
• Profiles, sessions, and environments
• Runtime artifacts
• Support policy
• Testing
• Encoding
• Example usage guide

Examples

• Minimal extraction
• Parameters
• Interaction and scrolling
• Template data flow
• Runtime authority surface

The complete supported example inventory is listed in the example usage guide.

License

MIT. See LICENSE.