nuggets 0.9.9 → 1.0.0

data/lib/nuggets/range/quantile.rb

@@ -0,0 +1,5 @@
+require 'nuggets/range/quantile_mixin'
+
+class Range
+  include Nuggets::Range::QuantileMixin
+end

data/lib/nuggets/range/quantile_mixin.rb

@@ -0,0 +1,42 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2011 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets is free software; you can redistribute it and/or modify it under    #
+# the terms of the GNU Affero General Public License as published by the Free #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# nuggets is distributed in the hope that it will be useful, but WITHOUT ANY  #
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS   #
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for     #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU Affero General Public License    #
+# along with nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class Range
+    module QuantileMixin
+
+  # call-seq:
+  #   range.quantile(value[, order]) => anInteger
+  #
+  # Determines the <tt>order</tt>-quantile of +value+ in _range_.
+  def quantile(value, order = 100)
+    value < first ? 1 : value >= last ? order :
+      ((value - first) / ((last - first) / order.to_f)).to_i + 1
+  end
+
+    end
+  end
+end

data/lib/nuggets/ruby.rb

@@ -0,0 +1,235 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2014 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets is free software; you can redistribute it and/or modify it under    #
+# the terms of the GNU Affero General Public License as published by the Free #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# nuggets is distributed in the hope that it will be useful, but WITHOUT ANY  #
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS   #
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for     #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU Affero General Public License    #
+# along with nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+require 'rbconfig'
+
+module Nuggets
+
+  # Originally based on Phusion Passenger's
+  # {PlatformInfo}[https://github.com/FooBarWidget/passenger/blob/release-3.0.2/lib/phusion_passenger/platform_info/ruby.rb]
+  # module.
+  #
+  #--
+  # Phusion Passenger - http://www.modrails.com/
+  # Copyright (c) 2010 Phusion
+  #
+  # "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
+  #
+  # 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.
+  #++
+
+  module Ruby
+
+    extend self
+
+    CONFIG = ::RbConfig::CONFIG
+
+    # Store original $GEM_HOME value so that even if the app customizes
+    # $GEM_HOME we can still work with the original value.
+    if gem_home = ::ENV['GEM_HOME']
+      gem_home = gem_home.strip.freeze
+      gem_home = nil if gem_home.empty?
+    end
+
+    GEM_HOME = gem_home
+
+    RUBY_ENGINE = defined?(::RUBY_ENGINE) ? ::RUBY_ENGINE : 'ruby'
+
+    OSX_RUBY_RE = %r{\A/System/Library/Frameworks/Ruby.framework/Versions/.*?/usr/bin/ruby\Z}
+
+    # Returns correct command for invoking the current Ruby interpreter.
+    def ruby_command
+      defined?(@ruby_command) ? @ruby_command : @ruby_command = ruby_executable
+    end
+
+    attr_writer :ruby_command
+
+    # Returns the full path to the current Ruby interpreter's executable file.
+    # This might not be the actual correct command to use for invoking the Ruby
+    # interpreter; use ruby_command instead.
+    def ruby_executable
+      @ruby_executable ||= begin
+        dir, name, ext = CONFIG.values_at(*%w[bindir RUBY_INSTALL_NAME EXEEXT])
+        ::File.join(dir, name + ext).sub(/.*\s.*/m, '"\&"')
+      end
+    end
+
+    attr_writer :ruby_executable
+
+    # Locates a Ruby tool command +name+, e.g. 'gem', 'rake', 'bundle', etc. Instead
+    # of naively looking in $PATH, this function uses a variety of search heuristics
+    # to find the command that's really associated with the current Ruby interpreter.
+    # It should never locate a command that's actually associated with a different
+    # Ruby interpreter.
+    #
+    # NOTE: The return value may not be the actual correct invocation for the tool.
+    # Use command_for_ruby_tool for that.
+    #
+    # Returns +nil+ when nothing's found.
+    def locate_ruby_tool(name, extensions = ['', CONFIG['EXEEXT']].compact.uniq)
+      # Deduce Ruby's --program-prefix and --program-suffix from its install name
+      # and transform the given input name accordingly.
+      #
+      #   "rake" => "jrake", "rake1.8", etc.
+      [name, CONFIG['RUBY_INSTALL_NAME'].sub('ruby', name)].uniq.each { |basename|
+        extensions.each { |ext|
+          result = locate_ruby_tool_by_basename(basename + ext) and return result
+        }
+      }
+
+      nil
+    end
+
+    # Returns the correct command string for invoking the +name+ executable
+    # that belongs to the current Ruby interpreter. Returns +nil+ if the
+    # command is not found.
+    #
+    # If the command executable is a Ruby program, then we need to run it
+    # in the correct Ruby interpreter just in case the command doesn't
+    # have the correct shebang line; we don't want a totally different
+    # Ruby than the current one to be invoked.
+    def command_for_ruby_tool(name)
+      filename = respond_to?(name) ? send(name) : locate_ruby_tool(name)
+      shebang_command(filename) =~ /ruby/ ? "#{ruby_command} #{filename}" : filename
+    end
+
+    def self.define_ruby_tool(name)
+      class_eval <<-EOT, __FILE__, __LINE__ + 1
+        def #{name}
+          @#{name} ||= locate_ruby_tool('#{name}')
+        end
+
+        attr_writer :#{name}
+
+        def #{name}_command
+          @#{name}_command ||= command_for_ruby_tool('#{name}')
+        end
+
+        attr_writer :#{name}_command
+      EOT
+    end
+
+    %w[gem rake rspec].each { |name| define_ruby_tool(name) }
+
+    def ruby_options_to_argv(args, ruby_command = ruby_command)
+      argv = [ruby_command]
+
+      ruby_options_from_hash(args.pop, argv) if args.last.is_a?(::Hash)
+
+      argv.concat(args.map! { |arg| arg.to_s.strip })
+    end
+
+    def ruby_options_from_hash(hash, argv = [])
+      hash.each { |key, val|
+        opt = "-#{key.to_s[0, 1]}"
+
+        if val.is_a?(::Array)
+          val.each { |v| argv << opt << v.to_s }
+        elsif opt == '-e'
+          argv << opt << val.to_s
+        elsif val != false
+          argv << "#{opt}#{val unless val == true}"
+        end
+      }
+
+      argv
+    end
+
+    private
+
+    def locate_ruby_tool_by_basename(name)
+      # On OS X we must look for Ruby binaries in /usr/bin.
+      # RubyGems puts executables (e.g. 'rake') in there, not in
+      # /System/Libraries/(...)/bin.
+      dir = ::RUBY_PLATFORM =~ /darwin/ && ruby_command =~ OSX_RUBY_RE ?
+        '/usr/bin' : ::File.dirname(ruby_command)
+
+      filename = executable_filename(dir, name) and return filename
+
+      # RubyGems might put binaries in a directory other
+      # than Ruby's bindir. Debian packaged RubyGems and
+      # DebGem packaged RubyGems are the prime examples.
+      filename = executable_filename(::Gem.bindir, name) and return filename
+
+      # Looks like it's not in the RubyGems bindir. Search in $PATH, but
+      # be very careful about this because whatever we find might belong
+      # to a different Ruby interpreter than the current one.
+      ::ENV['PATH'].split(::File::PATH_SEPARATOR).each { |path|
+        if filename = executable_filename(path, name)
+          return filename if shebang_command(filename) == ruby_command
+        end
+      }
+
+      nil
+    end
+
+    def executable_filename(dir, name)
+      filename = ::File.join(dir, name)
+      filename if ::File.file?(filename) && ::File.executable?(filename)
+    end
+
+    def shebang_command(filename)
+      ::File.foreach(filename) { |line|
+        return $1 if line =~ /\A#!\s*(\S*)/
+
+        # Allow one extra line for magic comment.
+        break if $. > 1
+      }
+
+      nil
+    end
+
+  end
+
+end
+
+def File.ruby; ::Nuggets::Ruby.ruby_command; end
+
+begin
+  require 'open4'
+
+  def Process.ruby(*args, &block)
+    argv = ::Nuggets::Ruby.ruby_options_to_argv(args)
+    ::Open4.popen4(*argv, &block)
+  end
+
+  require 'nuggets/io/interact'
+
+  def Process.interact_ruby(input, *args)
+    ruby(*args) { |_, i, o, e|
+      ::IO.interact({ input => i }, { o => $stdout, e => $stderr })
+    }
+  end
+rescue ::LoadError
+end

