Make a complete example with a simple language

[fflorent]

It could be really helpful to implement a full example using a simple language like JSON or toml.

https://github.com/Geal/nom/blob/master/examples/json.rs

Originally suggested by @Geal.

[bikeshedder]

I'm using nom + nom_locate in the webwire CLI tool for parsing the IDL:

Language spec: https://webwire.dev/idl.html
Parser implementation: https://github.com/webwire/webwire-cli/tree/master/src/idl

I consider this to be a rather simple language and the code contains testcases including checks that the parser errors report the correct line and column numbers.

[the-drunk-coder]

It would indeed be helpful ... I'm currently trying to get token locations from my little S-expression parser (which is based on the example from the nom repo), and I'm struggling a bit to integrate nom_locate in a way that maintains the elegance of the combinators, and the understandability/readbility of the parser code.

The IDL example by @bikeshedder makes me believe it's possible to do so, but having some intermediate examples (or docs on how to integrate nom_locate with combinators like map) would be a big help ...