zucker 0.9

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Jan Lelis
+
+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

@@ -0,0 +1,4 @@
+See http://rubyzucker.info
+
+Copyright (c) 2010 Jan Lelis, http://rbjl.net, released under the MIT license
+

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'rake/gempackagetask'
+require 'rubygems'
+require 'spec/rake/spectask'
+
+PKG_FILES = FileList[ '[a-zA-Z]*', 'lib/**/*' ]
+spec = Gem::Specification.new do |s|
+  s.name = 'zucker'
+  s.version = '0.9'
+  s.date = '2010-08-05'
+  s.authors = ['Jan Lelis']
+  s.email = 'mail@janlelis.de'
+  s.summary = 'Add more sugar to Ruby'
+  s.homepage = 'http://rubyzucker.info'
+  s.files = PKG_FILES.to_a
+  s.require_paths = [".","lib"]
+end
+
+desc 'build gem'
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+

data/lib/zucker.rb

@@ -0,0 +1,10 @@
+# nothing is done here
+# to use zucker:
+
+# require 'zucker/default'
+
+#  and/or
+
+# require 'zucker/debug'
+
+#  or cherry-pick the cubes you want ;)

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

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

data/lib/zucker/1/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/1/array2proc.rb

@@ -0,0 +1,10 @@
+class Array
+  def to_proc
+    Proc.new{ |obj|
+      obj.send *self
+    }
+  end
+end
+
+# J-_-L
+

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

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

data/lib/zucker/1/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/1/#{rb}"}
+

data/lib/zucker/1/descriptions/D.yaml

@@ -0,0 +1,25 @@
+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 object
+      # => (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
+  authors:
+  - Jan Lelis
+

data/lib/zucker/1/descriptions/aliases.yaml

@@ -0,0 +1,18 @@
+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
+  authors:
+  - Jan Lelis
+

data/lib/zucker/1/descriptions/array.yaml

@@ -0,0 +1,16 @@
+array:
+  summary: Methods one could miss for ⇧Array⇧
+  why:
+  - ⇧Array⇧ has ⇧&⇧ and ⇧|⇧, but why does it not have ⇧^⇧?
+  - ⇧sum⇧ is an alias for ⇧inject(:+)⇧, but it is just 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
+  authors:
+  - Jan Lelis
+

data/lib/zucker/1/descriptions/array2proc.yaml

@@ -0,0 +1,15 @@
+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( &[:to_s, 2] )  # => ["1", "10", "11", "100"]'
+  info:
+  - Inspired by http://www.sanityinc.com/articles/adding-array-to-proc-to-ruby
+  - "More about to_proc: http://rbjl.net/29-become-a-proc-star"
+  package: default
+  versions:
+  - 1.9
+  - 1.8
+  authors:
+  - Jan Lelis
+

data/lib/zucker/1/descriptions/binding.yaml

@@ -0,0 +1,12 @@
+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
+  authors:
+  - Jan Lelis
+

data/lib/zucker/1/descriptions/blank.yaml

@@ -0,0 +1,14 @@
+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
+  info:
+  - See ActiveSupport
+  versions:
+  - 1.9
+  - 1.8
+  authors:
+  - Jan Lelis (this implementation)
+

data/lib/zucker/1/descriptions/class2proc.yaml

@@ -0,0 +1,15 @@
+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
+  authors:
+  - Facet authors
+  - Jan Lelis (this implementation)
+

data/lib/zucker/1/descriptions/egonil.yaml

@@ -0,0 +1,20 @@
+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 http://rbjl.net/26-the-28-bytes-of-ruby-joy for more information and discussion
+  versions:
+  - 1.9
+  - 1.8
+  authors:
+  - Jan Lelis
+  - Yohan
+

data/lib/zucker/1/descriptions/enumerable.yaml

@@ -0,0 +1,13 @@
+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
+  authors:
+  - Jan Lelis
+

data/lib/zucker/1/descriptions/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}"
+  package: default
+  info:
+  - Some of the operators are inspired by Ruby Facets
+  versions:
+  - 1.9
+  - 1.8
+  authors:
+  - Jan Lelis
+

data/lib/zucker/1/descriptions/hash2proc.yaml

@@ -0,0 +1,13 @@
+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
+  authors:
+  - Jan Lelis
+

data/lib/zucker/1/descriptions/iterate.yaml

@@ -0,0 +1,19 @@
+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
+  authors:
+  - Jan Lelis
+