ryo.rb 0.4.7 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dab9ce575cc86bc7fc740dc72d1a1c416a22d36ed8806b86e1c7f60c0b46f5b
-  data.tar.gz: 403f51fb967e4c745461a61092984f78de8fac139465da0442cd30dea66c807d
+  metadata.gz: 4d4a31df7a8e4862600d2e3072df9320d95cdd805fdef5028cd1c6154a9786c2
+  data.tar.gz: 862aa59d0f09c4ebcabb9c5552f390dc8456a5964601c48d866a84a01e871443
 SHA512:
-  metadata.gz: dcac875bbd985395ffa37b1b3c48e9f52ebd11d36514faf75e18134530fc2599fbac437114d3d9c2530a66aec810cc7de8904355467a9854d9a9b4f80f2c63f6
-  data.tar.gz: bbb67ac56137b8989b8c94f82b20c887d3914d7218170ded3688e8f53251d2ef1808af4a143e469c374951031a1ab40b3f8ed6cf0ce084ee72f078ad2022446f
+  metadata.gz: 57bab86f4003fb0aa40c43fa2fc41d335b26ead6c99522d97227f25279b5f45330c7fc9edf66b4682508d4cf13593be6d1ce55ab8507263cad75fa99605651c0
+  data.tar.gz: 384411a195dbd7699dfa9f8b3a253588e477b28b04210c3a8452285f47778d149f090750b352de9bf9e95f19fb679127062b2fcce90aac5d0bc99224f452cf3c

data/README.md

@@ -2,13 +2,6 @@
 
 Ryo implements prototype-based inheritance, in Ruby.
 
-Ryo's implementation of prototype-based inheritance offers
-a flexible approach for establishing object relationships,
-and building configuration objects. Ryo can also act as a
-recursive OpenStruct alternative. JavaScript's implementation of
-prototype-based inheritance served as a reference point
-for Ryo's implementation.
-
 ## Examples
 
 ### Prototypes
