5. Programming in Spicy

This chapter summarizes the main concepts of writing Spicy grammars. We begin with a deep-dive on Spicy’s main task, parsing: We walk through all the corresponding constructs & mechanisms available to grammar writers, without paying too much attention to other specifics of the Spicy language, such as data types and control flow constructs. Much of that should be sufficiently intuitive to readers familiar with standard scripting languages. However, once we finish the parsing section, we follow up with a comprehensive overview of the Spicy language, as well as a reference of pre-built library functionality that Spicy grammars can leverage.

• 5.1. Parsing
  • 5.1.1. Basics
  • 5.1.2. Unit Hooks
  • 5.1.3. Unit Variables
  • 5.1.4. Unit Parameters
  • 5.1.5. Unit Attributes
  • 5.1.6. Meta data
  • 5.1.7. Parsing Types
  • 5.1.8. Controlling Parsing
  • 5.1.9. Changing Input
  • 5.1.10. Filters
  • 5.1.11. Sinks
  • 5.1.12. Contexts
  • 5.1.13. Error Recovery
• 5.2. Language
  • 5.2.1. Identifiers
  • 5.2.2. Modules
  • 5.2.3. Functions
  • 5.2.4. Variables and Constants
  • 5.2.5. Types
  • 5.2.6. Statements & Operators
  • 5.2.7. Packing / Unpacking Values
  • 5.2.8. Error Handling
  • 5.2.9. Conditional Compilation
  • 5.2.10. Appendix
• 5.3. Library
  • 5.3.1. Module spicy
  • 5.3.2. Module filter
• 5.4. Examples
• 5.5. Debugging
  • 5.5.1. Debug Hooks
  • 5.5.2. Debug Streams
  • 5.5.3. Exceptions
  • 5.5.4. Inspecting Generated Code
  • 5.5.5. Skipping validation
• 5.6. Custom Extensions
  • 5.6.1. Basic Example
  • 5.6.2. Advanced Usage