zucker 1 → 2

data/CHANGELOG

@@ -0,0 +1,14 @@
+2010-08-08 | Zucker 2
+* added info cube
+* added chaining for array2proc
+* fixed Hash.zip
+* fixed instance_variables_from binding for 1.9
+* more specs
+
+
+2010-08-06 | Zucker 1
+* initial release
+
+
+2010-08-05 | Zucker 0
+* pre-release for rug-b talk

data/Rakefile

@@ -1,17 +1,27 @@
 require 'rake'
+# require 'rubygems'
 require 'rake/gempackagetask'
-require 'rubygems'
 require 'spec/rake/spectask'
 
+desc 'Build documentation'
+task 'doc' do
+  zucker_path = "#{ Rake.application.find_rakefile_location[1] }/lib/zucker"
+  ruby File.join(zucker_path, 'doc/zucker_doc.rb'), zucker_path
+end
+
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_files = FileList['lib/zucker/spec/**/*.rb']
+end
+
 # gem
 PKG_FILES = FileList[ '[a-zA-Z]*', 'lib/**/*' ]
 spec = Gem::Specification.new do |s|
   s.name = 'zucker'
-  s.version = '1'
-  s.date = '2010-08-05'
+  s.version = '2'
+  s.date = '2010-08-08'
   s.authors = ['Jan Lelis']
   s.email = 'mail@janlelis.de'
-  s.summary = 'Add more sugar to Ruby'
+  s.summary = 'Make your Ruby code even sweeter with this syntacitcal sugar: http://rubyzucker.info :)'
   s.homepage = 'http://rubyzucker.info'
   s.files = PKG_FILES.to_a
   s.require_paths = [".","lib"]

data/lib/zucker.rb

@@ -1,7 +1,3 @@
-module Zucker
-  VERSION = '1'
-end
-
 # nothing is done here
 #  to use zucker:
 

data/lib/zucker/2/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/2/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/2/all.rb

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

data/lib/zucker/2/array.rb

@@ -0,0 +1,17 @@
+class Array
+  def ^(other) # TODO: more efficient
+    (self - other) +
+    (other - self)
+  end
+
+  def sum # sry, you just need this one too often
+    inject :+
+  end
+
+  def chrs
+    self.pack 'C*'
+  end
+end
+
+# J-_-L
+

data/lib/zucker/2/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/2/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/2/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/2/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/2/debug.rb

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

data/lib/zucker/2/default.rb

@@ -0,0 +1,25 @@
+# default
+zucker = %w|
+aliases
+array
+array2proc
+blank
+class2proc
+egonil
+enumerable
+hash
+hash2proc
+iterate
+ivars
+kernel
+mcopy
+regexp2proc
+sandbox
+square_brackets_for
+string
+unary
+union
+|
+
+zucker.each{|rb| require "zucker/#{rb}"}
+

data/lib/zucker/2/desc/D.yaml

@@ -0,0 +1,23 @@
+D:
+  summary: Easy debug printing with the ⇧p⇧ alternative ⇧.D⇧. It outputs to stdout and returns ⇧self⇧. Accepts a block.
+  methods:
+    Object#D: |
+      some.D.methods.D.noone.D.knows.D
+      # ...outputs 4 lines with the inspected objects
+      # => (result)
+
+      21+Math.sin(42).D
+      # outputs -0.916521547915634
+      # => 20.0834784520844
+
+      name = 'Earth'
+      'Hello ' + name.D{|e| "The length is: #{e.size}"}
+      # outputs "The length is: 5"
+      # => 'Hello Earth'
+  package: debug
+  info:
+  - "This is inspired by the funny →⇧.tap⇧ method→http://moonbase.rydia.net/mental/blog/programming/eavesdropping-on-expressions→."
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/aliases.yaml

@@ -0,0 +1,16 @@
+aliases:
+  summary: Some convenient aliases (and constants) for existing methods.
+  package: default
+  methods:
+    Object#is_an?: Object.is_a?
+    Enumerable#with: Enumerable#zip
+    Enumerable#%: Enumerable#zip
+    Array#**: Array#product
+    Hash#+: Hash#merge
+    Binding#[]: Binding#eval
+    Infinity: 1.0 / 0.0
+    NaN: 0.0 / 0.0
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/array.yaml

@@ -0,0 +1,14 @@
+array:
+  summary: Methods one could miss for ⇧Array⇧.
+  why:
+  - ⇧Array⇧ has ⇧&⇧ and ⇧|⇧, but why does it not have ⇧^⇧?
+  - ⇧sum⇧ is just an alias for ⇧inject(:+)⇧, but it is needed pretty often..
+  methods:
+    Array#^: "[1,2,3,4] ^ [3,4,5,6]  # => [1,2,5,6]"
+    Array#sum: "[1,2,3,4,5].sum  # => 15"
+    Array#chrs: "[72, 97, 108, 108, 111].chrs  # => 'Hallo'"
+  package: default
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/array2proc.yaml

