haveapi 0.13.1 → 0.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec4a7c126e25b77ada4e03d56e1fdcb8aed47c36ecc157080c808b98e142b90c
-  data.tar.gz: ffcdde27ee96bccba25e395356a90d4b519b1a6cbf59a2c542e65ff3e83cdb0c
+  metadata.gz: 18a4707c15c1b608bfacae382281e56afbb28b276c8aea07074dae4c4946e7c4
+  data.tar.gz: 8915471dca73cb18bbb6f9c97fd55ee03e404da6f6215f887772db965c12e875
 SHA512:
-  metadata.gz: b51e7c3ea6127a40f01be32ad2e71e64582f64a958440bc522364fa8c9354c312f271b0feca3d06fbe4b079f75d6872c5ef60dd2afaaed9633563e5fc93fc933
-  data.tar.gz: d0794b605fec0cfa137994fdb2535ec31442c7c372ef8ea032121a92a6d6dee2e84636bb45a703c0f28b5dbdf61d07591f064c28671061d7a797e855c2aa9180
+  metadata.gz: 30ba076bd5295de5d3fb3571509a022ede200879f1c456016e3c17b6cd07fdbaed150e063e2e0de3dad9c34efe6fe048de77a5fbdc601656c9edcae36f52bd50
+  data.tar.gz: 7f97d659955b5763db6e3816dbf6332b315bcdee29344f47a35c81c908efe934224e7062ad9fee5bf3edf2c7f1d9d8304f0cd87c6d50c1bedb93696d439d96ab

data/haveapi.gemspec

@@ -17,12 +17,12 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'require_all', '~> 2.0.0'
   s.add_runtime_dependency 'json'
   s.add_runtime_dependency 'activesupport', '>= 4.0'
-  s.add_runtime_dependency 'sinatra', '~> 2.0.5'
-  s.add_runtime_dependency 'tilt', '~> 2.0.9'
-  s.add_runtime_dependency 'redcarpet', '~> 3.4'
+  s.add_runtime_dependency 'sinatra', '~> 2.1.0'
+  s.add_runtime_dependency 'tilt', '~> 2.0.10'
+  s.add_runtime_dependency 'redcarpet', '~> 3.5'
   s.add_runtime_dependency 'rake'
   s.add_runtime_dependency 'github-markdown'
   s.add_runtime_dependency 'nesty', '~> 1.0'
-  s.add_runtime_dependency 'haveapi-client', '~> 0.13.1'
+  s.add_runtime_dependency 'haveapi-client', '~> 0.14.1'
   s.add_runtime_dependency 'mail'
 end

data/lib/haveapi/action.rb

@@ -72,6 +72,7 @@ module HaveAPI
         begin
           subclass.instance_variable_set(:@resource, resource)
           subclass.instance_variable_set(:@model, resource.model)
+          resource.action_defined(subclass)
         rescue NoMethodError
           return
         end

data/lib/haveapi/parameters/typed.rb

@@ -110,7 +110,10 @@ module HaveAPI::Parameters
     end
 
     def format_output(v)
-      if @type == ::Datetime && v.is_a?(Time)
+      if v.nil?
+        nil
+
+      elsif @type == ::Datetime && v.is_a?(Time)
         v.iso8601
 
       elsif @type == Boolean

data/lib/haveapi/resource.rb

@@ -14,6 +14,11 @@ module HaveAPI
       subclass.instance_variable_set(:@obj_type, obj_type)
     end
 
+    def self.action_defined(klass)
+      @actions ||= []
+      @actions << klass
+    end
+
     def self.params(name, &block)
       if block
         @params ||= {}
@@ -23,14 +28,8 @@ module HaveAPI
       end
     end
 
-    def self.actions
-      constants.select do |c|
-        obj = const_get(c)
-
-        if obj.respond_to?(:obj_type) && obj.obj_type == :action
-          yield obj
-        end
-      end
+    def self.actions(&block)
+      (@actions || []).each(&block)
     end
 
     def self.resources

data/lib/haveapi/server.rb

@@ -121,6 +121,29 @@ module HaveAPI
       end
     end
 
