gibbler 0.8.10 → 0.10.0.pre.RC1

data/sig/gibbler.rbs

@@ -0,0 +1,4 @@
+module Gibbler
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

data/try/{01_mixins_try.rb → 01_core_ext_try.rb}

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 
 ## has String#clear
   "".respond_to? :clear

data/try/02_compat_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 
 ## Gibbler Objects have gibbler_cache method
   "kimmy".respond_to? :gibbler_cache

data/try/05_gibbler_digest_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 
 ## has short method
   "kimmy".gibbler.short

data/try/10_standalone_try.rb

@@ -0,0 +1,49 @@
+require 'gibbler'
+
+@sha256_digest = if Tryouts.sysinfo.vm == :java 
+  require 'openssl'
+  OpenSSL::Digest::SHA256
+else
+  Digest::SHA256
+end
+
+## Default delimiter
+Gibbler.delimiter
+#=> ':'
+
+## Create a digest from flattened Array
+Gibbler.digest [1, :sym, ['string', 2,3]].flatten.join(':')
+#=> 'd84d6ad2bd5c9589842fb02cf3c384e4924b1d3f'
+
+## Create a digest from Array
+Gibbler.digest [1, :sym, ['string', 2,3]]
+#=> 'd84d6ad2bd5c9589842fb02cf3c384e4924b1d3f'
+
+## Create an instance
+Gibbler.new 1, :sym, 'string', 2,3
+#=> 'd84d6ad2bd5c9589842fb02cf3c384e4924b1d3f'
+
+## Can modify base
+g = Gibbler.new 1, :sym, 'string', 2,3
+g.base(36)
+#=> 'p9lffkbfkgpf7j71ho5cvxxcvx8gv27'
+
+## Maintains class
+g = Gibbler.new 1, :sym, 'string', 2,3
+g.base(36).class
+#=> Gibbler
+
+## Can change digest type by class
+Gibbler.digest_type = @sha256_digest
+g = Gibbler.new 1, :sym, 'string', 2,3
+#=> '204aacebb816bc2c8675f3490bf5a1a908988fb72f3dfd6774e963bbb9e26a26'
+
+## Can change digest type per instance
+Gibbler.digest_type = Digest::SHA1
+g = Gibbler.new 
+g.digest_type = @sha256_digest
+g.digest 1, :sym, 'string', 2,3
+g
+#=> '204aacebb816bc2c8675f3490bf5a1a908988fb72f3dfd6774e963bbb9e26a26'
+
+Gibbler.digest_type = Digest::SHA1

data/try/{10_basic_try.rb → 11_basic_try.rb}

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 
 #Gibbler.enable_debug
 
@@ -6,14 +6,14 @@ require 'gibbler'
   begin
     a = Class.new
     a.send :include, Gibbler
-  rescue RuntimeError
+  rescue TypeError
     :success
   end
 #=> :success
 
 # Symbol digests are consistent
   :kimmy.gibbler
-#=> '52be7494a602d85ff5d8a8ab4ffe7f1b171587df' 
+#=> '52be7494a602d85ff5d8a8ab4ffe7f1b171587df'
 
 # String digests are consistent
   'kimmy'.gibbler
@@ -27,25 +27,25 @@ require 'gibbler'
   Class.gibbler
 #=> '25ac269ae3ef18cdb4143ad02ca315afb5026de9'
 
-# Fixnum instance digests are consistent
+# Integer instance digests are consistent
   1.gibbler
 #=> 'a9cad665549bd22a4346fcf602d9d3c3b0482bbe'
 
-# Bignum instance
-  100000000000.gibbler
+# Large Integer instance
+  100_000_000_000.gibbler
 #=> '608256db120251843843bba57e9b2c7adb7342aa'
 
 # Empty Hash instance digests are consistent
   Hash.new.gibbler
 #=> '4fdcadc66a38feb9c57faf3c5a18d5e76a6d29bf'
-  
+
 # Populated Hash instance
   { :a => [1,2,3, [4,5,6]], :b => { :c => Class } }.gibbler
 #=> "1d4b62e1e9f2c097b0cefb6877bf47c2015cdd21"
