interfacez 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cd4cdba45bdc3c9ee5f65a733afdab9736e0a99b9f5f6cc56e2bff6e3f22392
-  data.tar.gz: ab510eaabb3e5cada57f4f10a827eb131386acd1335dafff22024bf575a565f9
+  metadata.gz: 59fc474fefa0478ba81ba00f1ce41de6c9cc423c3f8e8296bbd5055a86825a76
+  data.tar.gz: 1da020117eabb38b8f44c5b3f3a0fc5d4c3f16d522d93b2529bcef04cc36865e
 SHA512:
-  metadata.gz: dfb4a1c0c8ead706d0ada9427d695fd18c647a0b181699de62b3964a15a0407dfe1b41cddd7d96147e9986bf6e86a63ed7295c13ccccbb405057dc2983f8e0d9
-  data.tar.gz: 321405b666b65a6c4b377fb8783b73be700ab260307dd9ff217871e1beab4cf029216472b2d46c44ea1944a0e061241bd735787072b181894ee27eafd22692b7
+  metadata.gz: 72c67db1a181fb6259292933559c083b8989053d8ffd9d47f775371890e402d82d9dbdb97a349cdbb5ac741025e486a561ae07c3a11f1a058ec0fd2ecd8a82b9
+  data.tar.gz: ca0754fa026185c20f7d09b243fe218e60bc82a5de3ec0cfa7207cada163b506863c911d86c82229a3c83ae7990a5e140f1f8ee181d9d14640d07743fe0d6115

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    interfacez (1.0.0)
+    interfacez (1.0.1)
 
 GEM
   remote: https://rubygems.org/

data/lib/interfacez/version.rb

@@ -1,3 +1,3 @@
 module Interfacez
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/lib/interfacez.rb

@@ -19,6 +19,25 @@ module Interfacez
     Interfacez.ipv6_loopbacks { |iface| return iface }
   end
 
+  # Check for any (ipv4 or ipv6) loopback interface.
+  def self.loopback?
+    Interfacez.ipv4_loopbacks { |iface| return true }
+    Interfacez.ipv6_loopbacks { |iface| return true }
+    return false
+  end
+
+  # Get all (ipv4 or ipv6) loopback interfaces.
+  def self.loopbacks
+    if block_given?
+      Interfacez.ipv4_loopbacks { |iface| yield iface }
+      Interfacez.ipv6_loopbacks { |iface| yield iface }
+    else
+      loopbacks = []
+      Interfacez.loopbacks { |l| loopbacks << l unless loopbacks.any?(l) }
+      return loopbacks
+    end
+  end
+
   # First available ipv4 loopback interface.
   def self.ipv4_loopback
     Interfacez.ipv4_loopbacks { |iface| return iface }
@@ -26,13 +45,16 @@ module Interfacez
 
   # All ipv4 loopback interfaces.
   def self.ipv4_loopbacks
-    results = []
-    raw_interface_addresses.each do |iface| 
-      next unless iface.addr.ipv4_loopback?
-      yield iface.name if block_given?
-      results << iface.name
+    if block_given?
+      raw_interface_addresses.each do |iface| 
+        next unless iface.addr.ipv4_loopback?
+        yield iface.name if block_given?
+      end
+    else
+      results = []
+      Interfacez.ipv4_loopbacks { |l| results << l }
+      return results 
     end
-    return results
   end
 
   # First available ipv6 loopback interface.
@@ -42,13 +64,16 @@ module Interfacez
 
   # All ipv6 loopback interfaces.
   def self.ipv6_loopbacks
-    results = []
-    raw_interface_addresses.each do |iface| 
-      next unless iface.addr.ipv6_loopback?
-      yield iface.name if block_given?
-      results << iface.name
+    if block_given?
+      raw_interface_addresses.each do |iface| 
+        next unless iface.addr.ipv6_loopback?
+        yield iface.name if block_given?
+      end
+    else
+      results = []
+      Interfacez.ipv4_loopbacks { |l| results << l }
+      return results 
     end
-    return results
   end
 
   # All network interface names available on system. 
@@ -64,7 +89,8 @@ module Interfacez
 
   # Network interfaces with their ipv4 addresses, if they have
   # any asscoited with it.
-  def self.ipv4_addresses
+  def self.ipv4_addresses(interface = nil)
+    return ipv4_addresses_of(interface) unless interface.nil?
     results = Hash.new()
     raw_interface_addresses.each do |iface|
       if iface.addr.ipv4?
@@ -80,9 +106,22 @@ module Interfacez
     return results
   end
 
+  # Return all ipv4 addresses of a given interface.
+  def self.ipv4_address_of(interface)
+    addresses = Interfacez.ipv4_addresses[interface]
+    return nil if addresses.nil?
+    return addresses[0]
+  end
+
+  # Return the first ipv4 address of a given interface.
+  def self.ipv4_addresses_of(interface)
+    return Interfacez.ipv4_addresses[interface] || []
+  end
+
   # Network interfaces with their ipv6 addresses, if they have
   # any asscoited with it.
-  def self.ipv6_addresses
+  def self.ipv6_addresses(interface = nil)
+    return ipv6_addresses_of(interface) unless interface.nil?
     results = Hash.new()
     raw_interface_addresses.each do |iface|
       if iface.addr.ipv6?
@@ -98,6 +137,26 @@ module Interfacez
     return results
   end
 
+  # Return all available ipv6 addreses of a given interface.
+  def self.ipv6_addresses_of(interface)
+    return Interfacez.ipv4_addresses[interface] || []
+  end
+
+  # Return the first ipv6 address of a given interface.
+  def self.ipv6_address_of(interface)
+    addresses = Interfacez.ipv6_addresses_of(interface)
+    return nil if addresses.nil? 
+    return addresses[0]
+  end
+  
+  # Get index of network interface.
+  def self.index_of(interface)
+    raw_interface_addresses.each do |iface|
+      return iface.ifindex if iface.name == iface
+    end
+    return nil
+  end
+
   # :nodoc:
   def self.raw_interface_addresses
     Socket.getifaddrs
@@ -105,4 +164,5 @@ module Interfacez
     warn "Unable to get raw interface address list from Socket class"
     return []
   end
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: interfacez
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Kent 'picat' Gruber
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-04-03 00:00:00.000000000 Z
+date: 2018-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler