Add ability to transform_path for the core API config.

The `path` element of the swagger DSL `{"apis": [{"path": ...}]}`
allows a distinction between the API docs server and the hosted API
location (see https://github.com/wordnik/swagger-core/wiki/No-server-Integrations ).
This adds the ability to provide a custom transform function to swagger-docs which
can arbitrarily modify the currently-autogenerated `path` variable.
Update docs.
Merge branch 'add_transform_path' into internal

Conflicts:
	README.md
Add suport for Swagger models.

https://github.com/wordnik/swagger-core/wiki/Datatypes#wiki-complex-types
Merge branch 'internal' of github.com:scienceexchange/swagger-docs into internal

Conflicts:
	README.md
	lib/swagger/docs/generator.rb
Fix bug with not having any models declared
Spacing.
Update docs.
Add missing impotent method.
Refactor generation code to separate JSON generation from writing

Signed-off-by: Lucas Dutra Nunes <ldnunes@ossystems.com.br>
Allow reopening of docs for the swagger_api DSL command

This allows for some interesting inheritance mechanics, like defining the API
for a controller method in a superclass and then refining the API method, and
therefore documentation, in the subclass controller.

Signed-off-by: Lucas Dutra Nunes <ldnunes@ossystems.com.br>
ignore path filtering when no params are set

Conflicts:
	spec/fixtures/controllers/sample_controller.rb