datory 1.0.0.rc13 → 1.0.0.rc15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad1cc00d4916767ce4e99d5cd52cde2f9640c4ea536f602e0ade8e5008b61820
-  data.tar.gz: 012e57a2c905b6de960fb1cd32e1719f1f876c630cc77b37ea7e8ee31427dae8
+  metadata.gz: 7cf1723be06fbf81937c9e8e9b20cf1e37f3d70765dbfde943fc0e3640ab3c13
+  data.tar.gz: 90f48cba076d54721d8c03858016326a87c4b6c3dea2bcbabdff17ac7c69677e
 SHA512:
-  metadata.gz: 271166881cb4e4e5b673d05ed180b2a09e0523aab2739d9c8127894981b34d5d37486a74aaa029524f13dbb03206dbf924c96f7983f28a985738e41ae96b64f2
-  data.tar.gz: 0b5a6b6cbbf3db6f505ebf629ff33e2bd57f72d7840295cc35660fcba5f8ee497db538fb699b75a8db2676f6064bc67aa0533c78049dd958cb1a1e0573b6e559
+  metadata.gz: '0794e8bf0e3bbf898c595199207ecb6f833ab84b43450a493339c7a27f87577c3a4fdb43d48e2ab21f8a93c7cf49fdd55ca0e4182d18c89ad0a66bb613a2d0a5'
+  data.tar.gz: 8571cd2fbff8d5afb5b81fc68a8ae37c5d8ecb3f387037afdaddd61b0bad8974d0198d3c85750f028b9fd7a57e7b66d9a92bc3e0fd19849fc7bd6ab547c45237

data/README.md

@@ -22,13 +22,25 @@ gem "datory"
 ```ruby
 user = User.find(...)
 
-UserDto.serialize(user)
+UserDto.serialize(user) # => { ... }
+```
+
+For serialization, the `form` method is also available.
+This prepares a `Form` object, which has a set of additional methods such as `valid?` and `invalid?`.
+
+```ruby
+form = UserDto.form(user)
+
+form.valid? # => true
+form.invalid? # => false
+
+form.serialize # => { ... }
 ```
 
 #### Deserialize
 
 ```ruby
-UserDto.deserialize(json)
+UserDto.deserialize(json) # => Datory::Result
 ```
 
 #### Examples

data/lib/datory/attributes/form.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Datory
+  module Attributes
+    class Form
+      attr_reader :model
+
+      def initialize(context, model)
+        @context = context
+        @model = model
+      end
+
+      def target
+        @context
+      end
+
+      def update(**attributes)
+        if model_collection?
+          raise_misuse "The `update` method cannot be used with a collection. Instead, use the `update_by` method."
+        end
+
+        found_keys = model.keys & attributes.keys
+
+        reset!
+
+        model.merge!(attributes.slice(*found_keys))
+      end
+
+      def update_by(index, **attributes) # rubocop:disable Metrics/MethodLength
+        unless model_collection?
+          raise_misuse "The `update_by` method cannot be used without a collection. Instead, use the `update` method."
+        end
+
+        reset!
+
+        model.map!.with_index do |model_item, model_index|
+          if model_index == index
+            found_keys = model_item.keys & attributes.keys
+
+            model_item.merge(attributes.slice(*found_keys))
+          else
+            model_item
+          end
+        end
+      end
+
+      def serialize
+        @serialize ||= @context.serialize(model)
+      end
+
+      def valid?
+        serialize
+
+        true
+      rescue Datory::Exceptions::SerializationError
+        false
+      end
+
+      def invalid?
+        !valid?
+      end
+
+      private
+
+      def raise_misuse(message)
+        raise Datory::Exceptions::MisuseError, message
+      end
+
+      def model_collection?
+        [Set, Array].include?(model.class)
+      end
+
+      def reset!
+        @serialize = nil
+      end
+    end
+  end
+end

data/lib/datory/context/callable.rb

@@ -3,6 +3,10 @@
 module Datory
   module Context
     module Callable
+      def form(model)
+        Datory::Attributes::Form.new(self, model)
+      end
+
       def serialize(model) # rubocop:disable Metrics/MethodLength
         if [Set, Array].include?(model.class)
           model.map do |model_item|

data/lib/datory/exceptions.rb

@@ -2,7 +2,9 @@
 
 module Datory
   module Exceptions
+    class Base < StandardError; end
     class SerializationError < Datory::Service::Exceptions::Input; end
     class DeserializationError < Datory::Service::Exceptions::Input; end
+    class MisuseError < Base; end
   end
 end

data/lib/datory/version.rb

@@ -5,7 +5,7 @@ module Datory
     MAJOR = 1
     MINOR = 0
     PATCH = 0
-    PRE = "rc13"
+    PRE = "rc15"
 
     STRING = [MAJOR, MINOR, PATCH, PRE].compact.join(".")
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: datory
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc13
+  version: 1.0.0.rc15
 platform: ruby
 authors:
 - Anton Sokolov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-29 00:00:00.000000000 Z
+date: 2024-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -216,6 +216,7 @@ files:
 - lib/datory/attributes/deserialization/service_builder.rb
 - lib/datory/attributes/deserialization/service_factory.rb
 - lib/datory/attributes/dsl.rb
+- lib/datory/attributes/form.rb
 - lib/datory/attributes/options/base.rb
 - lib/datory/attributes/options/from.rb
 - lib/datory/attributes/options/to.rb