more_core_extensions 3.1.0 → 3.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: de0bf2437f3829de0a5f82ebd288a6cac59f0a71
-  data.tar.gz: 386ac9e9871d381269e507143b72df08619bfd75
+  metadata.gz: 813c1118ca8bd1502d467502dbc10c1965cfccb8
+  data.tar.gz: 44f901136763832691e94be69e73cc90e82d3a16
 SHA512:
-  metadata.gz: a132740693a2bd42601ef83c2cedb3680a742e7ad87a44c0643953d1f0f10a77c51118609532c184e21e5766404acdc90fcb0222e7b2a123d846c5d69dbec777
-  data.tar.gz: e7c599a6db36661dc88a85666aaac6ac6355441c059e9a54e04b6834f68359a4a970a104e9ba7321b037084527c49fa440db207096caccd303199aecdcd49c1f
+  metadata.gz: 82cbb225f4ba697fc29cc1b6b6ef0d1e00561de1fb6071d8078cae1981aa0209f983b843e787841706b4f584121b1a0c9d29078942ea1f606b682c58f79a4e65
+  data.tar.gz: 94645bbb55387932f89711371041e09bc4c00a7d7c43fe6224d52acf2d9ce00bb7f416ff2eb308ef3a3a8d8f26789657c178e8e095fa58e4d4294769708347e9

data/README.md

@@ -12,57 +12,88 @@ MoreCoreExtensions are a set of core extensions beyond those provided by ActiveS
 
 ## Extensions Provided
 
