Welcome to DHParser’s documentation!

DHParser is a parser-generator and and domain-specific-languages construction kit, designed for but not restricted to Digital-Humanities-applications.

DHParser offers:

• EBNF-based grammar-specification language with support for different flavors of EBNF

• Parsing-Expression-Grammar (PEG)-parser with memoization and full left-recursion support

• full unicode support

• unit-testing-framework for grammars

• post-mortem debugger for generated parsers

• support for fail-tolerant parsing

• customizable error messages

• extensive tree-processing facilities

• support for building language servers (experimental)

Install DHParser

$ python -m pip install --user DHParser

Resources

Contents:

• Overview of DHParser
  • Adhoc-Parsers
  • Full scale DSLs
  • Clutter-free grammars
  • Declarative AST-building
  • Test-driven grammar development
  • Fail-tolerant parsing
  • Compiling DSLs
  • Language Servers
  • Performance
• Step by Step Guide
  • System-Requirements
  • Installing DHParser from the git repository
  • Starting a new DHParser project
  • Understanding how compilation of DSL-documents with DHParser works
  • The development workflow for DSLs
  • Extending the example DSL further
  • Controlling abstract-syntax-tree generation
• Reference Manual
  • Module ebnf
  • Module syntaxtree
  • Module transform
  • Module compile
  • Module parse
  • Module dsl
  • Module preprocess
  • Module error
  • Module testing
  • Module trace
  • Module log
  • Module configuration
  • Module server
  • Module lsp
  • Module stringview
  • Module toolkit
  • Module versionnumber

Indices and tables

• Index

• Module Index

• Search Page