File: netaddr.rb

package info (click to toggle)
ruby-netaddr 2.0.6-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 296 kB
  • sloc: ruby: 2,022; makefile: 7
file content (126 lines) | stat: -rw-r--r-- 3,472 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
require_relative "eui48.rb"
require_relative "eui64.rb"
require_relative "ipv4.rb"
require_relative "ipv4net.rb"
require_relative "ipv6.rb"
require_relative "ipv6net.rb"
require_relative "mask32.rb"
require_relative "mask128.rb"
require_relative "util.rb"

module NetAddr
	# Constants
	
	# 32 bits worth of '1'
	F32 = 2**32-1
	
	# 128 bits worth of '1'
	F128 = 2**128-1
	

	# ValidationError is thrown when a method fails a validation test.
  class ValidationError < StandardError
  end
	
	# ipv4_prefix_len returns the prefix length needed to hold the number of IP addresses specified by "size".
	def ipv4_prefix_len(size)
		prefix_len = 32
		32.downto(0) do |i|
			hostbits = 32 - prefix_len
			max = 1 << hostbits
			if (size <= max)
				break
			end
			prefix_len -= 1
		end
		return prefix_len
	end
	module_function :ipv4_prefix_len
	
	## parse_ip parses a string into an IPv4 or IPv6
	def parse_ip(ip)
		if (ip.include?(":"))
			return IPv6.parse(ip)
		end
		return IPv4.parse(ip)
	end
	module_function :parse_ip
	
	## parse_net parses a string into an IPv4Net or IPv6Net
	def parse_net(net)
		if (net.include?(":"))
			return IPv6Net.parse(net)
		end
		return IPv4Net.parse(net)
	end
	module_function :parse_net
	
	# sort_IPv4 sorts a list of IPv4 objects in ascending order.
	# It will return a new list with any non IPv4 objects removed.
	def sort_IPv4(list)
		if ( !list.kind_of?(Array) )
			raise ArgumentError, "Expected an Array for 'list' but got a #{list.class}."
		end
		filtered = Util.filter_IPv4(list)
		return Util.quick_sort(filtered)
	end
	module_function :sort_IPv4
	
	# sort_IPv6 sorts a list of IPv6 objects in ascending order.
	# It will return a new list with any non IPv6 objects removed.
	def sort_IPv6(list)
		if ( !list.kind_of?(Array) )
			raise ArgumentError, "Expected an Array for 'list' but got a #{list.class}."
		end
		filtered = Util.filter_IPv6(list)
		return Util.quick_sort(filtered)
	end
	module_function :sort_IPv6
	
	# sort_IPv4Net sorts a list of IPv4Net objects in ascending order.
	# It will return a new list with any non IPv4Net objects removed.
	def sort_IPv4Net(list)
		if ( !list.kind_of?(Array) )
			raise ArgumentError, "Expected an Array for 'list' but got a #{list.class}."
		end
		filtered = Util.filter_IPv4Net(list)
		return Util.quick_sort(filtered)
	end
	module_function :sort_IPv4Net
	
	# sort_IPv6Net sorts a list of IPv6Net objects in ascending order.
	# It will return a new list with any non IPv6Net objects removed.
	def sort_IPv6Net(list)
		if ( !list.kind_of?(Array) )
			raise ArgumentError, "Expected an Array for 'list' but got a #{list.class}."
		end
		filtered = Util.filter_IPv6Net(list)
		return Util.quick_sort(filtered)
	end
	module_function :sort_IPv6Net
	
	# summ_IPv4Net summarizes a list of IPv4Net objects as much as possible.
	# It will return a new list with any non IPv4Net objects removed.
	def summ_IPv4Net(list)
		list = Util.filter_IPv4Net(list)
		if (list.length>1)
			list = Util.discard_subnets(list)
			return Util.summ_peers(list)
		end
		return [].concat(list)
	end
	module_function :summ_IPv4Net
	
	# summ_IPv6Net summarizes a list of IPv6Net objects as much as possible.
	# It will return a new list with any non IPv6Net objects removed.
	def summ_IPv6Net(list)
		list = Util.filter_IPv6Net(list)
		if (list.length>1)
			list = Util.discard_subnets(list)
			return Util.summ_peers(list)
		end
		return [].concat(list)
	end
	module_function :summ_IPv6Net
	
end # end module