Skip to content

Latest commit

 

History

History
41 lines (26 loc) · 1.48 KB

README.md

File metadata and controls

41 lines (26 loc) · 1.48 KB

Lagun

An interactive web UI for Open API (2.0) specs. Think of it as an alternative to the default Swagger UI. My first project for learning and exploring Elm.

Uses:

Demo on Github pages for swagger's petstore sample API

Build

elm-make src/Main.elm --warn --output elm.js

or

make

If everything compiles fine open index.html to use Lagun. If you want to change the default specification url simply edit index.html, and modify the specUrl setting passed into Elm.Main.fullscreen. This could also be a path to a file (for example '/docs/myspec.json'). You can also set the specUrl by providing a spec query parameter to index.html. For example: http://lagunlocation.com/index.html?spec=http://speclocation/swagger

Supported specification formats

I doubt I will add support for other specs (such as RAML). PRs welcome ;)

TODO / Explore

  • Add support for remaining parameter types: formData
  • Show schema types for body parameters (ugh)
  • Show response model for http responses
  • Some tests would be fun and useful
  • Show version of Lagun somewhere on the page (bottom?)
  • Structure the code in a nicer way