array_include_methods 1.5.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37098f6edb2efccc49b1957ed3a1fab4ba24de1513c418d6b354c55639f7c21e
-  data.tar.gz: 43017be01759fa4ad755f7c6eb137dc112579746c04925e7a2d27eacc068bc78
+  metadata.gz: cdce8ec8eb451f28c665c7dd6833190699abc55358dd2f488cfe594565ea2d54
+  data.tar.gz: bdd5b90776e4a606a161ec8b62fc5e9f1b6d7c3f03c12e77b8e7235907a5a7fb
 SHA512:
-  metadata.gz: 443405d84171e9e1bbbb50542d62f7648c4291adc2b35a698b48cc7a9f821e182af43fd43e2a858c42bef31c6e805e4f6d47dfa2b06b20c81b2c480e95ed3eee
-  data.tar.gz: 751bed4920602a17ac928f24d1d0f9b3ccc0f1f8c5c0d75dc29df580618198cb9b8985059a76d451effbfd1d62366d2e35f839f25e25908c5590fa6b93de505f
+  metadata.gz: 96e1cd8df937ded36f613d0fb97d1b1afc98ce44cc13900dfa7599ba0e6289b2119d4df51143145e6d177178fe40e4e72daa0395fad7dfa93e101518fb6740d6
+  data.tar.gz: 6d5b550e3acc6c8f2bea70553960a5e1bdf720d87b1603ad58c70bf8d5da53f383b07d10bdc68fd80d51fcdfbf2ae652426b1b3454b0101540c1499309e88e50

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Change Log
 
