# myna-parser

> A text parsing (syntactic analysis) library written in TypeScript.

Latest version **2.5.1** (published 2018-04-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install myna-parser
pnpm add myna-parser
yarn add myna-parser
bun add myna-parser
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.5.1 |
| Published | 2018-04-08 |
| First published | 2017-01-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 2.7 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 84 |
| Author | Christopher Diggins |
| Maintainers | cdiggins |

## Links

- npm: https://www.npmjs.com/package/myna-parser
- Repository: https://github.com/cdiggins/myna-parser
- Homepage: https://cdiggins.github.io/myna-parser
- Issues: https://github.com/cdiggins/myna-parser/issues
- npm.io page: https://npm.io/package/myna-parser

## Recent versions

- 2.5.1 (latest) — 2018-04-08
- 2.5.0 — 2018-03-06
- 2.4.5 — 2018-02-25
- 2.4.3 — 2018-01-14
- 2.4.2 — 2017-12-13
- 2.4.1 — 2017-12-13
- 2.4.0 — 2017-11-13
- 2.3.1 — 2017-08-13
- 2.3.0 — 2017-08-10
- 2.2.7 — 2017-08-04
- 2.2.6 — 2017-08-01
- 2.2.5 — 2017-07-31
- 2.2.4 — 2017-07-27
- 2.2.2 — 2017-07-24
- 2.2.1 — 2017-07-08
- … 12 more at https://npm.io/package/myna-parser/versions

## README

# [Myna Parsing Library](https://cdiggins.github.io/myna-parser)

[![npm version](https://badge.fury.io/js/myna-parser.svg)](https://badge.fury.io/js/myna-parser) 
[![Build Status](https://travis-ci.org/cdiggins/myna-parser.svg?branch=master)](https://travis-ci.org/cdiggins/myna-parser)

### [Home Page](https://cdiggins.github.io/myna-parser) | [QUnit Tests](https://cdiggins.github.io/myna-parser/tests/qunit.html) | [Source Code](https://github.com/cdiggins/myna-parser/blob/master/myna.ts) 

Myna is an efficient and easy to use parsing library for JavaScript written using [TypeScript 2.0](https://www.typescriptlang.org/) which targets [ECMAScript 5.1](https://www.ecma-international.org/ecma-262/5.1/). 

Unlike several popular parsing libraries (e.g. [Jison](http://jison.org/), [PEG.js](https://pegjs.org/), [nearley](http://nearley.js.org/), and [ANTLR](http://www.antlr.org/)) 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](https://github.com/jneen/parsimmon) and [Chevrotain](https://github.com/SAP/chevrotain). Myna has no dependencies, you can just download `myna.js` and start using it immediately.

There are several [example tools](https://github.com/cdiggins/myna-parser/tree/master/tools) that demonstrate how to use Myna parsers and 
a number of [sample grammars](https://github.com/cdiggins/myna-parser/tree/master/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](https://github.com/cdiggins/myna-parser/raw/master/myna.js) or [via Unpkg](https://unpkg.com/myna-parser) and start using it in your project, or you can [install Myna from npm](https://www.npmjs.com/package/myna-parser). 

## 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`](https://github.com/cdiggins/myna-parser/tree/master/myna.ts). 
The generated Myna JavaScript file that you would include in your project is [`myna.js`](https://github.com/cdiggins/myna-parser/tree/master/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](http://npmjs.com) 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](https://cdiggins.github.io/myna-parser/tests/qunit.html) written using [QUnit](http://qunitjs.com). 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](https://www.npmjs.com/package/uglify-js). 

# Bugs and Issues

Please submit any issues, questions, or feature requests via the [GitHub issue tracker](https://github.com/cdiggins/myna-parser/issues).

# 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](https://github.com/cdiggins)

# 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](https://sciumo.com/) for being the first person to financially support the Myna project.

---
_Source: https://npm.io/package/myna-parser · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._