ip-ranges 0.1.0

data/Gemfile

@@ -0,0 +1,4 @@
+source :rubygems
+gem "netaddr"
+gem "rdoc"
+gem "rspec"

data/Gemfile.lock

@@ -0,0 +1,22 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    netaddr (1.5.0)
+    rdoc (3.9.4)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  netaddr
+  rdoc
+  rspec

data/README.markdown

@@ -0,0 +1,57 @@
+Compare IP ranges
+=================
+
+This gem allows you to take multiple IP ranges, which may be defined in several ways (as a single IP number, a dotted string or a CIDR range), and compare them against each other to check for uniqueness, overlaps, equivalence or one range containing another.
+
+
+Example1 - Range class
+======================
+
+    r1 = IpRanges::Range.new :range => '1.2.3.4..1.2.3.5'
+    r2 = IpRanges::Range.new :range => '1.2.3.0/24'
+    
+    r2.overlaps_range?(r1) => true
+    r2.contains_range?(r1) => true
+    r2 == r1               => false
+    
+
+Example2 - Check for overlaps
+=============================
+
+    require 'rubygems'
+    require 'lib/ip-ranges'
+
+    include IpRanges
+
+    list = [
+      '1.2.3.4..1.2.3.5',
+      '1.2.3.0/24'
+    ]
+
+    puts check_for_overlaps(list)
+      
+    # outputs: 1.2.3.4..1.2.3.5 is contained by range 1.2.3.0/24
+
+
+MIT License
+===========
+
+(c) David Salgado 2011, or whenever
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,82 @@
+require "rubygems/package_task"
+require "rdoc/task"
+require "rspec"
+require "rspec/core/rake_task"
+require 'rake/testtask'
+
+$stdout.sync = true
+
+task :default => :spec
+
+task :spec do
+  system "bundle exec rspec spec/*_spec.rb spec/**/*_spec.rb"
+end
+
+# This builds the actual gem. For details of what all these options
+# mean, and other ones you can add, check the documentation here:
+#
+#   http://rubygems.org/read/chapter/20
+#
+spec = Gem::Specification.new do |s|
+
+  # Change these as appropriate
+  s.name              = "ip-ranges"
+  s.version           = "0.1.0"
+  s.summary           = "Manage ranges of IP numbers determining equivalence, containment and overlaps"
+  s.author            = "David Salgado"
+  s.email             = "david@digitalronin.com"
+  s.homepage          = "http://roninonrails.blogspot.com"
+
+  s.has_rdoc          = true
+  s.description       = "Compare multiple IP ranges for overlaps, equivalence and containment"
+  # s.extra_rdoc_files  = %w(README)
+  s.rdoc_options      = %w(-x pkg)
+
+  # Add any extra files to include in the gem (like your README)
+  s.files             = %w(Gemfile Gemfile.lock Rakefile README.markdown) + Dir.glob("{spec,lib}/**/*")
+  s.require_paths     = ["lib"]
+
+  # If you want to depend on other gems, add them here, along with any
+  # relevant versions
+  s.add_dependency("netaddr", "~> 1.5.0")
+
+  # If your tests use any gems, include them here
+  s.add_development_dependency("rspec")
+  s.add_development_dependency("rdoc")
+end
+
+# This task actually builds the gem. We also regenerate a static
+# .gemspec file, which is useful if something (i.e. GitHub) will
+# be automatically building a gem for this project. If you're not
+# using GitHub, edit as appropriate.
+#
+# To publish your gem online, install the 'gemcutter' gem; Read more 
+# about that here: http://gemcutter.org/pages/gem_docs
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Build the gemspec file #{spec.name}.gemspec"
+task :gemspec do
+  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
+  File.open(file, "w") {|f| f << spec.to_ruby }
+end
+
+# If you don't want to generate the .gemspec file, just remove this line. Reasons
+# why you might want to generate a gemspec:
+#  - using bundler with a git source
+#  - building the gem without rake (i.e. gem build blah.gemspec)
+#  - maybe others?
+task :package => :gemspec
+
+# Generate documentation
+RDoc::Task.new do |rd|
+  
+  rd.rdoc_files.include("lib/**/*.rb")
+  rd.rdoc_dir = "rdoc"
+end
+
+desc 'Clear out RDoc and generated packages'
+task :clean => [:clobber_rdoc, :clobber_package] do
+  rm "#{spec.name}.gemspec"
+end

