explicit 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46f92f599374b50a6ff4dcf044fadac51b9bf12d8f7c18b3f9bd1b39124be855
-  data.tar.gz: a9ec574ef2a8a6f3b0892994037fb7c19522af6afcaf4583933b8774b3ea2321
+  metadata.gz: b817ec6fe610ab86d5938a0b7958633f4f34e68a4d02b9bd8c8a50bf831622bc
+  data.tar.gz: 8cb2aae4e5a1d582734b6e1f4a917f0b07b4cf4839932dd1e2a5754f3320663b
 SHA512:
-  metadata.gz: dafc5889a7c3a33a772f9c3eac434e24ce7424e1cdd0e9c8f24f859fa6a3f5143fd631546f40d7705e69a14b68b75cc7314c1420bdadda791ca57eb6f132dc5d
-  data.tar.gz: 9a03258778b8b0b7fd0b928c7414c8599f2d6e324dcd45b8284c8f6dc89cf4dce027942201f9c03237c24c96df3e7a124e798e8a30de38f9520b82cd11b0a87d
+  metadata.gz: 1e385f89b47ec351fb000f5b9097d5ccf6233ac01dd57b9e07e87ac9488718528655ef7033686dc482dd9fc9812063f64c1f79313492157dd3ecad63055ff01b
+  data.tar.gz: 5fefc99c8c881d334364102f17e9cab4247bf0486dd5744e041654e83354e2b0265dbfaf2f41f185b354370356c33823c036b13fc2010db459e998ae0ba436ef

data/README.md

@@ -255,6 +255,8 @@ documentation for your API. The following methods are available:
 
 - `page_title(text)` - Sets the web page title.
 - `company_logo_url(url)` - Shows the company logo in the navigation menu.
+  The url can also be a lambda that returns the url, useful for referencing
+  assets at runtime.
 - `favicon_url(url)` - Adds a favicon to the web page.
 - `version(semver)` - Sets the version of the API. Default: "1.0"
 - `section(name, &block)` - Adds a section to the navigation menu.

data/lib/explicit/documentation/builder.rb

@@ -59,6 +59,7 @@ module Explicit::Documentation
 
     def merge_request_examples_from_file!
       return if !Explicit.configuration.request_examples_file_path
+      return if !::File.exist?(Explicit.configuration.request_examples_file_path)
 
       encoded = ::File.read(Explicit.configuration.request_examples_file_path)
 

data/lib/explicit/documentation/output/webpage.rb

@@ -19,15 +19,17 @@ module Explicit::Documentation::Output
     end
 
     private
+      Eval = ->(value) { value.respond_to?(:call) ? value.call : value }
+
       def render_documentation_page
         Explicit::ApplicationController.render(
           partial: "explicit/documentation/page",
           locals: {
             url_helpers: @builder.rails_engine.routes.url_helpers,
-            page_title: builder.get_page_title,
-            company_logo_url: builder.get_company_logo_url,
-            favicon_url: builder.get_favicon_url,
-            version: builder.get_version,
+            page_title: Eval[builder.get_page_title],
+            company_logo_url: Eval[builder.get_company_logo_url],
+            favicon_url: Eval[builder.get_favicon_url],
+            version: Eval[builder.get_version],
             sections: builder.sections,
           }
         )

data/lib/explicit/test_helper.rb

@@ -50,9 +50,13 @@ module Explicit::TestHelper
     end
 
     method = route.method
+    path = (request.get_base_path || "") + route.replace_path_params(params)
 
-    path = (request.get_base_path || "") + route.path
-    path = path.gsub(/:(\w+)/) { params.delete($1.to_sym).to_s }
+    if missing_path_param?(route, params)
+      raise <<~DESC
+        The request #{route} needs the following path parameters: #{route.params.join(", ")}
+      DESC
+    end
 
     process(method, path, params:, headers:)
 
@@ -90,6 +94,10 @@ module Explicit::TestHelper
     response
   end
 
+  def missing_path_param?(route, params)
+    route.params.any? { params.fetch(_1, nil).nil? }
+  end
+
   def ensure_response_matches_documented_type!(request, response)
     responses_type = request.responses_type(status: response.status)
 

data/lib/explicit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Explicit
-  VERSION = "0.2.6"
+  VERSION = "0.2.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: explicit
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - Luiz Vasconcellos