zucker 13.1 → 100.0.0

data/README

@@ -1,7 +0,0 @@
-Doc: http://rubyzucker.info
-
-Travis: https://travis-ci.org/janlelis/zucker
-
-Copyright (c) 2010-2013 Jan Lelis <http://happycode.org> released under the MIT license
-
-J-_-L

data/desc/alias_for.yaml

@@ -1,17 +0,0 @@
-alias_for:
-  summary: 'A different way to create aliases: Reversed order and you can pass multiple alias names.'
-  why: "It's clearer in which order to put the arguments."
-  methods:
-    alias_for, aliases_for: |
-      alias_for :methods, :ms # creates an alias for the method :methods with the name ms
-      module Enumerable
-        aliases_for :zip, :with, :%
-      end # creates multiple aliases
-    Module#method_alias_for, Module#method_aliases_for: |
-      # same as alias_for, but using Module#alias_method instead of alias
-  info: 
-  - Thanks to Kristian Mandrup for the idea and alias method specs.
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/aliases.yaml

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

data/desc/array.yaml

@@ -1,11 +0,0 @@
-array:
-  summary: Methods one could miss for ⇧Array⇧.
-  why:
-  - ⇧Array⇧ has ⇧&⇧ and ⇧|⇧, but why does it not have ⇧^⇧?
-  methods:
-    Array#^: "[1,2,3,4] ^ [3,4,5,6]  # => [1,2,5,6]"
-    Array#chrs: "[72, 97, 108, 108, 111].chrs  # => 'Hallo'"
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/array_to_proc.yaml

@@ -1,16 +0,0 @@
-array_to_proc:
-  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→.
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/binding.yaml

@@ -1,22 +0,0 @@
-binding:
-  summary: Adds ⇧Binding#vars⇧. It gives you information about the current environment variables.
-  methods:
-    Binding#variables, Binding#vars: |
-     # shows your current environment's variables, irb example:
-     >> a=3
-     => 3
-     >> binding.vars
-     => #<Binding:0x94c4b50>
-     local variables
-      - a: 3
-      - _: #<Binding:0x94c4b50>
-     (instance variables)
-      - none
-     self
-      - main
-     block_given?
-      - false
-  versions:
-  - 1.9
-  - 1.8 (no rbx support)
-

data/desc/blank.yaml

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

data/desc/case.yaml

@@ -1,9 +0,0 @@
-case:
-  summary: Provides ⇧String#to_camel⇧ and ⇧String#to_snake⇧.
-  why: It kind of lies in the nature of Ruby.
-  methods:
-    String#to_camel: "'was_snake_string'.to_camel # => 'WasSnakeString'"
-    String#to_snake: "'WasCamelString' # => 'was_camel_string'"
-  versions:
-  - 1.9
-

data/desc/cc.yaml

@@ -1,10 +0,0 @@
-cc:
-  summary: ⇧c⇧ outputs the current method callstack.
-  methods:
-    c, cc: |
-      c # shows the method callstack
-      c true # do not hide irb/ripl callstack
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/class_to_proc.yaml

@@ -1,11 +0,0 @@
-class_to_proc:
-  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] ]"
-  info:
-  - Inspired by Ruby Facets.
-  - "More about →to_proc→http://rbjl.net/29-become-a-proc-star→."
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/dd.yaml

@@ -1,23 +0,0 @@
-dd:
-  summary: Easy debug printing with the ⇧p⇧ alternative ⇧.d⇧. It outputs to stdout and returns ⇧self⇧. Accepts a block.
-  methods:
-    Object#d, Object#dd: |
-      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'
-  info:
-  - "This is inspired by the →⇧.tap⇧ method→http://moonbase.rydia.net/mental/blog/programming/eavesdropping-on-expressions→."
-  - There is also ⇧tap⇧ cube with more ⇧tap⇧ methods.
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/egonil.yaml

@@ -1,15 +0,0 @@
-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{ nil.some_methods.that[:do].not.exist } # => nil
-  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/desc/engine.yaml

