nuggets 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d101677594dc97521392e9f3e9633e83f408303f
-  data.tar.gz: 5f5fcba403d1d7aee7b3a7bf7041389ee437e00d
+  metadata.gz: 2a1936682f72cb0230791ed908e37cacf43667cc
+  data.tar.gz: b5b3086d7f0edf596f76a6a2e4c2ddb8cd4a741e
 SHA512:
-  metadata.gz: 1ea3f177acaa6e138a4fde477323284a5a3439339e206c6b01ce8f1d43aaa2458d15dfe92c45d800f268688bde54f3171ad90202ad4d20fe8911c78f9a6a81a8
-  data.tar.gz: 402c097802cb1636c9ddb040080dfb20aa414477f47d724eab1c33b55be85b76e74d65f6a6e49f71355bbb615846da0218c527f031b76405810a62fd067465df
+  metadata.gz: 198004daec45f4efccfac5dddb720dc967c6662e5744e9932d91212585c5740e763d3568840baa5e18f98ea870a4b6a818b15714ff394e7c72d561d8303a6de7
+  data.tar.gz: fdbbe46e74251556320c14784d58231eebbdc819f884a8fc8090dd4f9fd4a6894fc931558a63546adabaed849451f5ccebff7cbdaf2ded5ecde5d637b039aee1

data/ChangeLog

@@ -2,6 +2,15 @@
 
 = Revision history for nuggets
 
+== 1.0.1 [2014-08-27]
+
+* Added DATA.{consume,reposition,update}.
+* Added Module#query_attr.
+* Added Module#lazy_attr.
+* Added Integer#to_roman.
+* Added Numeric#signum_s.
+* Added Array#interpolate.
+
 == 1.0.0 [2014-06-20]
 
 * First release under new name. Formerly known as ruby-nuggets.

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to nuggets version 1.0.0.
+This documentation refers to nuggets version 1.0.1.
 
 
 == DESCRIPTION
@@ -45,7 +45,7 @@ expected or cause other libraries to misbehave. Use at your own risk!
 
 == LINKS
 
-Documentation:: https://blackwinter.github.io/nuggets/
+Documentation:: https://blackwinter.github.com/nuggets
 Source code::   https://github.com/blackwinter/nuggets
 RubyGem::       https://rubygems.org/gems/nuggets
 Travis CI::     https://travis-ci.org/blackwinter/nuggets

data/lib/nuggets/array/interpolate.rb

@@ -0,0 +1,5 @@
+require 'nuggets/array/interpolate_mixin'
+
+class Array
+  include Nuggets::Array::InterpolateMixin
+end

data/lib/nuggets/array/interpolate_mixin.rb

@@ -0,0 +1,54 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class Array
+    module InterpolateMixin
+
+  # call-seq:
+  #   array.interpolate([x0[, xN]]) => anArray
+  #
+  # Simple {linear interpolation}[http://en.wikipedia.org/wiki/Linear_interpolation]
+  # of missing values in _array_.
+  #
+  # Example:
+  #
+  #   [1, nil, 3, nil, 5].interpolate #=> [1, 2, 3, 4, 5]
+  def interpolate(x0 = 0, xN = x0)
+    res, xX, interpolate = dup, [], lambda { |x|
+      m = (x - x0) / xX.size.succ.to_f unless xX.empty?
+      xX.each_with_index { |j, k| res[j] = m * k.succ + x0 }.clear
+      x
+    }
+
+    each_with_index { |x, i| x ? x0 = interpolate[x] : xX << i }
+    interpolate[xN] if xN
+    res
+  end
+
+    end
+  end
+end

data/lib/nuggets/data/consume.rb

@@ -0,0 +1,3 @@
+require 'nuggets/data/consume_mixin'
+
+DATA.extend(Nuggets::Data::ConsumeMixin)

data/lib/nuggets/data/consume_mixin.rb

@@ -0,0 +1,43 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  module Data
+    module ConsumeMixin
+
+  # call-seq:
+  #   DATA.consume(*args) -> aString
+  #
+  # Read DATA and rewind.
+  def consume(*args)
+    pos, res = self.pos, read(*args)
+    seek(pos)
+    res
+  end
+
+    end
+  end
+end

data/lib/nuggets/data/position.rb

@@ -0,0 +1,3 @@
+require 'nuggets/data/position_mixin'
+
+DATA.extend(Nuggets::Data::PositionMixin)

data/lib/nuggets/data/position_mixin.rb

