macos.rb 0.50.0

data/test/MacOS/Users_test.rb

@@ -0,0 +1,10 @@
+require_relative '../helper'
+require 'MacOS/Users'
+
+describe MacOS::Users do
+  it "lists the real users, without the system and service accounts" do
+    MacOS::Users.stub(:`, fixture('dscl-list-users.txt')) do
+      _(MacOS::Users.all).must_equal(%w{another example})
+    end
+  end
+end

data/test/MacOS/VPN_test.rb

@@ -0,0 +1,18 @@
+require_relative '../helper'
+require 'MacOS/IfConfig'
+require 'MacOS/VPN'
+
+describe MacOS::VPN do
+  it "is up where a tunnel interface is up" do
+    MacOS::IfConfig.stub(:output, fixture('ifconfig-a.txt')) do
+      _(MacOS::VPN.up?.interface).must_equal('utun4')
+    end
+  end
+
+  it "isn't where no tunnel interface has an address" do
+    without_tunnel = fixture('ifconfig-a.txt').sub(/^\tinet 198\.51\.100\.250 .+\n/, '')
+    MacOS::IfConfig.stub(:output, without_tunnel) do
+      _(MacOS::VPN.up?).must_be_nil
+    end
+  end
+end

data/test/MacOS/Voice_test.rb

@@ -0,0 +1,46 @@
+require_relative '../helper'
+require 'MacOS/Voice'
+
+describe MacOS::Voice do
+  def with_voices(&block)
+    MacOS::Voice.stub(:`, fixture('say-v.txt'), &block)
+  end
+
+  def voice(name)
+    MacOS::Voice.list.find{|voice| voice.name == name}
+  end
+
+  it "makes one for each voice say knows" do
+    with_voices do
+      _(MacOS::Voice.all.size).must_equal(8)
+      _(MacOS::Voice.list.map(&:name)).must_include('Albert')
+    end
+  end
+
+  it "reads a voice's name, localisation and description" do
+    with_voices do
+      albert = voice('Albert')
+      _(albert.localization).must_equal('en_US')
+      _(albert.description).must_equal('Hello! My name is Albert.')
+    end
+  end
+
+  it "reads a name with spaces in it whole" do
+    with_voices do
+      _(voice('Bad News').localization).must_equal('en_US')
+      _(voice('Eddy (English (UK))').localization).must_equal('en_GB')
+    end
+  end
+
+  it "gives a description without its newline" do
+    with_voices do
+      _(MacOS::Voice.list.none?{|voice| voice.description.end_with?("\n")}).must_equal(true)
+    end
+  end
+
+  it "picks a voice at random from those say knows" do
+    with_voices do
+      _(MacOS::Voice.list.map(&:name)).must_include(MacOS::Voice.random_voice.name)
+    end
+  end
+end

data/test/MacOS_test.rb

@@ -0,0 +1,17 @@
+require_relative './helper'
+require 'MacOS'
+
+describe MacOS do
+  it "loads every library" do
+    %w{
+      Apple80211 Applications Defaults Defaults::ComAppleDock Defaults::NSGlobalDomain::NSUserKeyEquivalents DiskUtil Dmg
+      HardwarePort IfConfig Keychain LaunchControl SystemProfiler USBFlashDrive Users VERSION VPN Voice
+    }.each{|name| _(MacOS.const_get(name)).wont_be_nil}
+  end
+
+  it "gives the system's version" do
+    MacOS::SystemProfiler.stub(:system_profiler_output, fixture('system_profiler-SPSoftwareDataType.txt')) do
+      _(MacOS.version.to_s).must_equal('15.8.1')
+    end
+  end
+end

data/test/VERSION_test.rb

@@ -0,0 +1,19 @@
+require_relative './helper'
+require 'MacOS/VERSION'
+
+describe MacOS do
+  describe "VERSION" do
+    it "is a string" do
+      _(MacOS::VERSION).must_be_instance_of String
+    end
+
+    it "is three numbers separated by dots" do
+      _(MacOS::VERSION).must_match(/\A\d+\.\d+\.\d+\z/)
+    end
+
+    it "matches the newest entry in the CHANGELOG" do
+      changelog = File.read(File.expand_path('../CHANGELOG', __dir__))
+      _(changelog[/^(\d+\.\d+\.\d+):/, 1]).must_equal(MacOS::VERSION)
+    end
+  end
+end