@@ -1,15 +0,0 @@
-engine:
-  summary: Adds a ⇧RubyEngine⇧ class for easy compatibility checks.
-  methods:
-    RubyEngine: |
-    RubyEngine: "# outputs the interpreter name"
-    RubyEngine.mri?: "RubyEngine.mri? # true if using the official Ruby interpreter"
-    RubyEngine.jruby?: "RubyEngine.jruby? # true if using JRuby"
-    RubyEngine.rubinius?: "RubyEngine.rubinius? # true if using rubinius"
-    RubyEngine.ree?: "RubyEngine.ree? # true if using enterprise edition"
-    RubyEngine.ironruby?: "RubyEngine.ironruby? # true if using IronRuby"
-    RubyEngine.macruby?: "RubyEngine.macruby? # true if using MacRuby"
-    RubyEngine.cardinal?: "RubyEngine.cardinal? # true if using parrot"
-  versions:
-  - 1.9
-  - 1.8

data/desc/enumerable.yaml

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

data/desc/file.yaml

@@ -1,14 +0,0 @@
-file:
-  summary: Extensions for ⇧File⇧.
-  methods:
-    File.gsub: |
-      File.gsub 'some_filename', # will read the file and substitute the hash keys with their values
-        /hi/ => 'cu',
-        /\d/ => proc{ |m| (m.to_i+1).to_s }
-    File.delete!: "File.delete! 'some_filename' # will delete the file, don't care if it exist."
-  info:
-  - "Idea for ⇧File.delete!⇧ from sugar-high."
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/hash.yaml

@@ -1,14 +0,0 @@
-hash:
-  summary: Some sugar for dealing with hashes.
-  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 }
-    Hash#&: "{ 1=>4, 2=>5, 3=>6 } & { 1=>4, 2=>7 } # => { 1=>4 }"
-  info:
-  - Some of the operators are inspired by Ruby Facets.
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/hash_to_proc.yaml

@@ -1,10 +0,0 @@
-hash_to_proc:
-  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']"
-  info:
-  - "More about →to_proc→http://rbjl.net/29-become-a-proc-star→."
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/info.yaml

@@ -1,20 +0,0 @@
-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: |
-      # for example
-      Info.working_directory # Dir.pwd
-      Info.load_path         # $:
-      Info.platform          # RUBY_PLATFORM
-      Info.current_file      # similar to __FILE__
-      # you could also add them to the global namespace with: include Info
-      # see the source file for the list of accessors or
-      Info.list
-  info:
-  - Please note that it is not possible to put some of __THOSE_KEYWORDS__ in methods, so the result might slightly differ. This might affect ⇧current_file⇧, ⇧current_file_directory⇧, ⇧current_line⇧ and ⇧current_method⇧.
-  - Thanks to Facets for the ⇧caller⇧ Regexp.
-  versions:
-  - 1.9
-  - 1.8 (not all information)
-

data/desc/iterate.yaml

@@ -1,16 +0,0 @@
-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
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/ivars.yaml

@@ -1,19 +0,0 @@
-ivars:
-  summary: This method lets you easily assign lots of instance variables.
-  why: |
-   Often, you have to write boilerplate code for assigning instance variables, for example this one:
-   ⇧def initialize(variable1, variable2)
-     @variable1, @variable2 = variable1, variable2
-   end⇧
-  methods:
-    instance_variables_from, ivars: |
-      def a_method(a = 1, b = 2)
-        instance_variables_from binding # assigns @a and @b
-
-        params = {:c => 3, :d => 4}
-        instance_variables_from params # # assigns @c and @d
-      end
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/kernel.yaml

@@ -1,15 +0,0 @@
-kernel:
-  summary: Some useful general shortcut methods.
-  why: Readability.
-  methods:
-    activate_warnings!: "activate_warnings! # sets $VERBOSE to 1"
-    deactivate_warnings!: "deactivate_warnings! # sets $VERBOSE to 0"
-    executed_directly?, directly_executed?, standalone?: "executed_directly? # checks, if the current file is run directly -> true"
-    library?: "library? # checks, if the current file is run directly -> false"
-    irb?: "irb? # returns false if not called from IRB or RIPL"
-    ignore_sigint!: "ignore_sigint! # blocks CTRL+C"
-    ignore_sigquit!: "ignore_sigquit! # blocks CTRL+\\"
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/mcopy.yaml