data/lib/ip-ranges.rb

@@ -0,0 +1,51 @@
+require 'netaddr'
+
+# Manipulate and compare ranges of Ip numbers.
+# In particular, this gem allows you to specify
+# multiple Ip ranges, in a variety of formats,
+# and compare them for overlaps, equivalence and
+# containment (i.e. range1 contains all of range2)
+#
+# :title: IpRanges Gem
+# Author:: David Salgado (mailto:david@digitalronin.com)
+# Copyright:: Copyright (c) 2011 David Salgado
+# License::   Distributes under the same terms as Ruby
+
+module IpRanges
+
+  # Checks multiple ranges of IP numbers for uniqueness (in the sense that a given IP number
+  # should only appear once within the set of all supplied ranges).
+  #
+  # Arguments:
+  # * An array of strings that define single IP numbers or ranges (in dotted or CIDR notation)
+  #
+  # Returns:
+  # * An array of strings describing any overlaps, equivalences and containments which occur in the list (see the specs for details)
+  #
+  def check_for_overlaps(list)
+    rtn = []
+    while list.any?
+      test_range = list.shift
+      test = Range.new :range => test_range
+      list.each do |range| 
+        i = Range.new :range => range
+        if test.overlaps_range?(i)
+          if test == i
+            rtn << "#{test_range} equals range #{range}"
+          elsif test.contains_range?(i)
+            rtn << "#{test_range} contains range #{range}"
+          elsif i.contains_range?(test)
+            rtn << "#{test_range} is contained by range #{range}"
+          else
+            rtn << "#{test_range} overlaps with #{range}"
+          end
+        end
+      end
+    end
+    rtn
+  end
+end
+
+libdir = File.join(File.dirname(__FILE__), 'ip-ranges')
+require File.join(libdir, 'ip')
+require File.join(libdir, 'range')

data/lib/ip-ranges/ip.rb

@@ -0,0 +1,140 @@
+module IpRanges
+
+  # Class to represent a single IP number. Exposes methods for comparisons
+  # with other IP numbers, as well as a method to increment the IP number.
+  class Ip
+    # String representation of this Ip number
+    # 
+    # Example:
+    #
+    #   ip = Ip.new :number => '1.2.3.4'
+    #   ip.number => '1.2.3.4'
+    #
+    attr_accessor :number
+
+    # Arguments:
+    #
+    # *  A hash containing a single key whose value is the IP number as a string
+    # 
+    # Example:
+    #
+    #   Ip.new(:number => '1.2.3.4')
+    #
+    def initialize(params = {})
+      @number = params[:number]
+    end
+
+    # Example:
+    # Ip.new(:number => '1.2.3.4').to_s => '1.2.3.4'
+    def to_s
+      number
+    end
+
+    # Arguments:
+    #
+    # * another Ip object
+    #
+    # Example:
+    #
+    #   ip1 = Ip.new(:number => '1.2.3.4')
+    #   ip2 = Ip.new(:number => '1.2.3.5')
+    #   ip3 = Ip.new(:number => '1.2.3.4')
+    #
+    #   ip1 == ip2 => false
+    #   ip1 == ip3 => true
+    def ==(ip)
+      number == ip.number
+    end
+
+    # Arguments:
+    #
+    # * another Ip object
+    #
+    # Example:
+    #
+    #   ip1 = Ip.new(:number => '1.2.3.4')
+    #   ip2 = Ip.new(:number => '1.2.3.5')
+    #   ip3 = Ip.new(:number => '1.2.3.4')
+    #
+    #   ip1 >= ip2 => false
+    #   ip2 >= ip3 => true
+    #   ip1 >= ip3 => true
+    def >=(ip)
+      self == ip || self > ip
+    end
+
+    # Arguments:
+    #
+    # * another Ip object
+    #
+    # Example:
+    #
+    #   ip1 = Ip.new(:number => '1.2.3.4')
+    #   ip2 = Ip.new(:number => '1.2.3.5')
+    #
+    #   ip1 > ip2 => false
+    #   ip2 > ip1 => true
+    #   ip2 > ip2 => false
+    def >(ip)
+      a1, b1, c1, d1 = tuples number
+      a2, b2, c2, d2 = tuples ip.number
+      if a1 > a2
+        true
+      elsif a1 < a2
+        false
+      elsif b1 > b2
+        true
+      elsif b1 < b2
+        false
+      elsif c1 > c2
+        true
+      elsif c1 < c2
+        false
+      else
+        d1 > d2
+      end
+    end
+
+    # Changes the 'number' property of this Ip
+    # to the next number after this one.
+    #
+    #   example: 
+    #
+    #     ip = Ip.new(:number => '1.2.3.4')
+    #     ip.number => '1.2.3.4'
+    #     ip.increment
+    #     ip.number => '1.2.3.5'
+    #
+    def increment
+      a, b, c, d = tuples number
+      if d < 255
+        d += 1
+      else
+        d = 0
+        if c < 255
+          c += 1
+        else
+          c = 0
+          if b < 255
+            b += 1
+          else
+            b = 0
+            if a < 255
+              a += 1
+            else
+              raise "No more IPs"
+            end
+          end
+        end
+      end
+      @number = [a, b, c, d].join('.')
+    end
+
+    private
+
+    def tuples(string)
+      string.split(/\./).map {|i| i.to_i}
+    end
+
+  end
+end

data/lib/ip-ranges/range.rb

@@ -0,0 +1,119 @@
+module IpRanges
+
+  # Class to represent a range of IP numbers. 
+  # Range objects are instantiated from a string which may be a single 
+  # Exposes methods to compare this range with another range, and to 
+  # iterate through all IP numbers in the range.
+  class Range
+    # First IP number in the range, as an Ip object
+    attr_accessor :first
+
+    # Last IP number in the range, as an Ip object
+    attr_accessor :last
+
+    SINGLE_IP = /^\d+\.\d+\.\d+\.\d+$/
+    DOTTED_RANGE = /^(\d+\.\d+\.\d+\.\d+)\.\.(\d+\.\d+\.\d+\.\d+)$/
+    CIDR_RANGE = %r[/]
+
+    BATCHSIZE = 250
+    PAUSE = 2
+
+    # Instatiate a range from a string representation which can be a single
+    # Ip number, a dotted range or a CIDR range
+    #
+    # Arguments:
+    # * A +Hash+ with a single key ':range' whose value is a string defining the range.
+    #
+    # Examples:
+    #
+    #   IpRanges::Range.new :range => '1.2.3.4' => a range containing one Ip
+    #   IpRanges::Range.new :range => '1.2.3.4 .. 1.2.3.5' => a range containing two Ip numbers (spaces around the '..' are ignored)
+    #   IpRanges::Range.new :range => '1.2.3.0/24' => a range containing 256 Ip numbers (1.2.3.0 .. 1.2.3.255)
+    #
+    def initialize(params)
+      string = params[:range].gsub(' ', '')
+      case string
+      when SINGLE_IP
+        @first = Ip.new :number => string
+        @last = Ip.new :number => string
+      when DOTTED_RANGE
+        @first = Ip.new :number => $1
+        @last = Ip.new :number => $2
+      when CIDR_RANGE
+        begin
+          cidr = NetAddr::CIDR.create(string)
+          @first = Ip.new :number => cidr.first
+          @last = Ip.new :number => cidr.last
+        rescue Exception => e
+          puts "Error creating CIDR range from: #{string}"
+          raise e
+        end
+      end
+    end
+
+    # Returns the last Ip object in this range.
+    def last
+      @last
+    end
+
+    # Returns the first Ip object in this range.
+    def first
+      @first
+    end
+
+    # Arguments
+    # * A +Range+ object
+    # True if this range is equivalent to the passed-in range.
+    def ==(range)
+      first == range.first && last == range.last
+    end
+
+    # Arguments
+    # * A +Range+ object
+    # True if this range intersects with the passed-in range.
+    def overlaps_range?(range)
+      contains_ip?(range.first) || contains_ip?(range.last) || range.contains_ip?(first) || range.contains_ip?(last)
+    end
+
+    # Arguments
+    # * A +Range+ object
+    # True if this range completely contains the passed-in range.
+    def contains_range?(range)
+      contains_ip?(range.first) && contains_ip?(range.last)
+    end
+
+    # Arguments
+    # * A +String+ or an +Ip+ object
+    # True if the range contains the IP
+    def contains_ip?(ip)
+      test = ip.kind_of?(String) ? Ip.new(:number => ip) : ip
+      test >= @first && @last >= test
+    end
+
+    # Yields each IP in the range, in turn, as an Ip object.
+    def each_ip
+      @counter = 0 # for throttling
+      ip = first
+      while last >= ip
+        yield ip.dup
+        ip.increment
+        throttle
+      end
+    end
+
+    private
+
+    def throttle
+      @counter += 1
+      if @counter % BATCHSIZE == 0
+        take_a_nap
+      end
+    end
+
+    def take_a_nap
+      log "Counter: #{$counter}, sleeping for #{PAUSE} seconds" if $verbose
+      sleep PAUSE
+    end
+
+  end
+end

