rspec-networking 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c23ab357e131d559918e6f06633477b8b7a6db590f90a13ab8337b53a2d2f1d3
-  data.tar.gz: 3de02a615ac9a9f49af41e648de4bd8782d2d702b753e9d29c0b7f477e28c92b
+  metadata.gz: e3bbe53912eef445cf379232b5bfeb54f5f4b08ac5b1a512d097284ad9f92082
+  data.tar.gz: 8f53cbeb1fe4b9329204c92062d14f0d59028d9a15e7b18e1921f1fd069f5836
 SHA512:
-  metadata.gz: a40ebea318ce0a503558b3e62bc26e907d1f2da926ccb3b90ba78c2a86922fa43aca0cfe072be5853cb194e13ce6687f232dc07d444bde3dcdc48f2061e67255
-  data.tar.gz: d6802ad3a46dda23b9a7908657ab4d822b1dd994d50225f5b0c6f8f0edc1afc188eead8ab18fc9e0b5cd8da334171449e41f4d6ddc36c7f5c59a47232436ae2e
+  metadata.gz: 8038d82b745d89a9ad1c24f39275cdf1c20e1ec2416b0ffdc16ad03d06cccb4e6aa58d98da7f9b55474b4ea265a28bd1feac7737ca775855c01d29e6afcf56e9
+  data.tar.gz: d806849ad84301e317f7d080aaaef62d0f1998c2570588b6168c41558b9247504cd2c9913ffebecd387c2b333053384eaa2b7f3f67b0d878289ff4dab23584df

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+###  0.1.1  (2026-11-01)
+- Manufacturer lookups use fresh IEEE data. Texas Instruments never matched, and OUIs with leading zeros (e.g. Microsoft 00:22:48) were missing.
+- MAC addresses must match the whole string; a multi-line string no longer matches.
+- `MMM.MMM.SSS.SSS` is no longer a MAC address (it matched IPv4 strings); Cisco `MMMM.MMSS.SSSS` is. Use colons or dashes with `.from` and `.for`.
+- 64-bit MAC addresses accept dashes.
+- MAC failure messages show `nil` as `nil`, and read "to be a MAC address".
+- CIDR ranges like `10.0.0.0/8` are no longer IP addresses.
+- IP failure messages show `nil` as `nil`.
+
 ###  0.1.0  (2024-08-31)
 - ip address
 - mac addresses

data/Gemfile.lock

@@ -1,49 +1,76 @@
 PATH
   remote: .
   specs:
-    rspec-networking (0.1.0)
+    rspec-networking (0.1.1)
       rspec-expectations (>= 3)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    byebug (11.1.3)
-    concurrent-ruby (1.3.4)
-    diff-lcs (1.5.1)
-    docile (1.4.0)
-    faker (3.4.2)
+    cgi (0.5.1)
+    concurrent-ruby (1.3.7)
+    date (3.5.1)
+    debug (1.11.1)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    erb (4.0.4.1)
+      cgi (>= 0.3.3)
+    faker (3.5.3)
       i18n (>= 1.8.11, < 2)
-    i18n (1.14.5)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
-    rspec (3.13.0)
+    io-console (0.8.2)
+    irb (1.17.0)
+      pp (>= 0.6.0)
+      prism (>= 1.3.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.9.0)
+    psych (5.3.1)
+      date
+      stringio
+    rdoc (7.2.0)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.0)
+    rspec-mocks (3.13.8)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
+    rspec-support (3.13.7)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.12.3)
+    simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
+    stringio (3.2.0)
+    tsort (0.2.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  byebug
+  debug
   faker
   rspec
   rspec-networking!
   simplecov
 
 BUNDLED WITH
-   2.5.7
+  4.0.16

data/README.md

@@ -17,10 +17,13 @@ gem install rspec-networking
 ```ruby
 require "rspec/networking"
 
+
+###  match an IP address  ###
 expect(obj).to be_an_ip_address
 
 # check version
 expect(obj).to be_an_ip_address.v4
+expect(obj).to be_an_ip_address.v6
 
 # check for localhost
 expect(obj).to be_an_ip_address.localhost
@@ -31,14 +34,18 @@ expect(data).to include(addr: an_ip_address)
 
 
 ###  match a MAC address  ###
+# 00:11:22:33:44:55, 00-11-22-33-44-55, 0011.2233.4455, or EUI-64
 expect(obj).to be_a_mac_address
 
+expect(obj).to be_a_mac_address.bits(48)
+
 expect(obj).to be_a_mac_address.broadcast
 expect(obj).to be_a_mac_address.multicast
 expect(obj).to be_a_mac_address.unicast
 
 # check manufacturer or specific device
 expect(obj).to be_a_mac_address.from("xerox")
+expect(obj).to be_a_mac_address.from("00:00:0C")
 expect(obj).to be_a_mac_address.for(device)
 
 # compose with other matchers
@@ -63,3 +70,5 @@ Yes please  :)
 1. Commit your changes (`git commit -am 'awesome new feature'`)
 1. Push your branch (`git push origin my-feature`)
 1. Create a Pull Request
+
+Manufacturer OUIs come from the [IEEE registry](https://standards-oui.ieee.org/); refresh them with `script/update_manufacturers`.

data/lib/rspec/networking/ip_address.rb

@@ -14,41 +14,29 @@ RSpec::Matchers.define :be_an_ip_address do
   end
 
   match do |actual|
-    @actual = actual
-
     return false unless actual.is_a?(String) || actual.is_a?(IPAddr)
 
     addr = actual.is_a?(IPAddr) ? actual : IPAddr.new(actual)
 
-    if @version
-      return false unless @version == 4 ? addr.ipv4? : addr.ipv6?
-    end
+    # IPAddr also parses CIDR ranges, eg. "10.0.0.0/8"
+    return false unless addr.prefix == (addr.ipv4? ? 32 : 128)
 
-    if @localhost
-      return false unless addr.loopback?
-    end
+    return false if @version == 4 && !addr.ipv4?
+    return false if @version == 6 && !addr.ipv6?
+    return false if @localhost && !addr.loopback?
 
     true
-  rescue IPAddr::InvalidAddressError
+  rescue IPAddr::Error
     false
   end
 
   description do
     if @version
-      addr = @localhost ? "localhost " : "address"
-      "an IPv#{@version} #{addr}"
+      "be an IPv#{@version} #{"localhost " if @localhost}address"
     else
-      @localhost ? "a localhost" : "an IP address"
+      @localhost ? "be a localhost address" : "be an IP address"
     end
   end
-
-  failure_message do
-    "expected '#{@actual}' to be #{description}"
-  end
-
-  failure_message_when_negated do
-    "expected '#{@actual}' not to be #{description}"
-  end
 end
 
-RSpec::Matchers.alias_matcher :an_ip_address, :be_an_ip_address
+RSpec::Matchers.alias_matcher(:an_ip_address, :be_an_ip_address) { |desc| desc.delete_prefix("be ") }