ruby-nuggets 0.9.1 → 0.9.2

data/lib/nuggets/util/cli.rb

@@ -1,242 +1,4 @@
-#--
-###############################################################################
-#                                                                             #
-# A component of ruby-nuggets, some extensions to the Ruby programming        #
-# language.                                                                   #
-#                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@gmail.com>                                       #
-#                                                                             #
-# ruby-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.                                                  #
-#                                                                             #
-# ruby-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 ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.        #
-#                                                                             #
-###############################################################################
-#++
+require 'nuggets/cli'
+module Util; CLI = ::Nuggets::CLI; end
 
-require 'optparse'
-require 'yaml'
-require 'zlib'
-require 'highline'
-
-module Util
-
-  class CLI
-
-    class << self
-
-      def usage(prog)
-        "Usage: #{prog} [-h|--help] [options]"
-      end
-
-      def version
-        parent_const_get(:VERSION)
-      end
-
-      def defaults
-        {}
-      end
-
-      def execute(*args)
-        new.execute(*args)
-      end
-
-      private
-
-      def parent_const_get(const, range = 0...-1)
-        name.split('::').inject([::Object]) { |memo, name|
-          memo << memo.last.const_get(name)
-        }.reverse[range].each { |mod|
-          return mod.const_get(const) if mod.const_defined?(const)
-        }
-
-        raise ::NameError, "uninitialized constant #{self}::#{const}"
-      end
-
-    end
-
-    attr_reader :options, :config, :defaults
-    attr_reader :stdin, :stdout, :stderr
-
-    attr_accessor :prog
-
-    def initialize(defaults = nil, *args)
-      @defaults, @prog = defaults || self.class.defaults, $0
-
-      init(*args)
-
-      # prevent backtrace on ^C
-      trap(:INT) { exit 130 }
-    end
-
-    def progname
-      ::File.basename(prog)
-    end
-
-    def usage
-      self.class.usage(prog)
-    end
-
-    def version
-      self.class.version
-    end
-
-    def execute(arguments = ::ARGV, *inouterr)
-      reset(*inouterr)
-      parse_options(arguments)
-      run(arguments)
-    rescue => err
-      raise if $VERBOSE
-      abort "#{err.backtrace.first}: #{err} (#{err.class})"
-    ensure
-      options.each_value { |value|
-        value.close if value.is_a?(::Zlib::GzipWriter)
-      }
-    end
-
-    def reset(stdin = ::STDIN, stdout = ::STDOUT, stderr = ::STDERR)
-      @stdin, @stdout, @stderr = stdin, stdout, stderr
-      @options, @config = {}, {}
-    end
-
-    private
-
-    def init(*args)
-      reset
-    end
-
-    def ask(question, &block)
-      ::HighLine.new(stdin, stdout).ask(question, &block)
-    end
-
-    def puts(*msg)
-      stdout.puts(*msg)
-    end
-
-    def warn(*msg)
-      stderr.puts(*msg)
-    end
-
-    def quit(msg = nil, include_usage = msg != false)
-      out = []
-
-      out << "#{progname}: #{msg}" if msg
-      out << usage if include_usage
-
-      abort out.any? && out.join("\n\n")
-    end
-
-    def abort(msg = nil, status = 1)
-      warn(msg) if msg
-      exit(status)
-    end
-
-    def shut(msg = nil, status = 0)
-      puts(msg) if msg
-      exit(status)
-    end
-
-    def exit(status = 0)
-      ::Kernel.exit(status)
-    end
-
-    def open_file_or_std(file, write = false)
-      if file == '-'
-        write ? stdout : stdin
-      else
-        gz = file =~ /\.gz\z/i
-
-        if write
-          gz ? ::Zlib::GzipWriter.open(file) : ::File.open(file, 'w')
-        else
-          quit "No such file: #{file}" unless ::File.readable?(file)
-          (gz ? ::Zlib::GzipReader : ::File).open(file)
-        end
-      end
-    end
-
-    def load_config(file = options[:config] || default = defaults[:config])
-      return unless file
-
-      if ::File.readable?(file)
-        @config = ::YAML.load_file(file)
-      else
-        quit "No such file: #{file}" unless default
-      end
-    end
-
-    def merge_config(args = [config, defaults])
-      args.each { |hash| hash && hash.each { |key, value|
-        options[key] = value unless options.has_key?(key)
-      } }
-    end
-
-    def parse_options(arguments)
-      option_parser.parse!(arguments)
-
-      load_config
-      merge_config
-    end
-
-    def option_parser
-      ::OptionParser.new { |opts|
-        opts.banner = usage
-
-        pre_opts(opts)
-
-        opts.separator ''
-        opts.separator 'Options:'
-
-        opts(opts)
-
-        opts.separator ''
-        opts.separator 'Generic options:'
-
-        generic_opts(opts)
-        post_opts(opts)
-      }.extend(Util::CLI::OptionParserExtension)
-    end
-
-    def pre_opts(opts)
-    end
-
-    def opts(opts)
-    end
-
-    def generic_opts(opts)
-      opts.on('-h', '--help', 'Print this help message and exit') {
-        shut opts
-      }
-
-      opts.on('--version', 'Print program version and exit') {
-        shut "#{progname} v#{version}"
-      }
-    end
-
-    def post_opts(opts)
-    end
-
-    module OptionParserExtension
-
-      KEY_POOL = ('A'..'Z').to_a + ('a'..'z').to_a + ('0'..'9').to_a
-
-      def keys
-        { :used => keys = top.short.keys, :free => KEY_POOL - keys }
-      end
-
-    end
-
-  end
-
-end
+warn "#{__FILE__}: Util::CLI is deprecated, use Nuggets::CLI instead."