@@ -0,0 +1,43 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  module Data
+    module PositionMixin
+
+  attr_accessor :position
+
+  def reposition
+    seek(position)
+  end
+
+  def self.extended(base)
+    base.position = base.pos
+  end
+
+    end
+  end
+end

data/lib/nuggets/data/update.rb

@@ -0,0 +1,3 @@
+require 'nuggets/data/update_mixin'
+
+DATA.extend(Nuggets::Data::UpdateMixin)

data/lib/nuggets/data/update_mixin.rb

@@ -0,0 +1,45 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  module Data
+    module UpdateMixin
+
+  # call-seq:
+  #   DATA.update(string) -> anInteger
+  #
+  # Update DATA with +string+.
+  def update(string)
+    File.open(self, 'r+') { |io|
+      io.seek(pos)
+      io.truncate(pos)
+      io.write(string)
+    }
+  end
+
+    end
+  end
+end

data/lib/nuggets/integer/roman.rb

@@ -0,0 +1,5 @@
+require 'nuggets/integer/roman_mixin'
+
+class Integer
+  include Nuggets::Integer::RomanMixin
+end

data/lib/nuggets/integer/roman_mixin.rb

@@ -0,0 +1,70 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class Integer
+    module RomanMixin
+
+  NUMERAL = {
+    1000 => 'M',
+    500  => 'D',
+    100  => 'C',
+    50   => 'L',
+    10   => 'X',
+    5    => 'V',
+    1    => 'I'
+  }
+
+  COMPACT = NUMERAL.values.each_cons(3).to_a.values_at(0, 2, 4).flat_map { |*a, b|
+    a.push(nil).each_cons(2).map { |x, y| [/#{y}#{b}{4}/, "#{b}#{x}"] }
+  }
+
+  # call-seq:
+  #   to_roman(int) => aString
+  #
+  # Converts _positive_ integer +int+ to Roman numerals.
+  def self.to_roman(int, num = '')
+    NUMERAL.each { |key, val|
+      until int < key; int -= key; num << val; end
+    }
+
+    COMPACT.each { |key, val| num.gsub!(key, val) }
+
+    num
+  end
+
+  # call-seq:
+  #   int.to_roman => aString
+  #
+  # Converts _int_ to Roman numerals.
+  def to_roman
+    self == 0 ? 'N' : self < 0 ?
+      RomanMixin.to_roman(-self, '-') : RomanMixin.to_roman(self)
+  end
+
+    end
+  end
+end

data/lib/nuggets/io/interact_mixin.rb

@@ -3,7 +3,7 @@
 #                                                                             #
 # nuggets -- Extending Ruby                                                   #
 #                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
+# Copyright (C) 2007-2014 Jens Wille                                          #
 #                                                                             #
 # Authors:                                                                    #
 #     Jens Wille <jens.wille@gmail.com>                                       #
@@ -75,44 +75,84 @@ module Nuggets
   #       IO.interact({ f => stdin }, { stdout => STDOUT, stderr => STDERR })
   #     }
   #   }
-  def interact(input, output, timeout = nil, maxlen = 2 ** 16)
-    readers, writers = {}, {}
+  def interact(input, output, timeout = nil, maxlen = nil)
+    Interaction.new(input, output, timeout, maxlen).interact
+  end
+
+  class Interaction
+
+    DEFAULT_MAXLEN = 2 ** 16
+
+    def initialize(input, output, timeout = nil, maxlen = nil)
+      @readers, @writers = {}, {}
+
+      output.each { |key, val| @readers[key] =  initialize_reader(val)      }
+      input.each  { |key, val| @writers[val] = [initialize_writer(key), ''] }
+
+      @timeout, @maxlen = timeout, maxlen || DEFAULT_MAXLEN
+    end
+
+    attr_reader :readers, :writers
+
+    attr_accessor :timeout, :maxlen
+
+    def interact
+      until readers.empty? && writers.empty?
+        handles = select(readers.keys, writers.keys, nil, timeout) or return
 
-    output.each { |key, val|
-      if val.is_a?(::Proc) && !val.respond_to?(:<<)
-        class << val; alias_method :<<, :call; end
+        handle_readers(handles[0])
+        handle_writers(handles[1])
       end
 
-      readers[key] = val
-    }
+      []
+    end
+
+    private
+
+    def initialize_reader(reader)
+      if reader.is_a?(::Proc) && !reader.respond_to?(:<<)
+        class << reader; alias_method :<<, :call; end
+      end
+
+      reader
+    end
 
-    input.each { |key, val|
-      if key.is_a?(::String)
+    def initialize_writer(writer)
+      if writer.is_a?(::String)
         require 'stringio'
-        key = ::StringIO.new(key)
+        writer = ::StringIO.new(writer)
       end
 
-      unless key.respond_to?(:read_nonblock)
-        def key.read_nonblock(*args)
+      unless writer.respond_to?(:read_nonblock)
+        def writer.read_nonblock(*args)
           read(*args) or raise ::EOFError, 'end of string reached'
         end
       end
 
-      writers[val] = [key, '']
-    }
+      writer
+    end
 
-    close = lambda { |*args|
-      container, item, read = args
+    def handle_readers(handles)
+      handles.each { |reader| read(reader, readers[reader]) }
+    end
 
-      container.delete(item)
-      read ? item.close_read : item.close_write
-    }
+    def handle_writers(handles)
+      handles.each { |writer|
+        reader, buffer = writers[writer]
+        read(reader, buffer, writer) or next if buffer.empty?
 
-    read = lambda { |*args|
-      reader, buffer, writer = args
+        begin
+          bytes = writer.write_nonblock(buffer)
+        rescue ::Errno::EPIPE
+          close(writers, writer)
+        end
+
+        buffer.force_encoding('BINARY').slice!(0, bytes) if bytes
+      }
+    end
 
+    def read(reader, buffer, writer = nil)
       container = writer ? writers : readers
-      buffer ||= container[reader]
 
       begin
         buffer << reader.read_nonblock(maxlen)
@@ -125,33 +165,15 @@ module Nuggets
           Encoding.default_external
         ) if buffer.respond_to?(:force_encoding)
 
-        close[container, writer || reader, !writer]
+        close(container, writer || reader, !writer)
       end
-    }
-
-    until readers.empty? && writers.empty?
-      fhs = select(readers.keys, writers.keys, nil, timeout) or return
-
-      fhs[0].each { |reader| read[reader] }
-
-      fhs[1].each { |writer|
-        reader, buffer = writers[writer]
-        read[reader, buffer, writer] or next if buffer.empty?
-
-        begin
-          bytes = writer.write_nonblock(buffer)
-        rescue ::Errno::EPIPE
-          close[writers, writer]
-        end
+    end
 
-        if bytes
-          buffer.force_encoding('BINARY') if buffer.respond_to?(:force_encoding)
-          buffer.slice!(0, bytes)
-        end
-      }
+    def close(container, item, reading = nil)
+      container.delete(item)
+      reading ? item.close_read : item.close_write
     end
 
-    []
   end
 
     end

data/lib/nuggets/lazy_attr.rb

@@ -1,44 +1,2 @@
-#--
-###############################################################################
-#                                                                             #
-# 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
-
-  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
+require 'nuggets/object/lazy_attr'
+warn "#{__FILE__}: 'nuggets/lazy_attr' is deprecated, use 'nuggets/object/lazy_attr' instead." unless ENV['NUGGETS_DEPRECATED_LAZY_ATTR']

data/lib/nuggets/module/lazy_attr.rb

@@ -0,0 +1,5 @@
+require 'nuggets/module/lazy_attr_mixin'
+
+class Module
+  include Nuggets::Module::LazyAttrMixin
+end

data/lib/nuggets/module/lazy_attr_mixin.rb

@@ -0,0 +1,55 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 'nuggets/object/lazy_attr'
+
+module Nuggets
+  class Module
+    module LazyAttrMixin
+
+  def lazy_accessor(name, options = {}, &block)
+    attr_accessor(lazy_name(name, options))
+    lazy_reader(name, options, &block)
+  end
+
+  def lazy_reader(name, options = {}, &block)
+    attr = lazy_name(name, options)
+
+    define_method(name) { lazy_attr(attr,
+      options.fetch(:freeze, true), &block) }
+  end
+
+  alias_method :lazy_attr, :lazy_reader
+
+  private
+
+  def lazy_name(name, options)
+    options.fetch(:name) { name.to_s.sub(/\?\z/, '_p') }
+  end
+
+    end
+  end
+end

data/lib/nuggets/module/query_attr.rb

@@ -0,0 +1,5 @@
+require 'nuggets/module/query_attr_mixin'
+
+class Module
+  include Nuggets::Module::QueryAttrMixin
+end

data/lib/nuggets/module/query_attr_mixin.rb

@@ -0,0 +1,49 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class Module
+    module QueryAttrMixin
+
+  def query_accessor(*names)
+    query_reader(*names).each(&method(:attr_writer))
+  end
+
+  def query_reader(*names)
+    names.each { |name|
+      class_eval <<-EOT, __FILE__, __LINE__ + 1
+        def #{name}?
+          !!@#{name} if instance_variable_defined?("@#{name}")
+        end
+      EOT
+    }
+  end
+
+  alias_method :query_attr, :query_reader
+
+    end
+  end
+end

data/lib/nuggets/numeric/signum.rb

@@ -3,7 +3,7 @@
 #                                                                             #
 # nuggets -- Extending Ruby                                                   #
 #                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
+# Copyright (C) 2007-2014 Jens Wille                                          #
 #                                                                             #
 # Authors:                                                                    #
 #     Jens Wille <jens.wille@gmail.com>                                       #
@@ -49,4 +49,11 @@ class Numeric
   alias_method :sign, :signum
   alias_method :sgn,  :signum
 
+  def signum_s(positive = '+', negative = '-', zero = positive)
+    positive? ? positive : negative? ? negative : zero
+  end
+
+  alias_method :sign_s, :signum_s
+  alias_method :sgn_s,  :signum_s
+
 end

data/lib/nuggets/object/lazy_attr.rb

@@ -0,0 +1,5 @@
+require 'nuggets/object/lazy_attr_mixin'
+
+class Object
+  include Nuggets::Object::LazyAttrMixin
+end

data/lib/nuggets/object/lazy_attr_mixin.rb

@@ -0,0 +1,45 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class Object
+    module LazyAttrMixin
+
+  private
+
+  def lazy_attr(name, freeze = true, &block)
+    class << self; self; end.send(:attr_reader, name)
+
+    value = instance_variable_defined?(ivar = "@#{name}") ?
+      instance_variable_get(ivar) :
+      instance_variable_set(ivar, instance_eval(&block))
+
+    freeze ? value.freeze : value
+  end
+
+    end
+  end
+end

data/lib/nuggets/version.rb

@@ -4,7 +4,7 @@ module Nuggets
 
     MAJOR = 1
     MINOR = 0
-    TINY  = 0
+    TINY  = 1
 
     class << self
 

data/spec/nuggets/array/interpolate_spec.rb

@@ -0,0 +1,45 @@
+require 'nuggets/array/interpolate'
+
+describe_extended Array, Nuggets::Array::InterpolateMixin do
+
+  {
+    []                                                       => [],
+    [0]                                                      => [0],
+    [nil]                                                    => [0],
+    [0, nil]                                                 => [0, 0],
+    [1, nil, 3]                                              => [1, 2, 3],
+    [1, nil, 3, nil]                                         => [1, 2, 3, 1.5],
+    [1, nil, nil, 4]                                         => [1, 2, 3, 4],
+    [1, nil, 3, nil, 5]                                      => [1, 2, 3, 4, 5],
+    [1, nil, nil, 4, 5]                                      => [1, 2, 3, 4, 5],
+    [1, nil, nil, nil, nil, nil, nil, nil, nil, nil, 11]     => [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],
+    [1, nil, nil, nil, nil, 11, nil, nil, nil, nil, 11]      => [1, 3, 5, 7, 9, 11, 11, 11, 11, 11, 11],
+    [1, 2, 3, nil, nil, 4, 5, nil, 6, nil, nil, nil, 7, nil] => [1, 2, 3, 3.3333333333333335, 3.6666666666666665, 4, 5, 5.5, 6, 6.25, 6.5, 6.75, 7, 3.5]
+  }.each { |a, b| example { a.interpolate.should == b } }
+
+  {
+    []                                                       => [],
+    [0]                                                      => [0],
+    [nil]                                                    => [nil],
+    [0, nil]                                                 => [0, nil],
+    [1, nil, 3]                                              => [1, 2, 3],
+    [1, nil, 3, nil]                                         => [1, 2, 3, nil],
+    [1, nil, nil, 4]                                         => [1, 2, 3, 4],
+    [1, nil, 3, nil, 5]                                      => [1, 2, 3, 4, 5],
+    [1, nil, nil, 4, 5]                                      => [1, 2, 3, 4, 5],
+    [1, nil, nil, nil, nil, nil, nil, nil, nil, nil, 11]     => [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],
+    [1, nil, nil, nil, nil, 11, nil, nil, nil, nil, 11]      => [1, 3, 5, 7, 9, 11, 11, 11, 11, 11, 11],
+    [1, 2, 3, nil, nil, 4, 5, nil, 6, nil, nil, nil, 7, nil] => [1, 2, 3, 3.3333333333333335, 3.6666666666666665, 4, 5, 5.5, 6, 6.25, 6.5, 6.75, 7, nil]
+  }.each { |a, b| example { a.interpolate(nil).should == b } }
+
+  example { [nil].interpolate(42).should == [42] }
+
+  example { [nil].interpolate(40, 44).should == [42] }
+
+  example { [nil, nil, nil, nil, 5].interpolate.should == [1, 2, 3, 4, 5] }
+
+  example { [nil, nil, nil, nil, 5].interpolate(10).should == [9, 8, 7, 6, 5] }
+
+  example { [nil, nil, nil, nil, 5, nil, nil, nil, nil].interpolate(10, 0).should == [9, 8, 7, 6, 5, 4, 3, 2, 1] }
+
+end

data/spec/nuggets/integer/roman_spec.rb

@@ -0,0 +1,36 @@
+require 'nuggets/integer/roman'
+
+describe_extended Integer, Nuggets::Integer::RomanMixin do
+
+  {
+    1    => 'I',
+    2    => 'II',
+    3    => 'III',
+    4    => 'IV',
+    5    => 'V',
+    6    => 'VI',
+    7    => 'VII',
+    8    => 'VIII',
+    9    => 'IX',
+    10   => 'X',
+    13   => 'XIII',
+    22   => 'XXII',
+    40   => 'XL',
+    90   => 'XC',
+    207  => 'CCVII',
+    1066 => 'MLXVI',
+    1666 => 'MDCLXVI',
+    1903 => 'MCMIII',
+    1910 => 'MCMX',
+    1954 => 'MCMLIV',
+    1990 => 'MCMXC',
+    2014 => 'MMXIV',
+    3999 => 'MMMCMXCIX'
+  }.each { |int, num|
+    example { int.to_roman.should == num }
+    example { (-int).to_roman.should == '-' + num }
+  }
+
+  example { 0.to_roman.should == 'N' }
+
+end

data/spec/nuggets/module/lazy_attr_spec.rb

@@ -0,0 +1,7 @@
+require 'nuggets/module/lazy_attr'
+
+describe_extended Module, Nuggets::Module::LazyAttrMixin do
+
+  # TODO
+
+end

data/spec/nuggets/module/query_attr_spec.rb

@@ -0,0 +1,58 @@
+require 'nuggets/module/query_attr'
+
+describe_extended Module, Nuggets::Module::QueryAttrMixin do
+
+  shared_examples 'common' do
+
+    subject { described_class.new }
+
+    example {
+      expect(subject.foo?).to be_nil
+    }
+
+    example {
+      subject.instance_variable_set(:@foo, 42)
+      expect(subject.foo?).to equal(true)
+    }
+
+    example {
+      expect { subject.foo }.to raise_error(NoMethodError)
+    }
+
+  end
+
+  shared_examples 'reader' do
+
+    it_behaves_like 'common'
+
+    example {
+      expect { subject.foo = 42 }.to raise_error(NoMethodError)
+    }
+
+  end
+
+  describe(Class.new { query_attr :foo }, '#query_attr') do
+    it_behaves_like 'reader'
+  end
+
+  describe(Class.new { query_reader :foo }, '#query_reader') do
+    it_behaves_like 'reader'
+  end
+
+  describe(Class.new { query_accessor :foo }, '#query_accessor') do
+
+    it_behaves_like 'common'
+
+    example {
+      subject.foo = 42
+      expect(subject.foo?).to equal(true)
+    }
+
+    example {
+      subject.foo = nil
+      expect(subject.foo?).to equal(false)
+    }
+
+  end
+
+end

data/spec/nuggets/numeric/signum_spec.rb

@@ -13,4 +13,15 @@ describe Numeric, 'signum' do
     example { n.sign.should == s }
   }
 