data/lib/nuggets/statistics.rb

@@ -0,0 +1,12 @@
+# load statistics related nuggets
+
+require 'nuggets/array/boost'
+require 'nuggets/array/correlation'
+require 'nuggets/array/histogram'
+require 'nuggets/array/mean'
+require 'nuggets/array/median'
+require 'nuggets/array/mode'
+require 'nuggets/array/regression'
+require 'nuggets/array/standard_deviation'
+require 'nuggets/array/variance'
+require 'nuggets/range/quantile'

data/lib/nuggets/statistics_mixins.rb

@@ -0,0 +1,12 @@
+# load statistics related nuggets (mixins)
+
+require 'nuggets/array/boost_mixin'
+require 'nuggets/array/correlation_mixin'
+require 'nuggets/array/histogram_mixin'
+require 'nuggets/array/mean_mixin'
+require 'nuggets/array/median_mixin'
+require 'nuggets/array/mode_mixin'
+require 'nuggets/array/regression_mixin'
+require 'nuggets/array/standard_deviation_mixin'
+require 'nuggets/array/variance_mixin'
+require 'nuggets/range/quantile_mixin'

data/lib/nuggets/string/camelscore.rb

@@ -0,0 +1,5 @@
+require 'nuggets/string/camelscore_mixin'
+
+class String
+  include Nuggets::String::CamelscoreMixin
+end

