sixarm_ruby_ramp 2.1.0

data/CHANGELOG.txt

@@ -0,0 +1,51 @@
+2.1.0 Spring cleaning for Ruby 1.9.3 with better README, new CHANGELOG, less YAML, etc.
+2.0.9 Remove Hash#to_yaml_sort and replace its functionality with Hash#sort_by_keys
+2.0.8 Add Numeric#percent
+2.0.7 Move YAML#load_xxx methods to new gem
+2.0.6 Move Date#age_xxx methods to new gem
+2.0.5 Move String#to_class to new gem
+2.0.4 Add lib to path
+2.0.0 Upgrade to Ruby 1.9.2
+1.9.0 Add Enumerable#mutex? and #nitems?
+1.8.4 Add YAML#load_dir_key_values
+1.8.2 Refactored Numeric metric names into their own methods
+1.8.0 100% rcov coverage
+1.7.8 Add rcov testing
+1.7.4 Add Class#publicize_methods, Integer#even?, Integer#odd?
+1.7.3 Refactor Rails classes to their own gem, add README, LICENSE
+1.7.2 Gemcutter update
+1.7.1.8 Add Enumerable#map_with_index
+1.7.1.6 Add ActiveRecord::SaveExtensions#save_false_then_reload!
+1.7.1.3 Add XML#strip_xxx
+1.7.1.2 Update gems: Gemcutter, Ruby 1.9.1, JRuby sqlite3
+1.7.1.0 Add XML attributes methods #
+1.7.0.9 Add Enumerable #hash_by, #index_by
+1.7.0.7 Add Array#to_tsv, String#split_tsv, improve Array#to_csv
+1.7.0.6 Add Array#shuffle, Array#shuffle!
+1.7.0.5 Add Array#shifted, Array#rest, Array#car, Array#cdr
+1.7.0.4 Upgrade IO#readrows and #readrow to use options
+1.7.0.2 Add Array#to_tdf
+1.7.0.1 Remove sqlite3 testing dependency
+1.6.9.6 Add Symbol with comparable and <=>
+1.6.9.5 Add ActiveRecord testing with sqlite3
+1.6.9.4 JRuby install and test successful
+1.6.9.3 Array#join add infix, prefix, suffix
+1.6.9.2 Improve ri docs
+1.6.9.1 Add Array#onto, Enumerable#intersect?
+1.6.9.0 Add IO, File, ActiveRecord#seed
+1.6.8.9 Add Enumerable#to_h, Array#hash, Hash#each_key!, Hash#each_pair, Hash#each_value!
+1.6.8.8 Add Hash#map_pair, Hash#size?, Hash#pivot
+1.6.8.7 Add Math
+1.6.8.6 Add ActiveRecord SchemaStatements
+1.6.8.5 Add Integer#maps, String#ACCENTS
+1.6.8.4 Add XML
+1.6.8.3 Add ActiveRecord
+1.6.8.2 Add String#lowcase
+1.6.8 Add map_to_xxx methods
+1.6.7 Add CSV
+1.6.6 Add Array#to_csv, Integer, String#lorem, etc., improve tests
+1.6.4 Bug fixes: String characters and YAML test files
+1.6.2 Improve organizaiton of class files to lib/ramp
+1.6.0 Upgraded to work with Ruby 1.9.1
+1.5.0 Combined all Ruby extension files into one gem
+1.0.0 Original

data/INSTALL.txt

@@ -0,0 +1,32 @@
+
+= SixArm.com Ruby Gem Install
+
+
+First-time users: add our gem certificate and source.
+When you do this once, it works for all our gems.
+
+  sudo wget http://sixarm.com/sixarm.pem
+  sudo gem cert --add sixarm.pem   
+  sudo gem sources --add http://sixarm.com
+
+Install the gem with advanced options.
+
+  sudo gem install sixarm_ruby_ramp --test --trust-policy HighSecurity
+
+
+== Notes
+
+Do you have any questions, comments, suggestions, or feedback?
+Let us know, we're happy to help. Our email is sixarm@sixarm.com
+
+Do you want to create your own high security gems?
+Learn how at http://www.rubygems.org/read/chapter/21
+
+To see your current gem certificate list:
+
+  sudo gem cert --list
+
+Our cert looks like this:
+
+  /C=US/ST=California/L=San Francisco/O=SixArm/CN=sixarm.com
+