+    module DocHelpers
+      def format_param_type(param)
+        return param[:type] if param[:type] != 'Resource'
+        "<a href=\"#root-#{param[:resource].join('-')}-show\">#{param[:type]}</a>"
+      end
+
+      def format_validators(validators)
+        ret = ''
+        return ret if validators.nil?
+
+        validators.each do |name, opts|
+          ret += "<h5>#{name.to_s.capitalize}</h5>"
+          ret += '<dl>'
+          opts.each do |k, v|
+            ret += "<dt>#{k}</dt><dd>#{v}</dd>"
+          end
+          ret += '</dl>'
+        end
+
+        ret
+      end
+    end
+
     def initialize(module_name = HaveAPI.module_name)
       @module_name = module_name
       @allowed_headers = ['Content-Type']
@@ -176,6 +199,7 @@ module HaveAPI
         end
 
         helpers ServerHelpers
+        helpers DocHelpers
 
         before do
           @formatter = OutputFormatter.new

data/lib/haveapi/version.rb

@@ -1,4 +1,4 @@
 module HaveAPI
   PROTOCOL_VERSION = '2.0'
-  VERSION = '0.13.1'
+  VERSION = '0.14.1'
 end

data/lib/haveapi/views/version_page/auth_body.erb

@@ -0,0 +1,48 @@
+<h2 id="auth-<%= name %>"><%= name.to_s.humanize %></h2>
+<hr>
+
+<p><%= info[:description] %></p>
+
+<% if name == :token %>
+  <dl>
+    <dt>HTTP header:</dt>
+    <dd><%= info[:http_header] %></dd>
+    <dt>Query parameter:</dt>
+    <dd><%= info[:query_parameter] %></dd>
+  </dl>
+<% end %>
+
+<% if info[:resources] %>
+  <h2>Resources</h2>
+  <% sort_hash(info[:resources]).each do |resource, desc| %>
+    <%= erb :"version_page/resource_body", locals: {resource: resource.to_s, info: desc, path: [], prefix: 'root', name: nil} %>
+  <% end %>
+<% end %>
+
+<% baseid = "auth-#{name}" %>
+<div id="<%= baseid %>-tabbar"></div>
+
+<div id="<%= baseid %>-examples">
+  <% HaveAPI::ClientExample.clients.each_with_index do |client, i| %>
+    <div id="<%= "#{baseid}-#{i}" %>">
+      <%= erb :"version_page/client_auth", locals: {client: client, method: name, desc: info} %>
+    </div>
+  <% end %>
+</div>
+
+<script type="text/javascript">
+nojsTabs({
+  tabs: document.getElementById('<%= "#{baseid}-examples" %>'),
+  titleSelector: 'h4',
+  tabBar: document.getElementById('<%= "#{baseid}-tabbar" %>'),
+  hiddenClass: 'tab-hidden',
+  activeClass: 'active',
+  createElement: function (el) {
+    if (el.tagName == 'UL')
+      el.classList.add('nav', 'nav-tabs');
+
+    else if (el.tagName == 'LI')
+      el.setAttribute('role', 'presentation');
+  }
+});
+</script>

data/lib/haveapi/views/version_page/client_auth.erb

@@ -0,0 +1,2 @@
+<h4><%= client.label %></h4>
+<pre><code class="<%= client.code %>"><%= client.auth(host, base_url, api_version, method, desc) %></code></pre>

data/lib/haveapi/views/version_page/client_example.erb

@@ -0,0 +1,11 @@
+<h6><%= client.label %></h6>
+<% sample = client.new(host, base_url, api_version, r_name, resource, a_name, action) %>
+<% if sample.respond_to?(:example) %>
+  <pre><code class="<%= client.code %>"><%= sample.example(example) %></code></pre>
+
+<% else %>
+  <h6>Request</h6>
+  <pre><code class="<%= client.code %>"><%= sample.request(example) %></code></pre>
+  <h6>Response</h6>
+  <pre><code class="<%= client.code %>"><%= sample.response(example) %></code></pre>
+<% end %>

data/lib/haveapi/views/version_page/client_init.erb

@@ -0,0 +1,2 @@
+<h4><%= client.label %></h4>
+<pre><code class="<%= client.code %>"><%= client.init(host, base_url, api_version) %></code></pre>

data/lib/haveapi/views/version_page/resource_body.erb

