darkhelmet-darkext 0.0.2

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2008-11-21
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,18 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+lib/darkext.rb
+script/console
+script/destroy
+script/generate
+test/test_darkext.rb
+test/test_helper.rb
+lib/darkext/array.rb
+lib/darkext/boolean.rb
+lib/darkext/hash.rb
+lib/darkext/numeric.rb
+lib/darkext/statistics.rb
+lib/darkext/string.rb
+lib/darkext/symbol.rb

data/PostInstall.txt

@@ -0,0 +1,7 @@
+
+For more information on darkext, see http://darkext.rubyforge.org
+
+NOTE: Change this information in PostInstall.txt 
+You can also delete it if you don't want it.
+
+

data/README.rdoc

@@ -0,0 +1,49 @@
+= darkext
+
+* http://github.com/darkhelmet/darkext/
+
+== DESCRIPTION:
+
+Just some useful Ruby functionality. No particular focus, except usefulness
+
+== FEATURES/PROBLEMS:
+
+* FIX (list of features or problems)
+
+== SYNOPSIS:
+
+  FIX (code sample of usage)
+
+== REQUIREMENTS:
+
+* FIX (list of requirements)
+
+== INSTALL:
+
+* $ gem sources -a http://gems.github.com # unless you already have done this
+* $ gem install darkhelmet-darkext
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIXME full name
+
+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/Rakefile

@@ -0,0 +1,28 @@
+%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require 'version'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('darkext', Darkext::VERSION) do |p|
+  p.developer('Daniel Huckstep', 'darkhelmet@darkhelmetlive.com')
+  p.changes              = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
+  p.rubyforge_name       = p.name # TODO this is default value
+  # p.extra_deps         = [
+  #   ['activesupport','>= 2.0.2'],
+  # ]
+  p.extra_dev_deps = [
+    ['newgem', ">= #{::Newgem::VERSION}"]
+  ]
+
+  p.clean_globs |= %w[**/.DS_Store tmp *.log]
+  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# task :default => [:spec, :features]

data/lib/darkext/array.rb

@@ -0,0 +1,46 @@
+require 'darkext/numeric'
+require 'darkext/symbol'
+
+class Array
+  # Rotates the array left by n elements
+  def rotate(n = 1)
+    return if self.size.zero?
+    n.times { self.push(self.shift) }
+  end
+
+  # Rotates the array right by n elements
+  def rotate_reverse(n = 1)
+    return if self.size.zero?
+    n.times { self.unshift(self.pop) }
+  end
+
+  # Sums the array
+  def sum
+    self.inject(:+)
+  end
+
+  # Finds the product of the array
+  def product
+    self.inject(:*)
+  end
+
+  # Collects the squares of each value in the array
+  def squares
+    self.map(&:square)
+  end
+
+  # Finds the sum of squares of the array
+  def sum_of_squares
+    self.squares.sum
+  end
+
+  # Picks a random value from the array
+  def random
+    self[rand(self.size)]
+  end
+
+  # Randomizes the array
+  def randomize
+    self.sort_by { rand }
+  end
+end

data/lib/darkext/boolean.rb

@@ -0,0 +1,11 @@
+class TrueClass
+  def intern
+    return :true
+  end
+end
+
+class FalseClass
+  def intern
+    return :false
+  end
+end

data/lib/darkext/hash.rb

@@ -0,0 +1,11 @@
+class Hash
+  # Merges defaults with the hash
+  def with_defaults(defaults)
+    self.merge(defaults) { |key,old,new| old.nil? ? new : old }
+  end
+
+  # Merges defaults with the hash (destructive)
+  def with_defaults!(defaults)
+    self.merge!(defaults) { |key,old,new| old.nil? ? new : old }
+  end
+end

data/lib/darkext/numeric.rb

@@ -0,0 +1,13 @@
+require 'mathn'
+
+class Numeric
+  # Squares the number
+  def square
+    self * self
+  end
+
+  # Finds the square root of the number
+  def sqrt
+    Math.sqrt(self)
+  end
+end

data/lib/darkext/statistics.rb

