gibbler 0.2

data/CHANGES.txt

@@ -0,0 +1,6 @@
+GIBBLER, CHANGES
+
+
+#### 0.2 (2009-06-25) ###############################
+
+NOTE: Initial release

data/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2009 Solutious Inc, Delano Mandelbaum
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,31 @@
+= Gibbler - v0.2 
+
+Git-like hashes for Ruby objects.
+
+    
+    config = {}
+    config.gibbler             # => 57589e9811fe00c307ed3ab740cdac516c9975cb
+    
+    config[:server] = { 
+      :users => [:dave, :ali], 
+      :ports => [22, 80, 443]
+    }
+    config.gibbler             # => 87d792aefceb893b2d966828827c61636b0ace3e 
+    
+    config[:server][:users] << :yanni
+    
+    config.gibbler             # => 126ea10af73149ae4e69b0e036aa1d47a7651f07
+
+== ALPHA NOTICE
+
+This code is hella fresh. It's ugly and barely tested, but it's fun to play with. I'll happily accept patches. 
+
+
+== Credits
+
+* Delano Mandelbaum (delano@solutious.com)
+
+
+== License
+
+See: LICENSE.txt

data/Rakefile

@@ -0,0 +1,79 @@
+require 'rubygems'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'hanna/rdoctask'
+require 'fileutils'
+include FileUtils
+ 
+task :default => :package
+ 
+# CONFIG =============================================================
+
+# Change the following according to your needs
+README = "README.rdoc"
+CHANGES = "CHANGES.txt"
+LICENSE = "LICENSE.txt"
+
+# Files and directories to be deleted when you run "rake clean"
+CLEAN.include [ 'pkg', '*.gem', '.config']
+
+name = 'gibbler'
+load "#{name}.gemspec"
+version = @spec.version
+
+# That's it! The following defaults should allow you to get started
+# on other things. 
+
+
+# TESTS/SPECS =========================================================
+
+
+
+# INSTALL =============================================================
+
+Rake::GemPackageTask.new(@spec) do |p|
+  p.need_tar = true if RUBY_PLATFORM !~ /mswin/
+end
+
+task :release => [ :rdoc, :package ]
+task :install => [ :rdoc, :package ] do
+	sh %{sudo gem install pkg/#{name}-#{version}.gem}
+end
+task :uninstall => [ :clean ] do
+	sh %{sudo gem uninstall #{name}}
+end
+
+
+# RUBYFORGE RELEASE / PUBLISH TASKS ==================================
+
+if @spec.rubyforge_project
+  desc 'Publish website to rubyforge'
+  task 'publish:rdoc' => 'doc/index.html' do
+    sh "scp -rp doc/* rubyforge.org:/var/www/gforge-projects/#{name}/"
+  end
+
+  desc 'Public release to rubyforge'
+  task 'publish:gem' => [:package] do |t|
+    sh <<-end
+      rubyforge add_release -o Any -a #{CHANGES} -f -n #{README} #{name} #{name} #{@spec.version} pkg/#{name}-#{@spec.version}.gem &&
+      rubyforge add_file -o Any -a #{CHANGES} -f -n #{README} #{name} #{name} #{@spec.version} pkg/#{name}-#{@spec.version}.tgz 
+    end
+  end
+end
+
+
+
+# RUBY DOCS TASK ==================================
+
+Rake::RDocTask.new do |t|
+	t.rdoc_dir = 'doc'
+	t.title    = @spec.summary
+	t.options << '--line-numbers' 
+	t.options << '--charset' << 'utf-8'
+	t.rdoc_files.include(LICENSE)
+	t.rdoc_files.include(README)
+	t.rdoc_files.include(CHANGES)
+	t.rdoc_files.include('lib/**/*.rb')
+end
+
+

data/gibbler.gemspec

@@ -0,0 +1,39 @@
+@spec = Gem::Specification.new do |s|
+	s.name = "gibbler"
+  s.rubyforge_project = "gibbler"
+	s.version = "0.2"
+	s.summary = "Gibbler: Git-like hashes for Ruby objects"
+	s.description = s.summary
+	s.author = "Delano Mandelbaum"
+	s.email = "delano@solutious.com"
+	s.homepage = "http://github.com/delano/gibbler"
+  
+  # = EXECUTABLES =
+  # The list of executables in your project (if any). Don't include the path, 
+  # just the base filename.
+  s.executables = %w[]
+  
+  # Directories to extract rdocs from
+  s.require_paths = %w[lib]  
+  
+  # Specific files to include rdocs from
+  s.extra_rdoc_files = ["README.rdoc", "LICENSE.txt"]
+  s.has_rdoc = true
+  
+  # Update --main to reflect the default page to display
+  s.rdoc_options = ["--line-numbers", "--title", s.summary, "--main", "README.rdoc"]
+  
+  # = MANIFEST =
+  s.files = %w(
+  README.rdoc
+  CHANGES.txt
+  LICENSE.txt
+  Rakefile
+  gibbler.gemspec
+  lib/gibbler.rb
+  )
+  
+  s.has_rdoc = true
+  s.rubygems_version = '1.3.0'
+  
+end

data/lib/gibbler.rb

@@ -0,0 +1,82 @@
+
+require 'digest/sha1'
+
+# = Object
+# 
+# "Hola, Tanneritos"
+#
+class Object
+  
+  @@gibbler_digest_type = Digest::SHA1
+  @@gibbler_debug = false
+  
+  # Specify a different digest class. The default is +Digest::SHA1+. You 
+  # could try +Digest::SHA256+ by doing this: 
+  # 
+  #     Object.gibbler_digest_type = Digest::SHA256
+  #
+  def self.gibbler_digest_type=(v)
+    @@gibbler_digest_type = v
+  end
+    # Returns the current digest class. 
+  def self.gibbler_digest_type; @@gibbler_digest_type; end
+    # Returns the current debug status (true or false)
+  def self.gibbler_debug?;      @@gibbler_debug; end
+    # Enable debugging with a true value
+  def self.gibbler_debug=(v);   @@gibbler_debug = v; end
+  
+  # Calculates a digest for the current object instance. 
+  # Objects that are a kind of Hash or Array are processed
+  # recursively. The length of the returned String depends 
+  # on the digest type. 
+  def to_gibble
+    gibbler_debug [:GIBBLER, self.class, self]
+    @__gibble__ = __default_gibbler self
+  end
+  
+  # Has this object been modified?
+  def gibbled?
+    was, now = @__gibble__.clone, self.to_gibble
+    gibbler_debug [:gibbled?, was, now]
+    was != now
+  end
+  
+  private
+  def __default_gibbler(h)
+    klass = h.class
+    if h.respond_to? :__custom_gibbler
+      h.__custom_gibbler
+      
+    elsif h.kind_of?(Hash) || h.respond_to?(:keys)
+      d = h.keys.sort { |a,b| a.inspect <=> b.inspect }
+      d.collect! do |name| 
+        '%s:%s:%s' % [klass, name, __default_gibbler(h[name])]
+      end 
+      a = __default_gibbler d.join($/)
+      gibbler_debug [klass, a]
+      a
+      
+    elsif h.kind_of?(Array)
+      d, index = [], 0
+      h.each do |value| 
+        d << '%s:%s:%s' % [h.class, index, __default_gibbler(value)]
+        index += 1
+      end
+      a = __default_gibbler d.join($/)
+      gibbler_debug [klass, a]
+      a
+      
+    else
+      value = h.nil? ? "\0" : h.to_s
+      a=@@gibbler_digest_type.hexdigest "%s:%d:%s" % [klass, value.size, value]
+      gibbler_debug [klass, value.size, value, a]
+      a
+      
+    end
+  end
+  
+  def gibbler_debug(*args)
+    return unless @@gibbler_debug == true
+    p *args 
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: gibbler
+version: !ruby/object:Gem::Version 
+  version: "0.2"
+platform: ruby
+authors: 
+- Delano Mandelbaum
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-25 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: "Gibbler: Git-like hashes for Ruby objects"
+email: delano@solutious.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE.txt
+files: 
+- README.rdoc
+- CHANGES.txt
+- LICENSE.txt
+- Rakefile
+- gibbler.gemspec
+- lib/gibbler.rb
+has_rdoc: true
+homepage: http://github.com/delano/gibbler
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --title
+- "Gibbler: Git-like hashes for Ruby objects"
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: gibbler
+rubygems_version: 1.3.2
+signing_key: 
+specification_version: 3
+summary: "Gibbler: Git-like hashes for Ruby objects"
+test_files: []
+