data/spec/ip-ranges/ip_spec.rb

@@ -0,0 +1,94 @@
+require 'spec/spec_helper'
+
+describe IpRanges::Ip do
+  before do
+    @ip = IpRanges::Ip.new
+  end
+
+  it "duplicates with a different object" do
+    @ip.number = "1.200.3.4"
+    ip2 = @ip.dup
+    ip2.object_id.should_not == @ip.object_id
+  end
+
+  it "duplicates" do
+    @ip.number = "1.200.3.4"
+    ip2 = @ip.dup
+    ip2.should == @ip
+  end
+
+  it "is greater than or equal to" do
+    @ip.number = "1.200.3.4"
+    eq = IpRanges::Ip.new :number => "1.200.3.4"
+    lt = IpRanges::Ip.new :number => "1.200.3.3"
+    [eq, lt].each {|test| (@ip >= test).should be_true}
+  end
+
+  it "is equivalent" do
+    @ip.number = "1.200.3.4"
+    ip2 = IpRanges::Ip.new :number => "1.200.3.4"
+    @ip.should == ip2
+  end
+
+  it "renders to string" do
+    @ip.number = "1.200.3.4"
+    @ip.to_s.should == "1.200.3.4"
+  end
+
+  it "knows 1.2.3.255 < 1.2.4.0" do
+    @ip.number = '1.2.3.255'
+    ip2 = IpRanges::Ip.new :number => "1.2.4.0"
+    (@ip > ip2).should be_false
+  end
+
+  it "knows 1.2.4.0 >= 1.2.3.255" do
+    @ip.number = "1.2.4.0"
+    ip2 = IpRanges::Ip.new :number => '1.2.3.255'
+    (@ip >= ip2).should be_true
+  end
+
+  it "knows 1.200.3.4 > 1.199.3.4" do
+    @ip.number = "1.200.3.4"
+    ip2 = IpRanges::Ip.new :number => '1.199.3.4'
+    (@ip > ip2).should be_true
+  end
+
+  it "knows 1.2.3.4 > 1.2.2.4" do
+    @ip.number = "1.2.3.4"
+    ip2 = IpRanges::Ip.new :number => '1.2.2.4'
+    (@ip > ip2).should be_true
+  end
+
+  it "knows 1.2.3.4 > 1.2.3.3" do
+    @ip.number = "1.2.3.4"
+    ip2 = IpRanges::Ip.new :number => '1.2.3.3'
+    (@ip > ip2).should be_true
+  end
+
+  it "knows 1.2.3.3 <= 1.2.3.4" do
+    @ip.number = "1.2.3.3"
+    ip2 = IpRanges::Ip.new :number => '1.2.3.4'
+    (@ip > ip2).should be_false
+  end
+
+  it "increments when 2nd tuple hits 255" do
+    @ip.number = "1.255.255.255"
+    @ip.increment.should == "2.0.0.0"
+  end
+
+  it "increments when 3rd tuple hits 255" do
+    @ip.number = "1.2.255.255"
+    @ip.increment.should == "1.3.0.0"
+  end
+
+  it "increments when last tuple hits 255" do
+    @ip.number = "1.2.3.255"
+    @ip.increment.should == "1.2.4.0"
+  end
+
+  it "increments last tuple" do
+    @ip.number = '1.2.3.4'
+    @ip.increment.should == "1.2.3.5"
+  end
+
+end