-* Array
-  * delete_nils
-  * delete_blanks
-  * delete_blank_paths
-  * delete_path
-  * deviation
-  * duplicates
-  * include_any?
-  * include_none?
-  * include_all?
-  * fetch_path
-  * find_path
-  * has_key_path?
-    * include_path?
-    * key_path?
-    * member_path?
-  * mean
-  * random_index
-  * random_element
-  * squares
-  * store_path
-  * stretch
-  * stretch!
-  * zip_stretched
-  * tableize
-  * variance
-* Hash
-  * delete_nils
-  * delete_blanks
-  * delete_blank_paths
-  * delete_path
-  * fetch_path
-  * find_path
-  * has_key_path?
-    * include_path?
-    * key_path?
-    * member_path?
-  * store_path
-* Numeric
-  * square
-  * round_down
-  * round_up
-* String
-  * email?
-  * domain_name?
-  * ipv4?
-  * ipv6?
-  * ipaddress?
-  * integer?
-  * guid?
-  * hex_dump
+#### Array
+
+* core_ext/array/deletes.rb
+  * `#delete_blanks` - Deletes all items where the value is blank
+  * `#delete_nils` - Deletes all items where the value is nil
+* core_ext/array/duplicates.rb
+  * `#duplicates` - Returns an Array of the duplicates found
+* core_ext/array/element_counts.rb
+  * `#element_counts` - Returns a Hash of each element to the count of those elements
+* core_ext/array/inclusions.rb
+  * `#include_all?` - Returns whether the Array contains all of the items
+  * `#include_any?` - Returns whether the Array contains any of the items
+  * `#include_none?` - Returns whether the Array contains none of the items
+  * `#includes_index?` - Returns whether the Array has a value at the index
+* core_ext/array/math.rb
+  * `#mean` -  Returns the mean of an Array of Numerics
+  * `#stddev` - Returns the standard deviation of an Array of Numerics
+  * `#variance` - Returns the variance of an Array of Numerics
+* core_ext/array/nested.rb (see [Shared](#shared))
+  * `#delete_blank_paths` - Deletes all paths where the value is blank
+* core_ext/array/random.rb
+  * `#random_index` - Picks a valid index randomly
+  * `#random_element` - Picks an element randomly
+* core_ext/array/stretch.rb
+  * `.stretch` - Stretch all argument Arrays to make them the same size
+  * `.stretch!` - Stretch all argument Arrays to make them the same size. Modifies the arguments in place.
+  * `#stretch` - Stretch receiver to be the same size as the longest argument Array.
+  * `#stretch`! - Stretch receiver to be the same size as the longest argument Array.  Modifies the receiver in place.
+  * `#zip_stretched` - Zip arguments stretching the receiver if necessary
+* core_ext/array/tableize.rb
+  * `#tableize` - Create a string representation of receiver in a tabular format if receiver is an Array of Arrays or an Array of Hashes
+
+#### Hash
+
+* core_ext/hash/deletes.rb
+  * `#delete_blanks` - Deletes all keys where the value is blank
+  * `#delete_nils` - Deletes all keys where the value is nil
+* core_ext/hash/nested.rb (see [Shared](#shared))
+  * `#delete_blank_paths` - Deletes all paths where the value is blank
+
+#### Module
+
+* core_ext/module/namespace.rb
+  * `#namespace` - Returns an Array with the namespace to the current Module
+
+#### Numeric
+
+* core_ext/numeric/math.rb
+  * `#square` - Returns the square of a Numeric
+* core_ext/numeric/rounding.rb
+  * `#round_down` - Round down to the specified precision
+  * `#round_up` - Round up to the specified precision
+
+#### Object
+
+* core_ext/module/namespace.rb
+  * `#in_namespace?` - Returns whether or not the object is in the given namespace
+
+#### String
+
+* core_ext/string/formats.rb
+  * `#email?` - Returns whether or not the String is an= valid email
+  * `#domain_name?` - Returns whether or not the String is a valid domain name
+  * `#ipv4?` - Returns whether or not the String is an IPv4 address
+  * `#ipv6?` - Returns whether or not the String is an IPv6 address
+  * `#ipaddress?` - Returns whether or not the String is an IPv4 or IPv6 address
+  * `#integer?` - Returns whether or not the String is an integer
+  * `#guid?` - Returns whether or not the String is a valid GUID
+* core_ext/string/hex_dump.rb
+  * `#hex_dump` - Dumps the string in a hex editor style format
+
+#### Shared
+
+* core_ext/shared/nested.rb
+  * `#delete_path` - Delete the value at the specified nesting
+  * `#fetch_path` - Fetch the value at the specified nesting
+  * `#find_path` - Detect which nesting holds the specified value
+  * `#has_key_path?` - Check if a key exists at the specified nesting
+  * `#include_path?` - alias of `#has_key_path?`
+  * `#key_path?` - alias of `#has_key_path?`
+  * `#member_path?` - alias of `#has_key_path?`
+  * `#store_path` - Store a value at the specified nesting
 
 ## Installation
 

data/lib/more_core_extensions/core_ext/array/nested.rb

@@ -5,6 +5,9 @@ module MoreCoreExtensions
     include MoreCoreExtensions::Shared::Nested
     extend  MoreCoreExtensions::Shared::Nested
 
+    #
+    # Deletes all paths where the value is blank
+    #
     def delete_blank_paths
       self.each { |v| v.delete_blank_paths if v.respond_to?(:delete_blank_paths) }
       self.delete_blanks
@@ -12,4 +15,4 @@ module MoreCoreExtensions
   end
 end
 
-Array.send(:include, MoreCoreExtensions::ArrayNested)
+Array.send(:include, MoreCoreExtensions::ArrayNested)

data/lib/more_core_extensions/core_ext/hash/nested.rb

@@ -5,6 +5,9 @@ module MoreCoreExtensions
     include MoreCoreExtensions::Shared::Nested
     extend  MoreCoreExtensions::Shared::Nested
 
+    #
+    # Deletes all paths where the value is blank
+    #
     def delete_blank_paths
       self.each_value { |v| v.delete_blank_paths if v.respond_to?(:delete_blank_paths) }
       self.delete_blanks

data/lib/more_core_extensions/core_ext/shared/nested.rb

@@ -1,7 +1,9 @@
 module MoreCoreExtensions
   module Shared
     module Nested
-
+      #
+      # Delete the value at the specified nesting
+      #
       def delete_path(*args)
         args = args.first if args.length == 1 && args.first.kind_of?(Array)
         raise ArgumentError, "must pass at least one key" if args.empty?
@@ -17,6 +19,9 @@ module MoreCoreExtensions
         end
       end
 
+      #
+      # Fetch the value at the specific nesting
+      #
       def fetch_path(*args)
         args = args.first if args.length == 1 && args.first.kind_of?(Array)
         raise ArgumentError, "must pass at least one key" if args.empty?
@@ -30,6 +35,9 @@ module MoreCoreExtensions
         return child.fetch_path(args[1..-1])
       end
 
+      #
+      # Check if a key exists at the specified nesting
+      #
       def has_key_path?(*args)
         args = args.first if args.length == 1 && args.first.kind_of?(Array)
         raise ArgumentError, "must pass at least one key" if args.empty?
@@ -48,6 +56,9 @@ module MoreCoreExtensions
       alias key_path?     has_key_path?
       alias member_path?  has_key_path?
 
+      #
+      # Store a value at the specified nesting
+      #
       def store_path(*args)
         raise ArgumentError, "must pass at least one key, and a value" if args.length < 2
         value = args.pop
@@ -68,6 +79,9 @@ module MoreCoreExtensions
         end
       end
 
+      #
+      # Detect which nesting holds the specified value
+      #
       def find_path(val)
         self.each_with_index do |v, k|
           k, v = v if self.kind_of?(Hash)

data/lib/more_core_extensions/core_ext/string/formats.rb

@@ -1,7 +1,8 @@
 module MoreCoreExtensions
   module StringFormats
-    # From: Regular Expression Cookbook: 4.1 Validate Email Addresses
-    RE_EMAIL = %r{\A[\w!#$\%&'*+/=?`\{|\}~^-]+(?:\.[\w!#$\%&'*+/=?`\{|\}~^-]+)*@(?:[A-Z0-9-]+\.)+[A-Z]{2,6}\Z}i
+    # From: http://www.regular-expressions.info/email.html
+    RE_EMAIL =  %r{\A[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\z}
+
     def email?
       !!(self =~ RE_EMAIL)
     end

data/lib/more_core_extensions/version.rb

@@ -1,3 +1,3 @@
 module MoreCoreExtensions
-  VERSION = "3.1.0"
+  VERSION = "3.1.1".freeze
 end

data/spec/core_ext/string/formats_spec.rb

@@ -2,9 +2,10 @@ describe String do
   it '#email?' do
     expect("john@example.com").to be_email
     expect("john.doe@example.com").to be_email
+    expect("john.doe@my-company.prestidigitation").to be_email
+    expect("john.o'doe@example.com").to be_email
 
-    expect("john.doe@examplecom").not_to be_email
-    expect("john.doe@example-com").not_to be_email
+    expect("john\ndoe@example.com").not_to be_email
     expect("").not_to be_email
     expect("foo").not_to be_email
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: more_core_extensions
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.1.1
 platform: ruby
 authors:
 - Jason Frey
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-11 00:00:00.000000000 Z
+date: 2016-12-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -157,7 +157,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
 summary: MoreCoreExtensions are a set of core extensions beyond those provided by