rspec-networking 0.0.1 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27e1529533844c6f359735dc609ecb1a937762787f2c609a147d4a30bdb700ee
-  data.tar.gz: 9c6856542b1477181e7b5ee82c39525e5295ed145e1a6edeaadfbd8feac6b500
+  metadata.gz: e3bbe53912eef445cf379232b5bfeb54f5f4b08ac5b1a512d097284ad9f92082
+  data.tar.gz: 8f53cbeb1fe4b9329204c92062d14f0d59028d9a15e7b18e1921f1fd069f5836
 SHA512:
-  metadata.gz: 0eb7ec667852a07380d2bc2344c04a175066b03ad86bfc5630f3b45f692555947e6ad02a505200fb73e76b0ff801214a684f19b2697baecf9bc52e941da5a326
-  data.tar.gz: 3a2521fe2955a92542c82e322d0f82eb602f8967aaf208e814f303586fd6de72cb42680b8f6df59dd3fa77fedceda74ce3292e656922e012c9f96ba40275a68e
+  metadata.gz: 8038d82b745d89a9ad1c24f39275cdf1c20e1ec2416b0ffdc16ad03d06cccb4e6aa58d98da7f9b55474b4ea265a28bd1feac7737ca775855c01d29e6afcf56e9
+  data.tar.gz: d806849ad84301e317f7d080aaaef62d0f1998c2570588b6168c41558b9247504cd2c9913ffebecd387c2b333053384eaa2b7f3f67b0d878289ff4dab23584df

data/CHANGELOG.md

@@ -1,2 +1,16 @@
+###  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
+- manufacturers
+
 ###  0.0.1  (2024-08-30)
 init

data/Gemfile.lock

@@ -1,49 +1,76 @@
 PATH
   remote: .
   specs:
-    rspec-networking (0.0.1)
+    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

@@ -6,11 +6,59 @@ RSpec::Networking
 RSpec matchers for IP and MAC Addresses
 
 
+### Install
+```bash
+gem install rspec-networking
+```
+
+
+### Usage
+
 ```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
+
+# compose with other matchers
+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
+expect(data).to include(addr: a_mac_address)
 ```
 
 
+### Resources
+- https://en.wikipedia.org/wiki/IP_address
+- https://en.wikipedia.org/wiki/MAC_address
+- https://www.lifewire.com/introduction-to-mac-addresses-817937
+
+
 ----
 ## Contributing
 
@@ -22,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

@@ -0,0 +1,42 @@
+require "ipaddr"
+
+RSpec::Matchers.define :be_an_ip_address do
+  chain :v4 do
+    @version = 4
+  end
+
+  chain :v6 do
+    @version = 6
+  end
+
+  chain :localhost do
+    @localhost = true
+  end
+
+  match do |actual|
+    return false unless actual.is_a?(String) || actual.is_a?(IPAddr)
+
+    addr = actual.is_a?(IPAddr) ? actual : IPAddr.new(actual)
+
+    # IPAddr also parses CIDR ranges, eg. "10.0.0.0/8"
+    return false unless addr.prefix == (addr.ipv4? ? 32 : 128)
+
+    return false if @version == 4 && !addr.ipv4?
+    return false if @version == 6 && !addr.ipv6?
+    return false if @localhost && !addr.loopback?
+
+    true
+  rescue IPAddr::Error
+    false
+  end
+
+  description do
+    if @version
+      "be an IPv#{@version} #{"localhost " if @localhost}address"
+    else
+      @localhost ? "be a localhost address" : "be an IP address"
+    end
+  end
+end
+
+RSpec::Matchers.alias_matcher(:an_ip_address, :be_an_ip_address) { |desc| desc.delete_prefix("be ") }