FhY Language and Frontend

A Language for Modeling Physical Things

FhY is a cross-domain language with mathematical foundations that moves beyond the current paradigm of domain-specific languages to enable cross-domain multi-acceleration.

This package provides the user-facing surface of the compiler: the FhY source language, its grammar and parser (built on ANTLR), the AST definitions, and the driver that turns a FhY source program into a fully-constructed AST module and symbol table ready to be consumed by downstream compilation stages.

Features

• FhY grammar and ANTLR-generated parser
• Abstract syntax tree (AST) definitions and pretty-printing utilities
• Parse-tree-to-AST conversion
• Symbol table construction
• Compilation driver with configurable options (verbose logging, optimization)
• AST serialization to JSON or human-readable pretty-printed formats

Command Line Interface

Installing the package exposes the compile-fhy-lang command:

compile-fhy-lang --help
compile-fhy-lang --version

Compile and serialize a FhY source program

compile-fhy-lang serialize path/to/main.fhy [OPTIONS]

Common options:

• --format, -f {json,pretty,prettyid} - serialization format for the resulting AST
• --indent, -i N - indentation width for human-readable output
• --verbose - enable debug-level logging
• --optimize - enable frontend optimizations
• --log-file PATH - write logs to the given file

If no --format is provided, the program is compiled but no serialized output is emitted.