ruby-nuggets 0.9.1 → 0.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 60dcd32240040bca4933e703e41b095fc72b7376
-  data.tar.gz: 7ab48f180ba23d603d00ad264f63d3cfa65e1eff
+  metadata.gz: 253d8874e5b94ce688f3b97a0e41a52a0397e2bb
+  data.tar.gz: 7901cb5cfc2138f3b3fe22c692b7ecb74299692e
 SHA512:
-  metadata.gz: 1759b4701eb80e6a041bf14d299bf0ac728708f6a36414258ef8f3228ae823f2827fa0225e28340b6ec132d077b0bb5db42ab6dd7d9361d0bcfa11acfeac9efe
-  data.tar.gz: 4c1431a95d67864b0b7cf9ce0095eadd0f28ecdce6dcc90125a630f1dc914b83c01fa0646eaa36bab5774872b57a0b11e6b15351bc886dae37c70bc209c02037
+  metadata.gz: d5630b19a59b8a25f4421b8525f419bdc5c98807358074f5f665c934ec96e2eccc8ead5277a1f0d23b321e273ab68c33911aaac1e08d2d2c9828203c6497ba32
+  data.tar.gz: 520a5f92d9011a4ea1089315f0109ba002e2379320786b0d6332092e9ffe23847351489c6749f81fecff4a0b5fff3cec0ffcc9de12176632ea2c436bd6bbf28c

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to ruby-nuggets version 0.9.1
+This documentation refers to ruby-nuggets version 0.9.2
 
 
 == DESCRIPTION
@@ -34,10 +34,9 @@ cause other libraries to misbehave. Use at your own risk!
 == LINKS
 
 <b></b>
-Documentation::     http://prometheus.rubyforge.org/ruby-nuggets
-Source code::       http://github.com/blackwinter/ruby-nuggets
-RubyForge project:: http://rubyforge.org/projects/prometheus
-RubyGem::           http://rubygems.org/gems/ruby-nuggets
+Documentation:: http://blackwinter.github.com/ruby-nuggets
+Source code::   http://github.com/blackwinter/ruby-nuggets
+RubyGem::       http://rubygems.org/gems/ruby-nuggets
 
 
 == AUTHORS

data/Rakefile

@@ -4,16 +4,14 @@ begin
   require 'hen'
 
   Hen.lay! {{
-    :rubyforge => {
-      :project => %q{prometheus},
-      :package => %q{ruby-nuggets}
-    },
-
     :gem => {
-      :version => Nuggets::VERSION,
-      :summary => %q{Some extensions to the Ruby programming language.},
-      :author  => %q{Jens Wille},
-      :email   => %q{jens.wille@gmail.com}
+      :name         => %q{ruby-nuggets},
+      :version      => Nuggets::VERSION,
+      :summary      => %q{Some extensions to the Ruby programming language.},
+      :author       => %q{Jens Wille},
+      :email        => %q{jens.wille@gmail.com},
+      :homepage     => :blackwinter,
+      :dependencies => %w[]
     }
   }}
 rescue LoadError => err

data/lib/nuggets/ansicolor2css.rb

@@ -0,0 +1,125 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Nuggets
+  module ANSIColor2CSS
+
+    extend self
+
+    ATTRIBUTES = {
+        '0' => nil,                              # clear
+        '1' => 'font-weight: bold',              # bold
+        '2' => '',                               # dark
+        '3' => 'font-style: italic',             # italic -- not widely implemented
+        '4' => 'text-decoration: underline',     # underline
+        '5' => 'text-decoration: blink',         # blink
+        '6' => 'text-decoration: blink',         # rapid blink -- not widely implemented
+        '7' => '',                               # reverse
+        '8' => 'opacity: 0',                     # concealed
+        '9' => 'text-decoration: line-through',  # strikethrough -- not widely implemented
+       '22' => 'font-weight: normal',            # bold off
+       '23' => 'font-style: normal',             # italic off
+       '24' => 'text-decoration: none',          # underline off
+       '25' => 'text-decoration: none',          # blink off
+       '27' => '',                               # reverse off
+       '28' => 'opacity: 1',                     # concealed off
+       '29' => 'text-decoration: none',          # strikethrough off
+       '30' => 'color: black',                   # black
+       '31' => 'color: maroon',                  # red
+       '32' => 'color: green',                   # green
+       '33' => 'color: olive',                   # yellow
+       '34' => 'color: navy',                    # blue
+       '35' => 'color: purple',                  # magenta
+       '36' => 'color: teal',                    # cyan
+       '37' => 'color: silver',                  # white
+       '39' => 'color: silver',                  # default (white)
+       '40' => 'background-color: black',        # on black
+       '41' => 'background-color: maroon',       # on red
+       '42' => 'background-color: green',        # on green
+       '43' => 'background-color: olive',        # on yellow
+       '44' => 'background-color: navy',         # on blue
+       '45' => 'background-color: purple',       # on magenta
+       '46' => 'background-color: teal',         # on cyan
+       '47' => 'background-color: silver',       # on white
+       '49' => 'background-color: black',        # on default (black)
+       '90' => 'color: gray',                    # bright black
+       '91' => 'color: red',                     # bright red
+       '92' => 'color: lime',                    # bright green
+       '93' => 'color: yellow',                  # bright yellow
+       '94' => 'color: blue',                    # bright blue
+       '95' => 'color: fuchsia',                 # bright magenta
+       '96' => 'color: cyan',                    # bright cyan
+       '97' => 'color: white',                   # bright white
+      '100' => 'background-color: gray',         # on bright black
+      '101' => 'background-color: red',          # on bright red
+      '102' => 'background-color: lime',         # on bright green
+      '103' => 'background-color: yellow',       # on bright yellow
+      '104' => 'background-color: blue',         # on bright blue
+      '105' => 'background-color: fuchsia',      # on bright magenta
+      '106' => 'background-color: cyan',         # on bright cyan
+      '107' => 'background-color: white'         # on bright white
+    }
+
+    ATTRIBUTES_RE = ::Regexp.union(*ATTRIBUTES.keys)
+
+    DELIMITER = ';'
+
+    COLOR_RE = %r{
+      \e \[ ( #{ATTRIBUTES_RE} (?: #{DELIMITER} #{ATTRIBUTES_RE} )* ) m
+    }x
+
+    STYLE = '<span style="%s">'
+    CLEAR = '</span>'
+
+    def convert(string)
+      string.gsub(COLOR_RE) { format($1.split(DELIMITER).uniq) }
+    end
+
+    def format(attributes)
+      "#{clear(attributes)}#{style(attributes) if attributes.any?}"
+    end
+
+    def clear(attributes)
+      CLEAR if attributes.delete('0')
+    end
+
+    def style(attributes)
+      STYLE % ATTRIBUTES.values_at(*attributes).join('; ')
+    end
+
+  end
+end
+
+class String
+
+  def ansicolor2css
+    ::Nuggets::ANSIColor2CSS.convert(self)
+  end
+
+  alias_method :ansicolour2css, :ansicolor2css
+
+end

data/lib/nuggets/cli.rb

@@ -0,0 +1,240 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 'optparse'
+require 'yaml'
+require 'zlib'
+require 'highline'
+
+module Nuggets
+  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(Nuggets::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

data/lib/nuggets/content_type.rb

@@ -0,0 +1,103 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.        #
+#                                                                             #
+###############################################################################
+#++
+
+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 Nuggets
+  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 = ::Nuggets::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

data/lib/nuggets/dotted_decimal.rb

@@ -0,0 +1,78 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/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