@@ -0,0 +1,17 @@
+array2proc:
+  summary: Calls the method named by the first paramenter and passes the other elements as paramaters.
+  why: When using ⇧Symbol#to_proc⇧, you often wish to pass parameters.
+  methods:
+    Array#to_proc: |
+      [1,2,3,4].map &[:*, 5] # => [5, 10, 15, 20]
+      # you can also chain them, if the first parameter is an Array
+      [1,2,3,4].map &[[:to_s, 2],[:+, 'b']]   # => ["1b", "10b", "11b", "100b"]
+  info:
+  - Inspired by →this article→http://www.sanityinc.com/articles/adding-array-to-proc-to-ruby→.
+  - "More about →to_proc→http://rbjl.net/29-become-a-proc-star→."
+  - Chaining inspired by →eregon→http://github.com/eregon/Classes/blob/master/to_proc.rb→.
+  package: default
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/binding.yaml

@@ -0,0 +1,10 @@
+binding:
+  summary: Adds a verbose ⇧Binding#inspect⇧.
+  why: It gives you information about the current environment.
+  methods:
+    Binding#inspect: binding.inspect
+  package: debug
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/blank.yaml

@@ -0,0 +1,10 @@
+blank:
+  summary: Does pretty the same as in ActiveSupport (Every object can be asked if it is blank).
+  why: It's too familiar ;)
+  methods:
+    Object#blank?: "'an object'.blank? # => false"
+  package: default
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/class2proc.yaml

@@ -0,0 +1,12 @@
+class2proc:
+  summary: Creates a new instance of the class.
+  methods:
+    Class#to_proc: "[ [1,2],[3,5,6,7,3] ].map(&Set) # => [ Set[1,2], Set[5,6,7,3] ]"
+  package: default
+  info:
+  - Inspired by Ruby Facets.
+  - "More about →to_proc→http://rbjl.net/29-become-a-proc-star→."
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/egonil.yaml

@@ -0,0 +1,17 @@
+egonil:
+  summary: Creates a block, where ⇧nil⇧ does not raise ⇧NoMethodError⇧s.
+  methods:
+    egonil, nn: |
+      egonil do
+        nil.some_methods.that[:do].not.exist
+      end # => nil
+
+      nn(5){ nil.some_methods.that[:do].not.exist }
+      # => 5
+  package: default
+  info:
+  - See →this post→http://rbjl.net/26-the-28-bytes-of-ruby-joy→ for more information and discussion.
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/enumerable.yaml

@@ -0,0 +1,11 @@
+enumerable:
+  summary: ⇧Enumerable⇧ extensions.
+  methods:
+    Enumerable#mash: "[1,2,3].mash{|e| [e, e.to_s] } # => {1=>'1',2=>'2',3=>'3'}"
+  package: default
+  info:
+  - Inspired by Ruby Facets' ⇧mash⇧.
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/hash.yaml

@@ -0,0 +1,14 @@
+hash:
+  summary: Some sugar for dealing with hashs.
+  methods:
+    Hash.zip: "Hash.zip [1,2,3], [4,5,6] # => {1 => 4, 2 => 5, 3 => 6}"
+    Hash#<<: |
+      {1 => 2} << [3, 4]   # => { 1 => 2, 3 => 4 }
+      {1 => 2} << { 5=>6 } # => { 1 => 2, 5 => 6 }
+  package: default
+  info:
+  - Some of the operators are inspired by Ruby Facets.
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/hash2proc.yaml

@@ -0,0 +1,11 @@
+hash2proc:
+  summary: Use a hash to apply procs to specific objects.
+  methods:
+    Hash#to_proc: "[1,2,3,4].map(&{\n2 => lambda {|e| e + 1000},\n4 => :to_s,\n}) # => [1, 1002, 3, '4']"
+  package: default
+  info:
+  - "More about →to_proc→http://rbjl.net/29-become-a-proc-star→."
+  versions:
+  - 1.9
+  - 1.8
+

data/lib/zucker/2/desc/info.yaml

@@ -0,0 +1,12 @@
+info:
+  summary: Access environment information with the ⇧Info⇧ module.
+  why: "You don't need to remember in which global variable, constant or special method the information you are searching for is hidden."
+  methods:
+    Info: |
+      # see the source file for the list of accessors
+      # you could also add them to the global namespace with: include Info
+  package: default
+  versions:
+  - 1.9
+  - 1.8 (not all information)
+

data/lib/zucker/2/desc/iterate.yaml

@@ -0,0 +1,17 @@
+iterate:
+  summary: Iterate over one or more collections.
+  why: "It's like ⇧.each⇧ with two differences: It feels more like a control structure and you can easily iterate over multiple objects."
+  methods:
+    iterate: |
+      iterate [1,2], [3,4,5] do |e,f|
+        puts "#{e},#{f}"
+      end
+      # outputs
+      #  1,3
+      #  2,4
+      #  ,5
+  package: default
+  versions:
+  - 1.9
+  - 1.8
+