License
Creative Commons Zero v1.0 Universal (cc0-1.0)
Version 1.4.8
Play around with this application in your browser.
Contents
- Overview
- Technical Documentation
- Build
- Dependencies
- Get the Code
- TypeScript Build
- Validation Build
- Contributing
- FAQ
Overview
A simplified uniform parser tree capable of describing every programming language. This provides two immediate benefits:
- All languages are described using an identical data structure.
- An entire file can be described in a single parse tree even if comprised of various different languages.
Standard Format
I call the standard output format the Universal Parse Model. It is a simple means to describe any structured programming language.
Before diving into this application it might help to have a quick background in what parsers are and their related terminology.
Technical Documentation
Please review the technical documentation to learn how to execute, embed, format input, and interpret output.
Supported Languages
A list of supplied lexers and their various dedicated language support as indicated through use of logic with options.language. Other languages may be supported without dedicated logic.
- markdown
- markup
- script
- style
45 total languages.
Build
Dependencies
This application is written in TypeScript, which requires NodeJS and a global installation of TypeScript. The optional validation build also requires ESLint. First, let's install these:
npm install -g typescript
npm install -g eslint
Get the Code
Second, we need to get the code. We can get this directly from Github:
git clone https://github.com/Unibeautify/sparser.git
cd sparser
Or, we can get the code from NPM:
npm install sparser
cd node_modules/sparser
Please note the NPM package contains both the TypeScript and the built JavaScript files, so it is ready to execute immediately without any additional build or compile step.
TypeScript Build
Finally, we need to run the TypeScript build to convert the code from TypeScript to JavaScript:
tsc --pretty
node js/services build
Tests
If you wish to run the test suite:
node js/services test
Or simply:
npm test