data/lib/nuggets/string/camelscore_mixin.rb

@@ -0,0 +1,116 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2012 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets is free software; you can redistribute it and/or modify it under    #
+# the terms of the GNU Affero General Public License as published by the Free #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# nuggets is distributed in the hope that it will be useful, but WITHOUT ANY  #
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS   #
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for     #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU Affero General Public License    #
+# along with nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class String
+    module CamelscoreMixin
+
+  # List of acronyms to treat specially
+  # in #camelcase and #underscore.
+  CAMELSCORE_ACRONYMS = {
+    'html' => 'HTML',
+    'rss'  => 'RSS',
+    'sql'  => 'SQL',
+    'ssl'  => 'SSL',
+    'xml'  => 'XML'
+  }
+
+  # call-seq:
+  #   str.camelcase => new_string
+  #
+  # Returns the CamelCase form of _str_.
+  def camelcase
+    dup.camelcase!
+  end
+
+  alias_method :camelize, :camelcase
+
+  # call-seq:
+  #   str.camelcase! => str
+  #
+  # Replaces _str_ with its CamelCase form and returns _str_.
+  def camelcase!
+    sub!(/^[a-z]+/) {
+      CAMELSCORE_ACRONYMS[$&] || $&.capitalize
+    }
+
+    gsub!(/(?:_|([\/\d]))([a-z]+)/i) {
+      "#{$1}#{CAMELSCORE_ACRONYMS[$2] || $2.capitalize}"
+    }
+
+    gsub!('/', '::')
+
+    self
+  end
+
+  alias_method :camelize!, :camelcase!
+
+  # call-seq:
+  #   str.underscore => new_string
+  #
+  # Returns the under_score form of _str_.
+  def underscore
+    dup.underscore!
+  end
+
+  # call-seq:
+  #   str.underscore! => str
+  #
+  # Replaces _str_ with its under_score form and returns _str_.
+  def underscore!
+    gsub!(/::/, '/')
+
+    a = CAMELSCORE_ACRONYMS.values
+    r = a.empty? ? /(?=a)b/ : ::Regexp.union(*a.sort_by { |v| v.length })
+
+    gsub!(/(?:([A-Za-z])|(\d)|^)(#{r})(?=\b|[^a-z])/) {
+      "#{$1 || $2}#{'_' if $1}#{$3.downcase}"
+    }
+
+    gsub!(/([A-Z])(?=[A-Z])/, '\1_')
+    gsub!(/([a-z\d])([A-Z])/, '\1_\2')
+
+    downcase!
+
+    self
+  end
+
+  # call-seq:
+  #   str.constantize(base = Object) => anObject
+  #
+  # Returns the constant pointed to by _str_, relative to +base+.
+  def constantize(base = ::Object)
+    names = split('::')
+    return if names.empty?
+
+    const = names.first.empty? ? (names.shift; ::Object) : base
+    names.each { |name| const = const.const_get(name) }
+    const
+  end
+
+    end
+  end
+end

data/lib/nuggets/string/capitalize_first.rb

@@ -0,0 +1,46 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2011 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets is free software; you can redistribute it and/or modify it under    #
+# the terms of the GNU Affero General Public License as published by the Free #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# nuggets is distributed in the hope that it will be useful, but WITHOUT ANY  #
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS   #
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for     #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU Affero General Public License    #
+# along with nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+class String
+
+  # call-seq:
+  #   str.capitalize_first => new_string
+  #
+  # Capitalizes the first character in +str+, but without downcasing the rest
+  # like String#capitalize does.
+  def capitalize_first
+    empty? ? self : self[0..0].upcase << self[1..-1]
+  end
+
+  # call-seq:
+  #   str.capitalize_first! => str
+  #
+  # Destructive version of #capitalize_first.
+  def capitalize_first!
+    replace(capitalize_first)
+  end
+
+end