data/LICENSE.txt

@@ -0,0 +1,12 @@
+LICENSE
+
+You may choose any of these licenses:
+
+  - CreativeCommons License, Non-commercial Share Alike
+  - LGPL, GNU Lesser General Public License
+  - MIT License
+  - Ruby License
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

data/README.rdoc

@@ -0,0 +1,240 @@
+= SixArm.com » Ruby » Ramp gem is a toolkit of Ruby base class extensions
+
+Author:: Joel Parker Henderson, joel@joelparkerhenderson.com
+Copyright:: Copyright (c) 2006-2011 Joel Parker Henderson
+License:: See LICENSE.txt file
+
+Ramp is a library of extensions to Ruby base classes, including Array, Date, Enumerable, Hash, Kernel, Numeric, Object, Process, String, Time, and YAML. 
+
+Testing: 
+
+* Each has an associated test class, e.g., ArrayTest, DateTest, etc.
+* The easy way to run the tests: gem install sixarm_ruby_ramp --test
+
+
+== Array
+
+* car, cdr: aka first, rest (see shifted)
+* choice, choices: one or more random elements from an array
+* cross: return the cross pairings of an array with another array
+* divvy: divides an array, like a pie, into a specified number of slices
+* join: same as Array#join with some improvments
+* onto: return a hash that maps an array's keys on to another array's values
+* rotate: moves the first element of an array to the end
+* rest: return the rest of the items of the array (aka cdr, aka shifted)
+* shifted, shifted!: return an array with the first n items shifted (aka cdr, aka rest)
+* shuffle, shuffle!: randomly sort an array efficiently; each of these methods are loaded only if needed (Ruby 1.8.7+ already defines shuffle)
+* slices: divide an array into specified number of equal size sub-arrays ([1,2,3,4,5,6]slices(3) => [[1,2],[3,4],[5,6]])
+* to_csv: join a multidimensional array into a string in CSV (Comma Separated Values), with each subarray becoming one 'line' in the output; typically for viewing in a spreadsheet such as Excel.
+* to_tdf: join a multidimensional array into a string in TDF (Tab Delimited Format); this is an alias for #to_tsv
+* to_tsv: join a multidimensional array into a string in TSV (Tab Separated Values), with each subarray becoming one 'line' in the output; typically for viewing in a spreadsheet such as Excel.
+* union: builds an array containing each of the unique elements of sub-arrays ([[1,2,3,4],[2,3,4,5],[3,4,5,6]].union => [1,2,3,4,5,6])
+
+
+== Class
+
+* publicize_methods: make all methods public for a block, e.g. to unit test private methods
+
+
+== CSV
+
+* http_headers: provides web file download headers for text/csv content type and disposition.
+
+
+== Date
+
+* age_days, age_years
+* between: a random date between two specified dates
+* to_sql: date as a string formatted as expected for MySQL
+* weekday?, weekend?: is date a weekday or on the weekend
+
+
+== Enumerable
+
+* cartesian_product: return an array of all possible ordered tuples from arrays.
+* hash_by: convert the array to a hash by mapping each item to a key=>value pair.
+* index_by: convert the array to a hash by mapping each ite to a key=>item pair.
+* join: forwards to self.to_a.join
+* map_id: return the id of an Enumerable object; *requires* that the object respond to an 'id' message
+* map_to_a, map_to_f, map_to_i, map_to_s, map_to_sym: convert each object to a specific type by calling its respective method to_a, to_i, to_f, to_s, to_sym
+* map_with_index: for each item, yield to a block with the item and its incrementing index
+* nitems_until, select_until: return the number of, or an array containing, the leading elements for which block is false or nil.
+* nitems_while, select_while: return the number of items, or an array containing the leading elements, for which block is not false or nil.
+* nitems_with_index, select_with_index: calls block with two arguments, the item and its index, for each item in enum. Return the number of, or an array containing, the leading elements for which block is not false or nil. 
+* power_set: return an array with all subsets of the enum's elements
+
+
+== File
+
+* File.joindir: wrapper for File.join(File.dirname(...),string,...)
+
+
+== Fixnum
+
+* even?: is the number even?
+* odd?: is the number odd?
+
+
+== Hash
+
+* size?: return true if hash has any keys
+* sort_by_keys: return a new Hash sorted by keys
+* each_sort: sort the keys then call each
+* each_key!: passes each key to a specified block and updates hash in place if the key changes
+* each_pair!: passes each key value pair to a specified block and updates the hash in place if the key or value change.
+* each_value!: passes each value to a specified block and updates the hash in place if the value changes.
+* map_pair: map each key-value pair by calling a a block
+* pivot: aggregates subtotals by keys and values, such as a rollup and rolldown 
+
+
+== Integer
+
+* maps: syntactic sugar to yield n times to a block, returning an array of any results
+* odd?: is the number odd?
+
+
+== IO
+
+* readrow: reads a row line as with IO#readline, and return the row split it into fields 
+* IO.readrows: reads the entire file specified by name as individual row lines, and return those rows split into fields, in an array of arrays.
+
+
+== Kernel
+
+* my_method_name: return the name of the current method
+* caller_method_name: return the name of the caller method, or the Nth parent up the call stack if the optional caller_index parameter is passed.
+
+
+== Math
+
+* ln(x): natural log of x
+* logn(x,b): log of x in base b
+
+
+== NilClass
+
+* blank?: return true (same as Rails)
+
+
+== Numeric
+
+* if: return 0 if the passed flag is any of: nil, false, 0, [], {} and otherwise return self
+* unless: return 0 unless the passed flag is any of: nil, false, 0, [], {} and otherwise return self
+* percent: return the number as a percentage with optional rounding to decimal points
+
+
+== Object
+
+* in?: return boolean indicating whether the object is a member of the specified array parameter
+
+
+== Process
+
+Extensions that help debug Ruby programs.
+
+* (class) ps: output of the system 'ps' command, also including aliases, as raw plain text.
+* (class) pss: output of the system 'ps' command as a hash with each value set to the right type, e.g., integer, float, etc..
+
+
+== REXML::Attributes
+
+* hash: flattens the attributes hash set into a more useful ruby hash, e.g. {:height => 100, :width => 400 }
+
+
+== REXML::Document
+
+* remove_attributes: remove all the attributes from the document's elements
+
+
+== REXML::Element
+
+* remove_attributes: remove all the attributes from the element
+
+
+== String
+
+* capitalize_words (alias to titleize/titlecase): ensures the first character of each word is uppercase.
+* decrement: decrease the rightmost natural number, defaults to one value lower or by the optional step parameter value.
+* increment: increase the rightmost natural number, defaults to one value higher or by the optional step parameter value.
+* lorem: return a short random string, good for use in "lorem ipsum" sample text.
+* lowcase: translate a string to lowercase, digits and single underscores (e.g. to a method name)
+* prev/pred: previous string ("b" => "a", "bbc" => "bbb", "a" => "z", "880" => "879")
+* prev!/pred!: updates variable to the previous string in place (astring = "bbc", astring.prev!, puts astring => "bbb")
+* (class) prev_char/pred_char: return the previous character, with a changed flag and carry flag; that is, there are three returned values, a string and two booleans.
+* split_tab: split the string into an array at each embedded tab ("Last\tFirst\tMiddle" => ["last","first","middle"])
+* split_tsv: split the string into an array at each embedded newline and embedded tab ("A\tB\t\C\nD\tE\tF" => [["A","B","C"],["D","E","F"]])
+* to_class: the global class reference of a given string
+* words: split the string into an array of words
+
+
+== Symbol
+
+* <=> and include the comparable mixin to compare symbols as strings
+
+
+== Time
+
+* (class) stamp: current time in UTC as a timestamp string ("YYYYMMDDHHMMSS")
+* to_sql: time as a string formatted as expected for MySQL
+
+
+== XML
+
+* (class) load_dir: specify a one or more directory patterns and pass each XML file in the matching directories to a block; see [Dir#glob](http://www.ruby-doc.org/core/classes/Dir.html#M002347) for pattern details.
+* (class) strip_all: delete exraneous junk from an XML text string, typically for sanitizing input
+* (class) strip_attributes: delete all attributes from an XML text string
+* (class) strip_comments: delete all comments from an XML text string
+* (class) strip_microsoft: delete all proprietary Microsoft code from an XML text string
+* (class) strip_unprintables: delete all unprintable characters from an XML text string
+
+
+== YAML
+
+* (class) load_dir: specify directory patterns and pass each YAML file in the matching directories to a block; see [Dir#glob](http://www.ruby-doc.org/core/classes/Dir.html#M002347) for pattern details.
+* (class) load_dir_pairs: specify directory patterns and pass each YAML file in the matching directories to a block to process key/value pairs.
+
+
+== Changes
+
+- 1.8.2 Refactored Numeric metric names into their own methods
+- 1.8.0 100% rcov coverage
+- 1.7.8 Add rcov testing
+- 1.7.4 Add Class#publicize_methods, Integer#even?, Integer#odd?
+- 1.7.3 Refactor Rails classes to their own gem, add README, LICENSE
+- 1.7.2 Gemcutter update
+- 1.7.1.8 Add Enumerable#map_with_index
+- 1.7.1.6 Add ActiveRecord::SaveExtensions#save_false_then_reload!
+- 1.7.1.3 Add XML#strip_xxx 
+- 1.7.1.2 Update gems: Gemcutter, Ruby 1.9.1, JRuby sqlite3
+- 1.7.1.0 Add XML attributes methods #
+- 1.7.0.9 Add Enumerable #hash_by, #index_by
+- 1.7.0.7 Add Array#to_tsv, String#split_tsv, improve Array#to_csv
+- 1.7.0.6 Add Array#shuffle, Array#shuffle! 
+- 1.7.0.5 Add Array#shifted, Array#rest, Array#car, Array#cdr
+- 1.7.0.4 Upgrade IO#readrows and #readrow to use options
+- 1.7.0.2 Add Array#to_tdf
+- 1.7.0.1 Remove sqlite3 testing dependency
+- 1.6.9.6 Add Symbol with comparable and <=>
+- 1.6.9.5 Add ActiveRecord testing with sqlite3
+- 1.6.9.4 JRuby install and test successful
+- 1.6.9.3 Array#join add infix, prefix, suffix
+- 1.6.9.2 Improve ri docs
+- 1.6.9.1 Add Array#onto, Enumerable#intersect?
+- 1.6.9.0 Add IO, File, ActiveRecord#seed
+- 1.6.8.9 Add Enumerable#to_h, Array#hash, Hash#each_key!, Hash#each_pair, Hash#each_value!
+- 1.6.8.8 Add Hash#map_pair, Hash#size?, Hash#pivot
+- 1.6.8.7 Add Math
+- 1.6.8.6 Add ActiveRecord SchemaStatements
+- 1.6.8.5 Add Integer#maps, String#ACCENTS
+- 1.6.8.4 Add XML
+- 1.6.8.3 Add ActiveRecord
+- 1.6.8.2 Add String#lowcase
+- 1.6.8 Add map_to_xxx methods
+- 1.6.7 Add CSV
+- 1.6.6 Add Array#to_csv, Integer, String#lorem, etc., improve tests
+- 1.6.4 Bug fixes: String characters and YAML test files
+- 1.6.2 Improve organizaiton of class files to lib/ramp
+- 1.6.0 Upgraded to work with Ruby 1.9.1
+- 1.5.0 Combined all Ruby extension files into one gem
+- 1.0.0 Original 
+

data/Rakefile

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+require 'rake'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib' << 'test'
+  t.pattern = 'test/*.rb'
+end

data/VERSION

@@ -0,0 +1 @@
+2.1.0