ip 0.0.2 → 0.0.3

data/lib/ip.rb

@@ -25,6 +25,30 @@
 # perhaps a distant, future release. Any patches that can correct this
 # issue are most welcome.
 #
+# ================================================================
+#
+# The compilation of software known as ip.rb is distributed under the
+# following terms:
+# Copyright (C) 2005-2006 Erik Hollensbe. All rights reserved.
+#
+# Redistribution and use in source form, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#   notice, this list of conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED.  IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+# SUCH DAMAGE.
+#
 
 class IP
 
@@ -158,7 +182,47 @@ class IP
       lower = rawip & rawnm
       return IP::Range[IP::Address.unpack(lower), IP::Address.unpack(upper)]
     end
+
+    #
+    # This returns the first ip address of the cidr as an IP::Address object.
+    #
+    def first_ip
+      rawip = IP::Address.pack(@ip)
+      rawnm = 0xFFFFFFFF << (32 - @mask)
+      lower = rawip & rawnm
+      return IP::Address.unpack(lower)
+    end
+
+    #
+    # This returns the last ip address of the cidr as an IP::Address object.
+    #
+    def last_ip
+      rawip = IP::Address.pack(@ip)
+      rawnm = 0xFFFFFFFF << (32 - @mask)
+      upper = rawip | ~rawnm
+      return IP::Address.unpack(upper)
+    end
+
+    #
+    # This will take another IP::CIDR object as an argument and check to see
+    # if it overlaps with this cidr object. Returns true/false on overlap.
+    #
+    # This also throws a TypeError if passed invalid data.
+    #
+    def overlaps?(other_cidr)
+      fail TypeError.new("Expected object of type IP::Address") unless(other_cidr.kind_of?(IP::CIDR))
+
+      myfirst = IP::Address.pack(self.first_ip)
+      mylast = IP::Address.pack(self.last_ip)
       
+      otherfirst = IP::Address.pack(other_cidr.first_ip)
+      otherlast = IP::Address.pack(other_cidr.last_ip)
+
+      return ((myfirst >= otherfirst && myfirst <= otherlast) ||
+        (mylast <= otherlast && mylast >= otherfirst) ||
+        (otherfirst >= myfirst && otherfirst <= mylast)) ? true : false;
+    end
+
   end
 
   #

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: ip
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
-date: 2005-11-13 00:00:00 -08:00
+  version: 0.0.3
+date: 2006-01-03 00:00:00 -08:00
 summary: "Ruby classes to work with IP address, ranges, and netmasks"
 require_paths: 
   - lib