-  
+
 # Empty Array instance
-  Array.new.gibbler
-#=> '48fda57c05684c9e5c3259557851943572183a21' 
+  Array.gibbler
+#=> '48fda57c05684c9e5c3259557851943572183a21'
 
 # Populated Array instance
   [1, 2, :runtime, [3, "four", [Object, true]]].gibbler
@@ -83,7 +83,7 @@ require 'gibbler'
 ## additional attic_var (:gibbler_history), but only if the
 ## gibbler_history method has been called already (the history
 ## remains nil by default). The fix is not straightfroward and
-## tests are not important anyway so disabling them is fine. 
+## tests are not important anyway so disabling them is fine.
 ## Symbol has list of attic vars", [:gibbler_cache]
 #  Symbol.attic_vars
 #end
@@ -98,8 +98,8 @@ require 'gibbler'
 
 # Freezing an object will update the digest
   a = { :a => 1 }
-  pre  = a.gibbler; 
-  a[:a] = 2 
+  pre  = a.gibbler;
+  a[:a] = 2
   post = a.freeze.gibbler
   pre != post && post == a.gibbler_cache
 #=> true
@@ -127,4 +127,3 @@ require 'gibbler'
   a.gibbler
   a.gibbler_cache
 #=> 'c8027100ecc54945ab15ddac529230e38b1ba6a1'
-

data/try/{11_basic_sha256_try.rb → 12_basic_sha256_try.rb}

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 
 # NOTE: JRuby requires that we use OpenSSL::Digest::SHA256
 if Tryouts.sysinfo.vm == :java 

data/try/14_extended_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 
 ## true can gibbler
   true.gibbler

data/try/15_file_try.rb

@@ -1,5 +1,5 @@
 require 'tempfile'
-require 'gibbler'
+require 'gibbler/mixins'
 
 @tempfile = "tryouts-9000-awesome.txt"
   

data/try/16_uri_try.rb

@@ -1,5 +1,5 @@
 require 'uri'
-require 'gibbler'
+require 'gibbler/mixins'
 
 # "URI::HTTP can gibbler"
   uri = URI.parse "http://localhost:3114/spaceship"

data/try/17_complex_object_try.rb

@@ -1,4 +1,5 @@
-require 'gibbler'
+require 'gibbler/mixins'
+require 'time'
 
 # arbitrary objects can specify instance variables to gibbler
   class ::FullHouse
@@ -18,10 +19,12 @@ require 'gibbler'
 # arbitrary objects can append more instance variables later on
   class ::FullHouse
     gibbler :stamp, :ready
+    def stamp
+      Time.parse('2009-08-25 16:43:53 UTC')
+    end
   end
   a = FullHouse.new
   a.roles = [:jesse, :joey, :danny, :kimmy, :michelle, :dj, :stephanie]
-  a.stamp = Time.parse('2009-08-25 16:43:53 UTC')
   a.ready = true
   a.gibbler
 #=> "fbdce0d97a856e7106bec418d585c914914b8aa5"

data/try/18_proc_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 
 class ::MyProc < Proc; end
 

data/try/20_time_try.rb

@@ -1,5 +1,5 @@
 require 'date'
-require 'gibbler'
+require 'gibbler/mixins'
 
 # "Date instance can gibbler
   Date.parse('2009-08-25').gibbler

data/try/30_secret_try.rb

@@ -1,5 +1,5 @@
 require 'uri'
-require 'gibbler'
+require 'gibbler/mixins'
 
 # "Can set a sexy global secret
   Gibbler.secret = 'kimmy'.gibbler

data/try/50_history_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 require 'gibbler/history'
 
 # can convert short digest into long

data/try/51_hash_history_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 require 'gibbler/history'
 
 class ::Hash

data/try/52_array_history_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 require 'gibbler/history'
 
 class Array

data/try/53_string_history_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 require 'gibbler/history'
 
 class String

data/try/57_arbitrary_history_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 require 'gibbler/history'
 
 class ::FullHouse

data/try/59_history_exceptions_try.rb

@@ -1,4 +1,4 @@
-require 'gibbler'
+require 'gibbler/mixins'
 require 'gibbler/history'
 
 

metadata

@@ -1,53 +1,89 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: gibbler
-version: !ruby/object:Gem::Version 
-  prerelease: 
-  version: 0.8.10
+version: !ruby/object:Gem::Version
+  version: 0.10.0.pre.RC1
 platform: ruby
-authors: 
+authors:
 - Delano Mandelbaum
-autorequire: 
-bindir: bin
+autorequire:
+bindir: exe
 cert_chain: []
-
-date: 2011-10-23 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: attic
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
+date: 2024-04-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.4.0
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id001
-description: "Gibbler: Git-like hashes for Ruby objects"
-email: delano@solutious.com
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tryouts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.2.0.pre.RC1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.2.0.pre.RC1
+description: 'A out Gibbler: Git-like hashes for Ruby objects'
+email: gems@solutious.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".github/workflows/ruby-rake.yaml"
+- ".gitignore"
+- ".pre-commit-config.yaml"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
 - LICENSE.txt
-- README.rdoc
-files: 
-- CHANGES.txt
-- LICENSE.txt
-- README.rdoc
-- Rakefile
+- README.md
 - VERSION.yml
-- gibbler.gemspec
+- bin/console
+- bin/setup
+- img/whoababy.gif
 - lib/gibbler.rb
 - lib/gibbler/aliases.rb
 - lib/gibbler/history.rb
 - lib/gibbler/mixins.rb
-- try/01_mixins_try.rb
+- lib/gibbler/version.rb
+- sig/gibbler.rbs
+- try/01_core_ext_try.rb
 - try/02_compat_try.rb
 - try/05_gibbler_digest_try.rb
-- try/10_basic_try.rb
-- try/11_basic_sha256_try.rb
+- try/10_standalone_try.rb
+- try/11_basic_try.rb
+- try/12_basic_sha256_try.rb
 - try/14_extended_try.rb
 - try/15_file_try.rb
 - try/16_uri_try.rb
@@ -64,31 +100,26 @@ files:
 - try/80_performance_try.rb
 - try/90_alias_try.rb
 homepage: http://github.com/delano/gibbler
-licenses: []
-
-post_install_message: 
+licenses:
+- MIT
+metadata: {}
+post_install_message:
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+    - !ruby/object:Gem::Version
+      version: 3.1.4
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
 requirements: []
-
-rubyforge_project: gibbler
-rubygems_version: 1.8.10
-signing_key: 
-specification_version: 3
-summary: "Gibbler: Git-like hashes for Ruby objects"
+rubygems_version: 3.3.26
+signing_key:
+specification_version: 4
+summary: Git-like hashes for Ruby objects
 test_files: []
-

data/README.rdoc

