sugar-high 0.5.0 → 0.5.1

data/{README.markdown → README.textile}

@@ -1,21 +1,21 @@
-# Sugar high!
+h1. Sugar high!
 
 Inspired by the 'zucker' project.
 
-## Install
+h2. Install
 
 <code>gem install sugar-high</code>
 
-## Usage
+h2. Usage
 
 See specs for example use
 
-## Update June 22, 2011
+h2. Update June 22, 2011
 
 file_mutate is now backwards compatible again in order nt to break gems such as cream et. al. that depend on auto inclusion of all File extensions into
 File object
 
-## Sugar packs
+h2. Sugar packs
 
 * alias
 * arguments
@@ -32,24 +32,26 @@ File object
 * metaclass
 * methods
 * module
-* not  
+* not
 * numeric
 * path
 * properties
 * reg_exp
-           
-### Alias
+
+h3. Alias
 
 * multi_alias name, options_hash : creates multiple aliases using patterns
 
-### Arguments
+h3. Arguments
 
 * args (Used in generator CLI testing)
 * last_option *args : Returns last argument if hash or empty hash otherwise
 * ...
 
-### Array
+h3. Array
 
+* pick_one! - pick one random item
+* pink (n) - pick n random item
 * to_symbols
 * to_symbols_uniq
 * to_strings
@@ -57,11 +59,11 @@ File object
 * file_join
 * ...
 
-### Blank
+h3. Blank
 
 * blank?
 
-### Class Extension
+h3. Class Extension
 
 * autoload_modules (by @stanislaw)
 
@@ -77,7 +79,7 @@ Makes it easy to autoload multiple modules by standard folder-to-module mapping
 * find_first_class(*class_names)
 * find_first_module(*module_names)
 
-### Enumerable
+h3. Enumerable
 
 * only_kinds_of?(*modules)
 * only_labels?
@@ -93,16 +95,16 @@ Makes it easy to autoload multiple modules by standard folder-to-module mapping
 * select_only(type)    
 * select_only!(type)
 
-### File
+h3. File
 
 * self.blank? and blank? : Is file empty?
 * self.overwrite : overwrite file with new content (mode = 'w')
 * self.append : append to existing file with content or create new (mode = 'w+')
 
-### File Mutate
+h3. File Mutate
 Adds all File mutation modules to the File class
 
-### File Mutation
+h3. File Mutation
 
 Various File Mutation modules that can be added to any module or class for some nice benefits. Useful for generators fx.
 
@@ -123,44 +125,44 @@ Otherwise, simply specify which ones:
 
 <pre>File.mutate_ext :append_content, overwrite_content</pre>
 
-### Hash
+h3. Hash
 
 * hash_revert : Reverse keys and values
 * try_keys : return value of first key that is in Hash
 
-### Includes
+h3. Includes
 
 * includes : Includes modules listed as symbols
 
-### Kind of
+h3. Kind of
 
 * any_kind_of? *const_list
 * kind_of_label? : Symbol or String ?
 
-### Metaclass
+h3. Metaclass
 
 * metaclass : Get the metaclass, can be used to dynamically add class singleton methods!
 
-### Methods
+h3. Methods
 
 * get_methods *types : Get collection of methods, fx :private and :protected (or :all)
 
-### Module
+h3. Module
 
 * modules *names
 * nested_modules *names
 
 Create empty namespaces
 
-### Not
+h3. Not
 
 * not
 
 Adds the _#not_ method to Object, so you can say fx: <code>if x.not.empty?</code>
 
-### Numeric
+h3. Numeric
 
-module _NumericCheckExt_ 
+module _NumericCheckExt_
 
 * is_numeric?(arg) - alias numeric?
 * check_numeric!(arg) - raises error if argument is not numeric
@@ -169,12 +171,11 @@ module NumberDslExt added to all numeric classes (Float and Numeric)
 * thousand
 * hundred
 
-<pre>
-3.thousand + 2.hundred 
-  => 3200  
+<pre>3.thousand + 2.hundred 
+  => 3200
 </pre>
 
