From 0061046d3b8ebcd6aff6b29c3a24055c8f5b1054 Mon Sep 17 00:00:00 2001
From: Hiram Chirino <hiram@hiramchirino.com>
Date: Fri, 9 Mar 2012 15:06:38 -0500
Subject: [PATCH 1/3] Support a relative url path to the service.

---
 source/javascripts/swagger-service.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/javascripts/swagger-service.js b/source/javascripts/swagger-service.js
index af6681dc..a3d5fb34 100644
--- a/source/javascripts/swagger-service.js
+++ b/source/javascripts/swagger-service.js
@@ -7,7 +7,7 @@ function SwaggerService(discoveryUrl, _apiKey, statusCallback) {
   if (discoveryUrl.length == 0)
   throw new Error("discoveryUrl must be passed while creating SwaggerService");
 
-  if (! (discoveryUrl.toLowerCase().indexOf("http:") == 0 || discoveryUrl.toLowerCase().indexOf("https:") == 0)) {
+  if ( discoveryUrl.indexOf("/")!=0 && ! (discoveryUrl.toLowerCase().indexOf("http:") == 0 || discoveryUrl.toLowerCase().indexOf("https:") == 0)) {
     discoveryUrl = ("http://" + discoveryUrl);
   }
 

From 4e1ad46699eaecf6f7781f0e6de9d604731eeebe Mon Sep 17 00:00:00 2001
From: Hiram Chirino <hiram@hiramchirino.com>
Date: Mon, 19 Mar 2012 09:56:34 -0400
Subject: [PATCH 2/3] Simplify how the name of the resource is constructed so
 that it can handle resources nested multiple directory levels in.

---
 source/index.html.haml                |  2 +-
 source/javascripts/swagger-service.js | 22 ++++------------------
 2 files changed, 5 insertions(+), 19 deletions(-)

diff --git a/source/index.html.haml b/source/index.html.haml
index c2d32553..b6a30ed8 100644
--- a/source/index.html.haml
+++ b/source/index.html.haml
@@ -5,7 +5,7 @@
   %li.resource{:id => "resource_${name}"}
     .heading
       %h2
-        %a{:href => "#!/${name}", :onclick => "Docs.toggleEndpointListForResource('${name}');"} ${name}
+        %a{:href => "#!/${name}", :onclick => "Docs.toggleEndpointListForResource('${name}');"} ${path}
       %ul.options
         %li
           %a{:href => "#!/${name}", :id => "endpointListTogger_${name}", :onclick => "Docs.toggleEndpointListForResource('${name}');"} Show/Hide
diff --git a/source/javascripts/swagger-service.js b/source/javascripts/swagger-service.js
index a3d5fb34..dd4915b5 100644
--- a/source/javascripts/swagger-service.js
+++ b/source/javascripts/swagger-service.js
@@ -57,17 +57,12 @@ function SwaggerService(discoveryUrl, _apiKey, statusCallback) {
   ApiResource.include({
     path_json: null,
     path_xml: null,
-
     init: function(atts) {
       if (atts) this.load(atts);
+      this.name = this.path.replace(".{format}", "").replace(/\//g, "_");
       this.path_json = this.path.replace("{format}", "json");
       this.path_xml = this.path.replace("{format}", "xml");
       this.baseUrl = globalBasePath;
-      //execluded 9 letters to remove .{format} from name
-      this.name = this.path.split("/");
-      this.name = this.name[this.name.length - 1];
-      this.name = this.name.replace(".{format}",'').replace(/\//g, "_");
-      // this.name = this.path.substr(1, this.path.length - formatString.length - 1).replace(/\//g, "_");
       this.apiList = Api.sub();
       this.modelList = ApiModel.sub();
     },
@@ -95,6 +90,9 @@ function SwaggerService(discoveryUrl, _apiKey, statusCallback) {
     init: function(atts) {
       if (atts) this.load(atts);
 
+      var sep = this.path.lastIndexOf("/");
+      this.name = this.path.substr(0, sep).replace(".{format}", "").replace(/\//g, "_");
+
       var secondPathSeperatorIndex = this.path.indexOf("/", 1);
       if (secondPathSeperatorIndex > 0) {
         var prefix = this.path.substr(0, secondPathSeperatorIndex);
@@ -102,21 +100,9 @@ function SwaggerService(discoveryUrl, _apiKey, statusCallback) {
         // log(this.path + ":: " + prefix + "..." + suffix);
         this.path_json = prefix.replace("{format}", "json") + suffix;
         this.path_xml = prefix.replace("{format}", "xml") + suffix;;
-
-        if (this.path.indexOf("/") == 0) {
-          this.name = this.path.substr(1, secondPathSeperatorIndex - formatString.length - 1);
-        } else {
-          this.name = this.path.substr(0, secondPathSeperatorIndex - formatString.length - 1);
-        }
       } else {
         this.path_json = this.path.replace("{format}", "json");
         this.path_xml = this.path.replace("{format}", "xml");
-
-        if (this.path.indexOf("/") == 0) {
-          this.name = this.path.substr(1, this.path.length - formatString.length - 1);
-        } else {
-          this.name = this.path.substr(0, this.path.length - formatString.length - 1);
-        }
       }
 
       var value = this.operations;

From bbcb230b2039157f7e7c8d9375d0781efa94e011 Mon Sep 17 00:00:00 2001
From: Hiram Chirino <hiram@hiramchirino.com>
Date: Mon, 19 Mar 2012 09:57:38 -0400
Subject: [PATCH 3/3] Rebuilt using 'middleman build'

---
 build/index.html                     |  26 ++---
 build/javascripts/swagger-service.js | 142 ++++++++++++++++-----------
 2 files changed, 98 insertions(+), 70 deletions(-)

diff --git a/build/index.html b/build/index.html
index 6c673534..46cd06b0 100644
--- a/build/index.html
+++ b/build/index.html
@@ -14,20 +14,20 @@
   </head>
   <body>
     <div id='header'>
-      <a id="logo" href="http://swagger.wordnik.com">swagger</a>
+      <a href="http://swagger.wordnik.com" id="logo">swagger</a>
       <form id='api_selector'>
-        <div class='input'><input placeholder="http://example.com/api" id="input_baseUrl" name="baseUrl" type="text" /></div>
-        <div class='input'><input placeholder="api_key" id="input_apiKey" name="apiKey" type="text" /></div>
-        <div class='input'><a id="explore" href="#">Explore</a></div>
+        <div class='input'><input type="text" placeholder="http://example.com/api" name="baseUrl" id="input_baseUrl" /></div>
+        <div class='input'><input type="text" placeholder="api_key" name="apiKey" id="input_apiKey" /></div>
+        <div class='input'><a href="#" id="explore">Explore</a></div>
       </form>
     </div>
     <div class='container' id='resources_container'>
       <ul id='resources'></ul>
     </div>
-    <script id="resourceTemplate" type="text/x-jquery-tmpl"><li class='resource' id='resource_${name}'>
+    <script type="text/x-jquery-tmpl" id="resourceTemplate"><li class='resource' id='resource_${name}'>
       <div class='heading'>
         <h2>
-          <a href='#!/${name}' onclick="Docs.toggleEndpointListForResource('${name}');">${name}</a>
+          <a href='#!/${name}' onclick="Docs.toggleEndpointListForResource('${name}');">${path}</a>
         </h2>
         <ul class='options'>
           <li>
@@ -51,11 +51,11 @@
       <ul class='endpoints' id='${name}_endpoint_list' style='display:none'></ul>
     </li>
     </script>
-    <script id="apiTemplate" type="text/x-jquery-tmpl"><li class='endpoint'>
+    <script type="text/x-jquery-tmpl" id="apiTemplate"><li class='endpoint'>
       <ul class='operations' id='${name}_endpoint_operations'></ul>
     </li>
     </script>
-    <script id="operationTemplate" type="text/x-jquery-tmpl"><li class='${httpMethodLowercase} operation' id='${apiName}_${nickname}_${httpMethod}'>
+    <script type="text/x-jquery-tmpl" id="operationTemplate"><li class='${httpMethodLowercase} operation' id='${apiName}_${nickname}_${httpMethod}'>
       <div class='heading'>
         <h3>
           <span class='http_method'>
@@ -108,7 +108,7 @@
       </div>
     </li>
     </script>
-    <script id="paramTemplate" type="text/x-jquery-tmpl"><tr>
+    <script type="text/x-jquery-tmpl" id="paramTemplate"><tr>
       <td class='code'>${name}</td>
       <td>
         <input minlength='0' name='${name}' placeholder='' type='text' value='' />
@@ -116,7 +116,7 @@
       <td width='500'>${description}</td>
     </tr>
     </script>
-    <script id="paramTemplateSelect" type="text/x-jquery-tmpl"><tr>
+    <script type="text/x-jquery-tmpl" id="paramTemplateSelect"><tr>
       <td class='code'>${name}</td>
       <td>
         <select name='${name}'>
@@ -135,7 +135,7 @@
       <td width='500'>${description}</td>
     </tr>
     </script>
-    <script id="paramTemplateRequired" type="text/x-jquery-tmpl"><tr>
+    <script type="text/x-jquery-tmpl" id="paramTemplateRequired"><tr>
       <td class='code required'>${name}</td>
       <td>
         <input class='required' minlength='1' name='${name}' placeholder='(required)' type='text' value='' />
@@ -145,13 +145,13 @@
       </td>
     </tr>
     </script>
-    <script id="paramTemplateRequiredReadOnly" type="text/x-jquery-tmpl"><tr>
+    <script type="text/x-jquery-tmpl" id="paramTemplateRequiredReadOnly"><tr>
       <td class='code required'>${name}</td>
       <td>-</td>
       <td width='500'>${description}</td>
     </tr>
     </script>
-    <script id="paramTemplateReadOnly" type="text/x-jquery-tmpl"><tr>
+    <script type="text/x-jquery-tmpl" id="paramTemplateReadOnly"><tr>
       <td class='code'>${name}</td>
       <td>-</td>
       <td width='500'>${description}</td>
diff --git a/build/javascripts/swagger-service.js b/build/javascripts/swagger-service.js
index f99eba24..dd4915b5 100644
--- a/build/javascripts/swagger-service.js
+++ b/build/javascripts/swagger-service.js
@@ -1,19 +1,17 @@
-function SwaggerService(baseUrl, _apiKey, statusCallback) {
-  if (!baseUrl)
-  throw new Error("baseUrl must be passed while creating SwaggerService");
+function SwaggerService(discoveryUrl, _apiKey, statusCallback) {
+  if (!discoveryUrl)
+  throw new Error("discoveryUrl must be passed while creating SwaggerService");
 
   // constants
-  baseUrl = jQuery.trim(baseUrl);
-  if (baseUrl.length == 0)
-  throw new Error("baseUrl must be passed while creating SwaggerService");
+  discoveryUrl = jQuery.trim(discoveryUrl);
+  if (discoveryUrl.length == 0)
+  throw new Error("discoveryUrl must be passed while creating SwaggerService");
 
-  if (! (baseUrl.toLowerCase().indexOf("http:") == 0 || baseUrl.toLowerCase().indexOf("https:") == 0)) {
-    baseUrl = ("http://" + baseUrl);
+  if ( discoveryUrl.indexOf("/")!=0 && ! (discoveryUrl.toLowerCase().indexOf("http:") == 0 || discoveryUrl.toLowerCase().indexOf("https:") == 0)) {
+    discoveryUrl = ("http://" + discoveryUrl);
   }
 
-  var apiHost = baseUrl.substr(0, baseUrl.lastIndexOf("/"));
-  var discoParts = baseUrl.split("/");
-  var rootResourcesApiName = discoParts[discoParts.length-1];
+  var globalBasePath = null;
   var formatString = ".{format}";
   var statusListener = statusCallback;
   var apiKey = _apiKey;
@@ -37,13 +35,17 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
     statusListener(status);
   }
 
+  function endsWith(str, suffix) {
+    return str.indexOf(suffix, str.length - suffix.length) !== -1;
+  }
+
   // make some models public
   this.ApiResource = function() {
     return ApiResource;
   };
 
   this.apiHost = function() {
-    return apiHost;
+    return globalBasePath;
   };
 
   this.formatString = function() {
@@ -55,26 +57,24 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
   ApiResource.include({
     path_json: null,
     path_xml: null,
-
     init: function(atts) {
       if (atts) this.load(atts);
+      this.name = this.path.replace(".{format}", "").replace(/\//g, "_");
       this.path_json = this.path.replace("{format}", "json");
       this.path_xml = this.path.replace("{format}", "xml");
-      this.baseUrl = apiHost;
-      //execluded 9 letters to remove .{format} from name
-      this.name = this.path.split("/");
-      this.name = this.name[this.name.length - 1];
-      this.name = this.name.replace(".{format}",'').replace(/\//g, "_");
-      // this.name = this.path.substr(1, this.path.length - formatString.length - 1).replace(/\//g, "_");
+      this.baseUrl = globalBasePath;
       this.apiList = Api.sub();
       this.modelList = ApiModel.sub();
     },
 
-    addApis: function(apiObjects) {
+    addApis: function(apiObjects, basePath) {
       // log("apiObjects: %o", apiObjects);
       this.apiList.createAll(apiObjects);
+	  this.apiList.each(function(api) {
+		api.setBaseUrl(basePath);
+	  });
     },
-
+    
     addModel: function(modelObject) {
       this.modelList.create(modelObject);
     },
@@ -90,7 +90,8 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
     init: function(atts) {
       if (atts) this.load(atts);
 
-      this.baseUrl = apiHost;
+      var sep = this.path.lastIndexOf("/");
+      this.name = this.path.substr(0, sep).replace(".{format}", "").replace(/\//g, "_");
 
       var secondPathSeperatorIndex = this.path.indexOf("/", 1);
       if (secondPathSeperatorIndex > 0) {
@@ -99,21 +100,9 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
         // log(this.path + ":: " + prefix + "..." + suffix);
         this.path_json = prefix.replace("{format}", "json") + suffix;
         this.path_xml = prefix.replace("{format}", "xml") + suffix;;
-
-        if (this.path.indexOf("/") == 0) {
-          this.name = this.path.substr(1, secondPathSeperatorIndex - formatString.length - 1);
-        } else {
-          this.name = this.path.substr(0, secondPathSeperatorIndex - formatString.length - 1);
-        }
       } else {
         this.path_json = this.path.replace("{format}", "json");
         this.path_xml = this.path.replace("{format}", "xml");
-
-        if (this.path.indexOf("/") == 0) {
-          this.name = this.path.substr(1, this.path.length - formatString.length - 1);
-        } else {
-          this.name = this.path.substr(0, this.path.length - formatString.length - 1);
-        }
       }
 
       var value = this.operations;
@@ -136,6 +125,13 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
 
     },
 
+    setBaseUrl: function(u) {
+		this.baseUrl = u;
+		this.operations.each(function(o) {
+			o.baseUrl = u;
+		});
+    },
+
     toString: function() {
       var opsString = "";
       for (var i = 0; i < this.operations.all().length; i++) {
@@ -157,7 +153,6 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
     init: function(atts) {
       if (atts) this.load(atts);
 
-      this.baseUrl = apiHost;
       this.httpMethodLowercase = this.httpMethod.toLowerCase();
 
       var value = this.parameters;
@@ -355,6 +350,8 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
   var ModelController = Spine.Controller.create({
     countLoaded: 0,
     proxied: ["fetchResources", "loadResources", "apisLoaded", "modelsLoaded"],
+    discoveryUrlList: [],
+	discoveryUrlListCursor: 0,
 
     init: function() {
       // log("ModelController.init");
@@ -363,26 +360,57 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
     },
 
     fetchEndpoints: function() {
-      var controller = this;
-
       updateStatus("Fetching API List...");
-      var url = apiHost + "/" + rootResourcesApiName + apiKeySuffix;
-      $.getJSON(url, function(response) {
-        
-        // if (response.apis) {
-          ApiResource.createAll(response.apis);  
-        // }
-        
-        // get rid of the root resource list api since we're not going to document that
-        var obj = ApiResource.findByAttribute("name", rootResourcesApiName);
-        if (obj)
-          obj.destroy();
-        controller.fetchResources();
-      });      
+	  var baseDiscoveryUrl = endsWith(discoveryUrl, "/") ? discoveryUrl.substr(0, discoveryUrl.length - 1) : discoveryUrl;
+	  if(endsWith(baseDiscoveryUrl, "/resources.json"))
+		baseDiscoveryUrl = baseDiscoveryUrl.substr(0, baseDiscoveryUrl.length - "/resources.json".length);
+	  else if(endsWith(baseDiscoveryUrl, "/resources"))
+		baseDiscoveryUrl = baseDiscoveryUrl.substr(0, baseDiscoveryUrl.length - "/resources".length);
+	
+	  this.discoveryUrlList.push(discoveryUrl);
+	  this.discoveryUrlList.push(baseDiscoveryUrl);
+	  this.discoveryUrlList.push(baseDiscoveryUrl + "/resources.json");
+	  this.discoveryUrlList.push(baseDiscoveryUrl + "/resources");
+	  
+	  log("Will try the following urls to discover api endpoints:")
+	  for(var i = 0; i < this.discoveryUrlList.length; i++)
+		log(" > " + this.discoveryUrlList[i]);
+	
+	  this.fetchEndpointsSeq();
     },
 
-    fetchResources: function() {
-      //log("fetchResources");
+    fetchEndpointsSeq: function() {
+      var controller = this;
+
+	  if(this.discoveryUrlListCursor < this.discoveryUrlList.length) {
+		  var url = this.discoveryUrlList[this.discoveryUrlListCursor++]
+	      updateStatus("Fetching API List from " + url);
+		  log("Trying url " + url);
+	      $.getJSON(url + apiKeySuffix, function(response) {
+	      })
+	      .success(function(response) {
+		      log("Setting globalBasePath to " + response.basePath);
+		      globalBasePath = response.basePath;
+		      ApiResource.createAll(response.apis);  
+	          controller.fetchResources(response.basePath);
+	      })
+	   	  .error(function(response) { 
+	          controller.fetchEndpointsSeq();
+		  });
+	  } else {
+	      log ('Error with resource discovery. Exhaused all possible endpoint urls');
+	
+		  var urlsTried = "";
+		  for(var i = 0; i < this.discoveryUrlList.length; i++) {
+			urlsTried = urlsTried + "<br/>" + this.discoveryUrlList[i];
+		  }
+			
+	      updateStatus("Unable to fetch API Listing. Tried the following urls:" + urlsTried);
+	  }
+    },
+
+    fetchResources: function(basePath) {
+      log("fetchResources: basePath = " + basePath);
       //ApiResource.logAll();
       for (var i = 0; i < ApiResource.all().length; i++) {
         var apiResource = ApiResource.all()[i];
@@ -393,8 +421,8 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
     fetchResource: function(apiResource) {
       var controller = this;
       updateStatus("Fetching " + apiResource.name + "...");
-      var resourceUrl = apiHost + apiResource.path_json + apiKeySuffix;
-      // log("resourceUrl: %o", resourceUrl);
+      var resourceUrl = globalBasePath + apiResource.path_json + apiKeySuffix;
+      log("resourceUrl: %o", resourceUrl);
       $.getJSON(resourceUrl,
       function(response) {
         controller.loadResources(response, apiResource);
@@ -405,9 +433,9 @@ function SwaggerService(baseUrl, _apiKey, statusCallback) {
       try {
         this.countLoaded++;
         //    log(response);
-        // if (response.apis) {
-          apiResource.addApis(response.apis);  
-        // }
+        if (response.apis) {
+          apiResource.addApis(response.apis, response.basePath);  
+        }
         //        updateStatus("Parsed Apis");
         //log(response.models);
         if (response.models) {