array_include_methods 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8de965f1a7a26091cfd9b1f2bdbb7191b92148afa5acf2b15b623c7950bc93b9
-  data.tar.gz: e8e4892cb0cbdd33d0cbf53dbf41d2e5927cbd364ac002e4983d948a0b418760
+  metadata.gz: 925807376e5d7c387227dc33369fa80dcefd7abc7f4164f5ed939e8de9a0fa66
+  data.tar.gz: 5a316e7e928da5eb1028e626fbcdec588e21fc66d683afec48278da7bdcc5899
 SHA512:
-  metadata.gz: 42a8e991852c1539669847b94b214d11ad7c47011670d432634fff64516ec2ffb8d749df18b165bc18b676539540eb5d7836dac215152909f5e12b27ad8e4f2a
-  data.tar.gz: 42be75002418adf80e9c7177f6d420dabaa0db20950cbc2d54ef4558773e75697269f0ed9f0849bacc40084c0e7296c55ca163d5f07215592a495f03c3479b54
+  metadata.gz: 8e50f5e30e11b7e2c19234fe207c436b87ee37ff690212af30eb9460eab789ba08dc06b545d55aa2d41d80ccaf2a97f37c6ee2dfeaac31f7d53be55b1ccb7b26
+  data.tar.gz: 9de14d6773e0f55527f6857fb72c75be710615cc02eb61fcf297ca00d3ee2db3d9b9a2e6fea05ebde468497d79a66a38996bd2f1877b0f9813b798b94b93d1dc

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## 1.2.0
+
+- Add `Array#array_index(array)` method to determine start array index of other array
+
 ## 1.1.0
 
 - Perform contiguous-element `include_all?([...])` check against an array argument (not splatted)

data/README.md

@@ -1,4 +1,4 @@
-# ArrayIncludeMethods 1.1.0 - Ruby Refinement
+# ArrayIncludeMethods 1.2.0 - Ruby Refinement
 [![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)
@@ -12,7 +12,7 @@
 Include the following in Gemfile:
 
 ```ruby
-gem 'array_include_methods', '~> 1.1.0'
+gem 'array_include_methods', '~> 1.2.0'
 ```
 
 Run:
@@ -26,7 +26,7 @@ bundle
 Run:
 
 ```
-gem install array_include_methods -v1.1.0
+gem install array_include_methods -v1.2.0
 ```
 
 ## Usage
@@ -47,7 +47,18 @@ Now, you have `#include_all?` and `#include_any?` methods on `Array` objects.
 
 ## Examples
 
-### `Array#include_all?(other_array)`
+### `Array#include_any?(*other_array)`
+
+```ruby
+[1, 2, 3, 4].include_any?(2, 4, 5) # returns true
+[1, 2, 3, 4].include_any?([2, 4, 5]) # returns true
+[1, 2, 3, 4].include_any?(6, 7) # returns false
+[1, 2, 3, 4].include_any?([6, 7]) # returns false
+[1, 2, 3, 4].include_any?([]) # returns true
+[1, 2, 3, 4].include_any?(nil) # returns false
+```
+
+### `Array#include_all?(*other_array)`
 
 ```ruby
 [1, 2, 3, 4].include_all?(2, 3) # returns true
@@ -64,15 +75,19 @@ Now, you have `#include_all?` and `#include_any?` methods on `Array` objects.
 [1, 2, 3, 4].include_all?(nil) # returns false
 ```
 
-### `Array#include_any?(other_array)`
+### `Array#array_index(other_array)`
+
+Returns first array index of `other_array` in `first_array` assuming `first_array.include_all?(other_array)` returns true
 
 ```ruby
-[1, 2, 3, 4].include_any?(2, 4, 5) # returns true
-[1, 2, 3, 4].include_any?([2, 4, 5]) # returns true
-[1, 2, 3, 4].include_any?(6, 7) # returns false
-[1, 2, 3, 4].include_any?([6, 7]) # returns false
-[1, 2, 3, 4].include_any?([]) # returns true
-[1, 2, 3, 4].include_any?(nil) # returns false
+[1, 2, 3, 4].array_index([2, 3, 4]) # returns 1
+[1, 2, 3, 4].array_index([2, 3]) # returns 1
+[1, 2, 3, 4].array_index([3, 4]) # returns 2
+[1, 2, 3, 4].array_index([2, 4]) # returns -1
+[1, 2, 3, 4].array_index([4, 2]) # returns -1
+[1, 2, 3, 4].array_index([2, 4, 5]) # returns -1
+[1, 2, 3, 4].array_index([]) # returns -1
+[1, 2, 3, 4].array_index(nil) # returns -1
 ```
 
 ## Opal Compatibility

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.2.0

data/array_include_methods.gemspec

@@ -2,11 +2,11 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: array_include_methods 1.1.0 ruby lib
+# stub: array_include_methods 1.2.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "array_include_methods".freeze
-  s.version = "1.1.0"
+  s.version = "1.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]

data/lib/array_include_methods.rb

@@ -53,6 +53,21 @@ module ArrayIncludeMethods
       array = array[0] if array.size == 1 && array[0].is_a?(Array)
       !array.nil? && (array.empty? || !(self & array).empty?)
     end
+    
+    def array_index(array)
+      result_array_index = -1
+      return result_array_index if array.nil?
+      if array.size <= self.size
+        size_diff = self.size - array.size
+        current_array_index = nil
+        result = (size_diff + 1).times.any? do |start_index|
+          current_array_index = start_index
+          self[start_index, array.size] == array
+        end
+        result_array_index = current_array_index if result
+      end
+      result_array_index
+    end
   end
 end
 if RUBY_PLATFORM == 'opal'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: array_include_methods
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Andy Maleh