data/spec/ip-ranges/range_spec.rb

@@ -0,0 +1,119 @@
+require 'spec/spec_helper'
+
+describe IpRanges::Range do
+  before do
+  end
+
+  context "checking for overlaps" do
+
+    it "knows when range a contains range b" do
+      ipr1 = IpRanges::Range.new :range => '1.2.3.3..1.2.3.5'
+      ipr2 = IpRanges::Range.new :range => '1.2.3.4..1.2.3.5'
+      ipr1.contains_range?(ipr2).should be_true
+    end
+
+    it "knows when range a does not contain range b" do
+      ipr1 = IpRanges::Range.new :range => '1.2.3.4..1.2.3.5'
+      ipr2 = IpRanges::Range.new :range => '1.2.3.5..1.2.3.6'
+      ipr1.contains_range?(ipr2).should be_false
+    end
+
+    it "knows there is an overlap" do
+      ipr1 = IpRanges::Range.new :range => '1.2.3.4'
+      ipr2 = IpRanges::Range.new :range => '1.2.3.4'
+      ipr1.overlaps_range?(ipr2).should be_true
+    end
+
+    it "knows there is no overlap" do
+      ipr1 = IpRanges::Range.new :range => '1.2.3.4'
+      ipr2 = IpRanges::Range.new :range => '1.2.3.5'
+      ipr1.overlaps_range?(ipr2).should be_false
+    end
+
+    it "accepts Ip object for contains_ip" do
+      ipr = IpRanges::Range.new :range => '1.2.3.4..1.2.3.6'
+      ip = IpRanges::Ip.new :number => '1.2.3.5'
+      ipr.contains_ip?(ip).should be_true
+    end
+
+    it "knows it doesn't contain ip numbers" do
+      ipr = IpRanges::Range.new :range => '1.2.3.4..1.2.3.6'
+      %w(1.2.3.3 1.2.3.7).each {|num| ipr.contains_ip?(num).should be_false}
+    end
+
+    it "knows it contains an ip number" do
+      ipr = IpRanges::Range.new :range => '1.2.3.4..1.2.3.6'
+      %w(1.2.3.4 1.2.3.5 1.2.3.6).each {|num| ipr.contains_ip?(num).should be_true}
+    end
+
+  end
+
+  it "knows it equals another range" do
+    dotted = IpRanges::Range.new :range => '1.2.3.0..1.2.3.255'
+    cidr   = IpRanges::Range.new :range => '1.2.3.0/24'
+    (dotted == cidr).should be_true
+    (cidr == dotted).should be_true
+  end
+
+  it "iterates over all ips" do
+    ipr = IpRanges::Range.new :range => '1.2.3.4 .. 1.2.3.6'
+    expected = [
+      IpRanges::Ip.new(:number => '1.2.3.4'),
+      IpRanges::Ip.new(:number => '1.2.3.5'),
+      IpRanges::Ip.new(:number => '1.2.3.6')
+    ]
+    arr = []
+    ipr.each_ip {|ip| arr << ip}
+    arr.should == expected
+  end
+
+  it "returns last ip from cidr range" do
+    ipr = IpRanges::Range.new :range => '1.2.3.0/24'
+    ipr.last.to_s.should == '1.2.3.255'
+  end
+
+  it "returns first ip from cidr range" do
+    ipr = IpRanges::Range.new :range => '1.2.3.0/24'
+    ipr.first.to_s.should == '1.2.3.0'
+  end
+
+  it "instantiates from a cidr range" do
+    ipr = IpRanges::Range.new :range => '1.2.3.0/24'
+    ipr.should be_kind_of(IpRanges::Range)
+  end
+
+  it "returns last ip from dotted range" do
+    ipr = IpRanges::Range.new :range => '1.2.3.4 .. 1.2.3.5'
+    ipr.last.to_s.should == '1.2.3.5'
+  end
+
+  it "returns first ip from dotted range" do
+    ipr = IpRanges::Range.new :range => '1.2.3.4 .. 1.2.3.5'
+    ipr.first.to_s.should == '1.2.3.4'
+  end
+
+  it "instantiates from a dotted range" do
+    ipr = IpRanges::Range.new :range => '1.2.3.4 .. 1.2.3.5'
+    ipr.should be_kind_of(IpRanges::Range)
+  end
+
+  it "returns last ip" do
+    ipr = IpRanges::Range.new :range => '1.2.3.4'
+    ipr.last.to_s.should == '1.2.3.4'
+  end
+
+  it "returns first ip" do
+    ipr = IpRanges::Range.new :range => '1.2.3.4'
+    ipr.first.to_s.should == '1.2.3.4'
+  end
+
+  it "instantiates from a single IP" do
+    ipr = IpRanges::Range.new :range => '1.2.3.4'
+    ipr.should be_kind_of(IpRanges::Range)
+  end
+
+  it "instantiates" do
+    ipr = IpRanges::Range.new :range => ''
+    ipr.should be_kind_of(IpRanges::Range)
+  end
+end

