/ramlstyle

RAML validator, linter, and document production

Primary LanguageHTML

Ramlstyle

Validates the a RAML file, runs lint rules against it, and produces HTML documentation.

Installation

Clone this repository on your machine, install dependencies and install the command.

git clone https://github.com/mmorga/ramlstyle.git
bundle
sudo bundle exec rake install:local  # if you are using the system Ruby
bundle exec rake install:local   # if you are using a rbenv, rvm, etc

If you aren't a regular ruby user, you should do this first:

sudo gem install bundler

Usage

Usage: ramlstyle [options] file1 file2 ...

Option Description
-v, --verbose Output more information
--no-document    | Do not produce HTML documentation
--no-lint        | Do not run linter rules

-o, --output-dir DIR | Write HTML documentation to DIR --version | print the version -h, --help | Display this screen

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/ramlstyle.

Credits

  1. Templates are derived from templates from RAML2HTML
  2. RAML is parsed with raml_ruby (with some modifications)