jsapi 1.1.1 → 1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5106832b9b6b3b6747fc83b4469176532e56a84d2fe1779cdad6e6e34d9da4b
-  data.tar.gz: 1d760c1fbb5556dfac42203ae05c483f2fcf99e3aa0c6bfc34c374d7093fbd0c
+  metadata.gz: 40ceeb6c8774b09bfb3fbfe2bc4550444a179158b43cac27d6f9923cead5971c
+  data.tar.gz: f6cc387571c73b93cdcc121c1c46267424a46362f4c400dee8bd53ec2e0af561
 SHA512:
-  metadata.gz: 3261a33d232a31b42f334d0ef13e36d5e0dd92c2863948fdcb54dee791e6580a2adf26c7fe1b0685837fb01d69cf3dc1b6f6f25557840c10c6ade65725ee6aaf
-  data.tar.gz: baaf0e9710ac6909ff970534f758a539835807d0e61515440759245960aac83e9477c231e42f48c03822a10e04afaaef19fbf3320972c303821f2e23aa4e4bfb
+  metadata.gz: 437497757705da6bfeddab26b70ab0e4df3b7abe11f78b4433f6b5576b783f8d576c0c3b2e6612b4e941d58136e965b705e5db37176f59ee672c58bf64e5bb42
+  data.tar.gz: d25820eec66069cba5bb25eb2a0c1cb262835a57ec60eef94199ab247332aa296ba5228ebf0a61c1bbc80c9b350aa19cfd2339cb11188c260973f3607cd6da5f

data/lib/jsapi/json/array.rb

@@ -20,6 +20,10 @@ module Jsapi
         "#<#{self.class.name} [#{@json_values.map(&:inspect).join(', ')}]>"
       end
 
+      def serializable_value(**options) # :nodoc:
+        @json_values.map { |element| element.serializable_value(**options) }
+      end
+
       def validate(errors) # :nodoc:
         return false unless super
 

data/lib/jsapi/json/object.rb

@@ -6,6 +6,8 @@ module Jsapi
     class Object < Value
       include Model::Nestable
 
+      alias serializable_value serializable_hash
+
       attr_reader :raw_additional_attributes, :raw_attributes
 
       def initialize(hash, schema, definitions, context: nil)

data/lib/jsapi/json/value.rb

@@ -29,6 +29,11 @@ module Jsapi
         false
       end
 
+      # Returns a serializable representation of +value+.
+      def serializable_value(**options)
+        options[:jsonify_values] == true ? value.as_json : value
+      end
+
       # Validates it against #schema. Returns true if it is valid, false otherwise.
       # Detected errors are added to +errors+.
       def validate(errors)

data/lib/jsapi/model/base.rb

@@ -25,7 +25,43 @@ module Jsapi
       extend ActiveModel::Translation
       include ActiveModel::Validations
 
-      delegate :[], :additional_attributes, :attribute?, :attributes, to: :@nested
+      ##
+      # :method: []
+      # :call-seq: [](name)
+      #
+      # Returns the value assigned to +name+.
+
+      ##
+      # :method: additional_attributes
+      #
+      # Returns a hash containing the additional attributes.
+
+      ##
+      # :method: attribute?
+      # :call-seq: attribute?(name)
+      #
+      # Returns +true+ if +name+ is present, +false+ otherwise.
+
+      ##
+      # :method: attributes
+      #
+      # Returns a hash containing all attributes.
+
+      ##
+      # :method: serializable_hash
+      # :call-seq: serializable_hash(**options)
+      #
+      # Returns a hash containing serializable representations of all attributes.
+      #
+      # Possible options are:
+      #
+      # - +:only+ - The hash contains the given attributes only.
+      # - +:except+ - The hash does not contain the given attributes.
+      # - +:symbolize_names+ - If set to true, keys are symbols.
+      # - +:jsonify_values+ - If set to true, values are converted by +as_json+.
+
+      delegate :[], :additional_attributes, :attribute?, :attributes,
+               :serializable_hash, to: :@nested
 
       validate :_nested_validity
 

data/lib/jsapi/model/nestable.rb

@@ -13,7 +13,7 @@ module Jsapi
         raw_additional_attributes.transform_values(&:value)
       end
 
-      # Returns +true+ if +name+ is present, false +otherwise+.
+      # Returns +true+ if +name+ is present, +false+ otherwise.
       def attribute?(name)
         raw_attributes.key?(name&.to_s)
       end
@@ -32,6 +32,32 @@ module Jsapi
         }>"
       end
 
+      # Returns a hash containing serializable representations of all attributes.
+      #
+      # Possible options are:
+      #
+      # - +:only+ - The hash contains the given attributes only.
+      # - +:except+ - The hash does not contain the given attributes.
+      # - +:symbolize_names+ - If set to true, keys are symbols.
+      # - +:jsonify_values+ - If set to true, values are converted by +as_json+.
+      def serializable_hash(**options)
+        options = options.dup
+        except = options.delete(:except)&.map(&:to_s)
+        only = options.delete(:only)&.map(&:to_s)
+        symbolize_names = options[:symbolize_names] == true
+
+        {}.tap do |hash|
+          [raw_attributes, raw_additional_attributes].each do |attributes|
+            attributes.each do |name, value|
+              next if except&.include?(name) || only&.exclude?(name)
+
+              name = name.to_sym if symbolize_names
+              hash[name] = value.serializable_value(**options)
+            end
+          end
+        end
+      end
+
       private
 
       def validate_attributes(errors)

data/lib/jsapi/version.rb

@@ -5,6 +5,6 @@ module Jsapi
     # NOTE: See https://bundler.io/guides/creating_gem.html
 
     # The current GEM version.
-    VERSION = '1.1.1'
+    VERSION = '1.2'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jsapi
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: '1.2'
 platform: ruby
 authors:
 - Denis Göller
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-19 00:00:00.000000000 Z
+date: 2025-08-30 00:00:00.000000000 Z
 dependencies: []
 description:
 email: denis@dmgoeller.de