nuggets 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 89f2d47d5e501cd0800f31bd572cdd1c20c6e98c
-  data.tar.gz: c69f1ac6fc489329f61e96fb419c63f5180bf5c4
+  metadata.gz: b8bc4223cf7e497022aa29613c8fddce9a757b69
+  data.tar.gz: 3f1f0159203157d4fbcded7cf3dc5aeb25972df2
 SHA512:
-  metadata.gz: 24d1c8c645c8d9ef912e30a82dea599744d986ea5254947cfea0598457f9943328f239cb59264fb43dfab9148f2627a40ca7648cdd9b7a756c1aa66acac32233
-  data.tar.gz: c503ac3652caedcf02c85353a4098ddfaa26a933af2fd5ac73ac3e53be5c71022cbf2498bd48b3654247db36c05b710b5dfae762343347dffbfc6248fd5be9be
+  metadata.gz: aedaaac17d00e186d8219ba67495fc1b5f73033251cff451b8f38e5e454cee49a4eac56922c2ae2b34c2ff3d87ba1bf922285a512f879e197552ea7219084733
+  data.tar.gz: 99ed4373f5c96cd6a0f42a0ee55e4ee5a8d99f166245fb2ff6f54330dfbeac503f021868bda9569bf8149b05aea31cb3ec7c6855c30a5509fbbabeff9a03678d

data/ChangeLog

@@ -2,6 +2,11 @@
 
 = Revision history for nuggets
 
+== 1.4.0 [2015-10-02]
+
+* Added File.open_file.
+* Added Array#extract_options.
+
 == 1.3.0 [2015-07-07]
 
 * Added <tt>Hash.{identity,array}</tt>.

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to nuggets version 1.3.0.
+This documentation refers to nuggets version 1.4.0.
 
 
 == DESCRIPTION

data/lib/nuggets/array/extract_options.rb

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

data/lib/nuggets/array/extract_options_mixin.rb

@@ -0,0 +1,49 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2015 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 ExtractOptionsMixin
+
+  # call-seq:
+  #   array.extract_options([default]) -> aHash or +default+
+  #
+  # Returns options hash from _array_ or +default+.
+  def extract_options(default = {})
+    last.is_a?(::Hash) ? last : default
+  end
+
+  # call-seq:
+  #   array.extract_options!([default]) -> aHash or +default+
+  #
+  # Extracts options hash from _array_ or returns +default+.
+  def extract_options!(default = {})
+    last.is_a?(::Hash) ? pop : default
+  end
+
+    end
+  end
+end

data/lib/nuggets/file/open_file.rb

@@ -0,0 +1,5 @@
+require 'nuggets/file/open_file_mixin'
+
+class File
+  extend Nuggets::File::OpenFileMixin
+end

data/lib/nuggets/file/open_file_mixin.rb

@@ -0,0 +1,71 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2015 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 File
+    module OpenFileMixin
+
+  # call-seq:
+  #   File.open_file(filename[, options[, mode]]) -> anIO
+  #   File.open_file(filename[, options[, mode]]) { |io| ... } => anObject
+  #
+  # Supported options are +mode+ (defaults to +r+) and +encoding+ (defaults
+  # to the default external encoding).
+  #
+  # If +filename+ is +-+, sets +io+ to +STDOUT+ when in write mode or +STDIN+
+  # otherwise. Puts +io+ into binary mode if requested. Sets +io+'s encoding.
+  #
+  # If +filename+ ends with +.gz+ or +.gzip+, uses Zlib for reading or writing
+  # the file.
+  #
+  # Otherwise defers to ::open.
+  #
+  # Yields +io+ to the given block or returns it when no block given.
+  def open_file(filename, options = {}, mode = 'r', &block)
+    mode = options.fetch(:mode, mode); writing = mode =~ /w/
+
+    encoding = options.fetch(:encoding, ::Encoding.default_external)
+
+    case filename
+      when '-'
+        io = writing ? $stdout : $stdin
+        io.binmode if mode =~ /b/
+        io.set_encoding(encoding)
+
+        block ? block[io] : io
+      when /\.gz(?:ip)?\z/i
+        require 'zlib'
+
+        klass = writing ? ::Zlib::GzipWriter : ::Zlib::GzipReader
+        klass.open(filename, encoding: encoding, &block)
+      else
+        open(filename, mode, encoding: encoding, &block)
+    end
+  end
+
+    end
+  end
+end

data/lib/nuggets/numeric/signum.rb

@@ -43,14 +43,15 @@ class Numeric
   #
   # Returns the sign of _num_.
   def signum
-    positive? ? 1 : negative? ? -1 : 0
+    # http://weblog.jamisbuck.org/2015/8/5/reducing-a-number-to-its-sign.html
+    self <=> 0
   end
 
   alias_method :sign, :signum
   alias_method :sgn,  :signum
 
   def signum_s(positive = '+', negative = '-', zero = positive)
-    positive? ? positive : negative? ? negative : zero
+    [zero, positive, negative][signum]
   end
 
   alias_method :sign_s, :signum_s

data/lib/nuggets/version.rb

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

data/spec/nuggets/array/extract_options_spec.rb

@@ -0,0 +1,47 @@
+require 'nuggets/array/extract_options'
+
+describe_extended Array, Nuggets::Array::ExtractOptionsMixin do
+
+  example { expect([].extract_options).to eq({}) }
+
+  example { expect([].extract_options(42)).to eq(42) }
+
+  example { expect([].extract_options(nil)).to eq(nil) }
+
+  example { expect([42].extract_options).to eq({}) }
+
+  example { expect([foo: 42].extract_options).to eq(foo: 42) }
+
+  example { expect([23, foo: 42].extract_options).to eq(foo: 42) }
+
+  example { expect([{ foo: 42 }, 23].extract_options).to eq({}) }
+
+  example { expect([23, 42, {}].extract_options).to eq({}) }
+
+  example { expect([23, 42, {}].extract_options(nil)).to eq({}) }
+
+  example { expect([23, 42].extract_options).to eq({}) }
+
+  example { expect([23, 42].extract_options(nil)).to eq(nil) }
+
+  example {
+    a = [23, foo: 42]
+
+    expect(a.extract_options).to eq(foo: 42)
+    expect(a).to eq([23, foo: 42])
+
+    expect(a.extract_options!).to eq(foo: 42)
+    expect(a).to eq([23])
+  }
+
+  example {
+    a = [{ foo: 42 }, 23]
+
+    expect(a.extract_options).to eq({})
+    expect(a).to eq([{ foo: 42 }, 23])
+
+    expect(a.extract_options!).to eq({})
+    expect(a).to eq([{ foo: 42 }, 23])
+  }
+
+end

data/spec/nuggets/numeric/signum_spec.rb

@@ -6,22 +6,22 @@ describe Numeric, 'signum' do
     123   =>  1,
     -123  => -1,
     0     =>  0,
+    1     =>  1,
+    -1    => -1,
     0.001 =>  1,
     1.23  =>  1,
     -12.3 => -1
-  }.each { |n, s|
-    example { n.sign.should == s }
-  }
+  }.each { |n, s| example { n.sign.should == s } }
 
   {
     123   => '+',
     -123  => '-',
     0     => '+',
+    1     => '+',
+    -1    => '-',
     0.001 => '+',
     1.23  => '+',
     -12.3 => '-'
-  }.each { |n, s|
-    example { n.sign_s.should == s }
-  }
+  }.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.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Jens Wille
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-07 00:00:00.000000000 Z
+date: 2015-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mime-types
@@ -47,7 +47,7 @@ dependencies:
         version: '0.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: 0.8.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -57,7 +57,7 @@ dependencies:
         version: '0.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: 0.8.3
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -110,6 +110,8 @@ files:
 - lib/nuggets/array/combination.rb
 - lib/nuggets/array/correlation.rb
 - lib/nuggets/array/correlation_mixin.rb
+- lib/nuggets/array/extract_options.rb
+- lib/nuggets/array/extract_options_mixin.rb
 - lib/nuggets/array/flatten_once.rb
 - lib/nuggets/array/flush.rb
 - lib/nuggets/array/flush_mixin.rb
@@ -162,6 +164,8 @@ files:
 - lib/nuggets/env/user_home_mixin.rb
 - lib/nuggets/file/ext.rb
 - lib/nuggets/file/ext_mixin.rb
+- lib/nuggets/file/open_file.rb
+- lib/nuggets/file/open_file_mixin.rb
 - lib/nuggets/file/replace.rb
 - lib/nuggets/file/replace_mixin.rb
 - lib/nuggets/file/sub.rb
@@ -273,6 +277,7 @@ files:
 - spec/nuggets/array/boost_spec.rb
 - spec/nuggets/array/combination_spec.rb
 - spec/nuggets/array/correlation_spec.rb
+- spec/nuggets/array/extract_options_spec.rb
 - spec/nuggets/array/flatten_once_spec.rb
 - spec/nuggets/array/flush_spec.rb
 - spec/nuggets/array/format_spec.rb
@@ -349,13 +354,14 @@ licenses:
 metadata: {}
 post_install_message: |2+
 
-  nuggets-1.3.0 [2015-07-07]:
+  nuggets-1.4.0 [2015-10-02]:
 
-  * Added <tt>Hash.{identity,array}</tt>.
+  * Added File.open_file.
+  * Added Array#extract_options.
 
 rdoc_options:
 - "--title"
-- nuggets Application documentation (v1.3.0)
+- nuggets Application documentation (v1.4.0)
 - "--charset"
 - UTF-8
 - "--line-numbers"