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)

DHParser is by now mature and “production ready”. It is being used in several projects, most notably for the domain specific notation of the Medieval Latin Dictionary and the Typescript-to-Python-interface-transpiler ts2python

License

DHParser is open source software under the Apache 2.0 License.

Copyright 2016-2022 Eckhart Arnold, Bavarian Academy of Sciences and Humanities

The source code can downloaded from: gitlab.lrz.de/badw-it/DHParser

Install DHParser

$ python -m pip install --user DHParser

Resources

Contents:

• Overview of DHParser
  • Generating a parser from a Grammar
  • Creating parsers within a Python-script
  • Full scale DSLs
  • Clutter-free grammars
  • Declarative AST-building
  • Test-driven grammar development
  • Fail-tolerant parsing
  • Compiling DSLs
  • Language Servers
  • Performance optimization
• A Step by Step Guide
  • System-Requirements
  • Setting up a new DHParser project
  • Developing a DHParser-project
• Manuals
  • EBNF-Grammars
  • Document-Trees
  • AST-Transformation
  • Compiling
• Reference
  • Module ebnf
  • Module nodetree
  • 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