@@ -0,0 +1,163 @@
+<% name ||= resource.humanize %>
+<% resource_path = path.clone << resource %>
+<% resource_info = info %>
+<h2 class="resource" id="<%= "#{prefix}-#{resource}" %>"><%= resource.humanize %></h2>
+<hr>
+<div class="resource-body">
+  <p><%= info[:description] %></p>
+
+  <div class="actions">
+    <% sort_hash(info[:actions]).each do |action, info| %>
+      <h3 id="<%= "#{prefix}-#{resource}-#{action}" %>"><%= name %> # <%= action.capitalize %></h3>
+      <div class="action">
+        <dl>
+          <dt>Path:</dt>
+          <dd><%= info[:method] %> <%= info[:path] %></dd>
+          <dt>Description:</dt>
+          <dd><%= info[:description] %></dd>
+          <dt>Authentication required:</dt>
+          <dd><%= info[:auth] ? 'yes' : 'no' %></dd>
+          <dt>Aliases:</dt>
+          <dd><%= info[:aliases].join(', ') %></dd>
+          <dt>Blocking:</dt>
+          <dd><%= info[:blocking] ? 'yes' : 'no' %></dd>
+        </dl>
+
+        <h4>Input parameters</h4>
+        <div class="parameters">
+          <% if info[:input][:parameters].empty? %>
+            <p>No parameters.</p>
+          <% else %>
+            <dl>
+              <dt>Layout:</dt>
+              <dd><%= info[:input][:layout] %></dd>
+              <dt>Namespace:</dt>
+              <dd><%= info[:input][:namespace] %></dd>
+            </dl>
+
+            <table class="table table-striped table-hover table-bordered">
+              <tr>
+                <th>Label</th>
+                <th>Name</th>
+                <th>Required</th>
+                <th>Type</th>
+                <th>Validators</th>
+                <th>Default</th>
+                <th>Description</th>
+              </tr>
+              <% info[:input][:parameters].each do |param, info| %>
+                <tr>
+                  <td><%= info[:label] %></td>
+                  <td><%= param %></td>
+                  <td><%= info[:required] ? 'yes' : 'no' %></td>
+                  <td><%= format_param_type(info) %></td>
+                  <td><%= format_validators(info[:validators]) %></td>
+                  <td><%= info[:default] == :_nil ? '' : info[:default] %></td>
+                  <td><%= info[:description] %></td>
+                </tr>
+              <% end %>
+            </table>
+          <% end %>
+        </div>
+
+        <h4>Output parameters</h4>
+        <div class="parameters">
+          <% if info[:output][:parameters].empty? && info[:output][:format].nil? %>
+            <p>No parameters.</p>
+          <% else %>
+            <dl>
+              <dt>Layout:</dt>
+              <dd><%= info[:output][:layout] %></dd>
+              <dt>Namespace:</dt>
+              <dd><%= info[:output][:namespace] %></dd>
+            </dl>
+
+            <table class="table table-striped table-hover table-bordered">
+              <tr>
+                <th>Label</th>
+                <th>Name</th>
+                <th>Type</th>
+                <th>Description</th>
+              </tr>
+              <% info[:output][:parameters].each do |param, info| %>
+                <tr>
+                  <td><%= info[:label] %></td>
+                  <td><%= param %></td>
+                  <td><%= format_param_type(info) %></td>
+                  <td><%= info[:description] %></td>
+                </tr>
+              <% end %>
+            </table>
+          <% end %>
+        </div>
+
+        <div class="action-self-description">
+          <h4>Self-description</h4>
+          <pre><code><%= JSON.pretty_generate(info) %></code></pre>
+        </div>
+
+        <% unless info[:examples].empty? %>
+          <h4>Examples</h4>
+          <% info[:examples].each_with_index do |example, i| %>
+              <h5><%= example[:title].empty? ? "Example ##{i}" : example[:title] %></h5>
+              <p><%= example[:comment] %></p>
+
+              <% baseid = "example-#{resource_path.join('.')}-#{action}-#{i}" %>
+              <%# placeholder for tabs %>
+              <div id="<%= "#{baseid}-tabbar" %>"></div>
+
+              <div id="<%= "#{baseid}-examples" %>">
+                <% HaveAPI::ClientExample.clients.each_with_index do |client, j| %>
+                  <div id="<%= "#{baseid}-#{j}" %>">
+                    <%=
+                      erb :"version_page/client_example", locals: {
+                        client: client,
+                        r_name: resource_path,
+                        resource: resource_info,
+                        a_name: action,
+                        action: info,
+                        example: example,
+                      }
+                    %>
+                  </div>
+                <% end %>
+              </div>
+
+              <script type="text/javascript">
+              nojsTabs({
+                tabs: document.getElementById('<%= "#{baseid}-examples" %>'),
+                titleSelector: 'h6',
+                tabBar: document.getElementById('<%= "#{baseid}-tabbar" %>'),
+                hiddenClass: 'tab-hidden',
+                activeClass: 'active',
+                createElement: function (el) {
+                  if (el.tagName == 'UL')
+                    el.classList.add('nav', 'nav-tabs');
+
+                  else if (el.tagName == 'LI')
+                    el.setAttribute('role', 'presentation');
+                }
+              });
+              </script>
+          <% end %>
+        <% end %>
+
+      </div>
+    <% end %>
+  </div>
+
+  <% unless info[:resources].empty? %>
+    <% sort_hash(info[:resources]).each do |r, i| %>
+      <%=
+        erb :"version_page/resource_body", locals: {
+          resource: r,
+          info: i,
+          path: resource_path,
+          prefix: "#{prefix}-#{resource}",
+          name: "#{name}.#{r.humanize}",
+        }
+      %>
+    <% end %>
+  <% end %>
+
+</div> <!-- resource -->

