Looks interesting Justin! How would you feel if i changed your code into a Swagger2 command and merged it into my project? You could also be co-auth, if you like...
I've been thinking about a swagger (or swagger2 command), which could convert the API description into POD. Something like this: $ mojo swagger pod path/to/spec.json I guess if I could merge your module, there would also be a --version switch: $ mojo swagger json --version 1.2 lib/YourApp.pm Not sure if that makes any sense though, since my module is called Swagger2. On Wednesday, December 10, 2014 2:04:11 AM UTC+1, Justin Hawkins wrote: > > > On 10 Dec 2014, at 1:32 am, Jan Henning Thorsen <[email protected]> > wrote: > > I'm working on a new module that takes advantage of the Swagger2 API > documentation format. > > https://metacpan.org/release/Swagger2 > https://metacpan.org/release/JHTHORSEN/Swagger2-0.03 (in case 0.03 isn't > visible from the line above) > > Features: > * Automatic route generation > * Input/output validation in your Mojoliicous applicaiton > * Swagger documentation to Perl documentation (POD) > * JSON Schema validation > > Plans: > * Add Swagger::Client which wraps around Mojo::UserAgent and enables > input/output validation > > Any feedback/ideas are very much appreciated. > > > > Hi Jan, > > Interesting idea! > > I hacked for a while on essentially the reverse - generate the swagger > JSON data from the Mojolicious routes + POD documentation. Thus the actual > code and inline documentation becomes the source of truth for your API > specification. > > Maybe I need to pick it up again :-) > > https://github.com/tardisx/mojolicious-command-swagger > > - Justin > -- You received this message because you are subscribed to the Google Groups "Mojolicious" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/mojolicious. For more options, visit https://groups.google.com/d/optout.
