Project

ip_ranger

0.01
No release in over 3 years
Low commit activity in last 3 years
ip_rangeraltmetric/ip_rangerHomepageDocumentationSource CodeBug TrackerWiki
A utility for converting IP ranges to CIDR subnets
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
382,224
Stars
3
Forks
2
Watchers
2
 Releases
Current version
0.0.2
Total releases
1
First release
2016-10-07
Latest release
2016-10-07
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
1
Merged Pull Requests
3
Pull Request Acceptance Rate
75%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2019-03-23
Reverse Dependencies
0

 Dependencies

Development

rspec
~> 3.5
 Project Readme

IP Ranger

A gem for converting an arbitrary IP range to the minimal CIDR notation required to describe it exactly.

Current version: 0.0.2
Supported Ruby versions: 1.8.7, 1.9.2, 1.9.3, 2.0, 2.1, 2.2, 2.3

Installation

gem install ip_ranger -v '~> 0.0.2'

Or, in your Gemfile:

gem 'ip_ranger', '~> 0.0.2'

Usage

require 'ip_ranger'

ip_range = IPRanger::IPRange.new('192.168.1.5', '192.168.1.42')
ip_range.cidrs
# => [#<IPAddr: IPv4:192.168.1.5/255.255.255.255>,
#  #<IPAddr: IPv4:192.168.1.6/255.255.255.254>,
#  #<IPAddr: IPv4:192.168.1.8/255.255.255.248>,
#  #<IPAddr: IPv4:192.168.1.16/255.255.255.240>,
#  #<IPAddr: IPv4:192.168.1.32/255.255.255.248>,
#  #<IPAddr: IPv4:192.168.1.40/255.255.255.254>,
#  #<IPAddr: IPv4:192.168.1.42/255.255.255.255>]

API Documentation

IPRanger::IPRange.new(start, finish)

ip_range = IPRanger::IPRange.new('192.168.1.1', '192.168.1.32')
ip_range = IPRanger::IPRange.new(IPAddr.new('10.0.0.1'), IPAddr.new('10.0.0.100'))

Return a new IPRanger::IPRange instance representing a range between the given start and finish IP addresses. Addresses can be given as either strings or IPAddr instances.

IPRanger::IPRange#cidrs

ip_range = IPRanger::IPRange.new('192.168.1.0', '192.168.1.255')
ip_range.cidrs
#=> [#<IPAddr: IPv4:192.168.1.0/255.255.255.0>]

ip_range = IPRanger::IPRange.new('192.168.1.0', '192.168.8.255')
ip_range.cidrs
#=> [#<IPAddr: IPv4:192.168.1.0/255.255.255.0>,
#    #<IPAddr: IPv4:192.168.2.0/255.255.254.0>,
#    #<IPAddr: IPv4:192.168.4.0/255.255.252.0>,
#    #<IPAddr: IPv4:192.168.8.0/255.255.255.0>]

Return an array with a minimal number of IPRanger::IPAddress objects (wrappers for instances of IPAddr), each representing a mask that together cover the entire IP range.

IPRanger::IPAddress.new(ip_addr)

ip_address = IPRanger::IPAddress.new(IPAddr.new('192.168.1.1'))

A wrapper for instances of Ruby's IPAddrthat can be used interchangeably with IPAddr but with some additional methods for working with CIDR notation.

Typically, you should not need to instantiate these yourself but they will be returned by methods on IPRanger::IPRanger and IPRanger::IPAddress itself.

IPRanger::IPAddress#width

ip_address = IPRanger::IPAddress.new(IPAddr.new('192.168.1.0'))
ip_address.width #=> 32

ip_address = IPRanger::IPAddress.new(IPAddr.new('::1'))
ip_address.width #=> 128

Return the width in bits of the IP address: either 32 for an IPv4 or 128 for an IPv6.

IPRanger::IPAddress#succ

ip_address = IPRanger::IPAddress.new(IPAddr.new('192.168.1.0'))
ip_address.succ #=> #<IPAddr: IPv4:192.168.1.1/255.255.255.0>

Return the successor to this IP address as an IPRanger::IPAddress (e.g. 192.168.0.2 succeeds 192.168.0.1).

IPRanger::IPAddress#pred

ip_address = IPRanger::IPAddress.new(IPAddr.new('192.168.1.0'))
ip_address.pred #=> #<IPAddr: IPv4:192.168.0.255/255.255.255.255>

Return the predecessor to this IP address as an IPRanger::IPAddress (e.g. 192.168.0.1 preceeds 192.168.0.2).

IPRanger::IPAddress#prefixlen

ip_address = IPRanger::IPAddress.new(IPAddr.new('192.168.1.0/24'))
ip_address.prefixlen #=> 24

Return the length in bits of the IP address's prefix.

IPRanger::IPAddress#to_cidr

ip_address = IPRanger::IPAddress.new(IPAddr.new('192.168.1.0'))
ip_address.to_cidr #=> "192.168.1.0/32"

Return the string CIDR notation for this IP address.

Acknowledgements

  • This began as a Ruby port of the Python netaddr library's iprange_to_cidrs feature.

License

Copyright © 2016-2024 Altmetric LLP

Distributed under the MIT License.