aboutsummaryrefslogtreecommitdiffstats
path: root/modelica-parser-lalrpop
diff options
context:
space:
mode:
authorbnewbold <bnewbold@robocracy.org>2016-12-18 14:23:35 -0800
committerbnewbold <bnewbold@robocracy.org>2016-12-18 14:23:53 -0800
commitb0e4d99b1e1abf58baecf7a687093bdd5991afe7 (patch)
treec7a19644ae7d1b6c70f3ea458abf9b6aa72c272a /modelica-parser-lalrpop
parent471276594ddcafeb1043850c0be9bbaad673b542 (diff)
downloadmodelthing-b0e4d99b1e1abf58baecf7a687093bdd5991afe7.tar.gz
modelthing-b0e4d99b1e1abf58baecf7a687093bdd5991afe7.zip
parser: add basic README
Diffstat (limited to 'modelica-parser-lalrpop')
-rw-r--r--modelica-parser-lalrpop/Cargo.toml1
-rw-r--r--modelica-parser-lalrpop/README.md18
2 files changed, 19 insertions, 0 deletions
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