From b0e4d99b1e1abf58baecf7a687093bdd5991afe7 Mon Sep 17 00:00:00 2001 From: bnewbold Date: Sun, 18 Dec 2016 14:23:35 -0800 Subject: parser: add basic README --- modelica-parser-lalrpop/Cargo.toml | 1 + modelica-parser-lalrpop/README.md | 18 ++++++++++++++++++ 2 files changed, 19 insertions(+) create mode 100644 modelica-parser-lalrpop/README.md (limited to 'modelica-parser-lalrpop') diff --git a/modelica-parser-lalrpop/Cargo.toml b/modelica-parser-lalrpop/Cargo.toml index fabffe5..6371bbf 100644 --- a/modelica-parser-lalrpop/Cargo.toml +++ b/modelica-parser-lalrpop/Cargo.toml @@ -9,6 +9,7 @@ rust parser crate. keywords = ["modelica", "lalrpop", "parser"] build = "src/build.rs" # LALRPOP preprocessing license = "MIT" +readme = "README.md" [lib] name = "modelica_parser" diff --git a/modelica-parser-lalrpop/README.md b/modelica-parser-lalrpop/README.md new file mode 100644 index 0000000..f5a52b2 --- /dev/null +++ b/modelica-parser-lalrpop/README.md @@ -0,0 +1,18 @@ +modelica-parser-lalrpop +============================ + +This is a pure-Rust library for parsing a subset of the Modelica modeling +language, built with the lalrpop parsing library. + +The current implementation was not written to be complete or closely follow the +lexing/parsing definitions from the formal Modelica standard. Instead it has +been cobbled together piecemeal with the goal of parsing a reasonable fraction +of real-world existing models. Given this, the parser is incorrect in a number +of corner cases, and it probably does not make sense to correct those +one-by-one. + +Contributions or a re-write to be more correct or more complete are welcome! + +To try parsing a set of example files: + + cargo run --example parse_file examples/modelica_models/*.mo -- cgit v1.2.3