-### Path
+h3. Path
 * String#path - extends String instance with PathString
 
 module PathString
@@ -183,8 +184,8 @@ module PathString
 * to_symlink
 
 <pre>
-"a/b/c".to_dir  
-"a/b/c/d.rb".to_file  
+"a/b/c".to_dir
+"a/b/c/d.rb".to_file
 </pre>
 
 File type existance
@@ -205,7 +206,7 @@ Navigate dirs
 "a/b/../".post_down(1).should == "a/b/"  
 </pre>
 
-### Properties
+h3. Properties
 
 <pre>
 class CruiseShip
@@ -213,15 +214,15 @@ class CruiseShip
 
   property :direction
   property :speed, is(0..300)
-end  
+end
 
-ship = CruiseShip.new  
+ship = CruiseShip.new
 ship.add_direction_listener(lambda {|x| puts "Oy... someone changed the direction to #{x}"})    
 ship.speed = 200
 ship.speed = 301 # outside valid range!
 </pre>
 
-### RegExp
+h3. RegExp
 
 String, RegExp
 * to_regexp
@@ -232,17 +233,31 @@ MatchData
 * offset_after
 * offset_before
 
-## RSpec 2 Matchers
+h3. RSpec 2 Matchers
 
 * have_aliases(method, *alias_methods)  
 
 <pre>
   require 'sugar-high/rspec'
-  
+
   have_aliases :original, :alias_1, :alias2
 </pre>
 
-## Note on Patches/Pull Requests
+h3. String
+
+Class methods
+* random_letters
+* letters
+
+Instance methods
+* alpha_numeric
+* insert_before_last
+
+If not already defined
+* trim
+* concat
+
+h2. Note on Patches/Pull Requests
  
 * Fork the project.
 * Make your feature addition or bug fix.
