Project

redsnow

0.04
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Ruby bindings for Snow Crash
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 1.7.0
~> 1.9.3
>= 10.3.2
~> 0.9.5
 Project Readme

logo

RedSnow Build Status

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.name

Parsing 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.name

Hacking Redsnow

You are welcome to contribute. Use following steps to build & test Redsnow.

Build

  1. If needed, install bundler:

    $ gem install bundler
  2. Clone the repo + fetch the submodules:

    $ git clone git://github.com/apiaryio/redsnow.git
    $ cd redsnow
    $ git submodule update --init --recursive
  3. Build:

    $ rake

Test

Inside the redsnow repository run:

$ bundle install
$ rake test

Release

Use rake install to test locally released version.

$ rake release

Contribute

Fork & Pull Request.

License

MIT License. See the LICENSE file.