+## 1.5.1
+
+- `counts` returns a hash of counts of every element in the array, performed in linear time (running time of O(n)).
+- `duplicates` returns a single occurrence of all elements that repeated in an array
+- `array_difference_indices`/`array_difference_indexes` aliases for `array_diff_indices`/`array_diff_indexes`
+- `array_diff`/`array_difference` (return elements of `array_diff_indexes`)
+- `array_intersection` (returns elements of `array_intersection_indexes`)
+
 ## 1.5.0
 
 - Add RubyMotion compatibility

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2020 Andy Maleh
+Copyright (c) 2020-2022 Andy Maleh
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,9 +1,9 @@
-# ArrayIncludeMethods 1.5.0 - Ruby Refinement
+# ArrayIncludeMethods 1.5.1 - [Ruby Refinement](https://docs.ruby-lang.org/en/master/syntax/refinements_rdoc.html)
 [![Gem Version](https://badge.fury.io/rb/array_include_methods.svg)](http://badge.fury.io/rb/array_include_methods)
 [![Build Status](https://travis-ci.com/AndyObtiva/array_include_methods.svg?branch=master)](https://travis-ci.com/AndyObtiva/array_include_methods)
 [![Coverage Status](https://coveralls.io/repos/github/AndyObtiva/array_include_methods/badge.svg?branch=master)](https://coveralls.io/github/AndyObtiva/array_include_methods?branch=master)
 
-`Array#include_all?`, `Array#include_any?`, `Array#include_array?`, `Array#array_index`, `Array#array_diff_indices`, and `Array#array_intersection_indices` methods missing from basic Ruby `Array` API.
+`Array#include_all?`, `Array#include_any?`, `Array#include_array?`, `Array#array_index`, `Array#counts`, and `Array#duplicates` methods missing from basic Ruby `Array` API.
 
 ## Setup
 
@@ -12,7 +12,7 @@
 Include the following in Gemfile:
 
 ```ruby
-gem 'array_include_methods', '~> 1.5.0'
+gem 'array_include_methods', '~> 1.5.1'
 ```
 
 Run:
@@ -26,7 +26,7 @@ bundle
 Run:
 
 ```
-gem install array_include_methods -v1.5.0
+gem install array_include_methods -v1.5.1
 ```
 
 ## Usage
@@ -37,13 +37,13 @@ Add the following line to your application if you are not requiring all gems via
 require 'array_include_methods'
 ```
 
-To activate the `ArrayIncludeMethods` Ruby Refinement for the `Array` class, add the following line to every Ruby file that needs it:
+To activate the `ArrayIncludeMethods` [Ruby Refinement](https://docs.ruby-lang.org/en/master/syntax/refinements_rdoc.html) for the `Array` class, add the following line to every Ruby file that needs it:
 
 ```ruby
 using ArrayIncludeMethods
 ```
 
-Now, you have `#include_all?` and `#include_any?` methods on `Array` objects.
+Now, you have `#include_all?`, `#include_any?`, `#include_array?`, `#array_index`, `#array_diff_indices`, and `#array_intersection_indices` methods on `Array` objects.
 
 ## Examples
 
@@ -128,17 +128,43 @@ Returns indexes from `self` array for which elements do not match elements in `o
 [1, 2, 3, 4].array_diff_indexes(nil) # returns [0, 1, 2, 3]
 ```
 
+### `Array#counts`
+
+Returns a hash of counts of every element in the array,
+performed in linear time (running time of O(n)).
+
+```ruby
+[1, 2, 3, 4].counts # returns {1=>1, 2=>1, 3=>1, 4=>1}
+[1, :a, :a, :b, 'bee', 'see', true, true, nil, nil].counts # returns {1=>1, :a=>2, :b=>1, "bee"=>1, "see"=>1, true=>2, nil=>2}
+[1, :a, :a, :b, 'bee', 'see', true, true, nil].counts # {1=>1, :a=>2, :b=>1, "bee"=>1, "see"=>1, true=>2, nil=>1}
+[1, {a: 1}, :a, :a, :b, 'bee', 'see', true, true, {a: 1}, {a: 1}].counts # {1=>1, {:a=>1}=>3, :a=>2, :b=>1, "bee"=>1, "see"=>1, true=>2}
+[].counts # returns {}
+```
+
+### `Array#duplicates`
+
+Returns a single occurrence of all elements that repeated in an array,
+performed in linear time (running time of O(n)).
+
+```ruby
+[1, 2, 3, 4].duplicates # returns []
+[1, :a, :a, :b, 'bee', 'see', true, true, nil, nil].duplicates # returns [:a, true, nil]
+[1, :a, :a, :b, 'bee', 'see', true, true, nil].duplicates # returns [:a, true]
+[1, {a: 1}, :a, :a, :b, 'bee', 'see', true, true, {a: 1}, {a: 1}].duplicates # returns [:a, true, {a: 1}]
+[].duplicates # returns []
+```
+
 ## JRuby Compatibility
 
 This gem is 100% compatible with JRuby.
 
 ## Opal Compatibility
 
-This gem degrades gracefully to monkey-patching in [Opal Ruby](https://opalrb.com) and provides a `using` method shim so consumer code does not have to change if it used gems that rely on the Ruby refinement.
+This gem degrades gracefully to monkey-patching in [Opal Ruby](https://opalrb.com) and provides a `using` method shim so consumer code does not have to change if it used gems that rely on the [Ruby refinement](https://docs.ruby-lang.org/en/master/syntax/refinements_rdoc.html).
 
 ## RubyMotion Compatibility
 
-This gem degrades gracefully to monkey-patching in [RubyMotion](http://www.rubymotion.com/) and provides a `using` method shim so consumer code does not have to change if it used gems that rely on the Ruby refinement.
+This gem degrades gracefully to monkey-patching in [RubyMotion](http://www.rubymotion.com/) and provides a `using` method shim so consumer code does not have to change if it used gems that rely on the [Ruby refinement](https://docs.ruby-lang.org/en/master/syntax/refinements_rdoc.html).
 
 ## TODO
 
@@ -160,5 +186,6 @@ This gem degrades gracefully to monkey-patching in [RubyMotion](http://www.rubym
 
 ## Copyright
 
-Copyright (c) 2020 Andy Maleh. See LICENSE.txt for
-further details.
+[MIT](LICENSE.txt)
+
+Copyright (c) 2020-2022 Andy Maleh. See [LICENSE.txt](LICENSE.txt) for further details.

data/VERSION

@@ -1 +1 @@
-1.5.0
+1.5.1

data/array_include_methods.gemspec

@@ -2,17 +2,17 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: array_include_methods 1.5.0 ruby lib
+# stub: array_include_methods 1.5.1 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "array_include_methods".freeze
-  s.version = "1.5.0"
+  s.version = "1.5.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Andy Maleh".freeze]
-  s.date = "2022-06-11"
-  s.description = "Array#include_all?, Array#include_any?, Array#include_array?, Array#array_index, Array#array_diff_indices, and Array#array_intersection_indices methods missing from basic Ruby Array API. Compatible with Ruby, JRuby, Opal, and RubyMotion.".freeze
+  s.date = "2023-02-17"
+  s.description = "Array#include_all?, Array#include_any?, Array#include_array?, Array#array_index, Array#counts, and Array#duplicates methods missing from basic Ruby Array API. Compatible with Ruby, JRuby, Opal, and RubyMotion.".freeze
   s.email = "andy.am@gmail.com".freeze
   s.extra_rdoc_files = [
     "CHANGELOG.md",
@@ -31,7 +31,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://github.com/AndyObtiva/array_include_methods".freeze
   s.licenses = ["MIT".freeze]
   s.rubygems_version = "3.3.3".freeze
-  s.summary = "Array#include_all? & Array#include_any? methods missing from basic Ruby Array API".freeze
+  s.summary = "Array#include_all?, Array#include_any?, and other methods missing from basic Ruby Array API".freeze
 
   if s.respond_to? :specification_version then
     s.specification_version = 4

data/lib/array_include_methods/array.rb

@@ -82,10 +82,37 @@ module ArrayIncludeMethods
     end
     alias array_intersection_indices array_intersection_indexes
     
+    def array_intersection(array)
+      array_intersection_indexes(array).map { |index| self[index] }
+    end
+    
     def array_diff_indexes(array)
       array_intersection_and_diff_indexes(array)[:diff_indexes]
     end
     alias array_diff_indices array_diff_indexes
+    alias array_difference_indexes array_diff_indexes
+    alias array_difference_indices array_diff_indexes
+    
+    def array_diff(array)
+      array_diff_indexes(array).map { |index| self[index] }
+    end
+    alias array_difference array_diff
+    
+    # Returns a hash of counts of every element in the array,
+    # performed in linear time (running time of O(n))
+    def counts
+      inject({}) do |count_hash, element|
+        count_hash[element] ||= 0
+        count_hash[element] += 1
+        count_hash
+      end
+    end
+    
+    # Returns a single occurrence of all elements that repeated in an array,
+    # performed in linear time (running time of O(n)).
+    def duplicates
+      counts.select { |element, count| count > 1 }.keys
+    end
     
     private
     

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: array_include_methods
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.5.1
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-06-11 00:00:00.000000000 Z
+date: 2023-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -123,8 +123,8 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: Array#include_all?, Array#include_any?, Array#include_array?, Array#array_index,
-  Array#array_diff_indices, and Array#array_intersection_indices methods missing from
-  basic Ruby Array API. Compatible with Ruby, JRuby, Opal, and RubyMotion.
+  Array#counts, and Array#duplicates methods missing from basic Ruby Array API. Compatible
+  with Ruby, JRuby, Opal, and RubyMotion.
 email: andy.am@gmail.com
 executables: []
 extensions: []
@@ -162,6 +162,6 @@ requirements: []
 rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
-summary: Array#include_all? & Array#include_any? methods missing from basic Ruby Array
-  API
+summary: Array#include_all?, Array#include_any?, and other methods missing from basic
+  Ruby Array API
 test_files: []