rs

raml-serverless

Work with RAML documentation for Serverless v1.0 projects

Showing:

Popularity

Downloads/wk

1

GitHub Stars

21

Maintenance

Last Commit

5yrs ago

Contributors

2

Package

Dependencies

1

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

RAML-Serverless Plugin

serverless npm version Build Status

Work with RAML documentation for Serverless v1.0 projects.

Currently it can be used to generate RAML documentation. Future versions will be able to deploy RAML documentents, stub API endpoints based on the RAML and even generate/update serverless.yml files from RAML specifications. For more information, take a look at the Feature Roadmap.

Installation

  1. Open a terminal to your Serverless project
  2. npm install --save raml-serverless
  3. Add raml-serverless to your serverless.yml file (see Serverless docs)

Usage

Example usage:

sls raml > docs.raml

RAML-Serverless will automatically create a section of the documentation for each HTTP endpoint you have in your serverless.yml file.

You can put global documentation in the custom: object in your Yaml file and it will be copied as is into the output RAML. Anything that can go into a RAML file can go here. For example:

custom:
  documentation:
    raml:
      title: My Awesome API
      version: v1.0

Which will result in a RAML file that starts with:

#%RAML 1.0
title: My Awsome API
version: v1.0

You can also put RAML on individual HTTP event endpoints and they will be included in the output. For example:

functions:
  index:
    handler: handlers.index
    events:
      - http:
          path: /hello/world
          method: get
          cors: true
          documentation:
             raml:
               description: Say hello to the world

Will produce this output in your RAML file:

/hello:
  /world:
    get:
      description: Say hello to the world

You can also include your RAML in a seperate file and import it into your serverless.yml using variables:

custom:
  documentation:
    raml: ${file(raml-base.yml)}

Contributing

This plugin is a work in progress. If you would like to contribute, go to Github issues (/andrewcurioso/raml-serverless/issues) and pick an issue to work on or create a new issue.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial