Welcome to booze-tools documentation!

Booze-Tools aims to be the ultimate Swiss-Army Knife of language-processing tasks. It does quite a bit so far, and has some features not found in other such tools. It happens to be written in Python.

Project Maturity Level:

The deep algorithmic stuff works like a champ, but there are some rough edges. Some APIs may change, but the general concept to keep the grammar definition independent of the target-language is not going anywhere. (In concept, this should allow a compiler, a pretty-printer, and an IDE to all run from the same grammar definition.) It’s used in a few different projects and generates feedback.

Contents:

• Introduction
  • Documentation Migration in Progress
  • Why and Wherefore?
• Invoking the Booze-Tools Metacompiler
  • Extremely Short Version
  • A Bit More Detail
  • Error Handling?
• Format of Tables
  • General Structure
  • Scanner Table
  • Parser Table
• The Allegedly Minimal LR(1)
  • What “Minimal” even means
  • My General Concept
  • Case in Point
  • A Tainted Approach
  • Another Round
  • Working Out the Example
  • Sharpening the Pencil
  • Tying Up Loose Ends
  • Beyond LR(1)
  • An Actual Algorithm
  • Results and Next Steps

Why the odd name?

• A few programming languages were named for beverages.

• Booze is a beverage.

• I could find no programming language called Booze.

If anything is unclear, please feel free to file an issue at GitHub or contact me via e-mail. Feedback is always welcome. My username in most places is “kjosib” and I have a gmail account.

Indices and tables

• Index

• Module Index

• Search Page