zucker 4 → 5

data/CHANGELOG

@@ -1,11 +1,25 @@
-2010-09-01 | Zucker 4
+2010-09-04 | Zucker 5
+* debug edition -  added two debug helpers: oo (output line, method, file) and cc (output method callstack)
+* renamed cube D to dd add added more debug aliases (for mm and binding)
+* fixed __SPECIAL_VARS__ in info and kernel cube and some minor bugfixes
+* Zucker.activate_more_aliases! option
+* added Hash#&
+* added aliases: File.filename (for basename), Dir.join and Dir.split (for File.join, split)
+* added a flexible requiring mechansim in zucker.rb (no api changes)
+* restructered packages
+* added rake tasks for releasing
+* improved RubyVersion constant (cleaner and more flexible)
+
 
+2010-09-01 | Zucker 4
+* fixed Binding#inspect
 * added RubyEngine constant
 * added RubyVersion constant
 * added OS constant
 * added q debug method (like p but on one line)
 * added String#-
 
+
 2010-08-14 | Zucker 3
 * added tap cube
 * added Object#not

data/Rakefile

@@ -18,6 +18,9 @@ end
 task 'default' => 'spec'
 Spec::Rake::SpecTask.new('spec') do |t|
   t.spec_files = FileList['spec/*.rb']
+  if RUBY_VERSION < '1.9'
+    t.spec_files -= Zucker::NON_1_8_CUBES.map{|e| "spec/#{e}_spec.rb"}
+  end
 end
 
 # gem
@@ -41,3 +44,44 @@ Rake::GemPackageTask.new(spec) do |pkg|
   pkg.gem_spec = spec
 end
 
+# release
+desc 'run specs, build doc, bump version, set date, copy version directories and add these changes to git'
+task 'prepare_release' => %w[spec doc] do # run specs and doc
+  # really want to release?
+  print 'Do you really want to release? ...then enter release: '
+  exit if $stdin.gets.chomp != 'release'
+
+  # bump version and date
+  require 'date'
+  zucker_rb = File.read('lib/zucker.rb')
+  zucker_rb.sub! /VERSION\s*=.*(\d+).*$/ do "VERSION = '#{ @v = $1.to_i + 1 }'" end
+  zucker_rb.sub! /DATE\s*=.*$/, "DATE = '#{Date.today}'"
+  File.open 'lib/zucker.rb','w' do |f| f.write zucker_rb end
+
+  # copy version directories
+  `mkdir lib/zucker/#@v`
+  `cp lib/zucker/*.* lib/zucker/#@v/`
+  `mkdir desc/#@v`
+  `cp desc/*.* desc/#@v/`
+  `mkdir doc/#@v`
+  `cp doc/*.* doc/#@v/`
+  `mkdir spec/#@v`
+  `cp spec/*.* spec/#@v/`
+
+  # add changes to git and tag
+  `git add .`
+  `git commit -m 'Ruby Zucker #@v :)'`
+  `git tag -a v#@v -m 'Ruby Zucker #@v :)'`
+
+   # done
+   puts "prepared Zucker #@v gem release"
+end
+
+desc 'prepare_release, build gem, and push it to git and rubygems'
+task 'release' => %w[gem] do
+  `git push origin master --tags`
+  last_gem = Dir['pkg/zucker-*.gem'].sort[-1] # TODO better sorting or date for zucker-10
+  exit if last_gem =~ /next/ # some error happened, do not pollute rubygems.org
+  puts last_gem
+  #`gem push pkg/#{last_gem}`
+end

data/lib/zucker.rb

@@ -1,19 +1,80 @@
 # documentation at http://rubyzucker.info or doc/zucker_doc.html
 
 module Zucker
-  VERSION = '4'
-  DATE    = '2010-09-01' # version 3
-end
+  # version and date get modified by the :prepare_release rake task
+  VERSION = '5'
+  DATE = '2010-09-04'
+  
+  # cube list
+  PACKAGES = {
+    :control    => %w|egonil iterate tap sandbox kernel|,
+    :env        => %w|engine info os version|,
+    :extensions => %w|array enumerable hash string unary union|,
+    :object     => %w|blank mcopy not|,
+    :to_proc    => %w|array2proc class2proc hash2proc regexp2proc|,
+    :shortcuts  => %w|aliases alias_for square_brackets_for ivars|,
+    :debug      => %w|binding cc dd mm oo qq|,
+  }
+
+  NON_1_8_CUBES = %w|not tap union|
+
+  class << self
+    # Zucker require helpers
+    def require_cube(cube, version = '')
+      unless RUBY_VERSION < '1.9' && Zucker::NON_1_8_CUBES.include?(cube)
+        require File.expand_path( File.join('..', 'zucker', version, cube), __FILE__)
+      end
+    end
 
-# nothing further is done here
-#  to use zucker:
+    def require_package(package, version = '')
+      PACKAGES[package.to_sym].each{ |cube|
+        require_cube cube, version
+      }
+    end
 
-# require 'zucker/default'
+    def require_this(filename)
+      version=  File.split( File.expand_path( filename) )[-2]
+      version = '' if version !~ /^\d+$/
+      package = File.basename( filename ).chomp( File.extname( filename ))
+      Zucker.require_package(package, version)
+    end
 
-#  and/or
+    def require_all(version = '')
+      require_default( version ) +
+      [require_package( :debug, version )]
+    end
 
