API Blueprint Parser for Ruby
NOTE: This library is deprecated and unmaintained. We recommend using drafter directly via libffi for example.
Ruby binding for the Snow Crash library, also a thermonuclear weapon.
API Blueprint is Web API documentation language. You can find API Blueprint documentation on the API Blueprint site.
Install
The best way to install RedSnow is by using its GEM package.
gem install redsnow
Installation instructions for Ubuntu 14.04 are described in detail here.
Documentation
Getting started
require 'redsnow'
result = RedSnow.parse('# My API', exportSourcemap: true)
puts result.ast.name
puts result.sourcemap.nameParsing options
Options can be number or hash. We support :requireBlueprintName and :exportSourcemap option.
require 'redsnow'
result = RedSnow::parse('# My API', { :exportSourcemap => true })
puts result.ast.name
puts result.sourcemap.nameHacking Redsnow
You are welcome to contribute. Use following steps to build & test Redsnow.
Build
-
If needed, install bundler:
$ gem install bundler
-
Clone the repo + fetch the submodules:
$ git clone git://github.com/apiaryio/redsnow.git $ cd redsnow $ git submodule update --init --recursive -
Build:
$ rake
Test
Inside the redsnow repository run:
$ bundle install
$ rake testRelease
Use rake install to test locally released version.
$ rake releaseContribute
Fork & Pull Request.
License
MIT License. See the LICENSE file.