The SignPuddle 3 source is written in ApiTxt Format, a custom text markup used to define a RESTful API. Each line in an ApiTxt document is a self-contained element which starts with a name and is followed by
Automated tools are used to parse, analyze, validate, and transform the source into a variety of formats.
The first transformation reads the ApiTxt Format document and writes an array of JSON Objects.
ApiTxt Format OK
The second transformation reverses the process by reading the array of JSON Objects and writing an ApiTxt Format document with standard order and indenting. The original ApiTxt Format document is compared to the new ApiTxt Format document.
With the ApiTxt Format validated, the array of JSON Objects is used for additional transformations.
API Blueprint has excellent tooling. This project makes use of an API Blueprint tool called Snowboard to generate HTML documentation, to check for errors with Lint, and to mimic a real API server with Mock.