1#![allow(clippy::redundant_closure_call)]23use peg::parser;4use std::{5 path::{Path, PathBuf},6 rc::Rc,7};8mod expr;9pub use expr::*;10pub use peg;1112pub struct ParserSettings {13 pub loc_data: bool,14 pub file_name: Rc<Path>,15}1617parser! {18 grammar jsonnet_parser() for str {19 use peg::ParseLiteral;2021 22 rule comment()23 = "//" (!['\n'][_])* "\n"24 / "/*" ("\\*/" / "\\\\" / (!("*/")[_]))* "*/"25 / "#" (!['\n'][_])* "\n"2627 rule single_whitespace() = quiet!{([' ' | '\r' | '\n' | '\t'] / comment())} / expected!("<whitespace>")28 rule _() = single_whitespace()*2930 31 rule comma() = quiet!{_ "," _} / expected!("<comma>")32 rule alpha() -> char = c:$(['_' | 'a'..='z' | 'A'..='Z']) {c.chars().next().unwrap()}33 rule digit() -> char = d:$(['0'..='9']) {d.chars().next().unwrap()}34 rule end_of_ident() = !['0'..='9' | '_' | 'a'..='z' | 'A'..='Z']35 36 rule uint() -> u64 = a:$(digit()+) { a.parse().unwrap() }37 38 rule number() -> f64 = quiet!{a:$(uint() ("." uint())? (['e'|'E'] (s:['+'|'-'])? uint())?) { a.parse().unwrap() }} / expected!("<number>")3940 41 rule reserved() = ("assert" / "else" / "error" / "false" / "for" / "function" / "if" / "import" / "importstr" / "in" / "local" / "null" / "tailstrict" / "then" / "self" / "super" / "true") end_of_ident()42 rule id() = quiet!{ !reserved() alpha() (alpha() / digit())*} / expected!("<identifier>")4344 rule keyword(id: &'static str) -> ()45 = ##parse_string_literal(id) end_of_ident()46 47 rule l(s: &ParserSettings, x: rule<Expr>) -> LocExpr48 = start:position!() v:x() end:position!() {loc_expr!(v, s.loc_data, (s.file_name.clone(), start, end))}4950 pub rule param(s: &ParserSettings) -> expr::Param = name:$(id()) expr:(_ "=" _ expr:expr(s){expr})? { expr::Param(name.into(), expr) }51 pub rule params(s: &ParserSettings) -> expr::ParamsDesc52 = params:param(s) ** comma() comma()? {53 let mut defaults_started = false;54 for param in ¶ms {55 defaults_started = defaults_started || param.1.is_some();56 assert_eq!(defaults_started, param.1.is_some(), "defauld parameters should be used after all positionals");57 }58 expr::ParamsDesc(Rc::new(params))59 }60 / { expr::ParamsDesc(Rc::new(Vec::new())) }6162 pub rule arg(s: &ParserSettings) -> expr::Arg63 = name:$(id()) _ "=" _ expr:expr(s) {expr::Arg(Some(name.into()), expr)}64 / expr:expr(s) {expr::Arg(None, expr)}65 pub rule args(s: &ParserSettings) -> expr::ArgsDesc66 = args:arg(s) ** comma() comma()? {67 let mut named_started = false;68 for arg in &args {69 named_started = named_started || arg.0.is_some();70 assert_eq!(named_started, arg.0.is_some(), "named args should be used after all positionals");71 }72 expr::ArgsDesc(args)73 }74 / { expr::ArgsDesc(Vec::new()) }7576 pub rule bind(s: &ParserSettings) -> expr::BindSpec77 = name:$(id()) _ "=" _ expr:expr(s) {expr::BindSpec{name:name.into(), params: None, value: expr}}78 / name:$(id()) _ "(" _ params:params(s) _ ")" _ "=" _ expr:expr(s) {expr::BindSpec{name:name.into(), params: Some(params), value: expr}}79 pub rule assertion(s: &ParserSettings) -> expr::AssertStmt80 = keyword("assert") _ cond:expr(s) msg:(_ ":" _ e:expr(s) {e})? { expr::AssertStmt(cond, msg) }8182 pub rule whole_line() -> &'input str83 = str:$((!['\n'][_])* "\n") {str}84 pub rule string_block() -> String85 = "|||" (!['\n']single_whitespace())* "\n"86 empty_lines:$(['\n']*)87 prefix:[' ' | '\t']+ first_line:whole_line()88 lines:("\n" {"\n"} / [' ' | '\t']*<{prefix.len()}> s:whole_line() {s})*89 [' ' | '\t']*<, {prefix.len() - 1}> "|||"90 {let mut l = empty_lines.to_owned(); l.push_str(first_line); l.extend(lines); l}91 pub rule string() -> String92 = quiet!{ "\"" str:$(("\\\"" / "\\\\" / (!['"'][_]))*) "\"" {unescape::unescape(str).unwrap()}93 / "'" str:$(("\\'" / "\\\\" / (!['\''][_]))*) "'" {unescape::unescape(str).unwrap()}94 / "@'" str:$(("''" / (!['\''][_]))*) "'" {str.replace("''", "'")}95 / "@\"" str:$(("\"\"" / (!['"'][_]))*) "\"" {str.replace("\"\"", "\"")}96 / string_block() } / expected!("<string>")9798 pub rule field_name(s: &ParserSettings) -> expr::FieldName99 = name:$(id()) {expr::FieldName::Fixed(name.into())}100 / name:string() {expr::FieldName::Fixed(name.into())}101 / "[" _ expr:expr(s) _ "]" {expr::FieldName::Dyn(expr)}102 pub rule visibility() -> expr::Visibility103 = ":::" {expr::Visibility::Unhide}104 / "::" {expr::Visibility::Hidden}105 / ":" {expr::Visibility::Normal}106 pub rule field(s: &ParserSettings) -> expr::FieldMember107 = name:field_name(s) _ plus:"+"? _ visibility:visibility() _ value:expr(s) {expr::FieldMember{108 name,109 plus: plus.is_some(),110 params: None,111 visibility,112 value,113 }}114 / name:field_name(s) _ "(" _ params:params(s) _ ")" _ visibility:visibility() _ value:expr(s) {expr::FieldMember{115 name,116 plus: false,117 params: Some(params),118 visibility,119 value,120 }}121 pub rule obj_local(s: &ParserSettings) -> BindSpec122 = keyword("local") _ bind:bind(s) {bind}123 pub rule member(s: &ParserSettings) -> expr::Member124 = bind:obj_local(s) {expr::Member::BindStmt(bind)}125 / assertion:assertion(s) {expr::Member::AssertStmt(assertion)}126 / field:field(s) {expr::Member::Field(field)}127 pub rule objinside(s: &ParserSettings) -> expr::ObjBody128 = pre_locals:(b: obj_local(s) comma() {b})* "[" _ key:expr(s) _ "]" _ ":" _ value:expr(s) post_locals:(comma() b:obj_local(s) {b})* _ forspec:forspec(s) others:(_ rest:compspec(s) {rest})? {129 let mut compspecs = vec![CompSpec::ForSpec(forspec)];130 compspecs.extend(others.unwrap_or_default());131 expr::ObjBody::ObjComp(expr::ObjComp{132 pre_locals,133 key,134 value,135 post_locals,136 compspecs,137 })138 }139 / members:(member(s) ** comma()) comma()? {expr::ObjBody::MemberList(members)}140 pub rule ifspec(s: &ParserSettings) -> IfSpecData141 = keyword("if") _ expr:expr(s) {IfSpecData(expr)}142 pub rule forspec(s: &ParserSettings) -> ForSpecData143 = keyword("for") _ id:$(id()) _ keyword("in") _ cond:expr(s) {ForSpecData(id.into(), cond)}144 pub rule compspec(s: &ParserSettings) -> Vec<expr::CompSpec>145 = s:(i:ifspec(s) { expr::CompSpec::IfSpec(i) } / f:forspec(s) {expr::CompSpec::ForSpec(f)} ) ** _ {s}146 pub rule local_expr(s: &ParserSettings) -> LocExpr147 = l(s,<keyword("local") _ binds:bind(s) ** comma() _ ";" _ expr:expr(s) { Expr::LocalExpr(binds, expr) }>)148 pub rule string_expr(s: &ParserSettings) -> LocExpr149 = l(s, <s:string() {Expr::Str(s.into())}>)150 pub rule obj_expr(s: &ParserSettings) -> LocExpr151 = l(s,<"{" _ body:objinside(s) _ "}" {Expr::Obj(body)}>)152 pub rule array_expr(s: &ParserSettings) -> LocExpr153 = l(s,<"[" _ elems:(expr(s) ** comma()) _ comma()? "]" {Expr::Arr(elems)}>)154 pub rule array_comp_expr(s: &ParserSettings) -> LocExpr155 = l(s,<"[" _ expr:expr(s) _ comma()? _ forspec:forspec(s) _ others:(others: compspec(s) _ {others})? "]" {156 let mut specs = vec![CompSpec::ForSpec(forspec)];157 specs.extend(others.unwrap_or_default());158 Expr::ArrComp(expr, specs)159 }>)160 pub rule number_expr(s: &ParserSettings) -> LocExpr161 = l(s,<n:number() { expr::Expr::Num(n) }>)162 pub rule var_expr(s: &ParserSettings) -> LocExpr163 = l(s,<n:$(id()) { expr::Expr::Var(n.into()) }>)164 pub rule if_then_else_expr(s: &ParserSettings) -> LocExpr165 = l(s,<cond:ifspec(s) _ keyword("then") _ cond_then:expr(s) cond_else:(_ keyword("else") _ e:expr(s) {e})? {Expr::IfElse{166 cond,167 cond_then,168 cond_else,169 }}>)170171 pub rule literal(s: &ParserSettings) -> LocExpr172 = l(s,<v:(173 keyword("null") {LiteralType::Null}174 / keyword("true") {LiteralType::True}175 / keyword("false") {LiteralType::False}176 / keyword("self") {LiteralType::This}177 / keyword("$") {LiteralType::Dollar}178 / keyword("super") {LiteralType::Super}179 ) {Expr::Literal(v)}>)180181 pub rule expr_basic(s: &ParserSettings) -> LocExpr182 = literal(s)183184 / string_expr(s) / number_expr(s)185 / array_expr(s)186 / obj_expr(s)187 / array_expr(s)188 / array_comp_expr(s)189190 / l(s,<keyword("importstr") _ path:string() {Expr::ImportStr(PathBuf::from(path))}>)191 / l(s,<keyword("import") _ path:string() {Expr::Import(PathBuf::from(path))}>)192193 / var_expr(s)194 / local_expr(s)195 / if_then_else_expr(s)196197 / l(s,<keyword("function") _ "(" _ params:params(s) _ ")" _ expr:expr(s) {Expr::Function(params, expr)}>)198 / l(s,<assertion:assertion(s) _ ";" _ expr:expr(s) { Expr::AssertExpr(assertion, expr) }>)199200 / l(s,<keyword("error") _ expr:expr(s) { Expr::ErrorStmt(expr) }>)201202 rule slice_part(s: &ParserSettings) -> Option<LocExpr>203 = e:(_ e:expr(s) _{e})? {e}204 pub rule slice_desc(s: &ParserSettings) -> SliceDesc205 = start:slice_part(s) ":" pair:(end:slice_part(s) step:(":" e:slice_part(s){e})? {(end, step.flatten())})? {206 let (end, step) = if let Some((end, step)) = pair {207 (end, step)208 }else{209 (None, None)210 };211212 SliceDesc { start, end, step }213 }214215 rule binop(x: rule<()>) -> ()216 = quiet!{ x() } / expected!("<binary op>")217 rule unaryop(x: rule<()>) -> ()218 = quiet!{ x() } / expected!("<unary op>")219220 rule expr(s: &ParserSettings) -> LocExpr221 = start:position!() a:precedence! {222 a:(@) _ binop(<"||">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Or, b))}223 --224 a:(@) _ binop(<"&&">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::And, b))}225 --226 a:(@) _ binop(<"|">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::BitOr, b))}227 --228 a:@ _ binop(<"^">) _ b:(@) {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::BitXor, b))}229 --230 a:(@) _ binop(<"&">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::BitAnd, b))}231 --232 a:(@) _ binop(<"==">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Eq, b))}233 a:(@) _ binop(<"!=">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Neq, b))}234 --235 a:(@) _ binop(<"<">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Lt, b))}236 a:(@) _ binop(<">">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Gt, b))}237 a:(@) _ binop(<"<=">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Lte, b))}238 a:(@) _ binop(<">=">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Gte, b))}239 a:(@) _ binop(<keyword("in")>) _ b:@ {loc_expr_todo!(Expr::Apply(240 el!(Expr::Intrinsic("objectHasEx".into())), ArgsDesc(vec![Arg(None, b), Arg(None, a), Arg(None, el!(Expr::Literal(LiteralType::True)))]),241 true242 ))}243 --244 a:(@) _ binop(<"<<">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Lhs, b))}245 a:(@) _ binop(<">>">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Rhs, b))}246 --247 a:(@) _ binop(<"+">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Add, b))}248 a:(@) _ binop(<"-">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Sub, b))}249 --250 a:(@) _ binop(<"*">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Mul, b))}251 a:(@) _ binop(<"/">) _ b:@ {loc_expr_todo!(Expr::BinaryOp(a, BinaryOpType::Div, b))}252 a:(@) _ binop(<"%">) _ b:@ {loc_expr_todo!(Expr::Apply(253 el!(Expr::Intrinsic("mod".into())), ArgsDesc(vec![Arg(None, a), Arg(None, b)]),254 false255 ))}256 --257 unaryop(<"-">) _ b:@ {loc_expr_todo!(Expr::UnaryOp(UnaryOpType::Minus, b))}258 unaryop(<"!">) _ b:@ {loc_expr_todo!(Expr::UnaryOp(UnaryOpType::Not, b))}259 unaryop(<"~">) _ b:@ { loc_expr_todo!(Expr::UnaryOp(UnaryOpType::BitNot, b)) }260 --261 a:(@) _ "[" _ s:slice_desc(s) _ "]" {loc_expr_todo!(Expr::Apply(262 el!(Expr::Intrinsic("slice".into())),263 ArgsDesc(vec![264 Arg(None, a),265 Arg(None, s.start.unwrap_or_else(||el!(Expr::Literal(LiteralType::Null)))),266 Arg(None, s.end.unwrap_or_else(||el!(Expr::Literal(LiteralType::Null)))),267 Arg(None, s.step.unwrap_or_else(||el!(Expr::Literal(LiteralType::Null)))),268 ]),269 true,270 ))}271 a:(@) _ "." _ s:$(id()) {loc_expr_todo!(Expr::Index(a, el!(Expr::Str(s.into()))))}272 a:(@) _ "[" _ s:expr(s) _ "]" {loc_expr_todo!(Expr::Index(a, s))}273 a:(@) _ "(" _ args:args(s) _ ")" ts:(_ keyword("tailstrict"))? {loc_expr_todo!(Expr::Apply(a, args, ts.is_some()))}274 a:(@) _ "{" _ body:objinside(s) _ "}" {loc_expr_todo!(Expr::ObjExtend(a, body))}275 --276 e:expr_basic(s) {e}277 "(" _ e:expr(s) _ ")" {loc_expr_todo!(Expr::Parened(e))}278 } end:position!() {279 let LocExpr(e, _) = a;280 LocExpr(e, if s.loc_data {281 Some(ExprLocation(s.file_name.clone(), start, end))282 } else {283 None284 })285 }286 / e:expr_basic(s) {e}287288 pub rule jsonnet(s: &ParserSettings) -> LocExpr = _ e:expr(s) _ {e}289 }290}291292pub type ParseError = peg::error::ParseError<peg::str::LineCol>;293pub fn parse(str: &str, settings: &ParserSettings) -> Result<LocExpr, ParseError> {294 jsonnet_parser::jsonnet(str, settings)295}296297#[macro_export]298macro_rules! el {299 ($expr:expr) => {300 LocExpr(std::rc::Rc::new($expr), None)301 };302}303304#[cfg(test)]305pub mod tests {306 use super::{expr::*, parse};307 use crate::ParserSettings;308 use std::path::PathBuf;309310 macro_rules! parse {311 ($s:expr) => {312 parse(313 $s,314 &ParserSettings {315 loc_data: false,316 file_name: PathBuf::from("/test.jsonnet").into(),317 },318 )319 .unwrap()320 };321 }322323 mod expressions {324 use super::*;325326 pub fn basic_math() -> LocExpr {327 el!(Expr::BinaryOp(328 el!(Expr::Num(2.0)),329 BinaryOpType::Add,330 el!(Expr::BinaryOp(331 el!(Expr::Num(2.0)),332 BinaryOpType::Mul,333 el!(Expr::Num(2.0)),334 )),335 ))336 }337 }338339 #[test]340 fn multiline_string() {341 assert_eq!(342 parse!("|||\n Hello world!\n a\n|||"),343 el!(Expr::Str("Hello world!\n a\n".into())),344 );345 assert_eq!(346 parse!("|||\n Hello world!\n a\n|||"),347 el!(Expr::Str("Hello world!\n a\n".into())),348 );349 assert_eq!(350 parse!("|||\n\t\tHello world!\n\t\t\ta\n|||"),351 el!(Expr::Str("Hello world!\n\ta\n".into())),352 );353 assert_eq!(354 parse!("|||\n Hello world!\n a\n |||"),355 el!(Expr::Str("Hello world!\n a\n".into())),356 );357 }358359 #[test]360 fn slice() {361 parse!("a[1:]");362 parse!("a[1::]");363 parse!("a[:1:]");364 parse!("a[::1]");365 parse!("str[:len - 1]");366 }367368 #[test]369 fn string_escaping() {370 assert_eq!(371 parse!(r#""Hello, \"world\"!""#),372 el!(Expr::Str(r#"Hello, "world"!"#.into())),373 );374 assert_eq!(375 parse!(r#"'Hello \'world\'!'"#),376 el!(Expr::Str("Hello 'world'!".into())),377 );378 assert_eq!(parse!(r#"'\\\\'"#), el!(Expr::Str("\\\\".into())),);379 }380381 #[test]382 fn string_unescaping() {383 assert_eq!(384 parse!(r#""Hello\nWorld""#),385 el!(Expr::Str("Hello\nWorld".into())),386 );387 }388389 #[test]390 fn string_verbantim() {391 assert_eq!(392 parse!(r#"@"Hello\n""World""""#),393 el!(Expr::Str("Hello\\n\"World\"".into())),394 );395 }396397 #[test]398 fn imports() {399 assert_eq!(400 parse!("import \"hello\""),401 el!(Expr::Import(PathBuf::from("hello"))),402 );403 assert_eq!(404 parse!("importstr \"garnish.txt\""),405 el!(Expr::ImportStr(PathBuf::from("garnish.txt")))406 );407 }408409 #[test]410 fn empty_object() {411 assert_eq!(parse!("{}"), el!(Expr::Obj(ObjBody::MemberList(vec![]))));412 }413414 #[test]415 fn basic_math() {416 assert_eq!(417 parse!("2+2*2"),418 el!(Expr::BinaryOp(419 el!(Expr::Num(2.0)),420 BinaryOpType::Add,421 el!(Expr::BinaryOp(422 el!(Expr::Num(2.0)),423 BinaryOpType::Mul,424 el!(Expr::Num(2.0))425 ))426 ))427 );428 }429430 #[test]431 fn basic_math_with_indents() {432 assert_eq!(parse!("2 + 2 * 2 "), expressions::basic_math());433 }434435 #[test]436 fn basic_math_parened() {437 assert_eq!(438 parse!("2+(2+2*2)"),439 el!(Expr::BinaryOp(440 el!(Expr::Num(2.0)),441 BinaryOpType::Add,442 el!(Expr::Parened(expressions::basic_math())),443 ))444 );445 }446447 448 #[test]449 fn comments() {450 assert_eq!(451 parse!("2//comment\n+//comment\n3/*test*/*/*test*/4"),452 el!(Expr::BinaryOp(453 el!(Expr::Num(2.0)),454 BinaryOpType::Add,455 el!(Expr::BinaryOp(456 el!(Expr::Num(3.0)),457 BinaryOpType::Mul,458 el!(Expr::Num(4.0))459 ))460 ))461 );462 }463464 465 #[test]466 fn comment_escaping() {467 assert_eq!(468 parse!("2/*\\*/+*/ - 22"),469 el!(Expr::BinaryOp(470 el!(Expr::Num(2.0)),471 BinaryOpType::Sub,472 el!(Expr::Num(22.0))473 ))474 );475 }476477 #[test]478 fn suffix() {479 480 481 482 483 }484485 #[test]486 fn array_comp() {487 use Expr::*;488 assert_eq!(489 parse!("[std.deepJoin(x) for x in arr]"),490 el!(ArrComp(491 el!(Apply(492 el!(Index(el!(Var("std".into())), el!(Str("deepJoin".into())))),493 ArgsDesc(vec![Arg(None, el!(Var("x".into())))]),494 false,495 )),496 vec![CompSpec::ForSpec(ForSpecData(497 "x".into(),498 el!(Var("arr".into()))499 ))]500 )),501 )502 }503504 #[test]505 fn reserved() {506 use Expr::*;507 assert_eq!(parse!("null"), el!(Literal(LiteralType::Null)));508 assert_eq!(parse!("nulla"), el!(Var("nulla".into())));509 }510511 #[test]512 fn multiple_args_buf() {513 parse!("a(b, null_fields)");514 }515516 #[test]517 fn infix_precedence() {518 use Expr::*;519 assert_eq!(520 parse!("!a && !b"),521 el!(BinaryOp(522 el!(UnaryOp(UnaryOpType::Not, el!(Var("a".into())))),523 BinaryOpType::And,524 el!(UnaryOp(UnaryOpType::Not, el!(Var("b".into()))))525 ))526 );527 }528529 #[test]530 fn infix_precedence_division() {531 use Expr::*;532 assert_eq!(533 parse!("!a / !b"),534 el!(BinaryOp(535 el!(UnaryOp(UnaryOpType::Not, el!(Var("a".into())))),536 BinaryOpType::Div,537 el!(UnaryOp(UnaryOpType::Not, el!(Var("b".into()))))538 ))539 );540 }541542 #[test]543 fn double_negation() {544 use Expr::*;545 assert_eq!(546 parse!("!!a"),547 el!(UnaryOp(548 UnaryOpType::Not,549 el!(UnaryOp(UnaryOpType::Not, el!(Var("a".into()))))550 ))551 )552 }553554 #[test]555 fn array_test_error() {556 parse!("[a for a in b if c for e in f]");557 558 }559560 #[test]561 fn can_parse_stdlib() {562 parse!(jrsonnet_stdlib::STDLIB_STR);563 }564565 566 567568569570571572}