PRAGMAR

Python, Reference Attribute Grammar, Models At Runtime

PRAGMAR is an experimental tool for building grammar-powered applications. Its two main focuses are programming ergonomics when creating grammars and catering to code-generator applications by providing templating utilities.

What is it?: It

• leverages Reference Attribute Grammars (RAGs) and aspect oriented programming
• simplifies and enhances the ergonomics of RAG attribute definition in a pythonic way
• generates a default xml-parser and xml-schema for the grammar out of the box
• models user-grammars inside a runtime meta-grammar
• supports runtime modification and validation of the whole meta-grammar
• PLANNED: provides utility functions for easy use with templating engines like mustache
• PLANNED: provides a web-ui to visualize and play around with grammars at runtime
• PLANNED: provides a web-endpoint out of the box to integrate it as an api

ROADMAP

flowchart LR
    Goal["`First Release`"]
    MultiFileAspects["`Aspects in Multible Files`"]
    MultiFileExample["`Create Multifile Example`"]
    ImproveGen["`Improve Generation Workflow`"]
    GenerateFields["`Generate Fields in classes.py`"]
    OptionalFields["`Optional Fields in Grammar definition`"]
    InhCheck["`Validate Inherited Attributes`"]
    Checks["`Only Generate Grammar when Checks succeed: Add Error Codes`"]
    RuntimeOnlyExample["`Create Runtime Only Example (Single File)`"]
    ReadMe["`Create README with all example variants`"]
    JastAddComparisonExample["`Create Example highlighting benefits compared to Jastadd`"]
    BetterChildAccess["`Make the interface easier to get children of nodes`"]
    
    MultiFileAspects --> ImproveGen --> MultiFileExample --> ReadMe --> Goal
    RuntimeOnlyExample --> ReadMe
    JastAddComparisonExample --> ReadMe
    GenerateFields --> Goal
    OptionalFields --> Goal
    BetterChildAccess --> Goal
    InhCheck --> Checks --> Goal
    
    HardenedMode["`Hardened Mode that generates the whole application (the application itself)`"]
    EBNFParser["`Allow parsing of Jastadd-EBNF to define Grammars`"]
    XmlJson["`Allow parsing Xml and Json to create usage-Trees of a defined language`"]
    RestApi["`Create Default Rest-Api to modify Trees at runtime using Rewrites`"]
    Future["`Future`"]
    
    HardenedMode:::future --> Future
    EBNFParser:::future --> Future
    XmlJson:::future --> Future
    RestApi:::future --> Future:::future
    
    
    Goal:::planned
    MultiFileAspects:::done
    MultiFileExample:::done
    ImproveGen:::done
    GenerateFields:::done
    OptionalFields:::done
    InhCheck:::planned
    Checks:::planned
    RuntimeOnlyExample:::done
    ReadMe:::planned
    JastAddComparisonExample:::planned
    BetterChildAccess:::next
    
    classDef planned fill:#555
    classDef done fill:#040
    classDef canceled fill:#700
    classDef next fill:#880
    classDef future fill:#000