data/lib/nuggets/util/content_type.rb

@@ -1,105 +1,4 @@
-#--
-###############################################################################
-#                                                                             #
-# A component of ruby-nuggets, some extensions to the Ruby programming        #
-# language.                                                                   #
-#                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@gmail.com>                                       #
-#                                                                             #
-# ruby-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.                                                  #
-#                                                                             #
-# ruby-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 ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.        #
-#                                                                             #
-###############################################################################
-#++
+require 'nuggets/content_type'
+module Util; ContentType = ::Nuggets::ContentType; end
 
-begin
-  require 'rubygems'
-rescue ::LoadError
-end
-
-begin
-  require 'filemagic/ext'
-rescue ::LoadError
-  def File.content_type(path)  # :nodoc:
-    nil
-  end
-end
-
-begin
-  require 'nuggets/uri/content_type'
-rescue ::LoadError
-  module URI
-    def self.content_type(path)  # :nodoc:
-      nil
-    end
-  end
-end
-
-begin
-  require 'mime/types'
-rescue ::LoadError
-  module MIME    # :nodoc:
-    class Types  # :nodoc:
-      def self.of(path)
-        []
-      end
-    end
-  end
-end
-
-module Util
-
-  module ContentType
-
-    extend self
-
-    # call-seq:
-    #   ContentType.of(path) => aString or +nil+
-    #
-    # Get the MIME-Type of the file living at +path+. Either by looking
-    # directly into the file (requires FileMagic), or, assuming +path+
-    # might denote a URI, by asking the web server (via OpenURI), or
-    # finally by just looking at the file extension (requires MIME::Types).
-    # Returns +nil+ in case no decision could be made.
-    #
-    # NOTE: This is really only useful with the filemagic and mime-types gems
-    # installed.
-    def of(path)
-      ::File.content_type(path) || ::URI.content_type(path) || (
-        t = ::MIME::Types.of(path).first and t.content_type
-      )
-    end
-
-  end
-
-end
-
-# Just a short-cut to make the code read nicer...
-ContentType = ::Util::ContentType
-
-if $0 == __FILE__
-  [
-    __FILE__,
-    'bla/blub.jpg',
-    'bla/blub.blob',
-    'http://www.google.de',
-    'http://blackwinter.de/misc/ww.png',
-    'http://blackwinter.de/misc/ww.jpg',
-    'http://blackwinter.de/bla/blub.blob'
-  ].each { |f|
-    p [f, ::ContentType.of(f)]
-  }
-end
+warn "#{__FILE__}: Util::ContentType is deprecated, use Nuggets::ContentType instead."

