thorero 0.9.4

data/History.txt

@@ -0,0 +1 @@
+

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Sam Smoot.
+
+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/Manifest

@@ -0,0 +1,45 @@
+History.txt
+lib/extlib/assertions.rb
+lib/extlib/blank.rb
+lib/extlib/class.rb
+lib/extlib/hash.rb
+lib/extlib/hook.rb
+lib/extlib/inflection.rb
+lib/extlib/lazy_array.rb
+lib/extlib/logger.rb
+lib/extlib/mash.rb
+lib/extlib/module.rb
+lib/extlib/object.rb
+lib/extlib/object_space.rb
+lib/extlib/pathname.rb
+lib/extlib/pooling.rb
+lib/extlib/rubygems.rb
+lib/extlib/simple_set.rb
+lib/extlib/string.rb
+lib/extlib/struct.rb
+lib/extlib/tasks/release.rb
+lib/extlib/time.rb
+lib/extlib/version.rb
+lib/extlib/virtual_file.rb
+lib/extlib.rb
+LICENSE
+Manifest.txt
+Rakefile
+README.txt
+spec/blank_spec.rb
+spec/hash_spec.rb
+spec/hook_spec.rb
+spec/inflection_spec.rb
+spec/lazy_array_spec.rb
+spec/mash_spec.rb
+spec/module_spec.rb
+spec/object_space_spec.rb
+spec/object_spec.rb
+spec/pooling_spec.rb
+spec/simple_set_spec.rb
+spec/spec_helper.rb
+spec/string_spec.rb
+spec/struct_spec.rb
+spec/time_spec.rb
+spec/virtual_file_spec.rb
+Manifest

data/Manifest.txt

@@ -0,0 +1,29 @@
+.autotest
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/extlib.rb
+lib/extlib/assertions.rb
+lib/extlib/blank.rb
+lib/extlib/hook.rb
+lib/extlib/inflection.rb
+lib/extlib/lazy_array.rb
+lib/extlib/module.rb
+lib/extlib/object.rb
+lib/extlib/pathname.rb
+lib/extlib/pooling.rb
+lib/extlib/string.rb
+lib/extlib/struct.rb
+lib/extlib/version.rb
+spec/blank_spec.rb
+spec/hook_spec.rb
+spec/inflection_spec.rb
+spec/lazy_array_spec.rb
+spec/module_spec.rb
+spec/object_spec.rb
+spec/pooling_spec.rb
+spec/spec_helper.rb
+spec/string_spec.rb
+spec/struct_spec.rb
+tasks/hoe.rb

data/README.txt

@@ -0,0 +1,3 @@
+= extlib
+
+A support library for DataMapper, DataObjects and Merb.

data/Rakefile

