mutability 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2504afd2226715583357d5ad0b509b4d2317597f
-  data.tar.gz: d6f1452f30ac8db6005346ca16f0adb1083e3445
+  metadata.gz: a58152afaa3f64181624fbe5d87fe552ef741b7f
+  data.tar.gz: bb33dce7188e8e74dff1fb7a2bf7aa8def65f767
 SHA512:
-  metadata.gz: ee010ec5d6781e8eee1bff969525c8fc4e6b4aabe5e599a2f434412e091af4a2c30a17a2b0d8a9daaeba27d645a6f73a8ac26abeef10a47788c214b3c239f2d4
-  data.tar.gz: 4a3a12fd41072ca77693064ff2ed70287bcf648998ca6391abb7cea3581a2fdd9e3e5930c523c29c0faa09f724be434fb5520723c2073782403abc291c64c423
+  metadata.gz: 8c0bc0028bf22d5f69d2d9c964d71c0d91c04d0f34a8ede8864a4a4c1f0d945f9b61fae3b6baf9ed7c47801947eb7a592ae01b642d4bc6dc8e2d6eccd0225b1c
+  data.tar.gz: d8071bc563dcba0e1bf06a216fe930073e38abc92077766f792192bd2bc96d6e81aa98b0730c06071357056a41b6f9b229ac61044368b3bcb376de401a9e591f

data/lib/mutability/mutable.rb

@@ -0,0 +1,48 @@
+require 'forwardable'
+
+# **************************************************************************
+# Mutability::Mutable
+#
+# This class adds a wrapper around a an object that keeps an unchanged
+#  copy of the object.  This allows it to be mutated as much as needed and
+#  still be compared against the original version, or even reset to the
+#  original.
+#
+# Adds the freeze! and revert! methods and delegates most methods to the
+#  working version (@self).  The following methods act upon the Mutable
+#  object itself and not its working version:
+#    - #inspect
+#    - #=
+#    - any equality methods that are not built on #== or #===
+# **************************************************************************
+
+module Mutability
+  class Mutable
+    extend Forwardable
+
+    def_delegators :@self, *Mutability::DELEGATED_METHODS
+
+    attr_reader :original
+    attr_accessor :self
+
+    def initialize(original)
+      @original = original.freeze   # don't modify, even accidentally!
+      revert!
+    end
+
+    def freeze!
+      @original = @self.dup.freeze
+    end
+
+    def revert!
+      @self = @original.dup         # we want an unfrozen copy, so cannot clone
+    end
+
+    private
+
+    # cheap delegation
+    def method_missing(sym, *args, &block)
+      @self.send(sym, *args, &block)
+    end
+  end
+end

data/lib/mutability/mutable_array.rb

@@ -0,0 +1,9 @@
+require_relative 'mutable'
+
+module Mutability
+  class MutableArray < Mutable
+    def initialize(array = [])
+      super array
+    end
+  end
+end

data/lib/mutability/mutable_hash.rb

@@ -0,0 +1,9 @@
+require_relative 'mutable'
+
+module Mutability
+  class MutableHash < Mutable
+    def initialize(hash = {})
+      super hash
+    end
+  end
+end

data/lib/mutability/version.rb

@@ -0,0 +1,3 @@
+module Mutability
+  VERSION = '1.0.1'
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mutability
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Kelli Searfos
@@ -78,6 +78,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/mutability.rb
+- lib/mutability/mutable.rb
+- lib/mutability/mutable_array.rb
+- lib/mutability/mutable_hash.rb
+- lib/mutability/version.rb
 homepage: https://github.com/ksearfos/mutability
 licenses:
 - MIT