Added IPRange::Range#=== (closes #491).

Author: postmodern

.rubocop.yml

@@ -122,6 +122,7 @@ Style/CaseEquality:
     - 'spec/network/ip_range_spec.rb'
     - 'spec/network/ip_range/cidr_spec.rb'
     - 'spec/network/ip_range/glob_spec.rb'
+    - 'spec/network/ip_range/range_spec.rb'
 
 Style/ConditionalAssignment:
   Exclude:

lib/ronin/support/network/ip_range/range.rb

@@ -207,6 +207,25 @@ def ==(other)
               self.end   == other.end
           end
 
+          #
+          # Determines if the given IP range is a sub-set of the IP range.
+          #
+          # @param [IPRange::Range, CIDR, Glob, Enumerable<String>] other
+          #   The other IP range.
+          #
+          # @return [Boolean]
+          #
+          # @since 1.1.0
+          #
+          def ===(other)
+            case other
+            when IPRange::Range
+              self.begin <= other.begin && self.end >= other.end
+            else
+              other.all? { |ip| include?(ip) }
+            end
+          end
+
           #
           # Calculates the size of the IP range.
           #

spec/network/ip_range/range_spec.rb

@@ -301,6 +301,62 @@
     end
   end
 
+  describe "#===" do
+    let(:cidr) { '10.1.1.1/24' }
+
+    context "when given Ronin::Support::Network::IPRange::Range" do
+      context "and the other IP range is equal to the IP range" do
+        let(:other) { described_class.new(first,last) }
+
+        it "must return true" do
+          expect(subject === other).to be(true)
+        end
+      end
+
+      context "and the other IP range is a subset within the IP range" do
+        let(:other_first) { '127.0.0.128' }
+        let(:other_last)  { '127.0.1.0' }
+        let(:other)       { described_class.new(other_first,other_last) }
+
+        it "must return true" do
+          expect(subject === other).to be(true)
+        end
+      end
+
+      context "and the other IP range does not overlap with the IP range" do
+        let(:other_first) { '1.0.0.0' }
+        let(:other_last)  { '1.0.0.1' }
+        let(:other)       { described_class.new(other_first,other_last) }
+
+        it "must return false" do
+          expect(subject === other).to be(false)
+        end
+      end
+    end
+
+    context "when given an Enumerable object" do
+      let(:other) do
+        (128..255).map { |i| "127.0.0.%d" % i }
+      end
+
+      context "and when every IP in the Enumerable object is included in the IP range" do
+        it "must return true" do
+          expect(subject === other).to be(true)
+        end
+      end
+
+      context "but one of the IPs in the Enumerable object is not included in the IP range" do
+        let(:other) do
+          super() + ['127.0.1.255']
+        end
+
+        it "must return false" do
+          expect(subject === other).to be(false)
+        end
+      end
+    end
+  end
+
   describe "#size" do
     it "must return the number of IPs in the IP range" do
       expect(subject.size).to eq(256)