• P6_413957
  • 780.7KB
  • zip
  • 0
  • VIP专享
  • 0
  • 2022-04-26 19:53
Chickadee编程语言 Chickadee是一种极简主义的编程语言,是为在进行内部技术演讲而构建的,以作为如何使用TypeScript构建解释器的课程。 Chickadee支持基本的数字和布尔表达式,变量,语句,块和lambda表达式。 这是一个示例程序。 var fib = (x) => { x <= 1 ? 1 : fib(x - 1) + fib(x - 2); } fib(7); Chickadee评估程序执行预处理的类型化抽象语法树。 解析器位于单独的文件中,并且依赖于,该库是用TypeScript编写的单文件语法分析库,没有其他依赖项。 代码结构 main.ts应用程序的入口,包含主要测试。 chickadee-grammar.ts包含chickadee-grammar.ts语言超集的语法(以防您扩展解释器) chickadee-rewrite.ts包含用于
# [Myna Parsing Library]( [![npm version](]( [![Build Status](]( ### [Home Page]( | [QUnit Tests]( | [Source Code]( Myna is an efficient and easy to use parsing library for JavaScript written using [TypeScript 2.0]( which targets [ECMAScript 5.1]( Unlike several popular parsing libraries (e.g. [Jison](, [PEG.js](, [nearley](, and [ANTLR]( Myna is an API, not a code generation tool, which makes it easier for programmers to write, debug, and maintain their parsing algorithms. This makes Myna closest to [Parsimmon]( and [Chevrotain]( Myna has no dependencies, you can just download `myna.js` and start using it immediately. There are several [example tools]( that demonstrate how to use Myna parsers and a number of [sample grammars]( shipped with Myna that you can use or modify as needed. # Getting Started You can either download the latest `myna.js` file [via GitHub]( or [via Unpkg]( and start using it in your project, or you can [install Myna from npm]( ## Using Myna Below is an example of how to use Myna from Node.JS in a single self-contained example: ``` // Reference the Myna module var m = require('myna-parser'); // Construct a grammar object var g = new function() { this.textdata = m.notChar('\n\r"' + delimiter); this.quoted = m.doubleQuoted(m.notChar('"').or('""').zeroOrMore); this.field = this.textdata.or(this.quoted).zeroOrMore.ast; this.record = this.field.delimited(delimiter).ast; this.file = this.record.delimited(m.newLine).ast; } // Let consumers of the Myna module access m.registerGrammar("csv", g, g.file); // Get the parser var parser = m.parsers.csv; // Parse some input and print the AST var input = 'a,1,"hello"\nb,2,"goodbye"'; console.log(parse(input)); ``` Only rules that are defined with the `.ast` property will create nodes in the output parse tree. This saves the work of having to convert from a Concrete Syntax Tree (CST) to an Abstract Syntax Tree (AST). ## Myna Source Code and Dependencies The Myna library is written in TypeScript 2.0 and is contained in one file [`myna.ts`]( The generated Myna JavaScript file that you would include in your project is [`myna.js`]( Myna has no run-time dependencies. The Myna module, and the grammars are designed to be able to be run from the browser or from Node.JS. ## Building Myna The `myna.js` library is generated from the `myna.ts` source file using the TypeScript 2.0 compiler (tsc). I use [npm]( as my build tool and task runner. I would welcome submissions for making my package cross platform. I use Visual Studio Code as my development environment. The steps I use to making a patch and re-building/publishing Myna are: 1. `npm run full` - This will build the TypeScript files, run tests, update docs, create a minified version of the JS file. 1. `git add .` - Add the files to the git working state 1. `git commit -m "message"` - Create a git commit 1. `npm version patch` - Create a patch (will create a secondary Git commit) 1. `git push -u` Push the commits to the server 1. `npm publish` - Publish the Node package ## Myna Tests There are over a [1000 unit tests]( written using [QUnit]( There are also individual test files for each example tool, which you can run as a suite using `node tests\test_all_tools.js`. ## Minification For convenience I am providing a minified/obfuscated version `dist/myna.min.js` that is being generated with [uglify.js]( # Bugs and Issues Please submit any issues, questions, or feature requests via the [GitHub issue tracker]( # Supporting Myna You can show your support by reporting issues, making suggestions, contributing fixes, offering ideas, and providing feedback or critiques of any aspect of this project. Whether it is about code, development environment, documentation, processes, tests, philosophy, or general approach, it is all appreciated and helpful. I want this library to be as useful to you, as it is for me, and I want to continue to learn to be a better developer. Letting me know how you use Myna, or why you decided against it would also be helpful, as would sharing your grammars with us! # Author [Christopher Diggins]( # License Myna is licensed under the MIT License. # Acknowledgements Thank you to my three gatitas Anneye, Anna, and Beatrice for their love, patience, and support. Also thank you to everyone who has ever written open-source code. We are doing this together! Thanks to Eric Lindahl of [Sciumo]( for being the first person to financially support the Myna project.