nrser 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1c1aebae949432774359be83991d38a1f2401011
-  data.tar.gz: 4c30490c2fd5fdab98b488e20a1fbc3a1b7b6273
+  metadata.gz: f720f1c58fc47b32ab949e9e898360ff3cf89d6b
+  data.tar.gz: 0d0080e605b5cec3cc3b3fa9361ac64fc6dd4a66
 SHA512:
-  metadata.gz: 4d57b3ce6c67e7bc25834d9109c290a86c64a56798c47ed23b3f01ca2ce3011ea90263cf3785fa6f76a3db00d14c2c9d04595e7fa1f35006f87cbaffebad823c
-  data.tar.gz: fbd33e894a99dadbe17b8dbc7569607871e829c161518e20f0f6eb7bcea537856a1a3a9d85edcd7b7a004be01ec1928b098bfac4f332913332cd059b329c7904
+  metadata.gz: 1d3d8af368c349faad2c129ba472ec3dc4f0107feded5bcb8421b45826ab00536703b385953229091642ef13d5876618485fd6f85c2219d27f25420f84ea7e6b
+  data.tar.gz: affdad306f4d35a39fabeab3a184d738dd06d0a335865466907b4de0b97b1318afcef177258fffdd51590e99f99ed75e22652ac60ea7b0d388756f095abac68b

data/lib/nrser/props/instance_methods.rb

@@ -137,9 +137,8 @@ module NRSER::Props::InstanceMethods
   def to_data only_own: false,
               only_primary: false,
               add_class: true,
-              class_key: '__class__',
+              class_key: NRSER::Props::DEFAULT_CLASS_KEY,
               compact: true
-              # class_key: NRSER::Props::DEFAULT_CLASS_KEY
               
     hash = self.class.props(only_own: only_own, only_primary: only_primary).
       map { |name, prop|

data/lib/nrser/props.rb

@@ -1,9 +1,87 @@
 require_relative './props/class_methods'
 require_relative './props/instance_methods'
 
+
+require 'nrser/refinements/types'
+using NRSER::Types
+
+
 module NRSER::Props
+  DEFAULT_CLASS_KEY = '__class__';
+  
   def self.included base
     base.include  NRSER::Props::InstanceMethods
     base.extend   NRSER::Props::ClassMethods
   end
+  
+  # Instantiate a class from a data hash. The hash must contain the
+  # `__class__` key and the target class must be loaded already.
+  # 
+  # **WARNING**
+  # 
+  # I'm sure this is all-sorts of unsafe. Please don't ever think this is
+  # reasonable to use on untrusted data.
+  # 
+  # @param [Hash<String, Object>] data
+  #   Data hash to load from.
+  # 
+  # @param
+  # 
+  # @return [NRSER::Props::Props]
+  #   Instance of a propertied class.
+  # 
+  def self.UNSAFE_load_instance_from_data data, class_key: DEFAULT_CLASS_KEY
+    t.hash_.check data
+    
+    unless data.key?( class_key )
+      raise ArgumentError.new binding.erb <<-ERB
+        Data is missing <%= class_key %> key - no idea what class to
+        instantiate.
+        
+        Data:
+        
+            <%= data.pretty_inspect %>
+        
+      ERB
+    end
+    
+    # Get the class name from the data hash using the key, checking that it's
+    # a non-empty string.
+    class_name = t.non_empty_str.check! data[class_key]
+    
+    # Resolve the constant at that name.
+    klass = class_name.to_const!
+    
+    # Make sure it's one of ours
+    unless klass.included_modules.include?( NRSER::Props )
+      raise ArgumentError.new binding.erb <<-ERB
+        Can not load instance from data - bad class name.
+        
+        Extracted class name
+        
+            <%= class_name.inspect %>
+        
+        from class key
+        
+            <%= class_key.inspect %>
+        
+        which resolved to constant
+        
+            <%= klass.inspect %>
+        
+        but that class does not include the NRSER::Props::Props mixin, which we
+        check for to help protect against executing an unrelated `.from_data`
+        class method when attempting to load.
+        
+        Data:
+        
+            <%= data.pretty_inspect %>
+        
+      ERB
+    end
+    
+    # Kick off the restore and return the result
+    klass.from_data data
+    
+  end # .UNSAFE_load_instance_from_data
 end

data/lib/nrser/version.rb

@@ -18,7 +18,7 @@ module NRSER
   # 
   # @return [String]
   # 
-  VERSION = '0.3.2'
+  VERSION = '0.3.3'
   
   
   module Version

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nrser
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
 platform: ruby
 authors:
 - nrser