Crate oq3_source_file

Management of source files for OpenQASM 3 parsing and semantic analysis. The main struct here is SourceFile which contains the path to a source file and the AST produced by the parser. It also contains a Vec<SourceFile> representing source files that are included via include. Nested includes are handled naturally this way.

report_error formats error messages using the external crate ariadne.

Structs

SourceFile

SourceString

Structure for managing parsing QASM from a string with no associated source file. fake_file_path contains something like “no file” and is present in order to make it easier to avoid duplicating code supporing QASM read from source files.

Traits

ErrorTrait

SourceTrait

Functions

inner_print_compiler_errors

Print compiler errors. Diagnostics include text take from source. The file info_file_path is only used for printing error messages. In particular, it does not need to correspond to an existing file. In case info_file_path is indeed the source file, then source is read before calling this function.

parse_source_file

Read source from file_path and parse to the syntactic AST. Parse and store included files recursively.

parse_source_string

Read source from file_path and parse to the syntactic AST. Parse and store included files recursively.

print_compiler_errors

report_error