+  {
+    123   => '+',
+    -123  => '-',
+    0     => '+',
+    0.001 => '+',
+    1.23  => '+',
+    -12.3 => '-'
+  }.each { |n, s|
+    example { n.sign_s.should == s }
+  }
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nuggets
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Jens Wille
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-20 00:00:00.000000000 Z
+date: 2014-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mime-types
@@ -113,6 +113,8 @@ files:
 - lib/nuggets/array/histogram.rb
 - lib/nuggets/array/histogram_mixin.rb
 - lib/nuggets/array/in_order.rb
+- lib/nuggets/array/interpolate.rb
+- lib/nuggets/array/interpolate_mixin.rb
 - lib/nuggets/array/limit.rb
 - lib/nuggets/array/limit_mixin.rb
 - lib/nuggets/array/mean.rb
@@ -135,6 +137,12 @@ files:
 - lib/nuggets/array/variance.rb
 - lib/nuggets/array/variance_mixin.rb
 - lib/nuggets/content_type.rb
+- lib/nuggets/data/consume.rb
+- lib/nuggets/data/consume_mixin.rb
+- lib/nuggets/data/position.rb
+- lib/nuggets/data/position_mixin.rb
+- lib/nuggets/data/update.rb
+- lib/nuggets/data/update_mixin.rb
 - lib/nuggets/dotted_decimal.rb
 - lib/nuggets/enumerable/agrep.rb
 - lib/nuggets/enumerable/all_any_extended.rb