@@ -0,0 +1,180 @@
+#!/usr/bin/env ruby
+require 'pathname'
+require 'rubygems'
+require 'rake'
+require "rake/clean"
+require "rake/gempackagetask"
+require "fileutils"
+require Pathname('spec/rake/spectask')
+require Pathname('lib/extlib/version')
+
+ROOT = Pathname(__FILE__).dirname.expand_path
+
+AUTHOR = "Test Test"
+EMAIL  = "test.test@gmail.com"
+
+PROJECT_NAME        = "thorero"
+PROJECT_URL         = "http://thorero.rubyforge.org"
+PROJECT_DESCRIPTION = PROJECT_SUMMARY = "Support Library for DataMapper and DataObjects"
+
+GEM_NAME         = PROJECT_NAME
+GEM_VERSION      = Extlib::VERSION
+GEM_DEPENDENCIES = [["english", ">=0.2.0"]]
+GEM_EXTRAS       = { :has_rdoc => false }
+
+RUBY_FORGE_PROJECT = "release-task-playground"
+
+PKG_NAME      = GEM_NAME
+PKG_BUILD     = ENV['PKG_BUILD'] ? '.' + ENV['PKG_BUILD'] : ''
+PKG_VERSION   = Extlib::VERSION + PKG_BUILD
+PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION}"
+
+RELEASE_NAME  = "REL #{PKG_VERSION}"
+
+begin
+  require 'echoe'
+
+  Echoe.new(PROJECT_NAME, Extlib::VERSION) do |p|
+    p.rubyforge_name = PROJECT_NAME
+    
+    p.summary      = PROJECT_SUMMARY
+    p.description  = PROJECT_DESCRIPTION
+    p.url          = PROJECT_URL
+    p.author       = AUTHOR
+    p.email        = EMAIL
+
+    # rdoc
+    p.has_rdoc         = false
+    p.rdoc_pattern = /^(lib|bin|tasks|ext)|^README\.txt|^CHANGELOG|^TODO|^LICENSE$/
+    
+    p.dependencies = ["english >=0.2.0"]
+  end
+
+rescue LoadError => boom
+  puts "You are missing a dependency required for meta-operations on this gem."
+  puts "#{boom.to_s.capitalize}."
+end
+
+
+task :default => 'extlib:spec'
+task :spec    => 'extlib:spec'
+
+desc 'Remove all package, docs and spec products'
+task :clobber_all => %w[ clobber_package clobber_doc extlib:clobber_spec ]
+
+namespace :extlib do
+  Spec::Rake::SpecTask.new(:spec) do |t|
+    t.spec_opts << '--format' << 'specdoc' << '--colour'
+    t.spec_opts << '--loadby' << 'random'
+    t.spec_files = Pathname.glob(ENV['FILES'] || 'spec/**/*_spec.rb')
+
+    begin
+      t.rcov = ENV.has_key?('NO_RCOV') ? ENV['NO_RCOV'] != 'true' : true
+      t.rcov_opts << '--exclude' << 'spec'
+      t.rcov_opts << '--text-summary'
+      t.rcov_opts << '--sort' << 'coverage' << '--sort-reverse'
+    rescue Exception
+      # rcov not installed
+    end
+  end
+end
+
+desc "Generate documentation"
+task :doc do
+  begin
+    require 'yard'
+    exec 'yardoc'
+  rescue LoadError
+    puts 'You will need to install the latest version of Yard to generate the
+          documentation for extlib.'
+  end
+end
+
+WINDOWS = (RUBY_PLATFORM =~ /win32|mingw|bccwin|cygwin/) rescue nil
+SUDO    = WINDOWS ? '' : ('sudo' unless ENV['SUDOLESS'])
+
+desc "Install #{GEM_NAME}"
+task :install => :package do
+  sh %{#{SUDO} gem install --local pkg/#{GEM_NAME}-#{GEM_VERSION} --no-update-sources}
+end
+
+if WINDOWS
+  namespace :dev do
+    desc 'Install for development (for windows)'
+    task :winstall => :gem do
+      system %{gem install --no-rdoc --no-ri -l pkg/#{GEM_NAME}-#{GEM_VERSION}.gem}
+    end
+  end
+end
+
+namespace :ci do
+
+  task :prepare do
+    rm_rf ROOT + "ci"
+    mkdir_p ROOT + "ci"
+    mkdir_p ROOT + "ci/doc"
+    mkdir_p ROOT + "ci/cyclomatic"
+    mkdir_p ROOT + "ci/token"
+  end
+
+  task :publish do
+    out = ENV['CC_BUILD_ARTIFACTS'] || "out"
+    mkdir_p out unless File.directory? out
+
+    mv "ci/unit_rspec_report.html", "#{out}/unit_rspec_report.html"
+    mv "ci/unit_coverage", "#{out}/unit_coverage"
+    mv "ci/integration_rspec_report.html", "#{out}/integration_rspec_report.html"
+    mv "ci/integration_coverage", "#{out}/integration_coverage"
+    mv "ci/doc", "#{out}/doc"
+    mv "ci/cyclomatic", "#{out}/cyclomatic_complexity"
+    mv "ci/token", "#{out}/token_complexity"
+  end
+
+
+  Spec::Rake::SpecTask.new("spec:unit" => :prepare) do |t|
+    t.spec_opts = ["--format", "specdoc", "--format", "html:#{ROOT}/ci/unit_rspec_report.html", "--diff"]
+    t.spec_files = Pathname.glob(ROOT + "spec/unit/**/*_spec.rb")
+    unless ENV['NO_RCOV']
+      t.rcov = true
+      t.rcov_opts << '--exclude' << "spec,gems"
+      t.rcov_opts << '--text-summary'
+      t.rcov_opts << '--sort' << 'coverage' << '--sort-reverse'
+      t.rcov_opts << '--only-uncovered'
+    end
+  end
+
+  Spec::Rake::SpecTask.new("spec:integration" => :prepare) do |t|
+    t.spec_opts = ["--format", "specdoc", "--format", "html:#{ROOT}/ci/integration_rspec_report.html", "--diff"]
+    t.spec_files = Pathname.glob(ROOT + "spec/integration/**/*_spec.rb")
+    unless ENV['NO_RCOV']
+      t.rcov = true
+      t.rcov_opts << '--exclude' << "spec,gems"
+      t.rcov_opts << '--text-summary'
+      t.rcov_opts << '--sort' << 'coverage' << '--sort-reverse'
+      t.rcov_opts << '--only-uncovered'
+    end
+  end
+
+  task :spec do
+    Rake::Task["ci:spec:unit"].invoke
+    mv ROOT + "coverage", ROOT + "ci/unit_coverage"
+
+    Rake::Task["ci:spec:integration"].invoke
+    mv ROOT + "coverage", ROOT + "ci/integration_coverage"
+  end
+
+  task :doc do
+    require 'yardoc'
+    sh 'yardoc'
+  end
+
+  task :saikuro => :prepare do
+    system "saikuro -c -i lib -y 0 -w 10 -e 15 -o ci/cyclomatic"
+    mv 'ci/cyclomatic/index_cyclo.html', 'ci/cyclomatic/index.html'
+
+    system "saikuro -t -i lib -y 0 -w 20 -e 30 -o ci/token"
+    mv 'ci/token/index_token.html', 'ci/token/index.html'
+  end
+end
+
+task :ci => ["ci:spec", "ci:doc", "ci:saikuro", :install, :publish]

data/lib/extlib.rb

@@ -0,0 +1,32 @@
+require 'pathname'
+require 'rubygems'
+
+__DIR__ = File.expand_path(File.dirname(__FILE__))
+$LOAD_PATH.unshift(__DIR__) unless $LOAD_PATH.include?(__DIR__)
+
+# for Pathname /
+require File.expand_path(File.join(__DIR__, 'extlib', 'pathname'))
+
+dir = Pathname(__FILE__).dirname.expand_path / 'extlib'
+
+require dir / "class.rb"
+require dir / "object"
+require dir / "object_space"
+
+require dir / "string"
+require dir / "hash"
+require dir / "mash"
+require dir / "virtual_file"
+require dir / "logger"
+require dir / "time"
+
+require dir / 'assertions'
+require dir / 'blank'
+require dir / 'inflection'
+require dir / 'lazy_array'
+require dir / 'module'
+require dir / 'blank'
+require dir / 'pooling'
+require dir / 'simple_set'
+require dir / 'struct'
+require dir / 'hook'

data/lib/extlib/assertions.rb

@@ -0,0 +1,8 @@
+module Extlib
+  module Assertions
+    def assert_kind_of(name, value, *klasses)
+      klasses.each { |k| return if value.kind_of?(k) }
+      raise ArgumentError, "+#{name}+ should be #{klasses.map { |k| k.name } * ' or '}, but was #{value.class.name}", caller(2)
+    end
+  end
+end

data/lib/extlib/blank.rb

@@ -0,0 +1,42 @@
+# blank? methods for several different class types
+class Object
+  # Returns true if the object is nil or empty (if applicable)
+  def blank?
+    nil? || (respond_to?(:empty?) && empty?)
+  end
+end # class Object
+
+class Numeric
+  # Numerics can't be blank
+  def blank?
+    false
+  end
+end # class Numeric
+
+class NilClass
+  # Nils are always blank
+  def blank?
+    true
+  end
+end # class NilClass
+
+class TrueClass
+  # True is not blank.
+  def blank?
+    false
+  end
+end # class TrueClass
+
+class FalseClass
+  # False is always blank.
+  def blank?
+    true
+  end
+end # class FalseClass
+
+class String
+  # Strips out whitespace then tests if the string is empty.
+  def blank?
+    strip.empty?
+  end
+end # class String

data/lib/extlib/class.rb

@@ -0,0 +1,175 @@
+# Copyright (c) 2004-2008 David Heinemeier Hansson
+# 
+# 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.
+
+# Allows attributes to be shared within an inheritance hierarchy, but where
+# each descendant gets a copy of their parents' attributes, instead of just a
+# pointer to the same. This means that the child can add elements to, for
+# example, an array without those additions being shared with either their
+# parent, siblings, or children, which is unlike the regular class-level
+# attributes that are shared across the entire hierarchy.
+class Class
+  # Defines class-level and instance-level attribute reader.
+  #
+  # @param *syms<Array> Array of attributes to define reader for.
+  # @return <Array[#to_s]> List of attributes that were made into cattr_readers
+  #
+  # @api public
+  #
+  # @todo Is this inconsistent in that it does not allow you to prevent
+  #   an instance_reader via :instance_reader => false
+  def cattr_reader(*syms)
+    syms.flatten.each do |sym|
+      next if sym.is_a?(Hash)
+      class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+        unless defined? @@#{sym}
+          @@#{sym} = nil
+        end
+
+        def self.#{sym}
+          @@#{sym}
+        end
+
+        def #{sym}
+          @@#{sym}
+        end
+      RUBY
+    end
+  end
+
+  # Defines class-level (and optionally instance-level) attribute writer.
+  #
+  # @param <Array[*#to_s, Hash{:instance_writer => Boolean}]> Array of attributes to define writer for.
+  # @option syms :instance_writer<Boolean> if true, instance-level attribute writer is defined.
+  # @return <Array[#to_s]> List of attributes that were made into cattr_writers
+  #
+  # @api public
+  def cattr_writer(*syms)
+    options = syms.last.is_a?(Hash) ? syms.pop : {}
+    syms.flatten.each do |sym|
+      class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+        unless defined? @@#{sym}
+          @@#{sym} = nil
+        end
+
+        def self.#{sym}=(obj)
+          @@#{sym} = obj
+        end
+      RUBY
+      
+      unless options[:instance_writer] == false
+        class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+          def #{sym}=(obj)
+            @@#{sym} = obj
+          end
+        RUBY
+      end
+    end
+  end
+
+  # Defines class-level (and optionally instance-level) attribute accessor.
+  #
+  # @param *syms<Array[*#to_s, Hash{:instance_writer => Boolean}]> Array of attributes to define accessor for.
+  # @option syms :instance_writer<Boolean> if true, instance-level attribute writer is defined.
+  # @return <Array[#to_s]> List of attributes that were made into accessors
+  #
+  # @api public
+  def cattr_accessor(*syms)
+    cattr_reader(*syms)
+    cattr_writer(*syms)
+  end
+
+  # Defines class-level inheritable attribute reader. Attributes are available to subclasses,
+  # each subclass has a copy of parent's attribute.
+  #
+  # @param *syms<Array[#to_s]> Array of attributes to define inheritable reader for.
+  # @return <Array[#to_s]> Array of attributes converted into inheritable_readers.
+  #
+  # @api public
+  #
+  # @todo Do we want to block instance_reader via :instance_reader => false
+  # @todo It would be preferable that we do something with a Hash passed in
+  #   (error out or do the same as other methods above) instead of silently
+  #   moving on). In particular, this makes the return value of this function
+  #   less useful.
+  def class_inheritable_reader(*ivars)
+    instance_reader = ivars.pop[:reader] if ivars.last.is_a?(Hash)
+    
+    ivars.each do |ivar|
+      self.class_eval <<-RUBY, __FILE__, __LINE__ + 1
+        def self.#{ivar}
+          return @#{ivar} if self == #{self} || defined?(@#{ivar})
+          ivar = superclass.#{ivar}
+          return nil if ivar.nil? && !#{self}.instance_variable_defined?("@#{ivar}")
+          @#{ivar} = ivar && !ivar.is_a?(Module) ? ivar.dup : ivar
+        end
+      RUBY
+      unless instance_reader == false
+        self.class_eval <<-RUBY, __FILE__, __LINE__ + 1
+          def #{ivar}
+            self.class.#{ivar}
+          end
+        RUBY
+      end
+    end
+  end
+  
+  # Defines class-level inheritable attribute writer. Attributes are available to subclasses,
+  # each subclass has a copy of parent's attribute.
+  #
+  # @param *syms<Array[*#to_s, Hash{:instance_writer => Boolean}]> Array of attributes to
+  #   define inheritable writer for.
+  # @option syms :instance_writer<Boolean> if true, instance-level inheritable attribute writer is defined.
+  # @return <Array[#to_s]> An Array of the attributes that were made into inheritable writers.
+  #
+  # @api public
+  #
+  # @todo We need a style for class_eval <<-HEREDOC. I'd like to make it 
+  #   class_eval(<<-RUBY, __FILE__, __LINE__), but we should codify it somewhere.
+  def class_inheritable_writer(*ivars)
+    instance_writer = ivars.pop[:instance_writer] if ivars.last.is_a?(Hash)
+    ivars.each do |ivar|
+      self.class_eval <<-RUBY, __FILE__, __LINE__ + 1
+        def self.#{ivar}=(obj)
+          @#{ivar} = obj        
+        end
+      RUBY
+      unless instance_writer == false
+        self.class_eval <<-RUBY, __FILE__, __LINE__ + 1
+          def #{ivar}=(obj) self.class.#{ivar} = obj end
+        RUBY
+      end
+    end
+  end
+  
+  # Defines class-level inheritable attribute accessor. Attributes are available to subclasses,
+  # each subclass has a copy of parent's attribute.
+  #
+  # @param *syms<Array[*#to_s, Hash{:instance_writer => Boolean}]> Array of attributes to 
+  #   define inheritable accessor for.
+  # @option syms :instance_writer<Boolean> if true, instance-level inheritable attribute writer is defined.
+  # @return <Array[#to_s]> An Array of attributes turned into inheritable accessors.
+  #
+  # @api public
+  def class_inheritable_accessor(*syms)
+    class_inheritable_reader(*syms)
+    class_inheritable_writer(*syms)
+  end
+end