@@ -0,0 +1,102 @@
+require 'mathn'
+require 'darkext/numeric'
+require 'darkext/array'
+
+class Array
+  # Finds the mean of the array
+  def mean
+    self.sum / self.size.to_f
+  end
+
+  # Finds the median of the array
+  def median
+    return nil if self.size.zero?
+    case self.size % 2
+    when 0
+      return self.sort[self.size / (2 - 1), 2].mean
+    when 1
+      return self.sort[self.size / 2]
+    end
+  end
+
+  # Generates a histogram hash for the array
+  def histogram(bins = nil)
+    self.sort.inject({}) do |a,x|
+      a[x] = a[x].to_i + 1
+      a
+    end
+  end
+
+  # Finds the mode of the array
+  def mode
+    map = self.histogram
+    max = map.values.max
+    map.keys.select{ |x| map[x] == max}
+  end
+
+  # Finds the variance of the array
+  def variance
+    (self.sum_of_squares.to_f / self.size.to_f) - self.mean.square
+  end
+
+  # Finds the standard deviation of the array
+  def deviation
+    self.variance.sqrt
+  end
+
+  # Randomly samples n elements
+  def sample(n = 1)
+    (1..n).collect { self[rand(self.size)] }
+  end
+
+  # Makes a two sided confidence interval for the array
+  # Percent must be 0 < percent < 1 for this to work properly
+  def ci(percent = 0.95, rho = 1)
+    m = self.mean
+    i = ((Statistics.zscore((1 - percent) / 2) * rho) /
+         self.size.sqrt).abs
+    [m - i, m + i]
+  end
+
+  # Standardizes the array
+  def standardize
+    m = self.mean.to_f
+    rho = self.deviation.to_f
+    self.map do |v|
+      (v.to_f - m) / rho
+    end
+  end
+end
+
+module Statistics
+  # Finds the probability of a z-score
+  def self.prob(z)
+    p = Math.erf(z.abs/2.sqrt) / 2
+    return 0.5 + p if 0 < z
+    return 0.5 - p
+  end
+
+  # Finds the zscore of a probability
+  def self.zscore(p, epsilon = 0.00000000000001)
+    return -1 if (1 < p || 0 > p)
+    minz, maxz = -6, 6
+    zscore = 0.5
+    prob = 0
+    while (maxz - minz) > epsilon
+      prob = prob(zscore)
+      if prob > p then maxz = zscore else minz = zscore end
+      zscore = (maxz + minz) * 0.5
+    end
+    return zscore
+  end
+
+  # Finds a two tail p-val for a high/low array
+  def self.p_val(r, n = 30, rho = 1, mu = r.mean)
+    probs = r.map do |x|
+      (x - mu) / (rho / n.sqrt)
+    end.map do |x|
+      Statistics.prob(x)
+    end
+    return 1 - (probs[1] - probs[0])
+  end
+end

data/lib/darkext/string.rb

@@ -0,0 +1,19 @@
+class String
+  # Parses a string like "1..10" to a Range
+  def to_range
+    case self.count('.')
+    when 2
+      elements = self.split('..')
+      return Range.new(elements[0].to_i, elements[1].to_i)
+    when 3
+      elements = self.split('...')
+      return Range.new(elements[0].to_i, elements[1].to_i-1)
+    end
+    return nil
+  end
+
+  # Executes the string with system
+  def exec
+    system(self)
+  end
+end

data/lib/darkext/symbol.rb

@@ -0,0 +1,5 @@
+class Symbol
+  def to_proc
+    proc { |obj,*args| obj.send(self, *args) }
+  end
+end

data/lib/darkext.rb

@@ -0,0 +1,4 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+Dir[File.join(File.join(File.dirname(__FILE__), 'darkext'), '*.rb')].sort.each { |lib| require lib }

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/darkext.rb'}"
+puts "Loading darkext gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/test/test_darkext.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestDarkext < Test::Unit::TestCase
+
+  def setup
+  end
+  
+  def test_truth
+    assert true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'stringio'
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/darkext'

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification 
+name: darkhelmet-darkext
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Daniel Huckstep
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-23 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: newgem
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: Just some useful Ruby functionality. No particular focus, except usefulness
+email: 
+- darkhelmet@darkhelmetlive.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+- Rakefile
+- lib/darkext.rb
+- script/console
+- script/destroy
+- script/generate
+- test/test_darkext.rb
+- test/test_helper.rb
+- lib/darkext/array.rb
+- lib/darkext/boolean.rb
+- lib/darkext/hash.rb
+- lib/darkext/numeric.rb
+- lib/darkext/statistics.rb
+- lib/darkext/string.rb
+- lib/darkext/symbol.rb
+has_rdoc: true
+homepage: http://github.com/darkhelmet/darkext/
+post_install_message: PostInstall.txt
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: darkext
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Just some useful Ruby functionality
+test_files: 
+- test/test_helper.rb
+- test/test_darkext.rb