ializer 0.6.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65d2290293ec3f08da6cf2b4b4ce3f30c7240ace2157380f6394c578902f6057
-  data.tar.gz: b7c0e5883f3133c4ea215648af2133cdb8d00153dbd1b53c2a08f3518c62bac7
+  metadata.gz: 436adbeed83a5f03cb2f5efe5f1ed07f3e7647e7fa15732e7af92923bc6165f5
+  data.tar.gz: c4d2dbc6a03164d51eb577a6a1fe084f35dca996739b75c6d78d7760dfb434cc
 SHA512:
-  metadata.gz: 14e4e920d24d0a3857dea918cbb318030887c4d5c2ee2c8c27bff61d547fb8c86cc54b573ff142d13c32daf78fbf9efc289d4204d16615cbcee1fbf1b583b5b5
-  data.tar.gz: bfa543caebda04f6bb6ccec07c93bda3b8e57e2f94a63b3221ffa04294467fb88ff9cdbb72ade621450554ff44f103efb932734f81aaa66cc7018cc8b16799d1
+  metadata.gz: b563551fb9ebdb39f866c6c1fe58977b9e5c074d1ba4bf0e5a3d040efe191056f4728549e0e36cc34b6f33801aecd83638885c86f04affb07c2c28726ca2f38e
+  data.tar.gz: 82aa9bb2072c937b1f23464418744eb7fff88cb90ea8d97b2ce5f9e99249aa71e59f6050b5da6d014bb9edc5d62c6561b127ac14204502ead6b5cfecd3a1dd89

data/README.md