@@ -177,6 +185,8 @@ files:
 - lib/nuggets/integer/length_mixin.rb
 - lib/nuggets/integer/map.rb
 - lib/nuggets/integer/map_mixin.rb
+- lib/nuggets/integer/roman.rb
+- lib/nuggets/integer/roman_mixin.rb
 - lib/nuggets/integer/to_binary_s.rb
 - lib/nuggets/io/agrep.rb
 - lib/nuggets/io/interact.rb
@@ -190,6 +200,10 @@ files:
 - lib/nuggets/log_parser.rb
 - lib/nuggets/log_parser/apache.rb
 - lib/nuggets/log_parser/rails.rb
+- lib/nuggets/module/lazy_attr.rb
+- lib/nuggets/module/lazy_attr_mixin.rb
+- lib/nuggets/module/query_attr.rb
+- lib/nuggets/module/query_attr_mixin.rb
 - lib/nuggets/net/success.rb
 - lib/nuggets/numeric/between.rb
 - lib/nuggets/numeric/duration.rb
@@ -202,6 +216,8 @@ files:
 - lib/nuggets/object/boolean_mixin.rb
 - lib/nuggets/object/eigenclass.rb
 - lib/nuggets/object/ghost_class.rb
+- lib/nuggets/object/lazy_attr.rb
+- lib/nuggets/object/lazy_attr_mixin.rb
 - lib/nuggets/object/metaclass.rb
 - lib/nuggets/object/msend.rb
 - lib/nuggets/object/msend_mixin.rb
@@ -250,6 +266,7 @@ files:
 - spec/nuggets/array/hashify_spec.rb
 - spec/nuggets/array/histogram_spec.rb
 - spec/nuggets/array/in_order_spec.rb
+- spec/nuggets/array/interpolate_spec.rb
 - spec/nuggets/array/limit_spec.rb
 - spec/nuggets/array/mean_spec.rb
 - spec/nuggets/array/median_spec.rb
@@ -284,7 +301,10 @@ files:
 - spec/nuggets/integer/factorial_spec.rb
 - spec/nuggets/integer/length_spec.rb
 - spec/nuggets/integer/map_spec.rb
+- spec/nuggets/integer/roman_spec.rb
 - spec/nuggets/integer/to_binary_s_spec.rb
+- spec/nuggets/module/lazy_attr_spec.rb
+- spec/nuggets/module/query_attr_spec.rb
 - spec/nuggets/numeric/duration_spec.rb
 - spec/nuggets/numeric/limit_spec.rb
 - spec/nuggets/numeric/signum_spec.rb
@@ -315,13 +335,18 @@ licenses:
 metadata: {}
 post_install_message: |2+
 
-  nuggets-1.0.0 [2014-06-20]:
+  nuggets-1.0.1 [2014-08-27]:
 
-  * First release under new name. Formerly known as ruby-nuggets.
+  * Added DATA.{consume,reposition,update}.
+  * Added Module#query_attr.
+  * Added Module#lazy_attr.
+  * Added Integer#to_roman.
+  * Added Numeric#signum_s.
+  * Added Array#interpolate.
 
 rdoc_options:
 - "--title"
-- nuggets Application documentation (v1.0.0)
+- nuggets Application documentation (v1.0.1)
 - "--charset"
 - UTF-8
 - "--line-numbers"
@@ -342,7 +367,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.3.0
+rubygems_version: 2.4.1
 signing_key: 
 specification_version: 4
 summary: Extending Ruby.