@@ -55,21 +48,19 @@ p point.multiply.call(2)
 # [10, 20]
 ```
 
-#### Ryo.lazy
+#### Ryo.memo
 
-The following example demonstrates a lazy Ryo value.
-[`Ryo.lazy`](https://0x1eef.github.io/x/ryo.rb/Ryo.html#lazy-class_method)
-creates a lazy value that is not evaluated until a property is accessed
-for the first time. It is similar to a Ryo function but it does not require
-that the `#call` method be used, and after the property is accessed for the
-first time the lazy value is replaced by the evaluated value:
+The following example demonstrates
+[`Ryo.memo`](https://0x1eef.github.io/x/ryo.rb/Ryo.html#memo-class_method).
+`Ryo.memo` returns a value that becomes memoized after a property is
+accessed for the first time. It is similar to a Ryo function:
 
 ```ruby
 require "ryo"
 
-point_x = Ryo(x: Ryo.lazy { 5 })
-point_y = Ryo({y: Ryo.lazy { 10 }}, point_x)
-point = Ryo({sum: Ryo.lazy { x + y }}, point_y)
+point_x = Ryo(x: Ryo.memo { 5 })
+point_y = Ryo({y: Ryo.memo { 10 }}, point_x)
+point = Ryo({sum: Ryo.memo { x + y }}, point_y)
 print "point.x = ", point.x, "\n"
 print "point.y = ", point.y, "\n"
 print "point.sum = ", point.sum, "\n"
@@ -310,7 +301,7 @@ p ryo.then { 34 } # => 34
 #### Duck typing
 
 The documentation has used simple terms to describe the objects that Ryo works
-with: Hash and Array objects. But actually, Ryo uses duck typing, so any object
+with: Hash and Array objects. But in reality, Ryo uses duck typing, so any object
 that implements `#each_pair` can be treated as a Hash object, and any object that
 implements `#each` can be treated as an Array object. Note that only
 [Ryo.from](https://0x1eef.github.io/x/ryo.rb/Ryo.html#from-class_method),
@@ -342,32 +333,19 @@ p point.x # => 5
 p point.y # => 10
 ```
 
-## Sources
-
-* [Source code (GitHub)](https://github.com/0x1eef/ryo.rb#readme)
-* [Source code (GitLab)](https://gitlab.com/0x1eef/ryo.rb#about)
-
 ## <a id='install'>Install</a>
 
-**Git**
-
-Ryo is distributed as a RubyGem through its git repositories. <br>
-[GitHub](https://github.com/0x1eef/ryo.rb),
-and
-[GitLab](https://gitlab.com/0x1eef/ryo.rb)
-are available as sources.
-
-```ruby
-# Gemfile
-gem "ryo.rb", github: "0x1eef/ryo.rb", tag: "v0.4.7"
-```
-
 **Rubygems.org**
 
-Ryo can also be installed via rubygems.org.
+Ryo can be installed via rubygems.org.
 
     gem install ryo.rb
 
+## Sources
+
+* [GitHub](https://github.com/0x1eef/ryo.rb#readme)
+* [GitLab](https://gitlab.com/0x1eef/ryo.rb#about)
+
 ## Thanks
 
 Thanks to

data/lib/ryo/json.rb

@@ -0,0 +1,41 @@
+##
+# The {Ryo::JSON Ryo::JSON} module provides a number of methods
+# for coercing JSON data into a Ryo object. It must be required
+# separately to Ryo (ie: require "ryo/json"), and the methods of
+# this module are then available on the {Ryo Ryo} module.
+module Ryo::JSON
+  require "json"
+  extend self
+
+  ##
+  # @param [String] path
+  #  The path to a JSON file.
+  #
+  # @param [Ryo] object
+  #  {Ryo::Object Ryo::Object}, or {Ryo::BasicObject Ryo::BasicObject}.
+  #  Defaults to {Ryo::Object Ryo::Object}.
+  #
+  # @raise [SystemCallError]
+  #  Might raise a number of Errno exceptions.
+  #
+  # @return [Ryo::Object, Ryo::BasicObject]
+  #  Returns a Ryo object.
+  def from_json_file(path, object: Ryo::Object)
+    from_json File.binread(path), object:
+  end
+
+  ##
+  # @param [String] blob
+  #  A blob of JSON.
+  #
+  # @param [Ryo] object
+  #  {Ryo::Object Ryo::Object}, or {Ryo::BasicObject Ryo::BasicObject}.
+  #  Defaults to {Ryo::Object Ryo::Object}.
+  #
+  # @return (see Ryo::JSON#from_json_file)
+  def from_json(blob, object: Ryo::Object)
+    object.from JSON.parse(blob)
+  end
+
+  Ryo.extend(self)
+end

data/lib/ryo/{lazy.rb → memo.rb}

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 
-class Ryo::Lazy < Ryo::Function
+class Ryo::Memo < Ryo::Function
 end

data/lib/ryo/reflect.rb

@@ -251,10 +251,11 @@ module Ryo::Reflect
   #
   # @return [Boolean]
   #  Returns true when the given object is an instance
-  #  of {Ryo::Lazy Ryo::Lazy}.
-  def lazy?(obj)
-    Ryo::Lazy === obj
+  #  of {Ryo::Memo Ryo::Memo}.
+  def memo?(obj)
+    Ryo::Memo === obj
   end
+  alias_method :lazy?, :memo?
 
   ##
   # @example

data/lib/ryo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ryo
-  VERSION = "0.4.7"
+  VERSION = "0.5.1"
 end

data/lib/ryo.rb

@@ -21,7 +21,7 @@ module Ryo
   require_relative "ryo/basic_object"
   require_relative "ryo/object"
   require_relative "ryo/function"
-  require_relative "ryo/lazy"
+  require_relative "ryo/memo"
   require_relative "ryo/enumerable"
 
   extend Ryo::Reflect
@@ -61,15 +61,18 @@ module Ryo
   end
 
   ##
-  # Creates a lazy Ryo value.
+  # Creates a memoized Ryo value.
   #
   # @param [Proc] b
-  #  A proc that is evaluated when a property is first accessed.
+  #  A Proc that is memoized after being accessed for the first time.
   #
-  # @return [Ryo::Lazy]
-  #  Returns an instance of {Ryo::Lazy Ryo::Lazy}.
-  def self.lazy(&b)
-    Ryo::Lazy.new(&b)
+  # @return [Ryo::Memo]
+  #  Returns an instance of {Ryo::Memo Ryo::Memo}.
+  def self.memo(&b)
+    Ryo::Memo.new(&b)
+  end
+  class << Ryo
+    alias_method :lazy, :memo
   end
 
   ##
@@ -107,7 +110,7 @@ module Ryo
     property = property.to_s
     if Ryo.property?(self, property)
       v = @_table[property]
-      Ryo.lazy?(v) ? self[property] = v.call : v
+      Ryo.memo?(v) ? self[property] = v.call : v
     else
       return unless @_proto
       Ryo.call_method(@_proto, property)

data/spec/readme_spec.rb

@@ -72,8 +72,8 @@ RSpec.describe "README.md examples" do
     it { is_expected.to eq("5\n10") }
   end
 
-  context "when given 7_ryo_lazy.rb" do
-    let(:file) { "7_ryo_lazy.rb" }
+  context "when given 7_ryo_memo.rb" do
+    let(:file) { "7_ryo_memo.rb" }
     it { is_expected.to eq("point.x = 5\npoint.y = 10\npoint.sum = 15") }
   end
 end

data/spec/ryo_basic_object_spec.rb

@@ -66,10 +66,10 @@ RSpec.describe Ryo::BasicObject do
     it { expect(h).to eq({"name" => "ford", "wheels" => {"quantity" => 4}}) }
 
     context "when given to Hash#merge" do
-      let(:car) { Ryo(name: "ford") }
       subject { {}.merge(car) }
+      let(:car) { Ryo(name: "ford") }
       it { is_expected.to be_instance_of(Hash) }
-      it { is_expected.to eq({"name" => "ford"})}
+      it { is_expected.to eq({"name" => "ford"}) }
     end
   end
 end

data/spec/ryo_json_spec.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "setup"
+require "ryo/json"
+require "fileutils"
+
+RSpec.describe Ryo::JSON do
+  describe ".from_json_file" do
+    subject(:ryo) { described_class.from_json_file(path, object:) }
+    before { File.binwrite path, JSON.dump(x: 20, y: 40) }
+    after { FileUtils.rm(path) }
+    let(:path) { File.join(__dir__, "test.json") }
+
+    context "with Ryo::Object" do
+      let(:object) { Ryo::Object }
+      it { is_expected.to be_instance_of(Ryo::Object) }
+      it { is_expected.to eq("x" => 20, "y" => 40) }
+    end
+
+    context "with Ryo::BasicObject" do
+      let(:object) { Ryo::BasicObject }
+      it { expect(Ryo::BasicObject === ryo).to be(true) }
+      it { is_expected.to eq("x" => 20, "y" => 40) }
+    end
+  end
+end

data/spec/ryo_object_spec.rb

@@ -61,10 +61,10 @@ RSpec.describe "Ryo objects" do
     it { expect(h).to eq({"name" => "ford", "wheels" => {"quantity" => 4}}) }
 
     context "when given to Hash#merge" do
-      let(:car) { Ryo(name: "ford") }
       subject { {}.merge(car) }
+      let(:car) { Ryo(name: "ford") }
       it { is_expected.to be_instance_of(Hash) }
-      it { is_expected.to eq({"name" => "ford"})}
+      it { is_expected.to eq({"name" => "ford"}) }
     end
   end
 

data/spec/ryo_spec.rb

@@ -127,4 +127,20 @@ RSpec.describe Ryo do
       it { is_expected.to eq(true) }
     end
   end
+
+  describe ".memo" do
+    let(:point) do
+      Ryo(x: Ryo.memo { "5".dup }, y: Ryo.memo { "10".dup })
+    end
+
+    it "returns a value" do
+      expect(point.x).to eq("5")
+      expect(point.y).to eq("10")
+    end
+
+    it "memoizes a value" do
+      expect(point.x).to equal(point.x)
+      expect(point.y).to equal(point.y)
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ryo.rb
 version: !ruby/object:Gem::Version
-  version: 0.4.7
+  version: 0.5.1
 platform: ruby
 authors:
 - '0x1eef'
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-02-01 00:00:00.000000000 Z
+date: 2024-03-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yard
@@ -116,8 +116,9 @@ files:
 - lib/ryo/builder.rb
 - lib/ryo/enumerable.rb
 - lib/ryo/function.rb
+- lib/ryo/json.rb
 - lib/ryo/keywords.rb
-- lib/ryo/lazy.rb
+- lib/ryo/memo.rb
 - lib/ryo/object.rb
 - lib/ryo/reflect.rb
 - lib/ryo/version.rb
@@ -134,11 +135,12 @@ files:
 - share/ryo.rb/examples/4.1_basicobject_ryo_basicobject_from.rb
 - share/ryo.rb/examples/5_collisions_resolution_strategy.rb
 - share/ryo.rb/examples/6_beyond_hash_objects.rb
-- share/ryo.rb/examples/7_ryo_lazy.rb
+- share/ryo.rb/examples/7_ryo_memo.rb
 - share/ryo.rb/examples/setup.rb
 - spec/readme_spec.rb
 - spec/ryo_basic_object_spec.rb
 - spec/ryo_enumerable_spec.rb
+- spec/ryo_json_spec.rb
 - spec/ryo_keywords_spec.rb
 - spec/ryo_object_spec.rb
 - spec/ryo_prototypes_spec.rb