2a:null 2b:["$","title",null,{"children":"PEG.js | ento | Observable"}] 30:[] 2e:{"id":"03f0bba3379ef23e","slug":"pegjs","title":"PEG.js","thumbnail":"47c0304e0a47e7cb38dc963f0030611b903583df692489c434eb6b6aabae0b34","access_level":"public","create_time":"$D2019-01-02T03:30:40.330Z","update_time":"$D2019-03-12T19:15:21.520Z","view_time":null,"first_public_time":"$D2019-01-02T03:56:05.639Z","fork":false,"stars":7,"starred":false,"owner":{"type":"team","id":"29c3cae0b7a46ab0","login":"ento","name":"ento","avatar_url":"https://avatars-next.observableusercontent.com/243e0c0d5a7636b3c2ec7be518b54666640203cca9008428e1f02a36bcd0488b","tier":"starter_2024"},"version":80,"publish_version":80,"role":null,"authored":false,"authors":[{"type":"individual","id":"9e583a9c2f29bc70","login":"ento","name":"ento","avatar_url":"https://avatars-next.observableusercontent.com/243e0c0d5a7636b3c2ec7be518b54666640203cca9008428e1f02a36bcd0488b","tier":null}],"members":[{"type":"individual","id":"9e583a9c2f29bc70","login":"ento","name":"ento","avatar_url":"https://avatars-next.observableusercontent.com/243e0c0d5a7636b3c2ec7be518b54666640203cca9008428e1f02a36bcd0488b","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"subscribed":null,"forks":1,"collection":{"id":"a938e0a9295452a5","slug":"tools","title":"Authoring Tools","owner":{"id":"29c3cae0b7a46ab0","login":"ento","name":"ento"}},"type":"notebook","body":{"title":"PEG.js","cells":[{"id":0,"value":"md`# PEG.js\nWrappers for defining your own grammar with PEG.js and using the parser as a template literal tag function.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":11,"value":"md`## API`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":29,"value":"md`### pegjs\\\\\\`grammarString\\\\\\`\nTemplate literal tag function that returns a parser for \\`grammarString\\`. The parser itself can be used as a template literal tag function.\n\nUnder the hood, this is created by calling \\`pegjsFactory()\\` documented below with an empty \\`pegOptions\\` and \\`wrapperOptions\\` set to \\`{logError: true}\\`.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":9,"value":"pegjs = pegjsFactory({}, {logError: true})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":26,"value":"md`#### example`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":69,"value":"md`Define a parser:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":20,"value":"helloWorldDsl = pegjs`\nstart = 'hello' { return 'world' }\n`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":71,"value":"md`Use it:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":22,"value":"helloWorldDsl`hello`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":36,"value":"md`### pegjsFactory(pegOptions, wrapperOptions)\nFunction for creating a pegjs grammar parser with full customizability. Use \\`pegjs\\` aboe when you don't need to customize the parser.\n\n#### Parameters\n\n

\\`pegOptions\\`: An object that will be passed as the second argument to \\`pegjs.generate()\\`.
\\`wrapperOptions\\`: An object that controls the behavior of the returned function.
\\`wrapperOptions.logError\\`: Set to \\`true\\` to log errors from \\`pegjs.generate()\\` to the console.

\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":7,"value":"pegjsFactory = (pegOptions, wrapperOptions) => {\n const _wrapperOptions = Object.assign({logError: false}, wrapperOptions)\n \n const parserTagFactory = (parser) => {\n return function(strings) {\n try {\n return parser.parse(strings.raw[0])\n } catch(e) {\n if (e.location) {\n e.message += ` (line ${e.location.start.line}, column ${e.location.start.column})`\n }\n throw e\n }\n }\n }\n \n return function pegjs() {\n const literal = String.raw.apply(String, arguments)\n try {\n const parser = pegjsLib.generate(literal, pegOptions)\n return parserTagFactory(parser)\n } catch(e) {\n if (_wrapperOptions.logError) {\n console.log(e)\n }\n throw e\n }\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":49,"value":"md`### example`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":50,"value":"pegjsWithContext = pegjsFactory({context: {ASTNode: (type, value) => ({type: type, value: value})}})","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":52,"value":"astDsl = pegjsWithContext`\nstart = 'hello' { return ASTNode('hello', 'world') }\n`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":56,"value":"astDsl`hello`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":2,"value":"md`## Dependencies`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"},{"id":5,"value":"pegjsLib = require('https://bundle.run/pegjs@0.11.0-dev.325')","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined"}],"files":"$W30","stdlib":"1","titling":"auto"}} 2f:"$2e:body"