data/lib/nuggets/util/dotted_decimal.rb

@@ -1,78 +1,4 @@
-#--
-###############################################################################
-#                                                                             #
-# A component of ruby-nuggets, some extensions to the Ruby programming        #
-# language.                                                                   #
-#                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@gmail.com>                                       #
-#                                                                             #
-# ruby-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.                                                  #
-#                                                                             #
-# ruby-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 ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.        #
-#                                                                             #
-###############################################################################
-#++
+require 'nuggets/dotted_decimal'
+module Util; DottedDecimal = ::Nuggets::DottedDecimal; end
 
-require 'nuggets/integer/to_binary_s'
-
-class Integer
-
-  # call-seq:
-  #   int.to_dotted_decimal => aString
-  #
-  # Converts _int_ to dotted-decimal notation.
-  def to_dotted_decimal
-    to_binary_s(32).unpack('a8' * 4).map { |s| s.to_i(2) }.join('.')
-  end
-
-end
-
-class String
-
-  # call-seq:
-  #   str.from_dotted_decimal => anInteger
-  #
-  # Converts _str_ from dotted-decimal notation to integer.
-  def from_dotted_decimal
-    split('.').map { |i| i.to_i.to_binary_s(8) }.join.to_i(2)
-  end
-
-end
-
-class Array
-
-  def sort_by_dotted_decimal
-    sort_by { |i| i.split('.').map { |j| j.to_i } }
-  end
-
-end
-
-if $0 == __FILE__
-  [2294967042, 4294967040].each { |i|
-    p i.to_binary_s(32)
-    p i.to_dotted_decimal
-  }
-
-  puts '#' * 34
-
-  %w[77.47.161.3 196.101.53.1].each { |s|
-    p s
-    p s.from_dotted_decimal.to_binary_s(32)
-  }
-
-  a = %w[77.47.161.3 196.101.53.1 77.47.161.11]
-  p a.sort
-  p a.sort_by_dotted_decimal
-end
+warn "#{__FILE__}: Util::DottedDecimal is deprecated, use Nuggets::DottedDecimal instead."

data/lib/nuggets/util/i18n.rb

@@ -1,167 +1,4 @@
-# encoding: utf-8
+require 'nuggets/i18n'
+module Util; I18n = ::Nuggets::I18n; end
 