@@ -13,6 +13,7 @@ A fast serializer/deserializer for Ruby Objects.
   * [Model Definitions](#model-definitions)
   * [Serializer Definitions](#serializer-definitions)
   * [DeSerializer Definitions](#deserializer-definitions)
+  * [De/Serializer Configuration](#deserializer-configuration)
   * [Object Serialization](#object-serialization)
   * [Object Deserialization](#object-deserialization)
 * [Attributes](#attributes)
@@ -153,6 +154,26 @@ class CustomerDeSer < De::Ser::Ializer
 end
 ```
 
+### De/Ser::Ializer Configuration
+
+You can override the global config for a specific `Ser::Ializer` or `De::Ser::Ializer` by calling the setup command.
+
+**Note:** `setup` must be called at the beginning of the definition otherwise the default config will be used.
+
+```ruby
+class OrderDeSer < De::Ser::Ializer
+  setup do |config|
+    config.key_transform = :dasherize
+  end
+
+  integer    :id
+  timestamp  :created_at
+
+  nested     :items,       deser: OrderItemDeSer,   model_class: OrderItem
+  nested     :customer,    deser: CustomerDeSer,    model_class: Customer
+end
+```
+
 ### Sample Object
 
 ```ruby
@@ -183,17 +204,17 @@ json_string = OrderDeser.serialize_json(order)
 ```json
 {
   "id": 4,
-  "created-at": "2019-12-01T00:00:00.000-06:00",
+  "created_at": "2019-12-01T00:00:00.000-06:00",
   "items": [
     {
        "name": "Baseball",
        "decimal": "4.99",
-       "in-stock": true
+       "in_stock": true
      },
      {
        "name": "Football",
        "decimal": "14.99",
-       "in-stock": false
+       "in_stock": false
      }
   ],
   "customer": {
@@ -226,7 +247,7 @@ data = OrderDeSer.serialize([order, order2])
 
 ### Object Deserialization
 
-**Note:** Objects that are parsed must have a zero-argument initializer (ie: Object.new)
+**Note:** Objects that are parsed must have a zero argument initializer (ie: Object.new)
 
 #### Parsing a hash
 
@@ -271,7 +292,7 @@ class OrderDeSer < De::Ser::Ializer
 
   nested     :items,       deser: OrderItemDeSer,   model_class: OrderItem
   # OR
-  property   :items,       deser: OrderItemDeSer,   model_classx: OrderItem
+  property   :items,       deser: OrderItemDeSer,   model_class: OrderItem
 
   nested     :customer,    model_class: Customer do
     string     :name
@@ -437,6 +458,27 @@ end
 CustomerDeSer.serialize(order, current_user)
 ```
 
+#### Using the context to serialize a subset of attributes
+
+There are special keywords/method names on the Serialization Context that can be used to limit the attributes that are serialized.  This is different from conditional attributes below.  The conditions would still apply to the subset.
+
+If your serialization context is a `Hash`, you can use the hash keys `:attributes` or `:include` to define the limited subset of attributes for serialization.
+
+```ruby
+CustomerDeSer.serialize(order, attributes: [:name])
+```
+
+If your serialization context is a ruby object, a method named `attributes` that returns an array of attribute names can be used.
+
+```ruby
+class AttributeSubsetContext
+  attr_accessor :attributes
+end
+
+context = AttributeSubsetContext.new(attributes: [:name])
+CustomerDeSer.serialize(order, context)
+```
+
 ### Conditional Attributes
 
 Conditional attributes can be defined by passing a Proc to the `if` key on the `property` method. Return `truthy` if the attribute should be serialized, and `falsey` if not. The record and any params passed to the serializer are available inside the Proc as the first and second parameters, respectively.

data/ializer.gemspec

@@ -28,7 +28,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'pry'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop', '~> 0.78.0'
   spec.add_development_dependency 'rubocop-rspec'
   spec.add_development_dependency 'simplecov'
 end

data/lib/ializer/big_decimal_de_ser.rb

@@ -14,6 +14,8 @@ module Ializer
       return nil if value.nil?
 
       BigDecimal(value)
+    rescue ArgumentError
+      value
     end
   end
 end

data/lib/ializer/config.rb

@@ -10,7 +10,7 @@ module Ializer
     # :key_transform=: key_transform
     #
     # symbol of string transform to call on field keys
-    # default is +:dasherize+.
+    # default is nil
     def key_transform=(key_transform)
       self.key_transformer = key_transform&.to_proc
     end

data/lib/ializer/date_de_ser.rb

@@ -11,7 +11,7 @@ module Ializer
     def self.parse(value)
       Date.parse(value)
     rescue ArgumentError, TypeError
-      nil
+      value
     end
   end
 end

data/lib/ializer/fix_num_de_ser.rb

@@ -9,6 +9,8 @@ module Ializer
     def self.parse(value)
       return value if value.is_a? Numeric
 
+      return nil if value.nil?
+
       value.to_i
     end
   end

data/lib/ializer/float_de_ser.rb

@@ -23,6 +23,8 @@ module Ializer
 
       return Float::INFINITY if value == INFINITY_STRING
 
+      return nil if value.nil?
+
       value.to_f
     end
   end

data/lib/ializer/millis_de_ser.rb

@@ -12,6 +12,8 @@ module Ializer
       return nil if value.nil?
 
       Time.at(value / 1000.0)
+    rescue NoMethodError
+      value
     end
   end
 end

data/lib/ializer/symbol_de_ser.rb

@@ -10,6 +10,8 @@ module Ializer
       return nil if value.nil?
 
       value.to_sym
+    rescue NoMethodError
+      value
     end
   end
 end

data/lib/ializer/time_de_ser.rb

@@ -11,7 +11,7 @@ module Ializer
     def self.parse(value)
       DateTime.iso8601 value
     rescue ArgumentError
-      nil
+      value
     end
   end
 end

data/lib/ializer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ializer
-  VERSION = '0.6.0'
+  VERSION = '0.9.1'
 end

data/lib/ser/ializer.rb

@@ -1,13 +1,31 @@
 # frozen_string_literal: true
 
+require 'active_support/hash_with_indifferent_access'
+require 'active_support/core_ext/hash'
+
 module Ser
   class Ializer # rubocop:disable Metrics/ClassLength
     @@method_registry = {} # rubocop:disable Style/ClassVars
 
     class << self
+      def config
+        @config ||=
+          if equal? Ser::Ializer
+            ::Ializer.config
+          else
+            superclass.config
+          end
+      end
+
+      def setup
+        @config = config.dup
+
+        yield @config
+      end
+
       # Public DSL
       def property(name, options = {}, &block)
-        return add_attribute(Field.new(name, options, &block)) if options[:deser]
+        return add_attribute(Field.new(name, options, config, &block)) if options[:deser]
 
         return default(name, options, &block) unless options[:type]
 
@@ -25,7 +43,7 @@ module Ser
           options[:deser] = deser
         end
 
-        add_attribute(Field.new(name, options))
+        add_attribute(Field.new(name, options, config))
       end
 
       def with(deser)
@@ -52,7 +70,7 @@ module Ser
 
         define_singleton_method(method_name) do |name, options = {}, &block|
           options[:deser] = deser
-          add_attribute Field.new(name, options, &block)
+          add_attribute Field.new(name, options, config, &block)
         end
 
         matchers.each do |matcher|
@@ -62,12 +80,12 @@ module Ser
 
       def register_default(deser)
         define_singleton_method('default') do |name, options = {}, &block|
-          raise ArgumentError, warning_message(name) if ::Ializer.config.raise_on_default?
+          raise ArgumentError, warning_message(name) if config.raise_on_default?
 
-          puts warning_message(name) if ::Ializer.config.warn_on_default?
+          puts warning_message(name) if config.warn_on_default?
 
           options[:deser] = deser
-          add_attribute Field.new(name, options, &block)
+          add_attribute Field.new(name, options, config, &block)
         end
       end
 
@@ -96,7 +114,7 @@ module Ser
       def _attributes
         @attributes ||=
           if equal? Ser::Ializer
-            {}
+            ActiveSupport::HashWithIndifferentAccess.new
           else
             superclass._attributes.dup
           end
@@ -137,7 +155,7 @@ module Ser
       end
 
       def serialize_one(object, context)
-        _attributes.values.each_with_object({}) do |field, data|
+        fields_for_serialization(context).each_with_object({}) do |field, data|
           next unless field.valid_for_context?(object, context)
 
           value = public_send(field.name, object, context)
@@ -148,6 +166,27 @@ module Ser
         end
       end
 
+      def fields_for_serialization(context)
+        field_names = fields_names_for_serialization(context)
+
+        return _attributes.values unless field_names
+
+        _attributes.values_at(*field_names).compact
+      end
+
+      def fields_names_for_serialization(context)
+        return nil unless context
+
+        if context.is_a?(Hash)
+          context = context.with_indifferent_access
+          return context[:attributes] || context[:include]
+        end
+
+        return context.attributes if context.respond_to?(:attributes)
+
+        nil
+      end
+
       def valid_enumerable?(object)
         return true if object.is_a? Array
 

data/lib/ser/ializer/field.rb

@@ -4,19 +4,19 @@ module Ser
   class Ializer
     class Field
       class << self
-        def transform(key)
-          return key unless ::Ializer.config.key_transformer
+        def transform(key, key_transformer)
+          return key unless key_transformer
 
-          ::Ializer.config.key_transformer.call(key)
+          key_transformer.call(key)
         end
       end
 
       attr_reader :name, :setter, :key, :deser, :model_class, :if_condition, :block
 
-      def initialize(name, options, &block)
+      def initialize(name, options, config, &block)
         @name = name
         @setter = options[:setter] || "#{name}="
-        @key = options[:key] || Field.transform(name.to_s)
+        @key = options[:key] || Field.transform(name.to_s, config.key_transformer)
         @deser = options[:deser]
         @if_condition = options[:if]
         @model_class = options[:model_class]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ializer
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Jeremy Steinberg
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-01 00:00:00.000000000 Z
+date: 2021-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -98,16 +98,16 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.78.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.78.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement