zucker 2 → 3

data/CHANGELOG

@@ -1,3 +1,15 @@
+2010-08-14 | Zucker 3
+* added tap cube
+* added Object#not
+* added alias_for for an alternative alias syntax
+* added String#constantize (improved AS version)
+* improved Info module
+* made Array#sum Rails compatibile
+* improved docs
+* changed directory layout (no changes for requiring)
+* more small changes
+
+
 2010-08-08 | Zucker 2
 * added info cube
 * added chaining for array2proc

data/README

@@ -1,4 +1,7 @@
-See http://rubyzucker.info
+See http://rubyzucker.info or doc/zucker_doc.html
+
+Please see the github wiki page, for discussion and contributing: http://wiki.github.com/janlelis/zucker
 
 Copyright (c) 2010 Jan Lelis, http://rbjl.net, released under the MIT license
 
+J-_-L

data/Rakefile

@@ -3,28 +3,38 @@ require 'rake'
 require 'rake/gempackagetask'
 require 'spec/rake/spectask'
 
+if RUBY_VERSION >= '1.9.2'
+  require_relative 'lib/zucker'
+else
+  require 'lib/zucker'
+end
+
 desc 'Build documentation'
 task 'doc' do
-  zucker_path = "#{ Rake.application.find_rakefile_location[1] }/lib/zucker"
+  zucker_path = Rake.application.find_rakefile_location[1]
   ruby File.join(zucker_path, 'doc/zucker_doc.rb'), zucker_path
 end
 
+task 'default' => 'spec'
 Spec::Rake::SpecTask.new('spec') do |t|
-  t.spec_files = FileList['lib/zucker/spec/**/*.rb']
+  t.spec_files = FileList['spec/*.rb']
 end
 
 # gem
 PKG_FILES = FileList[ '[a-zA-Z]*', 'lib/**/*' ]
 spec = Gem::Specification.new do |s|
   s.name = 'zucker'
-  s.version = '2'
-  s.date = '2010-08-08'
-  s.authors = ['Jan Lelis']
+  s.version = Zucker::VERSION
+  s.date = Zucker::DATE
+  s.authors = ['Based on the thoughts of many people ;)', 'Jan Lelis']
   s.email = 'mail@janlelis.de'
-  s.summary = 'Make your Ruby code even sweeter with this syntacitcal sugar: http://rubyzucker.info :)'
+  s.summary = "Make your Ruby code even sweeter with syntactic sugar :)
+Adds lots of little helpers that you never want to miss again.
+See http://rubyzucker.info"
   s.homepage = 'http://rubyzucker.info'
   s.files = PKG_FILES.to_a
-  s.require_paths = [".","lib"]
+  s.require_paths = ["lib"]
+  s.required_ruby_version = '>= 1.8.7' # 1.9 recommended
 end
 
 Rake::GemPackageTask.new(spec) do |pkg|

data/lib/zucker.rb

@@ -1,4 +1,9 @@
-# nothing is done here
+module Zucker
+  VERSION = '3'
+  DATE    = '2010-08-14'
+end
+
+# nothing further is done here
 #  to use zucker:
 
 # require 'zucker/default'
@@ -9,3 +14,4 @@
 
 #  or cherry-pick the cubes you want ;)
 
+# eg. require 'zucker/egonil'

data/lib/zucker/2/all.rb

@@ -1,6 +1,6 @@
 # require all the sugar ;)
 # see README for an explaination of what they do
 
-require 'zucker/default'
-require 'zucker/debug'
+require 'zucker/2/default'
+require 'zucker/2/debug'
 

data/lib/zucker/2/debug.rb

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

data/lib/zucker/2/default.rb

@@ -21,5 +21,5 @@ unary
 union
 |
 
-zucker.each{|rb| require "zucker/#{rb}"}
+zucker.each{|rb| require "zucker/2/#{rb}"}
 

data/lib/zucker/3/D.rb

@@ -0,0 +1,19 @@
+module Kernel
+  def D(*args, &block)
+    if args.empty?
+      tap{
+        if block_given?
+          puts yield self
+        else
+          puts self.inspect
+        end
+      }
+    else
+      raise ArgumentError, ".D - The parser thought that the code after .D are method arguments... Please don't put a space after D or use .D() or .D{} in this case!"
+#      eval ...
+    end
+  end
+end
+
+# J-_-L
+

data/lib/zucker/3/alias_for.rb

@@ -0,0 +1,19 @@
+def alias_for(m, *aliases)
+  aliases.each{ |a|
+    class_eval "alias #{a} #{m}"
+  }
+end
+alias aliases_for alias_for
+
+class Module
+  def alias_method_for(m, *alias_methods)
+    alias_methods.each{ |a|
+      class_eval do
+        alias_method a.to_sym, m.to_sym
+      end
+    }
+  end
+  alias alias_methods_for alias_method_for
+end
+
+# J-_-L

data/lib/zucker/3/aliases.rb

@@ -0,0 +1,28 @@
+alias is_an? is_a?
+
+module Enumerable
+  alias with zip
+  alias %    zip
+end
+
+class Array
+  alias ** product
+end
+
+class Hash
+  alias + merge
+end
+
+class Binding
+  #alias [] eval
+  def [](expr)
+    self.eval "#{expr}"
+  end
+end
+
+# constants - who would use these in real-world code for other things?
+Infinity = 1.0 / 0.0 # or 2*Float::MAX
+NaN      = 0.0 / 0.0
+
+# J-_-L
+

data/lib/zucker/3/all.rb

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

data/lib/zucker/3/array.rb

@@ -0,0 +1,23 @@
+class Array
+  def ^(other) # TODO: more efficient
+    (self - other) +
+    (other - self)
+  end
+
+  # can take an argument & block to be Rails compatible
+  def sum(identity = 0, &block)
+    # inject(:+)
+    if block_given?
+      map(&block).sum( identity )
+    else
+      inject(:+) || identity
+    end
+  end
+
+  def chrs
+    self.pack 'C*'
+  end
+end
+
+# J-_-L
+

data/lib/zucker/3/array2proc.rb

@@ -0,0 +1,16 @@
+class Array
+  def to_proc
+    Proc.new{ |obj|
+      if self.first.is_a? Array
+        self.inject(obj){ |result, nested_array|
+          nested_array.to_proc.call result
+        }
+      else
+        obj.send *self
+      end
+    }
+  end
+end
+
+# J-_-L
+

data/lib/zucker/3/binding.rb

@@ -0,0 +1,25 @@
+class Binding
+  def inspect
+    put_vars = lambda { |array|
+      if array.empty?
+        ' - none'
+      else
+        array.map{|e| " - #{e}: #{ self.eval '#{e}'}"}*"\n"
+      end
+    }
+
+"#{self.to_s}
+local vars
+#{ put_vars[ self.eval 'local_variables' ] }
+(instance vars)
+#{ put_vars[ self.eval 'instance_variables' ] }
+self
+ - #{self.eval 'self'}
+block_given?
+ - #{self.eval 'block_given?'}"
+
+  end
+end
+
+# J-_-L
+

data/lib/zucker/3/blank.rb

