philosophal 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d09ac65f9fd7fa000c82fa1d9e77c85e22866d2a9a1ffdfa1a63e19b36cb909b
-  data.tar.gz: bdf93344392beabea229e214b1403e88749fd51839e68c9e675fb9566fad5e52
+  metadata.gz: 1df7f3c754eeef6776d0e3a18bcfdb81124e413187beb2f580dd550cbdcd046e
+  data.tar.gz: 03ed60c26e12f8225145e6f00a138da84e3d1aa11ffd1ab1be878df0032e6896
 SHA512:
-  metadata.gz: f729b3f0a820e25d39e9de2eecd47cc7cd7bc12fa32cdc6306c81b02418f98507a3d814582f638822834dc3f9cae055b00db909a3cc66c3112c7ccb8118aaf90
-  data.tar.gz: a1ab12ea326c278c6d7eab6b555605642f0ce34d30d27782efe4a6991cbd3fc3b63917cbef00a8b21133b47e096056b2ba34234b40017239d556880960fa67f0
+  metadata.gz: ab3fd3bf30dbaba5d2936979b832b2f9a715b7dbab19eba5d08c7feb4e84aa5affd41247b294ffc7ff9a4c054dcaba932ba2cb98d9c8699b5825d1dbad4c0a9b
+  data.tar.gz: 2b372e50b9bcf123531cdc0df806061893e86a3ddc70eddc2cc47731a017cff18dea606aea8c3477c2d8f2adf1faaa051c3728ad8645b166a0c5c120e583f951

data/.rubocop.yml

@@ -6,4 +6,7 @@ require:
 
 AllCops:
   TargetRubyVersion: 3.1
-  NewCops: enable
+  NewCops: enable
+
+Style/Documentation:
+  Enabled: false

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.2.0

data/lib/philosophal/loaders/errors.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Philosophal
+  module Loaders
+    class LoadError < StandardError; end
+  end
+end

data/lib/philosophal/loaders/json_loader.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Philosophal
+  module Loaders
+    class JsonLoader
+      def initialize(klass)
+        @klass = klass
+      end
+
+      def load(json)
+        return load_from_hash(json) if json.is_a?(Hash)
+        return load_from_array(json) if json.is_a?(Array)
+
+        raise LoadError, 'invalid json parameter' unless json.is_a?(String)
+
+        first_char = json[0]
+
+        return load_from_json(json) if first_char == '{'
+
+        return load_from_json_collection(json) if first_char == '['
+
+        load_from_path(json)
+      end
+
+      private
+
+      def load_from_array(array)
+        raise LoadError, 'invalid json parameter' if array.find { |hash| !hash.is_a?(Hash) }
+
+        array.map! do |hash|
+          load_from_hash(hash)
+        end
+      end
+
+      def load_from_hash(hash)
+        obj = @klass.new
+
+        hash.each_key do |key|
+          setter = setter_from_key(key)
+          next unless obj.respond_to?(setter)
+
+          obj.public_send(setter, hash.delete(key))
+        end
+
+        obj
+      end
+
+      def setter_from_key(key)
+        real_key = @klass.philosophal_properties.json_names_h[key]
+        property = @klass.philosophal_properties[real_key]
+
+        return :"#{property.name}=" if property
+
+        :"#{key}="
+      end
+
+      def load_from_json(str)
+        hash = JSON.parse(str, symbolize_names: true)
+        load_from_hash(hash)
+      end
+
+      def load_from_json_collection(json)
+        array = JSON.parse(json, symbolize_names: true)
+        load_from_array(array)
+      end
+
+      def load_from_path(path)
+        raise LoadError, "no such file #{path}" unless File.exist?(path)
+
+        str = File.read(path)
+        load_from_json(str)
+      end
+    end
+  end
+end

data/lib/philosophal/loaders.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Philosophal
+  module Loaders
+    autoload :JsonLoader, 'philosophal/loaders/json_loader'
+    autoload :LoadError, 'philosophal/loaders/errors'
+  end
+end

data/lib/philosophal/properties/schema.rb

@@ -29,11 +29,23 @@ module Philosophal
       end
 
       def immutables
-        @properties_index.select { |_, v| v.immutable }
+        return @immutables if defined?(@immutables)
+
+        @immutables = @properties_index.select { |_, v| v.immutable }
       end
 
       def mutables
-        @properties_index.reject { |_, v| v.immutable }
+        return @mutables if defined?(@mutables)
+
+        @mutables = @properties_index.reject { |_, v| v.immutable }
+      end
+
+      def json_names_h
+        return @json_names_h if defined?(@json_names_h)
+
+        @json_names_h = @properties_index.to_h do |key, property|
+          [property.json_name, key]
+        end
       end
     end
   end

data/lib/philosophal/properties.rb

@@ -3,10 +3,11 @@
 module Philosophal
   module Properties
     autoload :Schema, 'philosophal/properties/schema'
+    autoload :JSONLoader, 'philosophal/loaders/json_loader'
 
     include Philosophal::Types
 
