ipaddress_2 0.11.1 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9a281ff3a5be006b8e76e2495597ccc727a403f3e43421250088e8a61da18c6
-  data.tar.gz: 548b551caad2225532081bc4d9203c703c333ee715b84768115c0697b8a7f865
+  metadata.gz: b6c14a053c2c3ae5bbf8f4daf54df76a221ece84a46fc3297159c6751ff45746
+  data.tar.gz: 13b69795534a2f0f46332c563348de881430a4b432e6cbf9ef7385861ea8b6d8
 SHA512:
-  metadata.gz: 48c4eefd3213e47460b477e34872e1c332f1480d620f6d96527f0c5acc7e4051ffefa233ac1b4566193ee9dfc548d040ee38e374968bda778b2f8462336cf792
-  data.tar.gz: 37c47f2d478e596a7f11daa7dd33f35e888c1ced7e351f4286561dc69853191d2b09b1e46c9d2227055916668381b30fd634e298aa5c9cf9ae35b7376d85b94a
+  metadata.gz: ee9429ddb8b2c69b036eabf72159c32ad8d3babc42bbdc747c12029422ddaf3e97c5b6c2daff8cf8ed4aab40db7a4a4995152093f29a6c3d0200fcb06f7c6900
+  data.tar.gz: '08ec5f9867b28c8073b9f06c39e15019479762e22892d7822917dde03f835b86b268dd3df6a1570d2e1f28a15c391b39f02740f707187f9fb1204d167b9e2f31'

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## 0.12.0
+
+### Enhancements
+* Added 'last' to IPv6
+* Added 'broadcast' to IPv6
+
 ## 0.11.1
 
 ### Bugfix

data/VERSION

@@ -1 +1 @@
-0.11.1
+0.12.0

data/lib/ipaddress_2/ipv6.rb

@@ -246,6 +246,63 @@ module IPAddress;
       to_u128 | @prefix.to_u128 == @prefix.to_u128
     end
 
+    #
+    # Returns a new IPv6 object with the
+    # first host IP address in the range.
+    # 
+    # Example: given the 2001:db8:8:800::/64 network, the first
+    # host IP address is 2001:db8:8:800::
+    #
+    #   ip = IPAddress("2001:db8:8:800::/64")
+    #
+    #   ip.first.to_s
+    #     #=> "2001:db8:8:800::"
+    #
+    # The object IP doesn't need to be a network: the method
+    # automatically gets the network number from it
+    #
+    #   ip = IPAddress("2001:db8:9:800::2/64")
+    #
+    #   ip.first.to_s
+    #     #=> "2001:db8:9:800::"
+    #
+    def first
+      if prefix == 128
+        return self
+      else
+        IPAddress::IPv6::parse_u128(network_u128)
+      end
+    end
+
+    #
+    # Like its sibling method IPv4#first, this method 
+    # returns a new IPv4 object with the 
+    # last host IP address in the range.
+    # 
+    # Example: given the 192.168.100.0/24 network, the last
+    # host IP address is 192.168.100.254
+    #
+    #   ip = IPAddress("2001:db8:8:800::/64")
+    #
+    #   ip.last.to_s
+    #     #=> "2001:db8:8:800:ffff:ffff:ffff:ffff"
+    #
+    # The object IP doesn't need to be a network: the method
+    # automatically gets the network number from it
+    #
+    #   ip = IPAddress("2001:db8:9:800::2/64")
+    #
+    #   ip.last.to_s
+    #     #=> "2001:db8:9:800:ffff:ffff:ffff:ffff"
+    #
+    def last
+      if prefix == 128
+        return self
+      else
+        IPAddress::IPv6::parse_u128(broadcast_u128)
+      end
+    end
+
     #
     # Returns the 16-bits value specified by index
     #
@@ -771,6 +828,23 @@ module IPAddress;
       self.class.parse_u128(network_u128, @prefix)
     end
 