data/lib/haveapi/views/version_page.erb

@@ -1,260 +1,3 @@
-<%
-def format_param_type(param)
-  return param[:type] if param[:type] != 'Resource'
-  "<a href=\"#root-#{param[:resource].join('-')}-show\">#{param[:type]}</a>"
-end
-
-def format_validators(validators)
-  ret = ''
-  return ret if validators.nil?
-
-  validators.each do |name, opts|
-    ret += "<h5>#{name.to_s.capitalize}</h5>"
-    ret += '<dl>'
-    opts.each do |k, v|
-      ret += "<dt>#{k}</dt><dd>#{v}</dd>"
-    end
-    ret += '</dl>'
-  end
-
-  ret
-end
-%>
-
-<% def render_auth_body(name, info) %>
-  <h2 id="auth-<%= name %>"><%= name.to_s.humanize %></h2>
-  <hr>
-
-  <p><%= info[:description] %></p>
-
-  <% if name == :token %>
-    <dl>
-      <dt>HTTP header:</dt>
-      <dd><%= info[:http_header] %></dd>
-      <dt>Query parameter:</dt>
-      <dd><%= info[:query_parameter] %></dd>
-    </dl>
-  <% end %>
-
-  <% if info[:resources] %>
-    <h2>Resources</h2>
-    <% sort_hash(info[:resources]).each do |resource, desc| %>
-      <% render_resource_body(resource.to_s, desc, 'auth') %>
-    <% end %>
-  <% end %>
-
-  <% baseid = "auth-#{name}" %>
-  <div id="<%= baseid %>-tabbar"></div>
-
-  <div id="<%= baseid %>-examples">
-    <% HaveAPI::ClientExample.clients.each_with_index do |client, i| %>
-      <div id="<%= "#{baseid}-#{i}" %>">
-        <% render_client_auth(client, name, info) %>
-      </div>
-    <% end %>
-  </div>
-
-  <script type="text/javascript">
-  nojsTabs({
-    tabs: document.getElementById('<%= "#{baseid}-examples" %>'),
-    titleSelector: 'h4',
-    tabBar: document.getElementById('<%= "#{baseid}-tabbar" %>'),
-    hiddenClass: 'tab-hidden',
-    activeClass: 'active',
-    createElement: function (el) {
-      if (el.tagName == 'UL')
-        el.classList.add('nav', 'nav-tabs');
-
-      else if (el.tagName == 'LI')
-        el.setAttribute('role', 'presentation');
-    }
-  });
-  </script>
-<% end %>
-
-<% def render_resource_body(resource, info, path = [], prefix='root', name=nil) %>
-  <% name ||= resource.humanize %>
-  <% resource_path = path.clone << resource %>
-  <% resource_info = info %>
-  <h2 class="resource" id="<%= "#{prefix}-#{resource}" %>"><%= resource.humanize %></h2>
-  <hr>
-  <div class="resource-body">
-    <p><%= info[:description] %></p>
-
-    <div class="actions">
-      <% sort_hash(info[:actions]).each do |action, info| %>
-        <h3 id="<%= "#{prefix}-#{resource}-#{action}" %>"><%= name %> # <%= action.capitalize %></h3>
-        <div class="action">
-          <dl>
-            <dt>Path:</dt>
-            <dd><%= info[:method] %> <%= info[:path] %></dd>
-            <dt>Description:</dt>
-            <dd><%= info[:description] %></dd>
-            <dt>Authentication required:</dt>
-            <dd><%= info[:auth] ? 'yes' : 'no' %></dd>
-            <dt>Aliases:</dt>
-            <dd><%= info[:aliases].join(', ') %></dd>
-            <dt>Blocking:</dt>
-            <dd><%= info[:blocking] ? 'yes' : 'no' %></dd>
-          </dl>
-
-          <h4>Input parameters</h4>
-          <div class="parameters">
-            <% if info[:input][:parameters].empty? %>
-              <p>No parameters.</p>
-            <% else %>
-              <dl>
-                <dt>Layout:</dt>
-                <dd><%= info[:input][:layout] %></dd>
-                <dt>Namespace:</dt>
-                <dd><%= info[:input][:namespace] %></dd>
-              </dl>
-
-              <table class="table table-striped table-hover table-bordered">
-                <tr>
-                  <th>Label</th>
-                  <th>Name</th>
-                  <th>Required</th>
-                  <th>Type</th>
-                  <th>Validators</th>
-                  <th>Default</th>
-                  <th>Description</th>
-                </tr>
-                <% info[:input][:parameters].each do |param, info| %>
-                  <tr>
-                    <td><%= info[:label] %></td>
-                    <td><%= param %></td>
-                    <td><%= info[:required] ? 'yes' : 'no' %></td>
-                    <td><%= format_param_type(info) %></td>
-                    <td><%= format_validators(info[:validators]) %></td>
-                    <td><%= info[:default] == :_nil ? '' : info[:default] %></td>
-                    <td><%= info[:description] %></td>
-                  </tr>
-                <% end %>
-              </table>
-            <% end %>
-          </div>
-
-          <h4>Output parameters</h4>
-          <div class="parameters">
-            <% if info[:output][:parameters].empty? && info[:output][:format].nil? %>
-              <p>No parameters.</p>
-            <% else %>
-              <dl>
-                <dt>Layout:</dt>
-                <dd><%= info[:output][:layout] %></dd>
-                <dt>Namespace:</dt>
-                <dd><%= info[:output][:namespace] %></dd>
-              </dl>
-
-              <table class="table table-striped table-hover table-bordered">
-                <tr>
-                  <th>Label</th>
-                  <th>Name</th>
-                  <th>Type</th>
-                  <th>Description</th>
-                </tr>
-                <% info[:output][:parameters].each do |param, info| %>
-                  <tr>
-                    <td><%= info[:label] %></td>
-                    <td><%= param %></td>
-                    <td><%= format_param_type(info) %></td>
-                    <td><%= info[:description] %></td>
-                  </tr>
-                <% end %>
-              </table>
-            <% end %>
-          </div>
-
-          <div class="action-self-description">
-            <h4>Self-description</h4>
-            <pre><code><%= JSON.pretty_generate(info) %></code></pre>
-          </div>
-
-          <% unless info[:examples].empty? %>
-            <h4>Examples</h4>
-            <% info[:examples].each_with_index do |example, i| %>
-                <h5><%= example[:title].empty? ? "Example ##{i}" : example[:title] %></h5>
-                <p><%= example[:comment] %></p>
-
-                <% baseid = "example-#{resource_path.join('.')}-#{action}-#{i}" %>
-                <%# placeholder for tabs %>
-                <div id="<%= "#{baseid}-tabbar" %>"></div>
-
-                <div id="<%= "#{baseid}-examples" %>">
-                  <% HaveAPI::ClientExample.clients.each_with_index do |client, j| %>
-                    <div id="<%= "#{baseid}-#{j}" %>">
-                      <%
-                        render_client_example(
-                          client,
-                          resource_path,
-                          resource_info,
-                          action,
-                          info,
-                          example
-                        )
-                      %>
-                    </div>
-                  <% end %>
-                </div>
-
-                <script type="text/javascript">
-                nojsTabs({
-                  tabs: document.getElementById('<%= "#{baseid}-examples" %>'),
-                  titleSelector: 'h6',
-                  tabBar: document.getElementById('<%= "#{baseid}-tabbar" %>'),
-                  hiddenClass: 'tab-hidden',
-                  activeClass: 'active',
-                  createElement: function (el) {
-                    if (el.tagName == 'UL')
-                      el.classList.add('nav', 'nav-tabs');
-
-                    else if (el.tagName == 'LI')
-                      el.setAttribute('role', 'presentation');
-                  }
-                });
-                </script>
-            <% end %>
-          <% end %>
-
-        </div>
-      <% end %>
-    </div>
-
-    <% unless info[:resources].empty? %>
-      <% sort_hash(info[:resources]).each do |r, i| %>
-        <% render_resource_body(r, i, resource_path, "#{prefix}-#{resource}", "#{name}.#{r.humanize}") %>
-      <% end %>
-    <% end %>
-
-  </div> <!-- resource -->
-<% end %>
-
-<% def render_client_init(client) %>
-  <h4><%= client.label %></h4>
-  <pre><code class="<%= client.code %>"><%= client.init(host, base_url, api_version) %></code></pre>
-<% end %>
-
-<% def render_client_auth(client, method, desc) %>
-  <h4><%= client.label %></h4>
-  <pre><code class="<%= client.code %>"><%= client.auth(host, base_url, api_version, method, desc) %></code></pre>
-<% end %>
-
-<% def render_client_example(client, r_name, resource, a_name, action, example) %>
-  <h6><%= client.label %></h6>
-  <% sample = client.new(host, base_url, api_version, r_name, resource, a_name, action) %>
-  <% if sample.respond_to?(:example) %>
-    <pre><code class="<%= client.code %>"><%= sample.example(example) %></code></pre>
-
-  <% else %>
-    <h6>Request</h6>
-    <pre><code class="<%= client.code %>"><%= sample.request(example) %></code></pre>
-    <h6>Response</h6>
-    <pre><code class="<%= client.code %>"><%= sample.response(example) %></code></pre>
-  <% end %>
-<% end %>
-
-
 <h1 id="api">API v<%= @v %></h1>
 
 <ol class="breadcrumb">