-    def cprop(name, type, default: nil, transform: nil, immutable: false, description: nil)
+    def cprop(name, type, default: nil, transform: nil, immutable: false, description: nil, json: false)
       default.freeze if default && !(default.is_a?(Proc) || default.frozen?)
 
       if transform && !(transform.is_a?(Proc) || transform.is_a?(Symbol))
@@ -23,7 +24,15 @@ module Philosophal
         description.freeze unless description.frozen?
       end
 
-      property = __philosophal_property_class__.new(name:, type:, default:, transform:, immutable:, description:)
+      if json
+        unless json.is_a?(TrueClass) || json.is_a?(String) || json.is_a?(Symbol)
+          raise Philosophal::ArgumentError, 'json param must be true or a String or a Symbol.'
+        end
+
+        json = json.to_sym if json.is_a?(String)
+      end
+
+      property = __philosophal_property_class__.new(name:, type:, default:, transform:, immutable:, description:, json:)
 
       philosophal_properties << property
       __define_philosophal_methods__(property)
@@ -43,7 +52,9 @@ module Philosophal
     def philosophal_descriptions
       return @philosophal_descriptions if defined?(@philosophal_descriptions)
 
-      @philosophal_descriptions = philosophal_properties.properties_index.values.select(&:description).to_h do |property|
+      @philosophal_descriptions = philosophal_properties.properties_index.values
+                                                        .select(&:description)
+                                                        .to_h do |property|
         [
           property.name,
           property.description
@@ -52,6 +63,12 @@ module Philosophal
     end
     alias cprop_descriptions philosophal_descriptions
 
+    def json
+      return @json if defined?(@json)
+
+      @json = Philosophal::Loaders::JsonLoader.new(self)
+    end
+
     private
 
     def __philosophal_property_class__
@@ -86,12 +103,12 @@ module Philosophal
             end
 
             keys_str = keys_map.map { |k, v| [k, v.inspect].join(': ') }.join(', ')
-            "#{self.class}:#{format('0x00%x', (object_id << 1))} #{keys_str}"
+            "#{self.class}:#{format('0x00%x', object_id << 1)} #{keys_str}"
           end
           alias cprop_inspect philosophal_inspect
 
           def philosophal_inspect_map
-            self.class.philosophal_properties.properties_index.values.to_h do |property|
+            philosophal_values.to_h do |property|
               [
                 property.name,
                 send(property.name)
@@ -99,6 +116,23 @@ module Philosophal
             end
           end
           alias cprop_inspect_map philosophal_inspect_map
+
+          def philosophal_values
+            self.class.philosophal_properties.properties_index.values
+          end
+
+          def to_json_hash
+            philosophal_values.select(&:json).to_h do |property|
+              [
+                property.json_name,
+                send(property.name)
+              ]
+            end
+          end
+
+          def to_json(*_args)
+            to_json_hash.to_json
+          end
         end
       end
     end

data/lib/philosophal/property.rb

@@ -2,16 +2,23 @@
 
 module Philosophal
   class Property
-    def initialize(name:, type:, default:, transform:, immutable:, description:)
+    def initialize(name:, type:, default:, transform:, immutable:, description:, json:)
       @name = name
       @type = type
       @default = default
       @transform = transform
       @immutable = immutable
       @description = description
+      @json = json
     end
 
-    attr_reader :name, :type, :default, :transform, :immutable, :description
+    attr_reader :name, :type, :default, :transform, :immutable, :description, :json
+
+    def json_name
+      return @json if @json.is_a?(Symbol)
+
+      @name
+    end
 
     def default?
       @default != nil
@@ -82,7 +89,7 @@ module Philosophal
         @name.name <<
         "_description\n  " \
         '%(' << @description << ')' \
-        "\nend\n"
+                                "\nend\n"
     end
   end
 end

data/lib/philosophal.rb

@@ -4,6 +4,7 @@ require 'date'
 require 'pathname'
 require 'set'
 require 'time'
+require 'json'
 
 module Philosophal
   autoload :Convertor, 'philosophal/convertor'
@@ -13,6 +14,7 @@ module Philosophal
   autoload :Property, 'philosophal/property'
 
   autoload :Types, 'philosophal/types'
+  autoload :Loaders, 'philosophal/loaders'
 
   autoload :TypeError, 'philosophal/errors/type_error'
   autoload :ArgumentError, 'philosophal/errors/argument_error'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philosophal
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Maxime Désécot
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-26 00:00:00.000000000 Z
+date: 2026-06-29 00:00:00.000000000 Z
 dependencies: []
 description: Auto convert value on setter method call
 email:
@@ -29,6 +29,9 @@ files:
 - lib/philosophal/convertor.rb
 - lib/philosophal/errors/argument_error.rb
 - lib/philosophal/errors/type_error.rb
+- lib/philosophal/loaders.rb
+- lib/philosophal/loaders/errors.rb
+- lib/philosophal/loaders/json_loader.rb
 - lib/philosophal/properties.rb
 - lib/philosophal/properties/schema.rb
 - lib/philosophal/property.rb