+    #
+    # Returns the broadcast address for the given IP.
+    # As this is IPv6 it is just the last IP
+    #
+    #   ip = IPAddress("2001:db8:8:800::/64")
+    #
+    #   ip.broadcast.to_s
+    #     #=> "2001:db8:8:800::"
+    #
+    def broadcast
+      if prefix == 128
+        return self
+      else
+        IPAddress::IPv6::parse_u128(broadcast_u128)
+      end
+    end
+
     #
     # Extract 16 bits groups from a string
     #

data/lib/ipaddress_2/version.rb

@@ -1,3 +1,3 @@
 module IPAddress
-  VERSION = "0.11.1"
+  VERSION = "0.12.0"
 end

data/test/ipaddress_2/ipv6_test.rb

@@ -128,6 +128,36 @@ class IPv6Test < Minitest::Test
     assert_equal bits, @ip.bits
   end
 
+  def test_method_first
+    ip = @klass.new("2001:db8:8:800::/64")
+    assert_instance_of @klass, ip.first
+    assert_equal "2001:db8:8:800::", ip.first.to_s
+    ip = @klass.new("2001:db8:8::/48")
+    assert_instance_of @klass, ip.first
+    assert_equal "2001:db8:8::", ip.first.to_s
+    ip = @klass.new("2001:db8::/32")
+    assert_instance_of @klass, ip.first
+    assert_equal "2001:db8::", ip.first.to_s
+    ip = @klass.new("2001:db8::8:800:200c:417a/64")
+    assert_instance_of @klass, ip.first
+    assert_equal "2001:db8::", ip.first.to_s
+  end
+
+  def test_method_last
+    ip = @klass.new("2001:db8:8:800::/64")
+    assert_instance_of @klass, ip.last
+    assert_equal  "2001:db8:8:800:ffff:ffff:ffff:ffff", ip.last.to_s
+    ip = @klass.new("2001:db8:8::/48")
+    assert_instance_of @klass, ip.last
+    assert_equal "2001:db8:8:ffff:ffff:ffff:ffff:ffff", ip.last.to_s
+    ip = @klass.new("2001:db8::/32")
+    assert_instance_of @klass, ip.last
+    assert_equal "2001:db8:ffff:ffff:ffff:ffff:ffff:ffff", ip.last.to_s
+    ip = @klass.new("2001:db8::8:800:200c:417a/64")
+    assert_instance_of @klass, ip.last
+    assert_equal  "2001:db8::ffff:ffff:ffff:ffff", ip.last.to_s
+  end
+
   def test_method_prefix=()
     ip = @klass.new "2001:db8::8:800:200c:417a"
     assert_equal 128, ip.prefix
@@ -399,6 +429,21 @@ class IPv6Test < Minitest::Test
     end
   end
 
+  def test_method_broadcast
+    ip = @klass.new("2001:db8:8:800::/64")
+    assert_instance_of @klass, ip.broadcast
+    assert_equal  "2001:db8:8:800:ffff:ffff:ffff:ffff", ip.broadcast.to_s
+    ip = @klass.new("2001:db8:8::/48")
+    assert_instance_of @klass, ip.broadcast
+    assert_equal "2001:db8:8:ffff:ffff:ffff:ffff:ffff", ip.broadcast.to_s
+    ip = @klass.new("2001:db8::/32")
+    assert_instance_of @klass, ip.broadcast
+    assert_equal "2001:db8:ffff:ffff:ffff:ffff:ffff:ffff", ip.broadcast.to_s
+    ip = @klass.new("2001:db8::8:800:200c:417a/64")
+    assert_instance_of @klass, ip.broadcast
+    assert_equal  "2001:db8::ffff:ffff:ffff:ffff", ip.broadcast.to_s
+  end
+
   def test_method_network
     @networks.each do |addr,net|
       ip = @klass.new addr

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ipaddress_2
 version: !ruby/object:Gem::Version
-  version: 0.11.1
+  version: 0.12.0
 platform: ruby
 authors:
 - bluemonk
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-22 00:00:00.000000000 Z
+date: 2019-02-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler