augmented 0.2.0 → 0.2.5

data/lib/augmented/procs.rb

@@ -4,6 +4,6 @@ require 'augmented/procs/rescuable'
 module Augmented
   module Procs
     include Chainable
-    include Recuable
+    include Rescuable
   end
-end
+end

data/lib/augmented/procs/rescuable.rb

@@ -1,9 +1,9 @@
 module Augmented
   module Procs
     module Rescuable
-      refine Proc do
+      NOT_PROVIDED = Object.new
 
-        NOT_PROVIDED = Object.new
+      refine Proc do
 
         def rescues exception_class, return_value = NOT_PROVIDED, &block
           raise ArgumentError, 'must provide a return value or block' if return_value == NOT_PROVIDED && !block_given?
@@ -12,7 +12,7 @@ module Augmented
 
           Proc.new do |*args|
             begin
-              original.call *args
+              original.call(*args)
             rescue exception_class => exception
               block ? block.call(exception) : return_value
             end

data/lib/augmented/strings.rb

@@ -0,0 +1,9 @@
+require 'augmented/strings/blank'
+require 'augmented/strings/truncatable'
+
+module Augmented
+  module Strings
+    include Blank
+    include Truncatable
+  end
+end

data/lib/augmented/strings/blank.rb

@@ -0,0 +1,15 @@
+module Augmented
+  module Strings
+    module Blank
+      REGEXP = /\A[[:space:]]*\z/
+
+      refine String do
+
+        def blank?
+          empty? || REGEXP.match?(self)
+        end
+
+      end
+    end
+  end
+end

data/lib/augmented/strings/truncatable.rb

@@ -0,0 +1,20 @@
+module Augmented
+  module Strings
+    module Truncatable
+      refine String do
+
+        def truncate length
+          raise ArgumentError, 'length must be a non-negative integer' unless length && length.to_int >= 0
+
+          slice(0, length)
+        end
+
+        def truncate! length
+          replace(truncate(length))
+          self
+        end
+
+      end
+    end
+  end
+end

data/lib/augmented/version.rb

@@ -1,3 +1,3 @@
 module Augmented
-  VERSION = "0.2.0"
+  VERSION = "0.2.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: augmented
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.5
 platform: ruby
 authors:
-- bruno
-autorequire: 
+- brunze
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-11-26 00:00:00.000000000 Z
+date: 2021-05-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,37 +16,37 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 13.0.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 13.0.3
 description: Adds a few useful extra methods to some of Ruby's core types, available
   as refinements.
 email:
-- bruno@brunze.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -57,6 +57,10 @@ files:
 - lib/augmented/arrays/tieable.rb
 - lib/augmented/enumerators.rb
 - lib/augmented/enumerators/indexing.rb
+- lib/augmented/exceptions.rb
+- lib/augmented/exceptions/chain.rb
+- lib/augmented/exceptions/detailed.rb
+- lib/augmented/exceptions/serializable.rb
 - lib/augmented/hashes.rb
 - lib/augmented/hashes/mappable.rb
 - lib/augmented/hashes/polymorphable.rb
@@ -72,30 +76,21 @@ files:
 - lib/augmented/procs.rb
 - lib/augmented/procs/chainable.rb
 - lib/augmented/procs/rescuable.rb
+- lib/augmented/strings.rb
+- lib/augmented/strings/blank.rb
+- lib/augmented/strings/truncatable.rb
 - lib/augmented/symbols.rb
 - lib/augmented/symbols/arguable.rb
 - lib/augmented/symbols/comparing.rb
 - lib/augmented/version.rb
-- test/augmented/arrays/tieable_test.rb
-- test/augmented/enumerators/indexing_test.rb
-- test/augmented/hashes/mappable_test.rb
-- test/augmented/hashes/polymorphable_test.rb
-- test/augmented/hashes/transformable_test.rb
-- test/augmented/modules/refined_test.rb
-- test/augmented/objects/iffy_test.rb
-- test/augmented/objects/pickable_test.rb
-- test/augmented/objects/tackable_test.rb
-- test/augmented/objects/tappable_test.rb
-- test/augmented/objects/thru_test.rb
-- test/augmented/procs/chainable_test.rb
-- test/augmented/procs/rescuable_test.rb
-- test/augmented/symbols/arguable_test.rb
-- test/augmented/symbols/comparing_test.rb
 homepage: https://github.com/brunze/augmented
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  homepage_uri: https://github.com/brunze/augmented
+  source_code_uri: https://github.com/brunze/augmented
+  changelog_uri: https://github.com/brunze/augmented/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -110,24 +105,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
-signing_key: 
+rubygems_version: 3.2.18
+signing_key:
 specification_version: 4
 summary: Useful extra methods for some Ruby core types.
-test_files:
-- test/augmented/arrays/tieable_test.rb
-- test/augmented/enumerators/indexing_test.rb
-- test/augmented/hashes/mappable_test.rb
-- test/augmented/hashes/polymorphable_test.rb
-- test/augmented/hashes/transformable_test.rb
-- test/augmented/modules/refined_test.rb
-- test/augmented/objects/iffy_test.rb
-- test/augmented/objects/pickable_test.rb
-- test/augmented/objects/tackable_test.rb
-- test/augmented/objects/tappable_test.rb
-- test/augmented/objects/thru_test.rb
-- test/augmented/procs/chainable_test.rb
-- test/augmented/procs/rescuable_test.rb
-- test/augmented/symbols/arguable_test.rb
-- test/augmented/symbols/comparing_test.rb
+test_files: []

data/test/augmented/arrays/tieable_test.rb

@@ -1,66 +0,0 @@
-require 'minitest/autorun'
-require 'augmented/arrays/tieable'
-
-describe Augmented::Arrays::Tieable do
-  using Augmented::Arrays::Tieable
-
-  describe '#tie' do
-
-    describe 'when supplied with an object' do
-
-      it 'returns an array interweaved with the specified object' do
-        object = Object.new
-        weaved = %w(a b c).tie object
-
-        weaved.must_equal ['a', object, 'b', object, 'c']
-      end
-
-      it 'returns an empty array if the original array is empty' do
-        [].tie(1).must_equal []
-      end
-
-      it 'returns the original array if it has only one element' do
-        [42].tie(1).must_equal [42]
-      end
-
-    end
-
-    describe 'when supplied with a block' do
-
-      it 'returns an array interweaved with the result of invoking the block' do
-        values = [10 ,20].each
-        weaved = %w(a b c).tie{ values.next }
-
-        weaved.must_equal ['a', 10, 'b', 20, 'c']
-      end
-
-      it 'passes both neighbour values as arguments to the supplied block' do
-        weaved = [1, 5, 12].tie{ |a, b| a + b }
-
-        weaved.must_equal [1, 6, 5, 17, 12]
-      end
-
-      it 'will weave nils if the block does not return anything else' do
-        weaved = [1, 2, 3].tie{}
-
-        weaved.must_equal [1, nil, 2, nil, 3]
-      end
-
-      it 'returns an empty array if the original arrays is empty' do
-        [].tie{ 1 }.must_equal []
-      end
-
-      it 'returns the original array if it has only one element' do
-        [42].tie{ 1 }.must_equal [42]
-      end
-
-    end
-
-    it 'raises an ArgumentError if not passed a non-nil object or block' do
-      proc{ [].tie }.must_raise ArgumentError
-      proc{ [].tie nil }.must_raise ArgumentError
-    end
-
-  end
-
-end

data/test/augmented/enumerators/indexing_test.rb

@@ -1,15 +0,0 @@
-require 'minitest/autorun'
-require 'augmented/enumerators/indexing'
-
-describe Augmented::Enumerators::Indexing do
-  using Augmented::Enumerators::Indexing
-
-  describe '#index_by' do
-
-    it 'returns a hash keyed by the results of invoking the criterion on every collection element and the values are the last element matching the criterion' do
-      ['a', 'bbb', 'c', 'dd'].to_enum.index_by(&:length).must_equal({ 1 => 'c', 2 => 'dd', 3 => 'bbb' })
-    end
-
-  end
-
-end

data/test/augmented/hashes/mappable_test.rb

@@ -1,37 +0,0 @@
-require 'minitest/autorun'
-require 'augmented/hashes/mappable'
-
-describe Augmented::Hashes::Mappable do
-  using Augmented::Hashes::Mappable
-
-  describe '#map_values' do
-
-    it 'returns a new hash with the same keys but transformed values' do
-      { aa: 11, bb: 22 }.map_values{ |i| i * 3 }.must_equal({ aa: 33, bb: 66 })
-    end
-
-    it 'also provides the key and hash to the tranformer function as additional arguments' do
-      hash = { aa: 11, bb: 22 }
-      result = hash.map_values{ |i, key, h| [key, h.object_id] }
-
-      result.values.must_equal [[:aa, hash.object_id], [:bb, hash.object_id]]
-    end
-
-  end
-
-  describe '#map_keys' do
-
-    it 'returns a new hash with the same values but transformed keys' do
-      { aa: 11, bb: 22 }.map_keys{ |k| k.to_s[0] }.must_equal({ 'a' => 11, 'b' => 22 })
-    end
-
-    it 'also provides the value and hash to the tranformer function as additional arguments' do
-      hash = { aa: 11, bb: 22 }
-      result = hash.map_keys{ |k, value, h| [value, h.object_id] }
-
-      result.keys.must_equal [[11, hash.object_id], [22, hash.object_id]]
-    end
-
-  end
-
-end

data/test/augmented/hashes/polymorphable_test.rb

@@ -1,45 +0,0 @@
-require 'minitest/autorun'
-require 'augmented/hashes/polymorphable'
-require 'ostruct'
-
-describe Augmented::Hashes::Polymorphable do
-  using Augmented::Hashes::Polymorphable
-
-  describe '#polymorph' do
-
-    it 'returns an object of the class specified by the `:type` attribute, initialized with the hash itself' do
-      object = { type: 'OpenStruct', speak: 'meeehh' }.polymorph
-
-      object.must_be_instance_of OpenStruct
-      object.speak.must_equal 'meeehh'
-    end
-
-    describe 'type attribute' do
-
-      it 'can also be a string key in the hash' do
-        { 'type' => 'OpenStruct' }.polymorph.must_be_instance_of OpenStruct
-      end
-
-      it 'can be an arbitrary attribute in the hash' do
-        { lorem_ipsum: 'OpenStruct' }.polymorph(:lorem_ipsum).must_be_instance_of OpenStruct
-        { 'lorem_ipsum' => 'OpenStruct' }.polymorph(:lorem_ipsum).must_be_instance_of OpenStruct
-      end
-
-      it 'can be a class' do
-        { type: OpenStruct }.polymorph().must_be_instance_of OpenStruct
-      end
-
-      it 'can be a class passed directly to the method, ignoring the type attribute in the hash' do
-        { type: 'TotallyIgnoredClass' }.polymorph(OpenStruct).must_be_instance_of OpenStruct
-      end
-
-    end
-
-    it 'raises an error if it cannot find a type class' do
-      proc{ {}.polymorph }.must_raise ArgumentError
-      proc{ { type: nil }.polymorph }.must_raise ArgumentError
-    end
-
-  end
-
-end

data/test/augmented/hashes/transformable_test.rb

@@ -1,87 +0,0 @@
-require 'minitest/autorun'
-require 'augmented/hashes/transformable'
-require 'ostruct'
-
-describe Augmented::Hashes::Transformable do
-  using Augmented::Hashes::Transformable
-
-  describe '#transform(!)' do
-
-    it 'mutates the values of the given keys by applying their respective procables' do
-      hash = { thing1: 100, thing2: OpenStruct.new(random_method_name: 900) }.freeze
-
-      new_hash = hash.transform thing1: -> i { i * 3 }, thing2: :random_method_name
-
-      new_hash[:thing1].must_equal 300
-      new_hash[:thing2].must_equal 900
-
-
-      # mutable version test:
-      hash = { thing1: 100, thing2: OpenStruct.new(random_method_name: 900) }
-
-      hash.transform! thing1: -> i { i * 3 }, thing2: :random_method_name
-
-      hash[:thing1].must_equal 300
-      hash[:thing2].must_equal 900
-    end
-
-    it 'applies procables recursively when given a hash' do
-      hash = { a: { b: { c: 100 } } }.freeze
-
-      new_hash = hash.transform({ a: { b: { c: -> i { i * 3 } } } })
-
-      new_hash[:a][:b][:c].must_equal 300
-
-
-      # mutable version test:
-      hash = { a: { b: { c: 100 } } }
-
-      hash.transform!({ a: { b: { c: -> i { i * 3 } } } })
-
-      hash[:a][:b][:c].must_equal 300
-    end
-
-    it 'applies procables to all elements of a collection if a value is iterable (iterable MUST be a collection of hashes)' do
-      hash = { a: [ { my_value: 10 }, { my_value: 20 } ] }.freeze
-
-      new_hash = hash.transform(a: { my_value: -> i { i * 3 } })
-
-      new_hash[:a].must_equal [ { my_value: 30 }, { my_value: 60 } ]
-
-
-      # mutable version test:
-      hash = { a: [ { my_value: 10 }, { my_value: 20 } ] }
-
-      hash.transform!(a: { my_value: -> i { i * 3 } })
-
-      hash[:a].must_equal [ { my_value: 30 }, { my_value: 60 } ]
-    end
-
-    it 'can apply several procables to a value, supplied in an array, executed from left to right' do
-      add_ten = -> i { i + 10 }
-      double = -> i { i * 2 }
-
-      hash = { a: 2.5 }.freeze
-
-      new_hash = hash.transform a: [ :to_i, add_ten, double ]
-
-      new_hash[:a].must_equal 24
-
-
-      # mutable version test:
-      hash = { a: 2.5 }
-
-      hash.transform! a: [ :to_i, add_ten, double ]
-
-      hash[:a].must_equal 24
-    end
-
-    it 'returns itself (mutable version only)' do
-      hash = {}
-      same_hash = hash.transform! Hash.new
-
-      same_hash.object_id.must_equal hash.object_id
-    end
-
-  end
-end