rice_bubble 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e81d5917da322d30c15b8def2c989d5b725daae03a2b843cb88534f273b6f49
-  data.tar.gz: acf5daa7c14f1a059db017ffa3a2dddf91d674b6b5694a5b0b6506e3abe8159e
+  metadata.gz: 5ff1a10fe0388c60a178246ee4c45a005292355ec741b9f175b56c8ba393b060
+  data.tar.gz: 35c94ec3a32ea7187b031eaf4341c59ad4a55649510bece671a52b480a10c2c5
 SHA512:
-  metadata.gz: c6311322cd18622ebf65dc0dc0e78cf9e89844e5cd3cc9f3564165400a3d9af70d447073025093532cdbdfeadbcc84008756a61d628c239f0de2756710f6dea2
-  data.tar.gz: 5c025fa2266a0ba755d946a6fc259164609f6549d5f5720fcb36c09790ca86f2c8ebd0a1c27e6dd37d01b3c08c6858c32866f644c67eacbb03c39fb709c97081
+  metadata.gz: 1eb7c799044b2d70f6f13a2066d175b4ff09965b19b11d91c36493509d579e6e9ea6ebbeb4cfe1d897faf5aded93bc74ea5e955db81fc396bda9a292689537c3
+  data.tar.gz: 9bd2f3aa7f5c6c70ebb5c8afc1d2ca2d4ee95e2978c5491c5a6a1e225ce31c4f3ea5e908a933fa48d74e1cea4d437e131f1718c5e0c496df7c7bf0f99196699b

data/CHANGELOG.md

@@ -1,4 +1,6 @@
-## [Unreleased]
+## [0.1.2] - 2023-05-23
+
+- Add DateTime attribute type
 
 ## [0.1.0] - 2023-05-04
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rice_bubble (0.1.0)
+    rice_bubble (0.1.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -37,9 +37,11 @@ end
 Then you can use the new serializer to convert your data to a JSON-friendly representation:
 
 ```ruby
-json = CharacterSerializer.call(my_character) # => { name: "...", ... }
+json = CharacterSerializer.new(my_character).call # => { name: "...", ... }
 ```
 
+**Note:** you can also use `CharacterSerializer.call(my_character)`.
+
 ### Attribute types
 
 | Name         | Expects                    | Options                                  | Example                                          |
@@ -100,12 +102,25 @@ WrappingSerializer.call({ name: 'Spicy Beef' }) # => { name: '{Spicy Beef}' }
 ### Fetching values from an object
 
 By default, attributes know how to fetch their values from the object being serialized
-by either:
+by either (in this order):
+
+- invoking an instance method with the same name on the serializer; or
+- invoking an instance method with the same name on the object; or
+- looking up a hash key on the object
+
+```ruby
+class FullNameSerializer
+  attributes(
+    full_name: string
+  )
 
-- invoking an instance method (on an object); or
-- looking up a hash key (on a hash)
+  def full_name
+    [object.first_name, object.last_name].join(' ')
+  end
+end
+```
 
-You can change how a value is retrieved by passing a block to the attribute:
+You can also change how a value is retrieved by passing a block to the attribute:
 
 ```ruby
 class FullNameSerializer
@@ -134,4 +149,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the RiceBubble project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/rice_bubble/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the RiceBubble project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://gitlab.com/fauxparse/rice_bubble/blob/main/CODE_OF_CONDUCT.md).

data/lib/rice_bubble/attributes/datetime.rb

@@ -0,0 +1,28 @@
+module RiceBubble
+  class Attributes
+    class Datetime < Base
+      def valid?(value)
+        return false unless valid_datetime?(value)
+
+        value.respond_to?(:to_datetime)
+      end
+
+      def coerce(value)
+        return nil unless valid_datetime?(value)
+
+        value.respond_to?(:to_datetime) ? value.to_datetime : value
+      end
+
+      private
+
+      def valid_datetime?(value)
+        case value
+        when ::Time then true
+        when ::DateTime then true
+        when ::Date then false
+        else value.respond_to?(:to_datetime)
+        end
+      end
+    end
+  end
+end

data/lib/rice_bubble/serializer.rb

@@ -1,17 +1,33 @@
 module RiceBubble
   class Serializer
-    def call(object, path: nil)
-      attributes.map do |name, attr|
-        attr.call(attr.fetch(object, name), path: path || self.class.name)
+    attr_reader :object
+
+    def initialize(object = nil)
+      @object = object
+    end
+
+    def call(object_to_serialize = nil, path: nil)
+      if object_to_serialize
+        self.class.new(object_to_serialize).call(path:)
+      elsif object
+        self.class.attributes.map do |name, attr|
+          attr.call(fetch(name), path: path || self.class.name)
+        end
+      else
+        raise ArgumentError, 'no object to serialize'
       end
     end
 
-    def attributes
-      self.class.attributes
+    def fetch(name)
+      if respond_to?(name)
+        public_send(name)
+      else
+        self.class.attributes[name].fetch(object, name)
+      end
     end
 
     def valid?(object)
-      attributes.all? do |name, attr|
+      self.class.attributes.all? do |name, attr|
         attr.valid?(attr.fetch(object, name))
       end
     end
@@ -19,7 +35,7 @@ module RiceBubble
     def validate!(object, path: '', **)
       path = self.class.name if path.empty?
 
-      attributes.each do |name, attr|
+      self.class.attributes.each do |name, attr|
         value = attr.fetch(object, name)
         attr.validate!(
           value,
@@ -34,8 +50,8 @@ module RiceBubble
     end
 
     class << self
-      def call(...)
-        new.call(...)
+      def call(object = nil, ...)
+        new(object).call(...)
       end
 
       def attributes(attrs = nil, &)

data/lib/rice_bubble/version.rb

@@ -1,3 +1,3 @@
 module RiceBubble
-  VERSION = '0.1.0'.freeze
+  VERSION = '0.1.2'.freeze
 end

data/lib/rice_bubble.rb

@@ -5,6 +5,7 @@ require_relative 'rice_bubble/attributes/any'
 require_relative 'rice_bubble/attributes/array'
 require_relative 'rice_bubble/attributes/boolean'
 require_relative 'rice_bubble/attributes/date'
+require_relative 'rice_bubble/attributes/datetime'
 require_relative 'rice_bubble/attributes/enum'
 require_relative 'rice_bubble/attributes/number'
 require_relative 'rice_bubble/attributes/integer'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rice_bubble
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Matt Powell
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-12 00:00:00.000000000 Z
+date: 2023-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -146,6 +146,7 @@ files:
 - lib/rice_bubble/attributes/base.rb
 - lib/rice_bubble/attributes/boolean.rb
 - lib/rice_bubble/attributes/date.rb
+- lib/rice_bubble/attributes/datetime.rb
 - lib/rice_bubble/attributes/enum.rb
 - lib/rice_bubble/attributes/integer.rb
 - lib/rice_bubble/attributes/literal.rb