@@ -295,7 +38,7 @@ end
 <div id="init-examples">
   <% HaveAPI::ClientExample.clients.each_with_index do |client, i| %>
     <div id="<%= "init-#{i}" %>">
-      <% render_client_init(client) %>
+      <%= erb :"version_page/client_init", locals: {client: client} %>
     </div>
   <% end %>
 </div>
@@ -319,14 +62,22 @@ nojsTabs({
 
 <h1 id="auth">Authentication methods</h1>
 <% @help[:authentication].each do |name, info| %>
-    <% render_auth_body(name, info) %>
+  <%= erb :"version_page/auth_body", locals: {name: name, info: info} %>
 <% end %>
 
 <h1 id="resources">Resources</h1>
 <p>Follows a list of all resources in this API and their actions.</p>
 
 <% sort_hash(@help[:resources]).each do |resource, info| %>
-    <% render_resource_body(resource, info) %>
+  <%=
+    erb :"version_page/resource_body", locals: {
+      resource: resource,
+      info: info,
+      path: [],
+      prefix: 'root',
+      name: nil,
+    }
+  %>
 <% end %>
 </div>
 

data/lib/haveapi/views/version_sidebar/auth_nav.erb

@@ -0,0 +1,20 @@
+<ul>
+  <% methods.each do |method, info| %>
+    <li>
+      <a href="#auth-<%= method %>"><%= method.to_s.humanize %></a>
+      <% if info[:resources] %>
+        <ul>
+          <% sort_hash(info[:resources]).each do |resource, info| %>
+            <%=
+              erb :"version_sidebar/resource_nav", locals: {
+                resource: resource.to_s,
+                info: info,
+                prefix: "auth-#{method}",
+              }
+            %>
+          <% end %>
+        </ul>
+      <% end %>
+    </li>
+  <% end %>
+</ul>

data/lib/haveapi/views/version_sidebar/resource_nav.erb

@@ -0,0 +1,21 @@
+<li>
+  <a href="#<%= "#{prefix}-#{resource}" %>">.<%= resource.humanize %></a>
+
+  <ul>
+    <% sort_hash(info[:actions]).each do |action, info| %>
+      <li>
+        <a href="#<%= "#{prefix}-#{resource}-#{action}" %>">#<%= action.capitalize %></a>
+      </li>
+    <% end %>
+
+    <% sort_hash(info[:resources]).each do |r, i| %>
+      <%=
+        erb :"version_sidebar/resource_nav", locals: {
+          resource: r,
+          info: i,
+          prefix: "#{prefix}-#{resource}",
+        }
+      %>
+    <% end %>
+  </ul>
+</li>

data/lib/haveapi/views/version_sidebar.erb

@@ -1,38 +1,3 @@
-<% def render_auth_nav(methods) %>
-  <ul>
-    <% methods.each do |method, info| %>
-      <li>
-        <a href="#auth-<%= method %>"><%= method.to_s.humanize %></a>
-        <% if info[:resources] %>
-          <ul>
-            <% sort_hash(info[:resources]).each do |resource, info| %>
-              <% render_resource_nav(resource.to_s, info, "auth-#{method}") %>
-            <% end %>
-          </ul>
-        <% end %>
-      </li>
-    <% end %>
-  </ul>
-<% end %>
-
-<% def render_resource_nav(resource, info, prefix='root') %>
-    <li>
-      <a href="#<%= "#{prefix}-#{resource}" %>">.<%= resource.humanize %></a>
-
-      <ul>
-        <% sort_hash(info[:actions]).each do |action, info| %>
-            <li>
-              <a href="#<%= "#{prefix}-#{resource}-#{action}" %>">#<%= action.capitalize %></a>
-            </li>
-        <% end %>
-
-        <% sort_hash(info[:resources]).each do |r, i| %>
-            <% render_resource_nav(r, i, "#{prefix}-#{resource}") %>
-        <% end %>
-      </ul>
-    </li>
-<% end %>
-
 <h1>Authentication</h1>
 <p class="authentication">
   <% if current_user %>
@@ -54,11 +19,17 @@
   <li><a href="#api">API v<%= @v %></a></li>
   <li>
     <a href="#auth">Authentication</a>
-    <% render_auth_nav(@help[:authentication]) %>
+    <%= erb :"version_sidebar/auth_nav", locals: {methods: @help[:authentication]} %>
   </li>
   <li><a href="#resources">Resources</a></li>
-  <% sort_hash(@help[:resources]).each do |resource, info| %>
-      <% render_resource_nav(resource, info) %>
+    <% sort_hash(@help[:resources]).each do |resource, info| %>
+      <%=
+        erb :"version_sidebar/resource_nav", locals: {
+          resource: resource,
+          info: info,
+          prefix: 'root',
+        }
+      %>
   <% end %>
 </ul>
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: haveapi
 version: !ruby/object:Gem::Version
-  version: 0.13.1
+  version: 0.14.1
 platform: ruby
 authors:
 - Jakub Skokan
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-05-20 00:00:00.000000000 Z
+date: 1980-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: require_all
@@ -58,42 +58,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 2.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 2.1.0
 - !ruby/object:Gem::Dependency
   name: tilt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.9
+        version: 2.0.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.9
+        version: 2.0.10
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.4'
+        version: '3.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.4'
+        version: '3.5'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -142,14 +142,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.13.1
+        version: 0.14.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.13.1
+        version: 0.14.1
 - !ruby/object:Gem::Dependency
   name: mail
   requirement: !ruby/object:Gem::Requirement
@@ -268,7 +268,14 @@ files:
 - lib/haveapi/views/index.erb
 - lib/haveapi/views/main_layout.erb
 - lib/haveapi/views/version_page.erb
+- lib/haveapi/views/version_page/auth_body.erb
+- lib/haveapi/views/version_page/client_auth.erb
+- lib/haveapi/views/version_page/client_example.erb
+- lib/haveapi/views/version_page/client_init.erb
+- lib/haveapi/views/version_page/resource_body.erb
 - lib/haveapi/views/version_sidebar.erb
+- lib/haveapi/views/version_sidebar/auth_nav.erb
+- lib/haveapi/views/version_sidebar/resource_nav.erb
 - shell.nix
 - spec/action/dsl_spec.rb
 - spec/authorization_spec.rb
@@ -289,11 +296,11 @@ files:
 - spec/validators/length_spec.rb
 - spec/validators/numericality_spec.rb
 - spec/validators/presence_spec.rb
-homepage: 
+homepage:
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -308,9 +315,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
-signing_key: 
+rubygems_version: 3.2.26
+signing_key:
 specification_version: 4
 summary: Framework for creating self-describing APIs
 test_files: []