data/test/commands_test.rb

@@ -0,0 +1,50 @@
+require_relative './helper'
+require 'open3'
+require 'MacOS'
+
+# The command each library sends, caught before it reaches the shell, so as none runs.
+describe "the commands" do
+  def sent_by(receiver, method, *args)
+    sent = []
+    receiver.stub(:`, ->(command){sent << command; ''}){receiver.send(method, *args)}
+    sent
+  end
+
+  def captured_by(receiver, method, *args)
+    sent = []
+    Open3.stub(:capture3, ->(command){sent << command; ['', '', nil]}){receiver.send(method, *args)}
+    sent
+  end
+
+  it "lists the hardware ports with networksetup" do
+    _(sent_by(MacOS::HardwarePort, :output)).must_equal(['networksetup -listallhardwareports'])
+  end
+
+  it "lists the interfaces with ifconfig" do
+    _(sent_by(MacOS::IfConfig, :output)).must_equal(['ifconfig -a'])
+  end
+
+  it "reads the software overview with system_profiler" do
+    _(sent_by(MacOS::SystemProfiler, :system_profiler_output)).must_equal(['system_profiler SPSoftwareDataType'])
+  end
+
+  it "reads the Wi-Fi connection with system_profiler" do
+    _(sent_by(MacOS::Apple80211, :system_profiler_airport)).must_equal(['system_profiler SPAirPortDataType'])
+  end
+
+  it "reads the Wi-Fi connection with airport, where it's there" do
+    _(sent_by(MacOS::Apple80211, :airport_i)).must_equal(['/System/Library/PrivateFrameworks/Apple80211.framework/Resources/airport -I'])
+  end
+
+  it "lists the disks with diskutil" do
+    _(sent_by(MacOS::DiskUtil, :xml_volume_plist)).must_equal(['diskutil list -plist'])
+  end
+
+  it "asks security for a generic password" do
+    _(captured_by(MacOS::Keychain, :find_generic_password, 'ExampleNet')).must_equal(['security find-generic-password -ga ExampleNet'])
+  end
+
+  it "asks system_profiler for the USB devices" do
+    _(captured_by(MacOS::USBFlashDrive, :raw_system_profiler_output)).must_equal(['system_profiler SPUSBDataType'])
+  end
+end

data/test/fixtures/airport-I-deprecated.txt

@@ -0,0 +1,2 @@
+WARNING: The airport command line tool is deprecated and will be removed in a future release.
+For diagnosing Wi-Fi related issues, use the Wireless Diagnostics app or wdutil command line tool.

data/test/fixtures/airport-I.txt

@@ -0,0 +1,17 @@
+     agrCtlRSSI: -52
+     agrExtRSSI: 0
+    agrCtlNoise: -94
+    agrExtNoise: 0
+          state: running
+        op mode: station
+     lastTxRate: 573
+        maxRate: 1201
+lastAssocStatus: 0
+    802.11 auth: open
+      link auth: wpa2-psk
+          BSSID: 00:00:5e:00:53:20
+           SSID: ExampleNet
+            MCS: 9
+  guardInterval: 800
+            NSS: 2
+        channel: 36,80

data/test/fixtures/defaults-domains.txt

@@ -0,0 +1 @@
+com.apple.dock, com.apple.finder, com.apple.Safari

data/test/fixtures/defaults-export-com.apple.dock.xml

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>autohide</key>
+	<true/>
+	<key>magnification</key>
+	<false/>
+	<key>mineffect</key>
+	<string>scale</string>
+	<key>orientation</key>
+	<string>bottom</string>
+	<key>persistent-apps</key>
+	<array>
+		<dict>
+			<key>tile-data</key>
+			<dict>
+				<key>file-data</key>
+				<dict>
+					<key>_CFURLString</key>
+					<string>file:///System/Applications/Mail.app/</string>
+					<key>_CFURLStringType</key>
+					<integer>15</integer>
+				</dict>
+			</dict>
+		</dict>
+		<dict>
+			<key>tile-data</key>
+			<dict>
+				<key>file-data</key>
+				<dict>
+					<key>_CFURLString</key>
+					<string>file:///Users/example/Applications/Example%20App.app/</string>
+					<key>_CFURLStringType</key>
+					<integer>15</integer>
+				</dict>
+			</dict>
+		</dict>
+	</array>
+	<key>persistent-others</key>
+	<array/>
+	<key>recent-apps</key>
+	<array/>
+	<key>tilesize</key>
+	<integer>48</integer>
+</dict>
+</plist>

data/test/fixtures/defaults-read-NSUserKeyEquivalents.txt

@@ -0,0 +1,4 @@
+{
+    "Find Previous" = "@$d";
+    "Previous Tab" = "@~\\UF702";
+}

data/test/fixtures/df-k.txt

@@ -0,0 +1,6 @@
+Filesystem     1024-blocks      Used Available Capacity iused      ifree %iused  Mounted on
+/dev/disk3s1s1   971350180  11000992 512000000     3%  425829 4291815364    0%   /
+devfs                  211       211         0   100%     730          0  100%   /dev
+/dev/disk3s5     971350180 400000000 512000000    44% 1200000 5120000000    0%   /System/Volumes/Data
+/dev/disk4s1      31256576     15552  31241024     1%       1          0  100%   /Volumes/EXAMPLE
+map auto_home            0         0         0   100%       0          0     -   /System/Volumes/Data/home

data/test/fixtures/diskutil-list-plist.xml

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AllDisks</key>
+	<array>
+		<string>disk0</string>
+		<string>disk0s1</string>
+		<string>disk0s2</string>
+		<string>disk3</string>
+		<string>disk4</string>
+		<string>disk4s1</string>
+	</array>
+	<key>AllDisksAndPartitions</key>
+	<array>
+		<dict>
+			<key>Content</key>
+			<string>GUID_partition_scheme</string>
+			<key>DeviceIdentifier</key>
+			<string>disk0</string>
+			<key>OSInternal</key>
+			<true/>
+			<key>Partitions</key>
+			<array>
+				<dict>
+					<key>Content</key>
+					<string>Apple_APFS_ISC</string>
+					<key>DeviceIdentifier</key>
+					<string>disk0s1</string>
+					<key>Size</key>
+					<integer>524288000</integer>
+				</dict>
+				<dict>
+					<key>Content</key>
+					<string>Apple_APFS</string>
+					<key>DeviceIdentifier</key>
+					<string>disk0s2</string>
+					<key>Size</key>
+					<integer>994662584320</integer>
+				</dict>
+			</array>
+			<key>Size</key>
+			<integer>1000555581440</integer>
+		</dict>
+		<dict>
+			<key>APFSVolumes</key>
+			<array>
+				<dict>
+					<key>DeviceIdentifier</key>
+					<string>disk3s1</string>
+					<key>MountPoint</key>
+					<string>/</string>
+					<key>VolumeName</key>
+					<string>Macintosh HD</string>
+				</dict>
+			</array>
+			<key>Content</key>
+			<string></string>
+			<key>DeviceIdentifier</key>
+			<string>disk3</string>
+			<key>Partitions</key>
+			<array/>
+			<key>Size</key>
+			<integer>994662584320</integer>
+		</dict>
+		<dict>
+			<key>Content</key>
+			<string>FDisk_partition_scheme</string>
+			<key>DeviceIdentifier</key>
+			<string>disk4</string>
+			<key>OSInternal</key>
+			<false/>
+			<key>Partitions</key>
+			<array>
+				<dict>
+					<key>Content</key>
+					<string>Windows_FAT_32</string>
+					<key>DeviceIdentifier</key>
+					<string>disk4s1</string>
+					<key>MountPoint</key>
+					<string>/Volumes/EXAMPLE</string>
+					<key>Size</key>
+					<integer>32006733824</integer>
+					<key>VolumeName</key>
+					<string>EXAMPLE</string>
+				</dict>
+			</array>
+			<key>Size</key>
+			<integer>32010928128</integer>
+		</dict>
+	</array>
+	<key>VolumesFromDisks</key>
+	<array>
+		<string>Macintosh HD</string>
+		<string>EXAMPLE</string>
+	</array>
+	<key>WholeDisks</key>
+	<array>
+		<string>disk0</string>
+		<string>disk3</string>
+		<string>disk4</string>
+	</array>
+</dict>
+</plist>

data/test/fixtures/dscl-list-users.txt

@@ -0,0 +1,8 @@
+_amavisd
+_appleevents
+_www
+another
+daemon
+example
+nobody
+root

data/test/fixtures/ifconfig-a.txt

@@ -0,0 +1,53 @@
+lo0: flags=8049<UP,LOOPBACK,RUNNING,MULTICAST> mtu 16384
+	options=1203<RXCSUM,TXCSUM,TXSTATUS,SW_TIMESTAMP>
+	inet 127.0.0.1 netmask 0xff000000
+	inet6 ::1 prefixlen 128 
+	inet6 fe80::1%lo0 prefixlen 64 scopeid 0x1 
+	nd6 options=201<PERFORMNUD,DAD>
+gif0: flags=8010<POINTOPOINT,MULTICAST> mtu 1280
+stf0: flags=0<> mtu 1280
+en1: flags=8963<UP,BROADCAST,SMART,RUNNING,PROMISC,SIMPLEX,MULTICAST> mtu 1500
+	options=460<TSO4,TSO6,CHANNEL_IO>
+	ether 00:00:5e:00:53:01
+	media: autoselect <full-duplex>
+	status: inactive
+en0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+	options=6460<TSO4,TSO6,CHANNEL_IO,PARTIAL_CSUM,ZEROINVERT_CSUM>
+	ether 00:00:5e:00:53:02
+	inet6 fe80::2%en0 prefixlen 64 secured scopeid 0xf 
+	inet 192.0.2.114 netmask 0xffffff00 broadcast 192.0.2.255
+	nd6 options=201<PERFORMNUD,DAD>
+	media: autoselect
+	status: active
+awdl0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+	options=6460<TSO4,TSO6,CHANNEL_IO,PARTIAL_CSUM,ZEROINVERT_CSUM>
+	ether 00:00:5e:00:53:03
+	inet6 fe80::3%awdl0 prefixlen 64 scopeid 0x10 
+	nd6 options=201<PERFORMNUD,DAD>
+	media: autoselect
+	status: active
+bridge0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+	options=63<RXCSUM,TXCSUM,TSO4,TSO6>
+	ether 00:00:5e:00:53:01
+	Configuration:
+		id 0:0:0:0:0:0 priority 0 hellotime 0 fwddelay 0
+		maxage 0 holdcnt 0 proto stp maxaddr 100 timeout 1200
+		root id 0:0:0:0:0:0 priority 0 ifcost 0 port 0
+		ipfilter disabled flags 0x0
+	member: en1 flags=3<LEARNING,DISCOVER>
+	        ifmaxaddr 0 port 10 priority 0 path cost 0
+	member: en2 flags=3<LEARNING,DISCOVER>
+	        ifmaxaddr 0 port 11 priority 0 path cost 0
+	member: en3 flags=3<LEARNING,DISCOVER>
+	        ifmaxaddr 0 port 12 priority 0 path cost 0
+	nd6 options=201<PERFORMNUD,DAD>
+	media: <unknown type>
+	status: inactive
+utun0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1500
+	inet6 fe80::4%utun0 prefixlen 64 scopeid 0x13 
+	nd6 options=201<PERFORMNUD,DAD>
+utun4: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1420
+	inet 198.51.100.250 --> 198.51.100.250 netmask 0xffffffff
+	inet6 fe80::5%utun4 prefixlen 64 scopeid 0x1d 
+	inet6 2001:db8::2 prefixlen 128 
+	nd6 options=201<PERFORMNUD,DAD>

data/test/fixtures/networksetup-listallhardwareports.txt

@@ -0,0 +1,39 @@
+
+Hardware Port: Ethernet Adapter (en4)
+Device: en4
+Ethernet Address: 00:00:5e:00:53:04
+
+Hardware Port: Ethernet Adapter (en5)
+Device: en5
+Ethernet Address: 00:00:5e:00:53:05
+
+Hardware Port: Ethernet Adapter (en6)
+Device: en6
+Ethernet Address: 00:00:5e:00:53:06
+
+Hardware Port: USB 10/100/1000 LAN
+Device: en8
+Ethernet Address: 00:00:5e:00:53:07
+
+Hardware Port: Thunderbolt Bridge
+Device: bridge0
+Ethernet Address: 00:00:5e:00:53:01
+
+Hardware Port: Wi-Fi
+Device: en0
+Ethernet Address: 00:00:5e:00:53:08
+
+Hardware Port: Thunderbolt 1
+Device: en1
+Ethernet Address: 00:00:5e:00:53:01
+
+Hardware Port: Thunderbolt 2
+Device: en2
+Ethernet Address: 00:00:5e:00:53:09
+
+Hardware Port: Thunderbolt 3
+Device: en3
+Ethernet Address: 00:00:5e:00:53:0a
+
+VLAN Configurations
+===================

data/test/fixtures/say-v.txt

@@ -0,0 +1,8 @@
+Albert              en_US    # Hello! My name is Albert.
+Bad News            en_US    # Hello! My name is Bad News.
+Eddy (English (UK)) en_GB    # Hello! My name is Eddy.
+Eddy (English (US)) en_US    # Hello! My name is Eddy.
+Karen               en_AU    # Hi my name is Karen
+Samantha            en_US    # Hello! My name is Samantha.
+Thomas              fr_FR    # Bonjour, je m’appelle Thomas.
+Zarvox              en_US    # Hello! My name is Zarvox.

data/test/fixtures/system_profiler-SPAirPortDataType.txt

@@ -0,0 +1,44 @@
+Wi-Fi:
+
+      Software Versions:
+          CoreWLAN: 16.0 (1657)
+          CoreWLANKit: 16.0 (1657)
+          Menu Extra: 17.0 (1728)
+          System Information: 15.0 (1502)
+          IO80211 Family: 12.0 (1200.13.1)
+          Diagnostics: 11.0 (1163)
+          AirPort Utility: 6.3.9 (639.23)
+      Interfaces:
+        en0:
+          Card Type: Wi-Fi  (0x14E4, 0x4388)
+          MAC Address: 00:00:5e:00:53:02
+          Locale: FCC
+          Country Code: US
+          Supported PHY Modes: 802.11 a/b/g/n/ac/ax
+          Wake On Wireless: Supported
+          AirDrop: Supported
+          Auto Unlock: Supported
+          Status: Connected
+          Current Network Information:
+            <redacted>:
+              PHY Mode: 802.11ax
+              Channel: 36 (5GHz, 80MHz)
+              Country Code: US
+              Network Type: Infrastructure
+              Security: WPA2 Personal
+              Signal / Noise: -52 dBm / -94 dBm
+              Transmit Rate: 573
+              MCS Index: 9
+          Other Local Wi-Fi Networks:
+            <redacted>:
+              PHY Mode: 802.11ac
+              Channel: 149 (5GHz, 80MHz)
+              Network Type: Infrastructure
+              Security: WPA2 Personal
+              Signal / Noise: -70 dBm / -94 dBm
+        awdl0:
+          MAC Address: 00:00:5e:00:53:03
+          Supported Channels: 6 (2GHz), 44 (5GHz), 149 (5GHz)
+          Status: Connected
+          Current Network Information:
+              Network Type: Infrastructure

data/test/fixtures/system_profiler-SPSoftwareDataType.txt

@@ -0,0 +1,14 @@
+Software:
+
+    System Software Overview:
+
+      System Version: macOS 15.8.1 (24H32)
+      Kernel Version: Darwin 24.6.0
+      Boot Volume: Macintosh HD
+      Boot Mode: Normal
+      Computer Name: Example Mac
+      User Name: Example User (example)
+      Secure Virtual Memory: Enabled
+      System Integrity Protection: Enabled
+      Time since boot: 6 days, 2 hours, 34 minutes
+

data/test/fixtures/system_profiler-SPUSBDataType.txt

@@ -0,0 +1,58 @@
+USB:
+
+    USB 3.1 Bus:
+
+      Host Controller Driver: AppleT8112USBXHCI
+
+        Flash Drive:
+
+          Product ID: 0x0001
+          Vendor ID: 0x0000
+          Version: 1.00
+          Serial Number: 0000000000000001
+          Speed: Up to 5 Gb/s
+          Manufacturer: Example
+          Location ID: 0x00100000 / 1
+          Current Available (mA): 900
+          Current Required (mA): 224
+          Extra Operating Current (mA): 0
+          Media:
+            Flash Drive:
+              Capacity: 32.01 GB (32,010,928,128 bytes)
+              Removable Media: Yes
+              BSD Name: disk4
+              Logical Unit: 0
+              Partition Map Type: MBR (Master Boot Record)
+              USB Interface: 0
+              Volumes:
+                EXAMPLE:
+                  Capacity: 32 GB (32,006,733,824 bytes)
+                  Free: 31.99 GB (31,990,808,576 bytes)
+                  Writable: Yes
+                  File System: MS-DOS FAT32
+                  BSD Name: disk4s1
+                  Mount Point: /Volumes/EXAMPLE
+                  Content: Windows_FAT_32
+
+        Flash Drive:
+
+          Product ID: 0x0002
+          Vendor ID: 0x0000
+          Version: 1.00
+          Serial Number: 0000000000000002
+          Speed: Up to 480 Mb/s
+          Manufacturer: Example
+          Location ID: 0x00200000 / 2
+          Media:
+            Flash Drive:
+              Capacity: 8 GB (8,004,304,896 bytes)
+              Removable Media: Yes
+              BSD Name: disk5
+              Volumes:
+                Example 2:
+                  Capacity: 8 GB (8,000,110,592 bytes)
+                  File System: ExFAT
+                  BSD Name: disk5s1
+                  Mount Point: /Volumes/Example 2
+                  Content: Windows_NTFS
+

data/test/gemspec_test.rb

@@ -0,0 +1,50 @@
+require_relative './helper'
+require 'MacOS/VERSION'
+
+describe 'macos.rb.gemspec' do
+  # Loaded and validated from the gem's own directory, as gem build does, so as neither depends on where the tests run.
+  let(:root){File.expand_path('..', __dir__)}
+  let(:spec){Dir.chdir(root){Gem::Specification.load('macos.rb.gemspec')}}
+
+  it "is a valid specification" do
+    _(Dir.chdir(root){spec.validate}).must_equal(true)
+  end
+
+  it "is named macos.rb" do
+    _(spec.name).must_equal('macos.rb')
+  end
+
+  it "does not pin a date" do
+    _(spec.date).must_equal(Gem::Specification.new.date)
+  end
+
+  it "takes its version from MacOS::VERSION" do
+    _(spec.version.to_s).must_equal(MacOS::VERSION)
+  end
+
+  it "declares its runtime dependencies" do
+    _(spec.runtime_dependencies.map(&:name).sort).must_equal(%w{CFPropertyList plist})
+  end
+
+  it "declares its development dependencies" do
+    _(spec.development_dependencies.map(&:name).sort).must_equal(%w{minitest minitest-mock rake})
+  end
+
+  it "ships the gemspec which names it, its Rakefile, and every library" do
+    _(spec.files).must_include('macos.rb.gemspec')
+    _(spec.files).must_include('Rakefile')
+    _(spec.files).must_include('lib/MacOS.rb')
+    _(spec.files).must_include('lib/Version.rb')
+  end
+
+  it "ships the tests with their fixtures" do
+    _(spec.files).must_include('test/helper.rb')
+    _(spec.files).must_include('test/fixtures/ifconfig-a.txt')
+  end
+
+  it "links the homepage and each metadata link to the repository" do
+    links = [spec.homepage] + spec.metadata.values
+    _(spec.metadata.keys.sort).must_equal(%w{bug_tracker_uri changelog_uri documentation_uri source_code_uri})
+    links.each{|link| _(link).must_match(%r{\Ahttps://github\.com/thoran/macos\.rb(/|\z)})}
+  end
+end

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'minitest/autorun'
+require 'minitest/spec'
+require 'minitest/mock'
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+
+# What a command printed, captured with its MAC addresses, IP addresses and names made anonymous.
+def fixture(name)
+  File.read(File.expand_path("fixtures/#{name}", __dir__))
+end
+
+# Runs the block with system stubbed on receiver, returning the commands it was given; each succeeds, setting $?.
+def commands_run_by(receiver)
+  commands = []
+  succeed = ->(*command, **options){commands << command; Kernel.system('true')}
+  receiver.stub(:system, succeed){yield}
+  commands
+end