@@ -252,6 +267,6 @@ MatchData
   (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
 * Send me a pull request. Bonus points for topic branches.
 
-## Copyright
+h2. Copyright
 
 Copyright (c) 2010 Kristian Mandrup. See LICENSE for details.

data/VERSION

@@ -1 +1 @@
-0.5.0
+0.5.1

data/lib/sugar-high/array.rb

@@ -3,17 +3,26 @@ require 'sugar-high/enumerable'
 require 'sugar-high/path'
 
 class Array
+  def pick_one!
+    index = Kernel.rand(self.size)
+    self[index]
+  end
+
+  def pick num
+    num.times.inject([]) {|res, x| res << pick_one!}
+  end
+
   def without(*values)
      copy = self.dup
      values.flatten.each { |value| copy.delete(value) }
      copy
   end
-      
+
   def to_symbols
     res = self.flatten.select_labels
     res = res.map{|a| a.to_s.to_sym } if res
     res || []
-  end  
+  end
 
   def to_symbols!
    self.flatten!

data/lib/sugar-high/boolean.rb

@@ -0,0 +1,7 @@
+require 'sugar-high/array'
+
+class Boolean
+  def self.random
+    [true, false].pick_one!
+  end
+end

data/lib/sugar-high/class_ext.rb

@@ -1,7 +1,7 @@
 require 'sugar-high/kind_of'
 require 'sugar-high/array'
 
-class Module 
+class Module
   def include_and_extend(the_module, options={})
     options[:instance_methods] ||= :InstanceMethods
     options[:class_methods] ||= :ClassMethods
@@ -11,7 +11,7 @@ class Module
     include main_module.const_get(options[:instance_methods]) if main_module.const_defined?(options[:instance_methods])
     extend main_module.const_get(options[:class_methods]) if main_module.const_defined?(options[:class_methods])
   end
-  
+
   def autoload_modules *args
 
     options = args.extract_options!
@@ -57,16 +57,16 @@ module AutoLoader
       namespaces[clazz_name.to_sym] ? namespaces[clazz_name.to_sym] : name
     end.join('/')
   end
-end  
+end
 
-module ClassExt  
+module ClassExt
   def get_module name
     # Module.const_get(name)
     name.to_s.camelize.constantize
   rescue
     nil
   end
-    
+
   def is_class?(clazz)
     clazz.is_a?(Class) && (clazz.respond_to? :new)
   end
@@ -74,42 +74,42 @@ module ClassExt
   def is_module?(clazz)
     clazz.is_a?(Module) && !(clazz.respond_to? :new)
   end
-     
+
   def class_exists?(name)
     is_class? get_module(name)
   rescue
     return false
-  end  
+  end
 
   def module_exists?(name)
     is_module? get_module(name)
   rescue NameError
     return false
-  end  
-  
+  end
+
   def try_class name
     return name if name.kind_of?(Class)
     found = get_module(name) if name.kind_of_label?
     return found if found.is_a?(Class)
-  rescue          
+  rescue
     false
-  end  
+  end
 
   def try_module name
     return name if name.kind_of?(Module)
     found = get_module(name) if name.kind_of_label?
     return found if found.is_a?(Module)
-  rescue          
+  rescue
     false
-  end  
+  end
 
   def try_module_only name
     return name if is_module?(name)
     found = get_module(name) if name.kind_of_label?
     return found if is_module?(found)
-  rescue          
+  rescue
     false
-  end  
+  end
 
 
   def find_first_class *names

data/lib/sugar-high/kind_of.rb

@@ -7,15 +7,15 @@ class Object
   end
 
   def any_kind_of? *kinds
-    kinds.all_kinds.each do |kind| 
-      return true if self.kind_of? kind        
+    kinds.all_kinds.each do |kind|
+      return true if self.kind_of? kind
     end
     false
   end
 
   def not_any_kind_of? *kinds
-    kinds.all_kinds.each do |kind| 
-      return false if self.kind_of? kind        
+    kinds.all_kinds.each do |kind|
+      return false if self.kind_of? kind
     end
     true
   end
@@ -33,11 +33,11 @@ class Object
     self.any_kind_of? Symbols, Symbol
   end
 end
-    
-class Kinds            
+
+class Kinds
   attr_accessor :kinds
-  
+
   def initialize *kinds
     self.kinds = *kinds
   end
-end
+end

data/lib/sugar-high/metaclass.rb

@@ -1,5 +1,5 @@
 class Object
   def self.metaclass
     class << self; self; end
-  end  
-end
+  end
+end

data/lib/sugar-high/string.rb

@@ -1,12 +1,25 @@
 class String
-  def trim
-    self.strip
+  def self.random_letters count, type = :lower
+   letters(type).pick(count)
   end
-  
-  def concat *args
-    args.inject(self) do |res, arg| 
-      res << arg.to_s
-      res
+
+  def self.letters type = :lower
+    letters = ('a'..'z').to_a
+    type == :upper ? letters.map!(&:upcase) : letters
+  end
+
+  unless respond_to? :trim
+    def trim
+      self.strip
+    end
+  end
+ 
+  unless respond_to? :concat
+    def concat *args
+      args.inject(self) do |res, arg| 
+        res << arg.to_s
+        res
+      end
     end
   end
 
@@ -14,7 +27,7 @@ class String
   def alpha_numeric
     self.gsub(/^\-+/, '').gsub(/[^0-9a-zA-Z_\-]+/i, '')
   end
-  
+
   def insert_before_last str, marker = 'end'
     res = []
     found = false
@@ -25,17 +38,12 @@ class String
       marker[:marker].to_s
     else
       raise ArgumentException, "last argument is the marker and must be a String, Symbol or even Hash with a :marker option pointing to the marker (String or Symbol)"
-    end      
-  
+    end
+
     marker = Regexp.escape(marker.to_s.reverse)
     nl = Regexp.escape("\n")
-    # puts self
-    # puts "marker: #{marker}"
-    # puts "nl: #{nl}"    
-    # puts "str: #{str}"    
-  
     self.reverse.each_line do |x|
-      x.gsub! /#{nl}/, ''  
+      x.gsub! /#{nl}/, ''
       if !found && x =~ /#{marker}/
         replace = "#{str}\n" << x.reverse
         res << replace
@@ -43,7 +51,7 @@ class String
       else
         res << x.reverse
       end
-    end    
+    end
     res = res.reverse.join("\n")
   end
-end
+end

data/sugar-high.gemspec

@@ -5,23 +5,23 @@
 
 Gem::Specification.new do |s|
   s.name = %q{sugar-high}
-  s.version = "0.5.0"
+  s.version = "0.5.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = [%q{Kristian Mandrup}]
-  s.date = %q{2011-07-20}
+  s.authors = ["Kristian Mandrup"]
+  s.date = %q{2011-07-31}
   s.description = %q{More Ruby sugar - inspired by the 'zuker' project}
   s.email = %q{kmandrup@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
-    "README.markdown"
+    "README.textile"
   ]
   s.files = [
     ".document",
     ".rspec",
     "Gemfile",
     "LICENSE",
-    "README.markdown",
+    "README.textile",
     "Rakefile",
     "VERSION",
     "lib/sugar-high.rb",
@@ -29,6 +29,7 @@ Gem::Specification.new do |s|
     "lib/sugar-high/arguments.rb",
     "lib/sugar-high/array.rb",
     "lib/sugar-high/blank.rb",
+    "lib/sugar-high/boolean.rb",
     "lib/sugar-high/class_ext.rb",
     "lib/sugar-high/enumerable.rb",
     "lib/sugar-high/file.rb",
@@ -110,8 +111,8 @@ Gem::Specification.new do |s|
     "sugar-high.gemspec"
   ]
   s.homepage = %q{http://github.com/kristianmandrup/sugar-high}
-  s.require_paths = [%q{lib}]
-  s.rubygems_version = %q{1.8.5}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
   s.summary = %q{Ruby convenience sugar packs!}
 
   if s.respond_to? :specification_version then

metadata

@@ -1,80 +1,63 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: sugar-high
-version: !ruby/object:Gem::Version 
-  hash: 11
+version: !ruby/object:Gem::Version
+  version: 0.5.1
   prerelease: 
-  segments: 
-  - 0
-  - 5
-  - 0
-  version: 0.5.0
 platform: ruby
-authors: 
+authors:
 - Kristian Mandrup
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-07-20 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  requirement: &id001 !ruby/object:Gem::Requirement 
+date: 2011-07-31 00:00:00.000000000 +02:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2155962220 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id001
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  name: rspec
   prerelease: false
-- !ruby/object:Gem::Dependency 
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *2155962220
+- !ruby/object:Gem::Dependency
+  name: active_support
+  requirement: &2155961300 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
-  version_requirements: *id002
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  name: active_support
   prerelease: false
-- !ruby/object:Gem::Dependency 
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *2155961300
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2155960580 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 9
-        segments: 
-        - 2
-        - 5
-        version: "2.5"
-  version_requirements: *id003
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.5'
   type: :development
-  name: rspec
   prerelease: false
+  version_requirements: *2155960580
 description: More Ruby sugar - inspired by the 'zuker' project
 email: kmandrup@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE
-- README.markdown
-files: 
+- README.textile
+files:
 - .document
 - .rspec
 - Gemfile
 - LICENSE
-- README.markdown
+- README.textile
 - Rakefile
 - VERSION
 - lib/sugar-high.rb
@@ -82,6 +65,7 @@ files:
 - lib/sugar-high/arguments.rb
 - lib/sugar-high/array.rb
 - lib/sugar-high/blank.rb
+- lib/sugar-high/boolean.rb
 - lib/sugar-high/class_ext.rb
 - lib/sugar-high/enumerable.rb
 - lib/sugar-high/file.rb
@@ -161,38 +145,29 @@ files:
 - spec/sugar-high/regexp_spec.rb
 - spec/sugar-high/string_spec.rb
 - sugar-high.gemspec
+has_rdoc: true
 homepage: http://github.com/kristianmandrup/sugar-high
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.5
+rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Ruby convenience sugar packs!
 test_files: []
-