data/spec/ip_ranges_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+
+describe IpRanges do
+  include IpRanges
+
+  context "checking for overlaps" do
+
+    it "explains range a equals range b" do
+      list = %w(1.2.3.0..1.2.3.255 1.2.3.0/24)
+      overlaps = check_for_overlaps(list)
+      overlaps[0].should == "1.2.3.0..1.2.3.255 equals range 1.2.3.0/24"
+    end
+
+    it "explains range a is contained by range b" do
+      list = %w(1.2.3.4..1.2.3.5 1.2.3.4..1.2.3.8)
+      overlaps = check_for_overlaps(list)
+      overlaps[0].should == "1.2.3.4..1.2.3.5 is contained by range 1.2.3.4..1.2.3.8"
+    end
+
+    it "explains range a contains range b" do
+      list = %w(1.2.3.4..1.2.3.8 1.2.3.4..1.2.3.5)
+      overlaps = check_for_overlaps(list)
+      overlaps[0].should == "1.2.3.4..1.2.3.8 contains range 1.2.3.4..1.2.3.5"
+    end
+
+    it "explains overlap" do
+      list = %w(1.2.3.4..1.2.3.8 1.2.3.5..1.2.3.9)
+      overlaps = check_for_overlaps(list)
+      overlaps[0].should == "1.2.3.4..1.2.3.8 overlaps with 1.2.3.5..1.2.3.9"
+    end
+
+    it "counts the overlaps" do
+      list = %w(1.2.3.4..1.2.3.8 1.2.3.4..1.2.3.5 1.2.3.8)
+      check_for_overlaps(list).size.should == 2
+    end
+
+    it "takes a list" do
+      check_for_overlaps []
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'lib/ip-ranges'

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification 
+name: ip-ranges
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- David Salgado
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-10 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: netaddr
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 1
+        - 5
+        - 0
+        version: 1.5.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rdoc
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: Compare multiple IP ranges for overlaps, equivalence and containment
+email: david@digitalronin.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- README.markdown
+- spec/ip-ranges/ip_spec.rb
+- spec/ip-ranges/range_spec.rb
+- spec/ip_ranges_spec.rb
+- spec/spec_helper.rb
+- lib/ip-ranges/ip.rb
+- lib/ip-ranges/range.rb
+- lib/ip-ranges.rb
+homepage: http://roninonrails.blogspot.com
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- -x
+- pkg
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Manage ranges of IP numbers determining equivalence, containment and overlaps
+test_files: []
+