Merge pull request #75 from APIs-guru/master

Add 'buildTagsFromPaths' option.

README.md

@@ -84,6 +84,7 @@ var swagger2Document = SwaggerConverter.convert(resourceListing, apiDeclarations
 ### Options
 
 - `collectionFormat`[string] - assigned to every array parameter.
+- `buildTagsFromPaths`[bool] - ignore `resourcePath` and buid tags from resource `path`. Default: false.
 
 ### Development
 

browser.js

@@ -200,13 +200,21 @@ Converter.prototype.getResources = function(resourceListing, apiDeclarations) {
  * @returns {array} - list of Swagger 2.0 tags
 */
 Converter.prototype.buildTags = function(resourceListing, resources) {
-  var resourcePaths = this.mapEach(resources, function(resource) {
-    return resource.resourcePath;
-  });
+  var resourcePaths = [];
+
+  if (this.options.buildTagsFromPaths !== true) {
+    resourcePaths = this.mapEach(resources, function(resource) {
+      return resource.resourcePath;
+    });
+
+    //'resourcePath' is optional parameter and also frequently have invalid values
+    // if so than we discard all values and use resource paths for listing instead.
+    if (getLength(removeDuplicates(resourcePaths)) < getLength(resources)) {
+      resourcePaths = [];
+    }
+  }
 
-  //'resourcePath' is optional parameter and also frequently have invalid values
-  // if so than we discard all values and use resource paths for listing instead.
-  if (getLength(removeDuplicates(resourcePaths)) < getLength(resources)) {
+  if (isEmpty(resourcePaths)) {
     resourcePaths = this.mapEach(resourceListing.apis, function(resource) {
       return resource.path;
     });

index.js

@@ -199,13 +199,21 @@ Converter.prototype.getResources = function(resourceListing, apiDeclarations) {
  * @returns {array} - list of Swagger 2.0 tags
 */
 Converter.prototype.buildTags = function(resourceListing, resources) {
-  var resourcePaths = this.mapEach(resources, function(resource) {
-    return resource.resourcePath;
-  });
+  var resourcePaths = [];
+
+  if (this.options.buildTagsFromPaths !== true) {
+    resourcePaths = this.mapEach(resources, function(resource) {
+      return resource.resourcePath;
+    });
+
+    //'resourcePath' is optional parameter and also frequently have invalid values
+    // if so than we discard all values and use resource paths for listing instead.
+    if (getLength(removeDuplicates(resourcePaths)) < getLength(resources)) {
+      resourcePaths = [];
+    }
+  }
 
-  //'resourcePath' is optional parameter and also frequently have invalid values
-  // if so than we discard all values and use resource paths for listing instead.
-  if (getLength(removeDuplicates(resourcePaths)) < getLength(resources)) {
+  if (isEmpty(resourcePaths)) {
     resourcePaths = this.mapEach(resourceListing.apis, function(resource) {
       return resource.path;
     });

package.json

@@ -1,6 +1,6 @@
 {
   "name": "swagger-converter",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Converts Swagger documents from version 1.x to version 2.0",
   "main": "index.js",
   "scripts": {