api-regulator 0.1.24 → 0.1.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b4abd774431dfae284e9714ed72d84799e40d8c86e9b154aaa6827c75abb057
-  data.tar.gz: 8714012268076ad42e78a64cfb1e4d556cce657e97451f2a7552c8b271027718
+  metadata.gz: a9d490065a7ecefa7103daa60c7baaa858d36baf23f5f4458713307ed3f196d8
+  data.tar.gz: 12fca76002d7a1dfb68318c372d8248ccd3bcb49d37db02eff42743bb721345c
 SHA512:
-  metadata.gz: 7db24c6a9040d526d05be3686e5e66bfe367d281665f7fa209a8d202d93bc9d0bb1725c750ccb0cedd4e73768206d207729a1d87362eba7fbdb5b5a4cf791641
-  data.tar.gz: e89a9066ceac3b1d082fc82150550a7aaaea20bb617188b772009e3aa14218e17fceebe67213ad8e2837ad94992ca5278abd595b8de53c1357f4e481f1f6ad3e
+  metadata.gz: 4890734557bcf61f41cc049cccf85faa09e8f9d8f76534efbba9409eb22e46bc6c030bee3c900029361f3418387c0762792120aa96af03061de046b35c979c4e
+  data.tar.gz: cb73bb660740be6f0c1efde659db26dbf576cf009f5fbe16f19d5ad10cf763b7e5aa443f1c6dfb5743e02b221c7a48077ddf7ff98797243632208cda4fe39835

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    api-regulator (0.1.24)
+    api-regulator (0.1.26)
       activemodel (~> 8.0)
       activesupport (~> 8.0)
 

data/lib/api_regulator/api.rb

@@ -1,6 +1,7 @@
 module ApiRegulator
   class Api
-    attr_reader :controller_class, :controller_path, :controller_name, :action_name, :description, :title, :params, :responses, :versions
+    attr_reader :controller_class, :controller_path, :controller_name, :action_name, :description,
+      :title, :params, :responses, :versions, :examples
 
     def initialize(controller_class, action_name, desc: nil, title: nil, versions: [], &block)
       @controller_class = controller_class
@@ -56,6 +57,12 @@ module ApiRegulator
       end
     end
 
+    def example(name, value, default: false)
+      @examples ||= {}
+      @examples[name] = { summary: "#{name} Example", value: value }
+      @default_example = value if default
+    end
+
     def path
       rails_route.path.spec.to_s
         .sub("(.:format)", "")   # Remove optional format

data/lib/api_regulator/open_api_generator.rb

@@ -75,7 +75,7 @@ module ApiRegulator
       params = api.params.select(&:body?)
       return {} if params.empty?
 
-      {
+      body = {
         required: true,
         content: {
           'application/json' => {
@@ -83,6 +83,9 @@ module ApiRegulator
           }
         }
       }
+
+      body[:content]['application/json'][:examples] = api.examples unless api.examples.blank?
+      body
     end
 
     def expand_nested_params(params)
@@ -137,8 +140,9 @@ module ApiRegulator
         generate_param_schema(param)
           .merge({
             name: param.name,
-            required: param.path? || param.required? || false
-          })
+            required: param.path? || param.required? || false,
+            examples: param.examples.presence
+          }).compact
       end
     end
 

data/lib/api_regulator/param.rb

@@ -12,6 +12,7 @@ module ApiRegulator
       @api = options.delete(:api)
       @allow_arbitrary_keys = options.delete(:allow_arbitrary_keys) || false
       @versions = Array(options.delete(:versions)).map(&:to_sym)
+      @examples = options.delete(:examples) || {}
 
       @children = []
       @options = options
@@ -151,5 +152,17 @@ module ApiRegulator
         type.to_s.downcase
       end
     end
+
+    def examples
+      return nil if @examples.blank?
+
+      @examples.each_with_object({}) do |(key, value), formatted_examples|
+        formatted_key = key.to_s.parameterize.underscore
+        formatted_examples[formatted_key] = {
+          summary: key.to_s,
+          value: value
+        }
+      end
+    end
   end
 end

data/lib/api_regulator/validator.rb

@@ -104,7 +104,9 @@ module ApiRegulator
         end
 
         # Store the nested class under the parent class namespace
-        parent_class.const_set(class_name, nested_validator_class)
+        silence_warnings do
+          parent_class.const_set(class_name, nested_validator_class)
+        end
         nested_validator_class
       end
     end
@@ -251,7 +253,9 @@ module ApiRegulator
       api_definitions.each do |api_definition|
         class_name = build_class_name(api_definition.controller_path, api_definition.action_name)
         validator_class = build_class(api_definition.params, api_definition.action_name)
-        Validator.const_set(class_name, validator_class)
+        silence_warnings do
+          Validator.const_set(class_name, validator_class)
+        end
       end
     end
 
@@ -260,7 +264,9 @@ module ApiRegulator
         api_definition.responses.each do |code, params|
           class_name = build_class_name(api_definition.controller_path, api_definition.action_name, code)
           validator_class = build_class(params.children, api_definition.action_name)
-          Validator.const_set(class_name, validator_class)
+          silence_warnings do
+            Validator.const_set(class_name, validator_class)
+          end
         end
       end
     end

data/lib/api_regulator/version.rb

@@ -1,3 +1,3 @@
 module ApiRegulator
-  VERSION = "0.1.24"
+  VERSION = "0.1.26"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: api-regulator
 version: !ruby/object:Gem::Version
-  version: 0.1.24
+  version: 0.1.26
 platform: ruby
 authors:
 - Geoff Massanek
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-03-06 00:00:00.000000000 Z
+date: 2025-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport