Commit Graph

414 Commits

Author SHA1 Message Date
Miroslav Bajtoš 0b17811546 Generate Swagger Spec 2.0 documentation
Notable breaking changes:

- The swagger output is a single object (JSON response) served
  at /explorer/swagger.json

- Methods with a single return arg without "root:true" flag
  are expected to produce an object response with a single property now,
  i.e. `{ data: arg }`.
  In v1.x, we were treating such arg as if "root:true" was specified.
  The new behaviour matches the actual implementation in strong-remoting.

- The property constraint "length" is translated to "maxLength" now.

- `operationId` includes model name now, because ids must be unique

- X-Forwarded-* headers are no longer processed, Swagger Spec 2.0
  has a way how to specify "use the scheme + host where the doc is served"

- opts.omitProtocolInBaseUrl was removed for the same reasons as
  X-Forwarded-* headers

- The deprecated opts.swaggerDistRoot was removed.
2015-08-21 18:55:32 +02:00
Miroslav Bajtoš ee42f0386c Merge pull request #114 from strongloop/feature/upgrade-to-swagger-ui-2.1
Upgrade to strong-swagger-ui@21.0 (swagger-ui@2.1)
2015-08-13 16:05:51 +02:00
Miroslav Bajtoš 30017c8242 Upgrade to strong-swagger-ui@21.0 (swagger-ui@2.1) 2015-08-13 15:58:35 +02:00
Ryan Graham 8c82f17930 bump major version
This has to be done before release because our staging registry is
essentialy a continusous deployment pipeline that makes use of the
major and minor version of master.
2015-08-10 14:51:28 -07:00
Miroslav Bajtoš 75ea3f928a Merge pull request #104 from strongloop/feature/refactor-as-component
[SEMVER-MAJOR] Rework the module to a loopback component
2015-08-10 16:54:38 +02:00
Miroslav Bajtoš 7ee8703ff5 Rework the module to a loopback component
Rework the exported function to conform to the component convention:

    var loopback = require('loopback');
    var explorer = require('loopback-explorer');
    var app = loopback();
    explorer(app, options);

Allow users to mount explorer as a middleware too:

    app.use('/explorer', explorer.routes(app, options));

- drop dependency on express
- drop support for loopback 1.x
- add a new option "mountPath" to specify where to mount the explorer UI
  and swagger metadata
- describe upgrading from v1.x in README
2015-08-10 16:51:03 +02:00
Miroslav Bajtoš d1e02695c8 Merge pull request #99 from cndreiter:master
Add `opts.host` to customize host of resource URLs

Close #99
2015-08-04 15:49:01 +02:00
cndreiter c47d8c9189 Add `opts.host` to customize host of resource URLs 2015-08-04 15:48:49 +02:00
Raymond Feng 8f2dc9966e Merge pull request #113 from strongloop/shelbys-master
Pick up enhancements from shelbys master
2015-07-31 15:59:47 -07:00
Raymond Feng 89d48f609a Merge branch 'master' of https://github.com/shelbys/loopback-explorer into shelbys-master 2015-07-30 13:52:07 -07:00
Shelby Sanders fccb69303f Merge pull request #5 from shelbys/validate_param_enum
Added support for param enum enforcement, and refactored to match changes in upstream of Forks
2015-07-22 15:06:50 -07:00
Shelby Sanders 732301d709 Removed branch-lock, and bumped version 2015-07-22 15:06:17 -07:00
Shelby Sanders 43e84c4cb1 Corrected to propagate properties from existing items object 2015-07-15 17:17:33 -07:00
Miroslav Bajtoš b5bf179546 Merge pull request #107 from strongloop/feature/switch-to-strong-swagger-ui
Switch to strong-swagger-ui
2015-07-10 14:13:14 +02:00
Miroslav Bajtoš 073beebcb7 Use strong-swagger-ui instead of swagger-ui 2015-07-10 14:00:52 +02:00
Miroslav Bajtoš 5531e217dc Merge pull request #108 from strongloop/feature/refactor-custom-css
Refactor customization of CSS
2015-07-09 12:49:43 +02:00
Miroslav Bajtoš 305d78c986 Remove public/images/throbber.gif
Use the image provided by swagger-ui instead.
2015-07-08 19:07:38 +02:00
Miroslav Bajtoš 74ac00c770 Move CSS customizations to loopbackStyles.css
Compare
  loopback-explorer:public/css/screen.css@f3d6cb9
against
  swagger-ui:dist/css/screen@e980cca
