rspec-apidoc 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf1ff0187b5a8c5f96fb7fb0defbe0db044ba5cfff1935c02d4d6117903921d8
-  data.tar.gz: 1148d0d99ad0515247f98553e7fe1e4652f62bc0f363f07016e80e7229993753
+  metadata.gz: 8700f45112bb1c1a6a8ca9770020b00c5e1887e673e4353b305ecc66f89f5d70
+  data.tar.gz: 9ce1fb0139b48f53dce57b0f51728ddcbf58546b64c99105437dc9b637bdf5ee
 SHA512:
-  metadata.gz: 581a39046185cf4ad93da1d5a42c8cb9f15a088971570d2331d3ff57cfd58a54a55cb658ac8cffdad8207598adfa6c281b684e3171d5b74a6fc5e2148d46d13a
-  data.tar.gz: 8000c199ef6ddaf9832183d7e1b11984f018d0f20d0126ed8df809319cdd49a063356e6030440986ebe56f563af5c6c135679f838fa58acaeeee1e117f727198
+  metadata.gz: 617d0a747bb1977de943ec794fde2c4975bc5058d93c5e6cdd1ae88a8075e24c20db6b187b3d8fb59661961974555305c50ace0558662697103bb60c3feab20c
+  data.tar.gz: 0c82c4f051092f3517279e1c5d4ca0cd4e7eaae8471dfe81b8240bad3517d0d023965e129cf0fb169d6df5b372cd23d7fa8d8b4b88f695ccceef35a85b1bac2e

data/README.md

@@ -47,12 +47,17 @@ RSpec.configure do |config|
 
   config.apidoc_title = 'YOUR.APP API Documentation'
   config.apidoc_description = \
-    'A longer intro to add before the examples: authtication, status codes...'
+    'A longer intro to add before the examples: authentication, status codes...'
 
   config.apidoc_host = 'https://api.YOUR.APP'
   # Optionally specify the output file path.
   config.apidoc_output_filename = 'apidoc.html'
 
+  # Customize the authentication header
+  config.apidoc_auth_header = lambda do |headers|
+    '"Authorization: Bearer $AUTH_TOKEN"' if headers['Authorization']
+  end
+
   # You can add it to any example based on the metadata.
   config.after(:each, type: :request) do |example|
     RSpec::Apidoc.add(self, example)

data/lib/rspec/apidoc/static/template.html.erb

@@ -92,12 +92,12 @@
         <% examples.each do |controller, items| %>
           <% items.sort.each_with_index do |(action, action_items), mindex| %>
             <% action_items.each_with_index do |item, index| %>
-              <div class="example">
+              <div class="example" id="<%= controller %>-<%= action %>-<%= mindex + index %>">
                 <% if mindex == 0 %>
                   <%= item[:controller_comment] %>
                 <% end %>
 
-                <% if index == 0 %>
+                <% if mindex == 0 && index == 0 %>
                   <div class="example-doc" id="<%= controller %>-<%= action %>">
                     <%= item[:action_comment] || ( item[:method] + ' ' + controller ) %>
                   </div>
@@ -108,15 +108,20 @@
                   <div class="request">
                     <span>Request</span>
                     <pre>
-$ curl '<%= host %><%= item[:path] %><%= ('?' + item[:query]) if item[:query] != '' %>' \
-  -X <%= item[:method] %> \
-  -H 'Content-Type: <%= item[:content_type] %>' <% if item[:request_body] != '' %> \
-  @- &lt;&lt; EOF
-<% if item[:request_body].is_a?(String) %>
-<%=h item[:request_body] %>
+$ curl -X <%= item[:method] %> '<%= host %><%= item[:path] %><%= ('?' + item[:query]) if item[:query] != '' %>' \
+<%- if item[:auth_header] -%>
+  -H <%= item[:auth_header] %> <%- if item[:content_type] %>\<% end %>
+<%- end -%>
+<%- if item[:content_type] -%>
+  -H 'Content-Type: <%= item[:content_type] %>'  <%- if item[:request_body] %>\<% end %>
+<%- end -%>
+<%- if item[:request_body] != '' -%>
+  -d - &lt;&lt; EOF
+<% if item[:request_body].is_a?(String) -%>
+<%=h item[:request_body] -%>
 <% else %>
 <%=h JSON.pretty_generate(item[:request_body]) %>
-<% end %>
+<%- end %>
 EOF
         <% end %>
                     </pre>
@@ -124,14 +129,14 @@ EOF
                   <div class="response">
                     <span>Response</span>
                     <pre>
-&lt; Content-Type: <%= item[:response_content_type] %>
+&lt; Content-Type: <%= item[:response_content_type] -%>
 &lt; Status: <%= item[:status] %>
 
-<% if item[:response_body].is_a?(String) %>
-<%=h item[:response_body] %>
+<% if item[:response_body].is_a?(String) -%>
+<%=h item[:response_body] -%>
 <% else %>
-<%=h JSON.pretty_generate(item[:response_body]) %>
-<% end %>
+<%=h JSON.pretty_generate(item[:response_body]) -%>
+<%- end -%>
                     </pre>
                   </div>
                 </div>
@@ -148,6 +153,9 @@ EOF
     </div>
     <div class="footer">
       &copy; <%= Date.current.year %> <%= title %>
+      <p>
+        <small>Latest update at <%= DateTime.current.to_s %></small>
+      </p>
     </div>
   </body>
 </html>

data/lib/rspec/apidoc.rb

@@ -13,6 +13,7 @@ module RSpec
     config.add_setting(:apidoc_title)
     config.add_setting(:apidoc_description)
     config.add_setting(:apidoc_host)
+    config.add_setting(:apidoc_auth_header, default: ->(headers) {})
     config.add_setting(
       :apidoc_template_path,
       default: File.expand_path('apidoc/static/template.html.erb', __dir__)
@@ -65,6 +66,14 @@ module RSpec
       RSpec.configuration.apidoc_host
     end
 
+    # Returns the API authentication header callback result
+    #
+    # @param headers [ActionDispatch::Http::Headers] object
+    # @return [Object]
+    def self.auth_header(headers)
+      RSpec.configuration.apidoc_auth_header.call(headers)
+    end
+
     # Returns the collected examples, sorted
     #
     # @return [Array] a list of [Hash] items
@@ -111,6 +120,7 @@ module RSpec
         action_comment: action_comment,
 
         content_type: spec.request.content_type,
+        auth_header: auth_header(spec.request.headers),
         method: spec.request.method,
         path: spec.request.path,
         query: spec.request.query_parameters.to_param,
@@ -153,7 +163,7 @@ module RSpec
     def close(_notification)
       return if examples.empty?
 
-      erb = ERB.new(File.read(template_path))
+      erb = ERB.new(File.read(template_path), trim_mode: '-')
       File.write(output_filename, erb.result(self.binding))
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rspec-apidoc
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Stas Suscov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-11-03 00:00:00.000000000 Z
+date: 2021-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: method_source