-# require 'zucker/debug'
+    def require_default(version = '')
+      PACKAGES.map{ |package, _|
+        require_package package if package != :debug
+      }.compact
+    end
+
+    # these aliases 'pollute' the global namespace or may conflict with other codee
+    def activate_more_aliases!
+      aliases = {
+        :mcopy       => :copy,
+        :egonil      => :n,
+        :make_new    => :init,
+        :tap_on      => :returning,
+        :library?    => :lib?,
+        :square_brackets_for => :brackets,
+      }
+
+      loaded_aliases = []
+      aliases.each{ |old, new|
+        Object.class_eval "alias #{new} #{old}; loaded_aliases << :#{new}" rescue nil
+      }
+      eval "::RV = RubyVersion; loaded_aliases << :RV" rescue nil
+      eval "::RE = RubyEngine;  loaded_aliases << :RE" rescue nil
+      
+      loaded_aliases
+    end
+    alias more_aliases! activate_more_aliases!
+  end
+end
 
-#  or cherry-pick the cubes you want ;)
+# You can use Zucker with
+#  require 'zucker/all'
 
-# eg. require 'zucker/egonil'
+# J-_-L

data/lib/zucker/1/D.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 module Kernel
   def D(*args, &block)
     if args.empty?

data/lib/zucker/1/aliases.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 alias is_an? is_a?
 
 module Enumerable

data/lib/zucker/1/all.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 # require all the sugar ;)
 # see README for an explaination of what they do
 

data/lib/zucker/1/array.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Array
   def ^(other) # TODO: more efficient
     (self - other) +

data/lib/zucker/1/array2proc.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Array
   def to_proc
     Proc.new{ |obj|

data/lib/zucker/1/binding.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Binding
   def inspect
     put_vars = lambda { |array|

data/lib/zucker/1/blank.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Object
   def blank?
     if respond_to? :empty? then empty? else !self end

data/lib/zucker/1/class2proc.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Class
   def to_proc
     Proc.new do |*args|

data/lib/zucker/1/debug.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 require 'zucker/1/D'
 require 'zucker/1/mm'
 require 'zucker/1/binding'

data/lib/zucker/1/default.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 # default
 zucker = %w|
 aliases

data/lib/zucker/1/egonil.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 def egonil(nil_value = nil)
   yield
 rescue NoMethodError => e

data/lib/zucker/1/enumerable.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 module Enumerable
   def mash
     ret = {}

data/lib/zucker/1/hash.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Hash
   def self.zip(keys,values)
     Hash[ *[1,2,3].zip( [4,5,6] ).flatten ]

data/lib/zucker/1/hash2proc.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Hash
   def to_proc
     Proc.new{ |obj|

data/lib/zucker/1/iterate.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 def iterate(*params)
   # params.shift.zip(*params).each{ |*elements| yield *elements }
 

data/lib/zucker/1/ivars.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 def instance_variables_from(obj, *only)
   iter =
   if    obj.is_a? Binding

data/lib/zucker/1/kernel.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 def activate_warnings!
   $VERBOSE = true
 end

data/lib/zucker/1/mcopy.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Object
   def mcopy
     Marshal.load Marshal.dump self

data/lib/zucker/1/mm.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 module Kernel
   def method_list(levels = 1)
     if self.is_a? Module

data/lib/zucker/1/regexp2proc.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Regexp
   def to_proc
     proc do |e|

data/lib/zucker/1/sandbox.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 def sandbox(rescueblock=nil)
   Thread.start do
     $SAFE = 4

data/lib/zucker/1/square_brackets_for.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 def square_brackets_for(ivar, assignment = true)
 #  undef []   if respond_to? :[]
 #  undef []=  if respond_to? :[]=

data/lib/zucker/1/string.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class String
   def ^(pos)
     pos = pos.to_i

data/lib/zucker/1/unary.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class String
   def +@
     self

data/lib/zucker/1/union.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Regexp
   def |(arg)
     Regexp.union self, arg.is_a?(Regexp) ? arg : arg.to_s

data/lib/zucker/2/D.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 module Kernel
   def D(*args, &block)
     if args.empty?

data/lib/zucker/2/aliases.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 alias is_an? is_a?
 
 module Enumerable

data/lib/zucker/2/all.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 # require all the sugar ;)
 # see README for an explaination of what they do
 

data/lib/zucker/2/array.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Array
   def ^(other) # TODO: more efficient
     (self - other) +

data/lib/zucker/2/array2proc.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Array
   def to_proc
     Proc.new{ |obj|

data/lib/zucker/2/binding.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Binding
   def inspect
     put_vars = lambda { |array|

data/lib/zucker/2/blank.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Object
   def blank?
     if respond_to? :empty? then empty? else !self end

data/lib/zucker/2/class2proc.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Class
   def to_proc
     Proc.new do |*args|

data/lib/zucker/2/debug.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 require 'zucker/2/D'
 require 'zucker/2/mm'
 require 'zucker/2/binding'

data/lib/zucker/2/default.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 # default
 zucker = %w|
 aliases

data/lib/zucker/2/egonil.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 def egonil(nil_value = nil)
   yield
 rescue NoMethodError => e

data/lib/zucker/2/enumerable.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 module Enumerable
   def mash
     ret = {}

data/lib/zucker/2/hash.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Hash
   def self.zip(keys,values)
     Hash[ *keys.zip( values ).flatten ]

data/lib/zucker/2/hash2proc.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 class Hash
   def to_proc
     Proc.new{ |obj|

data/lib/zucker/2/info.rb

@@ -1,3 +1,5 @@
+require 'zucker'
+
 module Info
   class << Info
     # hash like access