and move all changes to loopbackStyles.css
2015-07-08 15:41:48 +02:00
Shelby Sanders 33ca826573 Added Swagger fields for items and max/min(Items|Length) 2015-07-07 01:29:33 -07:00
Shelby Sanders a4b96c33e2 Corrected accidental duplication of responseMessages from merge 2015-07-03 00:33:40 -07:00
Shelby Sanders ef7e5d403c Corrected accidental duplication of responseMessages from merge 2015-07-03 00:11:05 -07:00
Shelby Sanders 1294b53f5c Merge remote-tracking branch 'upstream/master' into validate_param_enum
* upstream/master: (53 commits)
  1.8.0
  Add opts.omitProtocolInBaseUrl
  Fix tests broken by fa3035c (#96)
  Fix model description getting lost
  1.7.2
  Allow submitting token input with empty value to remove token.
  Fix duplicate stylesheet issue
  Fix explorer tests for different line endings on Windows
  1.7.1
  Remove unused external font "Droid Sans".
  1.7.0
  Made API doc of class use the http.path of the class if available, or the name of the class as a fallback
  v1.6.4
  Prevent double slash in the resource URLs
  v1.6.3
  Allow `uiDirs` to be defined as a String
  Fix bad CLA URL in CONTRIBUTING.md
  Add X-UA-Compatible tag
  v1.6.2
  Move 200 response to `type` on the operation object. See #75.
  ...
2015-07-02 11:19:18 -07:00
Shelby Sanders 1bf7c27a56 Merge remote-tracking branch 'upstream/master' into validate_param_enum 2015-07-02 11:03:27 -07:00
Miroslav Bajtoš 265d1cdbe1 1.8.0
* Add opts.omitProtocolInBaseUrl (Miroslav Bajtoš)

 * Fix tests broken by fa3035c (#96) (Miroslav Bajtoš)

 * Fix model description getting lost (bkniffler)
2015-06-25 18:53:53 +02:00
Miroslav Bajtoš 9d2da45ae8 Merge pull request #102 from strongloop/feature/omitProtocolInBaseUrl
Add options.omitProtocolInBaseUrl
2015-06-25 18:52:41 +02:00
Miroslav Bajtoš 5462ce9aac Add opts.omitProtocolInBaseUrl 2015-06-23 16:36:19 +02:00
Miroslav Bajtoš ccfd9c42b0 Fix tests broken by fa3035c (#96) 2015-04-27 08:28:44 +02:00
Raymond Feng e31ced4d47 Merge pull request #96 from bkniffler/master
Fix model description getting lost
2015-04-20 08:18:44 -07:00
bkniffler fa3035c4bb Fix model description getting lost 2015-04-20 16:04:44 +02:00
y-tang 2158af9c82 Merge pull request #3 from shelbys/PLATAPI-1912
add $ref and remove type for models
2015-04-13 09:42:31 -07:00
Ying Tang 7af616b21a review comments 2015-04-08 17:03:22 -07:00
Ying Tang c001bd6b01 add more tests 2015-04-07 15:53:56 -07:00
Ying Tang e93d87375b float additionalProperties and description to top 2015-04-07 11:30:54 -07:00
Ying Tang a91eb2fb04 Convert array to string for summary, note, and description. Fix additionalProperties 2015-04-07 11:21:12 -07:00
Ying Tang 3f8c3b7c04 back out changes of id to URI 2015-04-06 19:57:57 -07:00
Ying Tang b9001a3130 Uri id and $ref, join description 2015-04-06 17:00:32 -07:00
Ying Tang 1dbc9cf113 propertyName, not property 2015-04-05 17:04:30 -07:00
Ying Tang e22b826bca fix resource listing and remove id from each property 2015-04-05 16:51:15 -07:00
Ying Tang b9df4b6706 remove id fields from required array 2015-04-02 16:29:09 -07:00
Ying Tang 772a48773d remove required from sub-schema 2015-04-01 17:47:57 -07:00
Miroslav Bajtoš c9b6d451cc 1.7.2
* Allow submitting token input with empty value to remove token. (Samuel Reed)

 * Fix duplicate stylesheet issue (Pradnya Baviskar)

 * Fix explorer tests for different line endings on Windows (Pradnya Baviskar)
2015-03-30 15:19:38 +02:00
Ying Tang 022403eadc bump version 2015-03-26 22:33:12 -07:00
Ying Tang 27e5895aa5 add $ref and remove type for models 2015-03-26 22:23:24 -07:00
Raymond Feng 641e416dc5 Merge pull request #90 from STRML/removeToken
Allow submitting token input with empty value to remove token.
2015-03-05 21:45:46 -08:00
Samuel Reed b7c14b7a09 Allow submitting token input with empty value to remove token. 2015-03-06 12:32:45 +07:00
Miroslav Bajtoš 036591bcba Merge pull request #89 from PradnyaBaviskar/duplicateStylesheet
Fix duplicate stylesheet issue
2015-02-27 11:38:03 +01:00
Miroslav Bajtoš 8e8bb34c42 Merge pull request #88 from PradnyaBaviskar/issue-85
Fix explorer tests for different line endings on Windows
2015-02-27 11:19:01 +01:00
Pradnya Baviskar 5d4d25e853 Fix duplicate stylesheet issue 2015-02-27 15:44:04 +05:30
Pradnya Baviskar 297086fb55 Fix explorer tests for different line endings on Windows 2015-02-27 15:20:10 +05:30
Miroslav Bajtoš 780929ab73 1.7.1
* Remove unused external font "Droid Sans". (Miroslav Bajtoš)
2015-02-23 18:29:44 +01:00