Allow setting the outputPath in the config

[robbiet480]

I just did this visually, didn't test it. It allows a user to configure the path to output the spec file to

[jfugett]

@robbiet480 Thanks for the PR. It's still quite a ways off from being ready for everyday sails use. I made it for work and we have some specific outputs that are hard coded as well. I'll go through this when I get a chance probably in a week or two and see about getting it merged in.

Most of the functionality is there but it's not documented yet. The default rest routes work out of the box. Controller actions work as well but take a specifically formatted property on the controller. I can give you an example if you need it.

Manual routes and shortcut routes don't work at all right now though.

Hope you found it useful
Joshwa

[robbiet480]

@jfugett Maybe not as far away from usable as you might think, I got up and running within 5 minutes of finding it from Google. Just had to patch the output path (because the default Sails asset directory is assets, not public), setup my config/swagger.js with some settings and I was off to the races.

Right now i'm really just doing CRUD with only 1 controller action, so i'm not hurting yet, but it would be great to see an example.

Thanks!

[jfugett]

Here you go

'use strict';

let controller = {
  testRun: function testRun(req, res) {
    res.ok({gotHere: true});
  }
};

controller._swagger = {
  testRun: {
    methods: ['get'],
    responses: {
      default: {
        description: 'testRun',
        schema: {
          type: 'object',
          properties: {
            status: {
              type: 'string',
              default: '200'
            },
            error: {
              type: 'string',
              default: ''
            },
            data: {
              $ref: '#/definitions/tests'
            }
          }
        }
      }
    }
  }
};

module.exports = controller;