@@ -1,228 +0,0 @@
-= Gibbler - v0.8 
-
-Git-like hashes and history for Ruby objects for Ruby 1.8, 1.9 and JRuby. 
-
-Check out the screencast[http://www.rubypulse.com/episode-0.3-gibbler.html] created by Alex Peuchert.
-
-== Some things to keep in mind
-
-* Digest calculation may change between minor releases (as it did between 0.6 and 0.7)
-* Gibbler history is not suitable for very large objects since it keeps complete copies of the object in memory. This is a very early implementation of this feature so don't rely on it for production code. 
-* Don't forget to enjoy what you do!
-
-
-== Example 1 -- Basic Usage
-    
-    require 'gibbler'
-    
-    "kimmy".gibbler              # => c8027100ecc54945ab15ddac529230e38b1ba6a1
-    :kimmy.gibbler               # => 52be7494a602d85ff5d8a8ab4ffe7f1b171587df
-    
-    config = {}
-    config.gibbler               # => 4fdcadc66a38feb9c57faf3c5a18d5e76a6d29bf
-    config.gibbled?              # => false
-    
-    config[:server] = {          
-      :users => [:dave, :ali],   
-      :ports => [22, 80, 443]    
-    }                            
-    config.gibbled?              # => true
-    config.gibbler               # => ef23d605f8c4fc80a8e580f9a0e8dab8426454a8 
-    
-    config[:server][:users] << :yanni
-    
-    config.gibbler               # => 4c558a56bc2abf5f8a845a69e47ceb5e0003683f
-    
-    config.gibbler.short         # => 4c558a56
-
-    config.gibbler.base36        # => 8x00l83jov4j80i9vfzpaxr9jag23wf
-    
-    config.gibbler.base36.short  # => 8x00l83j
-    
-    
-== Example 2 -- Object History 
-    
-Gibbler can also keep track of the history of changes to an object. By default Gibbler supports history for Hash, Array, and String objects. The <tt>gibbler_commit</tt> method creates a clone of the current object and stores in an instance variable using the current hash digest as the key. 
-
-    require 'gibbler'
-    require 'gibbler/history'
-    
-    a = { :magic => :original }     
-    a.gibbler_commit             # => d7049916ddb25e6cc438b1028fb957e5139f9910
-    
-    a[:magic] = :updated           
-    a.gibbler_commit             # => b668098e16d08898532bf3aa33ce2253a3a4150e
-    
-    a[:magic] = :changed 
-    a.gibbler_commit             # => 0b11c377fccd44554a601e5d2b135c46dc1c4cb1
-    
-    a.gibbler_history            # => d7049916, b668098e, 0b11c377
-    
-    a.gibbler_revert! 'd7049916' # Return to a specific commit
-    a.gibbler                    # => d7049916ddb25e6cc438b1028fb957e5139f9910
-    a                            # => { :magic => :original } 
-    
-    a.delete :magic
-    
-    a.gibbler_revert!            # Return to the previous commit  
-    a.gibbler                    # => 0b11c377fccd44554a601e5d2b135c46dc1c4cb1
-    a                            # => { :magic => :changed }
-        
-    
-    a.gibbler_object 'b668098e'  # => { :magic => :updated }
-    a.gibbler_stamp              # => 2009-07-01 18:56:52 -0400
-    
-http://delano.github.com/gibbler/img/whoababy.gif
-
-
-== Example 3 -- Method Aliases
-
-If you have control over the namespaces of your objects, you can use the method aliases to tighten up your code a bit. The "gibbler" and "gibbled?" methods can be accessed via "digest" and "changed?", respectively. (The reason they're not enabled by default is to avoid conflicts.)
-  
-    require 'gibbler/aliases'
-    
-    "kimmy".digest               # => c8027100ecc54945ab15ddac529230e38b1ba6a1
-    :kimmy.digest                # => 52be7494a602d85ff5d8a8ab4ffe7f1b171587df
-    
-    a = [:a, :b, :c]
-    a.digest                     # => e554061823b8f06367555d1ee4c25b4ffee61944
-    a << :d
-    a.changed?                   # => true
-
-
-The history methods also have aliases which remove the "gibbler_" prefix.
-    
-    require 'gibbler/aliases'
-    require 'gibbler/history'
-    
-    a = { :magic => :original }     
-    a.commit                     
-    a.history                    
-    a.revert!                    
-    # etc...
-    
-== Example 4 -- Different Digest types
-
-By default Gibbler creates SHA1 hashes. You can change this globally or per instance. 
-
-    require 'gibbler'
-    
-    Gibbler.digest_type = Digest::MD5
-    
-    :kimmy.gibbler               # => 0c61ff17f46223f355759934154d5dcb
-    
-    :kimmy.gibbler(Digest::SHA1) # => 52be7494a602d85ff5d8a8ab4ffe7f1b171587df
-    
-
-In Jruby, you can grab the digest types from the openssl library. 
-
-    require 'openssl'
-    
-    Gibbler.digest_type = OpenSSL::Digest::SHA256
-    
-    :kimmy.gibbler               # => 1069428e6273cf329436c3dce9b680d4d4e229d7b7...
-    
-    
-== Example 5 -- All your base
-
-    require 'gibbler'
-    
-    :kimmy.gibbler               # => 52be7494a602d85ff5d8a8ab4ffe7f1b171587df
-    :kimmy.gibbler.base(16)      # => 52be7494a602d85ff5d8a8ab4ffe7f1b171587df
-    :kimmy.gibbler.base(36)      # => 9nydr6mpv6w4k8ngo3jtx0jz1n97h7j
-
-    :kimmy.gibbler.base(10)      # => 472384540402900668368761869477227308873774630879
-    :kimmy.gibbler.to_i          # => 472384540402900668368761869477227308873774630879
-
-
-== Example 6 -- Global secret
-
-Gibbler can prepend all digest inputs with a global secret. You can set this once per project to ensure your project's digests are unique. 
-
-    require 'gibbler'
-    
-    :kimmy.gibbler               # => 52be7494a602d85ff5d8a8ab4ffe7f1b171587df
-    
-    Gibbler.secret = "sUp0r5ekRu7"
-    
-    :kimmy.gibbler               # => 6c5f5aff4d809cec7e7da091214a35a2698489f8
-    
-
-== Supported Classes
-
-Gibbler methods are available only to the classes which explicitly include them (see RDocs[http://delano.github.com/gibbler] for details on which classes are supported by default). You can also extend custom objects:
-
-    class FullHouse
-      include Gibbler::Complex
-      attr_accessor :roles
-    end
-    
-    a = FullHouse.new
-    a.gibbler                    # => 4192d4cb59975813f117a51dcd4454ac16df6703
-    
-    a.roles = [:jesse, :joey, :danny, :kimmy, :michelle, :dj, :stephanie]
-    a.gibbler                    # => 6ea546919dc4caa2bab69799b71d48810a1b48fa
-    
-Gibbler::Complex creates a digest based on the name of the class and the names and values of the instance variables. See the RDocs[http://delano.github.com/gibbler] for other Gibbler::* types. 
-
-If you want to support all Ruby objects, add the following to your application:
-
-    class Object
-      include Gibbler::String
-    end
-
-Gibbler::String creates a digest based on the name of the class and the output of the to_s method. This is a reasonable default for most objects however any object that includes the object address in to_s (e.g. "Object:0x0x4ac9f0...") will produce unreliable digests (because the address can change).
-
-As of 0.7 all Proc objects have the same digest: <tt>12075835e94be34438376cd7a54c8db7e746f15d</tt>. 
-
-
-
-== Known Issues
-
-* gibbler or gibbled? must be called at least once before gibbled? will be able to return a useful value (otherwise there is no previous digest value to compare to)
-* Digests for Bignum objects are different between Ruby and JRuby. Does anyone know why?
-* Digests for Proc objects are different between Ruby 1.8 and 1.9 because Proc.arity returns different values and 1.8 has no lambda? method.
-
-
-== Installation
-
-Via Rubygems, one of:
-
-    $ gem install gibbler
-    $ gem install delano-gibbler
-
-
-or via download:
-* gibbler-latest.tar.gz[http://github.com/delano/gibbler/tarball/latest]
-* gibbler-latest.zip[http://github.com/delano/gibbler/zipball/latest]
-
-
-== What People Are Saying
-
-* "nice approach - everything is an object, every object is 'gittish'" -- @olgen_morten[http://twitter.com/olgen_morten/statuses/2629909133]
-* "gibbler is just awesome" -- @TomK32[http://twitter.com/TomK32/statuses/2618542872]
-* "wie cool ist Gibbler eigentlich?" -- @we5[http://twitter.com/we5/statuses/2615274279]
-* "it's nice idea and implementation!" -- HristoHristov[http://www.rubyinside.com/gibbler-git-like-hashes-and-history-for-ruby-objects-1980.html#comment-39092]
-
-== More Info
-
-* Codes[http://github.com/delano/gibbler]
-* RDocs[http://delano.github.com/gibbler]
-* Sponsor[http://solutious.com/]
-* Inspiration[http://www.youtube.com/watch?v=fipD4DdV48g]
-
-
-== Thanks
-
-* Kalin Harvey (krrh[http://github.com/krrh]) for the early feedback and artistic direction. 
-* Alex Peuchert (aaalex[http://github.com/aaalex]) for creating the screencast.
-
-
-== Credits
-
-* Delano (@solutious.com)
-
-
-== License
-
-See: LICENSE.txt