-#--
-###############################################################################
-#                                                                             #
-# A component of ruby-nuggets, some extensions to the Ruby programming        #
-# language.                                                                   #
-#                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@gmail.com>                                       #
-#                                                                             #
-# ruby-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.                                                  #
-#                                                                             #
-# ruby-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 ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.        #
-#                                                                             #
-###############################################################################
-#++
-
-module Util
-
-  module I18n
-
-    DIACRITICS = {
-      'À' => 'A',  # LATIN CAPITAL LETTER A WITH GRAVE
-      'Á' => 'A',  # LATIN CAPITAL LETTER A WITH ACUTE
-      'Â' => 'A',  # LATIN CAPITAL LETTER A WITH CIRCUMFLEX
-      'Ã' => 'A',  # LATIN CAPITAL LETTER A WITH TILDE
-      'Ä' => 'AE', # LATIN CAPITAL LETTER A WITH DIAERESIS
-      'Å' => 'A',  # LATIN CAPITAL LETTER A WITH RING ABOVE
-      'Æ' => 'AE', # LATIN CAPITAL LETTER AE
-      'Ç' => 'C',  # LATIN CAPITAL LETTER C WITH CEDILLA
-      'È' => 'E',  # LATIN CAPITAL LETTER E WITH GRAVE
-      'É' => 'E',  # LATIN CAPITAL LETTER E WITH ACUTE
-      'Ê' => 'E',  # LATIN CAPITAL LETTER E WITH CIRCUMFLEX
-      'Ë' => 'E',  # LATIN CAPITAL LETTER E WITH DIAERESIS
-      'Ì' => 'I',  # LATIN CAPITAL LETTER I WITH GRAVE
-      'Í' => 'I',  # LATIN CAPITAL LETTER I WITH ACUTE
-      'Î' => 'I',  # LATIN CAPITAL LETTER I WITH CIRCUMFLEX
-      'Ï' => 'I',  # LATIN CAPITAL LETTER I WITH DIAERESIS
-      'Ð' => 'DH', # LATIN CAPITAL LETTER ETH
-      'Ñ' => 'N',  # LATIN CAPITAL LETTER N WITH TILDE
-      'Ò' => 'O',  # LATIN CAPITAL LETTER O WITH GRAVE
-      'Ó' => 'O',  # LATIN CAPITAL LETTER O WITH ACUTE
-      'Ô' => 'O',  # LATIN CAPITAL LETTER O WITH CIRCUMFLEX
-      'Õ' => 'O',  # LATIN CAPITAL LETTER O WITH TILDE
-      'Ö' => 'OE', # LATIN CAPITAL LETTER O WITH DIAERESIS
-      'Ø' => 'O',  # LATIN CAPITAL LETTER O WITH STROKE
-      'Ù' => 'U',  # LATIN CAPITAL LETTER U WITH GRAVE
-      'Ú' => 'U',  # LATIN CAPITAL LETTER U WITH ACUTE
-      'Û' => 'U',  # LATIN CAPITAL LETTER U WITH CIRCUMFLEX
-      'Ü' => 'UE', # LATIN CAPITAL LETTER U WITH DIAERESIS
-      'Ý' => 'Y',  # LATIN CAPITAL LETTER Y WITH ACUTE
-      'Þ' => 'TH', # LATIN CAPITAL LETTER THORN
-      'ß' => 'ss', # LATIN SMALL LETTER SHARP S
-      'à' => 'a',  # LATIN SMALL LETTER A WITH GRAVE
-      'á' => 'a',  # LATIN SMALL LETTER A WITH ACUTE
-      'â' => 'a',  # LATIN SMALL LETTER A WITH CIRCUMFLEX
-      'ã' => 'a',  # LATIN SMALL LETTER A WITH TILDE
-      'ä' => 'ae', # LATIN SMALL LETTER A WITH DIAERESIS
-      'å' => 'a',  # LATIN SMALL LETTER A WITH RING ABOVE
-      'æ' => 'ae', # LATIN SMALL LETTER AE
-      'ç' => 'c',  # LATIN SMALL LETTER C WITH CEDILLA
-      'è' => 'e',  # LATIN SMALL LETTER E WITH GRAVE
-      'é' => 'e',  # LATIN SMALL LETTER E WITH ACUTE
-      'ê' => 'e',  # LATIN SMALL LETTER E WITH CIRCUMFLEX
-      'ë' => 'e',  # LATIN SMALL LETTER E WITH DIAERESIS
-      'ì' => 'i',  # LATIN SMALL LETTER I WITH GRAVE
-      'í' => 'i',  # LATIN SMALL LETTER I WITH ACUTE
-      'î' => 'i',  # LATIN SMALL LETTER I WITH CIRCUMFLEX
-      'ï' => 'i',  # LATIN SMALL LETTER I WITH DIAERESIS
-      'ð' => 'dh', # LATIN SMALL LETTER ETH
-      'ñ' => 'n',  # LATIN SMALL LETTER N WITH TILDE
-      'ò' => 'o',  # LATIN SMALL LETTER O WITH GRAVE
-      'ó' => 'o',  # LATIN SMALL LETTER O WITH ACUTE
-      'ô' => 'o',  # LATIN SMALL LETTER O WITH CIRCUMFLEX
-      'õ' => 'o',  # LATIN SMALL LETTER O WITH TILDE
-      'ö' => 'oe', # LATIN SMALL LETTER O WITH DIAERESIS
-      'ø' => 'o',  # LATIN SMALL LETTER O WITH STROKE
-      'ù' => 'u',  # LATIN SMALL LETTER U WITH GRAVE
-      'ú' => 'u',  # LATIN SMALL LETTER U WITH ACUTE
-      'û' => 'u',  # LATIN SMALL LETTER U WITH CIRCUMFLEX
-      'ü' => 'ue', # LATIN SMALL LETTER U WITH DIAERESIS
-      'ý' => 'y',  # LATIN SMALL LETTER Y WITH ACUTE
-      'þ' => 'th', # LATIN SMALL LETTER THORN
-      'ÿ' => 'y'   # LATIN SMALL LETTER Y WITH DIAERESIS
-    }
-
-    def self.args_for_map_diacritics
-      @args_for_map_diacritics ||= begin
-        map = ::Hash.new { |h, k| h[k] = [] }
-
-        DIACRITICS.each { |a| a.each { |i| map[i].concat(a) } }
-        map.each { |k, v| v.uniq!; map[k] = "(#{::Regexp.union(*v).source})" }
-
-        [::Regexp.union(*map.keys.sort_by { |k| -k.length }), map.method(:[])]
-      end
-    end
-
-  end
-
-end
-
-class String
-
-  # call-seq:
-  #   str.replace_diacritics => new_str
-  #
-  # Substitutes any diacritics in _str_ with their replacements as per
-  # Util::I18n::DIACRITICS.
-  def replace_diacritics
-    (_dup = dup).replace_diacritics! || _dup
-  end
-
-  # call-seq:
-  #   str.replace_diacritics! => str or +nil+
-  #
-  # Destructive version of #replace_diacritics.
-  def replace_diacritics!
-    diacritics = ::Util::I18n::DIACRITICS
-
-    gsub!(/#{::Regexp.union(*diacritics.keys)}/) { |m|
-      s = diacritics[m]
-
-      # Try to adjust case:
-      #   'Äh' => 'AEh' => 'Aeh'
-      #
-      # But:
-      #   'SÖS' => 'SOES' (not 'SOeS'!)
-      if s.length > 1
-        t = $'[0..0]
-        s[1..-1] = s[1..-1].downcase if t == t.downcase
-      end
-
-      s
-    }
-  end
-
-  def map_diacritics
-    (_dup = dup).map_diacritics! || _dup
-  end
-
-  def map_diacritics!
-    re, block = ::Util::I18n.args_for_map_diacritics
-    gsub!(re, &block)
-  end
-
-end
-
-if $0 == __FILE__
-  s = 'Äh, Rüby iß sö cüül, nö? SÖS!'
-  p s
-  p s.replace_diacritics
-
-  s.replace_diacritics!
-  p s
-end
+warn "#{__FILE__}: Util::I18n is deprecated, use Nuggets::I18n instead."

data/lib/nuggets/util/lazy_attr.rb

@@ -1,45 +1,4 @@
-#--
-###############################################################################
-#                                                                             #
-# A component of ruby-nuggets, some extensions to the Ruby programming        #
-# language.                                                                   #
-#                                                                             #
-# Copyright (C) 2007-2012 Jens Wille                                          #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@gmail.com>                                       #
-#                                                                             #
-# ruby-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.                                                  #
-#                                                                             #
-# ruby-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 ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.        #
-#                                                                             #
-###############################################################################
-#++
+require 'nuggets/lazy_attr'
+module Util; LazyAttr = ::Nuggets::LazyAttr; end
 
-module Util
-
-  module LazyAttr
-
-    private
-
-    def lazy_attr(attr, freeze = true)
-      class << self; self; end.class_eval { attr_reader attr }
-
-      value = instance_variable_get(name = "@#{attr}") ||
-              instance_variable_set(name, yield)
-
-      freeze ? value.freeze : value
-    end
-
-  end
-
-end
+warn "#{__FILE__}: Util::LazyAttr is deprecated, use Nuggets::LazyAttr instead."