Version 0.9 Created by Jon Abrams
This file provides functions for parsing input that is formatted using TOML.
It is meant to be used in browsers. If you're looking for a TOML parser for node.js, try this.
I wrote this because I wanted to try out CoffeeScript's new "literate" mode, and I wanted to take a crack at writing a parser; luckily TOML just happened to appear.
I hope it's useful and/or educational. It should be understandable for beginner to intermediate JavaScripters. It will help you to know the following first:
Include toml.js in your html file, then invoke TOML.parse(toml_input).
See the test.html file in this repo.
It's also available in a live demo.
If you're new to regex is might help to know the following patterns that I make heavy use of:
- /aregex/gm - The /gm part enabled the global flag and the multi-line flag. The global flag tells the regex to make multiple matches, i.e. don't just quite the first time a match is found. The multi-line flag just changes the behaviour of ^ and $ so that they act as beginning of line and end of line respectively.
- \s* - Look for 0 to many occurrences of whitespace
Either because I think parsers should be forgiving in what they accept (and encoders strict in what they produce), or because I was too lazy to implement a type check.
If you don't like all the text, and just care about the code, look at the compiled JS or use js2coffee to convert it back to vanilla CoffeeScript. Maybe someone will make a litcoffee to coffee converter.
- Tests
- Encoder
- Find more boundary conditions and weird errors
MIT
GitHub does a pretty decent job of rendering literate CoffeeScript, so feel free to just view it right here.