@@ -0,0 +1,26 @@
+class Object
+  def blank?
+    if respond_to? :empty? then empty? else !self end
+  end
+
+  def present?
+    !blank?
+  end
+end
+
+
+{ # what to do              # for which classes
+  lambda{ true }         => [FalseClass, NilClass],
+  lambda{ false }        => [TrueClass, Numeric],
+  lambda{ empty? }       => [Array, Hash],
+  lambda{ self !~ /\S/ } => [String],
+  lambda{ self == //   } => [Regexp],
+
+}.each{ |action, klass_array|
+  klass_array.each{ |klass|
+    klass.send :define_method, :blank?, &action
+  }
+}
+
+# J-_-L
+

data/lib/zucker/3/class2proc.rb

@@ -0,0 +1,10 @@
+class Class
+  def to_proc
+    Proc.new do |*args|
+      self.new *args
+    end
+  end
+end
+
+# J-_-L
+

data/lib/zucker/3/debug.rb

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

data/lib/zucker/3/default.rb

@@ -0,0 +1,35 @@
+require 'zucker'
+
+# default
+zucker = %w|
+alias_for
+aliases
+array
+array2proc
+blank
+class2proc
+egonil
+enumerable
+hash
+hash2proc
+info
+iterate
+ivars
+kernel
+mcopy
+not
+regexp2proc
+sandbox
+square_brackets_for
+string
+tap
+unary
+union
+|
+
+# remove 1.9 if 1.8
+if RUBY_VERSION < '1.9'
+  zucker -= %w|not tap union|
+end
+
+zucker.each{|rb| require File.join( 'zucker', '3', rb )}

data/lib/zucker/3/egonil.rb

@@ -0,0 +1,14 @@
+def egonil(nil_value = nil)
+  yield
+rescue NoMethodError => e
+  if e.message =~ /NilClass$/
+    nil_value
+  else
+    raise NoMethodError
+  end
+end
+
+alias nn egonil
+
+# J-_-L
+

data/lib/zucker/3/enumerable.rb

@@ -0,0 +1,12 @@
+module Enumerable
+  def mash
+    ret = {}
+    each{ |kv|
+      ret.store *( yield(kv)[0,2] )
+    }
+    ret
+  end
+end
+
+# J-_-L
+

data/lib/zucker/3/hash.rb

@@ -0,0 +1,19 @@
+class Hash
+  def self.zip(keys,values)
+    Hash[ *keys.zip( values ).flatten ]
+  end
+
+  def <<(other)
+    case
+    when other.is_a?(Hash)
+      merge! other
+    when other.is_a?(Enumerable) || other.respond_to?(:to_splat)
+      merge! Hash[*other]
+    else
+      raise TypeError, 'can only append other Hashs and Enumerables (or Classes that implement to_splat)'
+    end
+  end
+end
+
+# J-_-L
+

data/lib/zucker/3/hash2proc.rb

@@ -0,0 +1,14 @@
+class Hash
+  def to_proc
+    Proc.new{ |obj|
+      if self.member? obj
+        self[obj].to_proc.call obj
+      else
+        obj
+      end
+    }
+  end
+end
+
+# J-_-L
+

data/lib/zucker/3/info.rb

@@ -0,0 +1,167 @@
+module Info
+  class << Info
+    # hash like access
+    def [](what)
+      send what
+    end
+
+    # list available info methods
+    def list
+      singleton_methods - [:[], :list, '[]', 'list']
+    end
+  end
+
+  module_function
+
+  # current script file
+  def current_file
+    __FILE__
+  end
+
+  def current_file_directory
+    File.dirname(__FILE__)
+  end
+
+  # input
+  def last_input_file
+    $FILENAME
+  end
+
+  def last_input_line_number
+    $.
+  end
+
+  def last_input
+    $_
+  end
+
+  # program
+  def program_name
+    $0
+  end
+
+  def program_arguments
+    $:
+  end
+
+  def loaded_programs
+    $"
+  end
+
+  def program_data
+    ::DATA
+  end
+
+  def child_program_status
+    $CHILD_STATUS
+  end
+
+  # system info
+  def environment
+    ::ENV
+  end
+  alias env environment
+
+  def working_directory
+    Dir.pwd
+  end
+
+  def platform
+    ::RUBY_PLATFORM
+  end
+
+  def process_id
+    $$
+  end
+
+  def load_path
+    $:
+  end
+
+  # current
+  def current_line
+    __LINE__
+  end
+
+  def current_method # 1.9
+    __method__
+  end
+
+  def current_callstack
+    caller
+  end
+
+  # dealing with strings
+  def gets_separator
+    $/
+  end
+
+  def join_separator
+    $,
+  end
+
+  def print_separator
+    $,
+  end
+
+  def split_separator
+    $;
+  end
+
+  # misc
+  def security_level
+    $SAFE
+  end
+
+  def warnings_activated?
+    $VERBOSE
+  end
+
+  def debug_activated?
+    $DEBUG
+  end
+
+  def last_exception
+    $!
+  end
+
+  # defined objects
+  def global_variables
+    Object.send :global_variables
+  end
+
+  def global_constants
+    Object.constants
+  end
+
+  # encoding (1.9)
+  def source_encoding
+    __ENCODING__
+  end
+
+  def external_encoding
+    Encoding.default_external
+  end
+
+  def internal_encoding
+    Encoding.default_internal
+  end
+
+  # ruby version info
+  def ruby_version
+    ::RUBY_VERSION
+  end
+
+  def ruby_patchlevel
+    ::RUBY_PATCHLEVEL
+  end
+
+  def ruby_description
+    ::RUBY_DESCRIPTION
+  end
+
+  def ruby_release_date
+    ::RUBY_RELEASE_DATE
+  end
+end
+