@@ -1,11 +0,0 @@
-mcopy:
-  summary: Adds ⇧Object#mcopy⇧ to create a deep copy using ⇧Marshal⇧.
-  why: Every Ruby book describes, you can do ⇧Marshal.load Marshal.dump object⇧ to create a deep copy... But who needs this verbose syntax in everyday coding?
-  methods:
-    Object#mcopy: |
-      a = %w[hello world]
-      b = a.mcopy
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/mm.yaml

@@ -1,15 +0,0 @@
-mm:
-  summary: ⇧m⇧ displays an ordered public method list.
-  why: See one object's methods without those rarely used inherited methods.
-  methods:
-    Object#m, Object#mm, Object#method_list: |
-      >> 5.mm 2 # outputs the list (2 levels deep), for example:
-      # = Fixnum
-      # to_s  -@  +  -  *  /  div  %  modulo  divmod  fdiv  **  abs  magnitude  ==  ===  <=>  >  >=  <  <=  ~  &  |  ^  []  <<  >>  to_f  size  zero?  odd?  even?  succ
-      # = Integer
-      # integer?  odd?  even?  upto  downto  times  succ  next  pred  chr  ord  to_i  to_int  floor  ceil  truncate  round  gcd  lcm  gcdlcm  numerator  denominator  to_r  rationalize
-  info:
-  - See →this article→http://rbjl.net/31-the-multi-mega-method-list→ for more information.
-  versions:
-  - 1.9
-  - 1.8

data/desc/not.yaml

@@ -1,11 +0,0 @@
-not:
-  summary: ⇧not⇧ returns an object on which all methods are redirected to it's receiver object, but returns the inverted boolean.
-  why: Better readability.
-  methods:
-    Object#not: |
-      [1,2,3].not.empty? # true
-  info:
-  - See →this article by Jay Field→http://blog.jayfields.com/2007/08/ruby-adding-not-method-for-readability.html→ for more information.
-  versions:
-  - 1.9
-

data/desc/oo.yaml

@@ -1,10 +0,0 @@
-oo:
-  summary: The ⇧o⇧ method outputs the current method, line, file and label (if given).
-  methods:
-    o, oo: |
-      o # e.g: Reached method `irb_binding', line 1 of file (irb)
-      o:Label # e.g: Label: reached method `abc', line 7 of file (irb)
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/os.yaml

@@ -1,19 +0,0 @@
-os:
-  summary: Detect the operating system.
-  why: Checking for ⇧RUBY_PLATFORM⇧ does not report the OS when using JRuby and for better readability.
-  methods:
-    OS: "# displays the operating system"
-    OS.linux?: "OS.linux? # true if you are on a linux machine"
-    OS.mac?: "OS.mac? # true for macs"
-    OS.bsd?: "OS.bsd? # true for bsds"
-    OS.windows?: "include OS; windows? # true for windows. Example of including OS to get the os methods into the global namespace"
-    OS.solaris?: "OS.solaris? # true for solaris/sunos"
-    OS.posix?: "OS.posix? # true if system is posix compatible"
-    OS.is?: "OS.is? /x/ # matches the regex against the os string"
-  info:
-  - This cube depends on system information and may not be 100% accurate.
-  - "Syntax and semantic inspired by Roger Pack's →os gem→http://github.com/rdp/os→."
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/qq.yaml

@@ -1,11 +0,0 @@
-qq:
-  summary: The ⇧q⇧ method does the same like ⇧p⇧, but outputs multiple arguments on the same line.
-  methods:
-    q, qq: |
-      q "zucker", '', {6=>7}, 5, 2.3, :o # outputs "zucker"  ""  {6=>7}  5  2.3  :o
-  info:
-  - Inspired by →rdp→http://github.com/rdp/sane/blob/master/lib/sane/pps.rb→.
-  versions:
-  - 1.9
-  - 1.8
-

data/desc/regexp_to_proc.yaml

@@ -1,12 +0,0 @@
-regexp_to_proc:
-  summary: Use ⇧&/regex/⇧ to match it against strings.
-  methods:
-    Regexp#to_proc: |
-      %w|just another string array|.map    &/[jy]/  # => ["j", nil, nil, "y"]
-      %w|just another string array|.select &/[jy]/  # => ["just", "array"]
-  info:
-  - "More about →to_proc→http://rbjl.net/29-become-a-proc-star→."
-  versions:
-  - 1.9
-  - 1.8
-