macos.rb 0.50.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 50fab311c5e4b448110d69d1c86392f6e5502cf865895ab3f7c753e07c53bab3
+  data.tar.gz: a897572e9f0c3afc517fb2d9b65387281d72895132a018f18d6a3b0e2ffe4194
+SHA512:
+  metadata.gz: 5779e90ab10adb9d07bb35f82557b31d755a4da0ed72d5b0f508281582f382e44ce13534df664b540fb611724c8d3978f3cec5c742c815016c728daa197a7fdd
+  data.tar.gz: 6f028499e2a6c255c289d1e77dc6adaafcd1adea2bf00fd78fb28486a553fabb4dcc7cc1b1d18fec1df08ec0b02ed7c948c5b83aa78c5083e1d6e6387ff86963

data/CHANGELOG

@@ -0,0 +1,572 @@
+# macos.rb/CHANGELOG
+
+## 20261107
+
+0.50.0: The first release as a gem: + gemspec, tests in place of each library's self-run section, README, TODO and ROADMAP.md.
+
+1. + macos.rb.gemspec: macos.rb, for Ruby 2.7 on, depending on CFPropertyList and plist.
+2. + Gemfile, Rakefile.
+3. + LICENSE: MIT, 2013 to 2026.
+4. + README.md, TODO, ROADMAP.md.
+5. + test/helper.rb, test/MacOS_test.rb, test/VERSION_test.rb, test/gemspec_test.rb, test/commands_test.rb for the command each library sends, and a test for each library under test/MacOS.
+6. + test/fixtures: the output each library reads, in the form airport, defaults, df, diskutil, dscl, ifconfig, networksetup, say and system_profiler give it, with every MAC address, IP address and name made anonymous.
+7. - the self-run section of lib/MacOS/Apple80211.rb, Applications.rb, Defaults.rb, Defaults/NSGlobalDomain/NSUserKeyEquivalents.rb, Dmg.rb, HardwarePort.rb, IfConfig.rb, Keychain.rb, SystemProfiler.rb, USBFlashDrive.rb, Users.rb and Voice.rb, the tests taking their place.
+8. ~ lib/MacOS/Apple80211.rb, Keychain.rb, USBFlashDrive.rb: The header's first line names the file, in place of #!/usr/bin/env ruby, which only the self-run section needed.
+9. ~ MacOS::VERSION: /0.49.11/0.50.0/
+
+0.49.11: ~ MacOS::Apple80211: Where airport -I gives nothing, as from macOS 14.4 on, the attributes come from system_profiler SPAirPortDataType.
+
+1. ~ MacOS::Apple80211.attributes: airport -I's, or where it gives none, the current network's from system_profiler SPAirPortDataType, with its Channel and Security as channel and link auth too, and its name as SSID where macOS doesn't redact it.
+2. + MacOS::Apple80211.system_profiler_airport
+3. + MacOS::Apple80211.airport_attributes, private: airport -I's attributes, as .attributes read them before, less the WARNING line printed in their place from macOS 14.4 on.
+4. + MacOS::Apple80211.system_profiler_attributes, private.
+5. ~ MacOS::Apple80211.airport_i: '' where airport isn't there, rather than an Errno::ENOENT.
+6. ~ MacOS::VERSION: /0.49.10/0.49.11/
+
+0.49.10: ~ lib/MacOS/VPN.rb: The header's second line names MacOS::VPN, rather than repeating the file's name.
+
+1. ~ lib/MacOS/VPN.rb: /# MacOS\/VPN.rb/# MacOS::VPN/ in the header's second line.
+2. ~ MacOS::VERSION: /0.49.9/0.49.10/
+
+0.49.9: ~ MacOS::DiskUtil.free_bytes_for_device_id, .free_bytes_for_volume_name: The bytes available, as an Integer, rather than the 512-byte blocks used, as a String.
+
+1. ~ MacOS::DiskUtil.free_bytes_for_device_id, .free_bytes_for_volume_name: `df -k`, in place of `df`, and its Available column times 1024, in place of its Used column.
+2. ~ MacOS::VERSION: /0.49.8/0.49.9/
+
+0.49.8: + require 'yaml' in MacOS::Defaults::ComAppleDock and MacOS::Defaults::NSGlobalDomain::NSUserKeyEquivalents, and require 'set' in the latter, so as each works loaded on its own.
+
+1. ~ lib/MacOS/Defaults/ComAppleDock.rb: + require 'yaml'. Loaded without lib/MacOS/Defaults.rb, ComAppleDock.to_yaml raised a NameError.
+2. ~ lib/MacOS/Defaults/NSGlobalDomain/NSUserKeyEquivalents.rb: + require 'set', 'yaml'. Loaded on its own, NSUserKeyEquivalents.to_yaml raised a NameError, and .read_keys did on Rubies before 3.2.
+3. ~ MacOS::VERSION: /0.49.7/0.49.8/
+
+0.49.7: ~ MacOS::SystemProfiler: Its aliases work on the module, and boot_mode gives the boot mode rather than the boot volume.
+
+1. ~ MacOS::SystemProfiler: + module_function for every alias, from boot_volume_string to time_since_boot. alias_method makes instance methods alone, so MacOS::SystemProfiler.computer_name and the rest raised a NoMethodError.
+2. ~ MacOS::SystemProfiler.boot_mode, .boot_mode_string: Aliases of boot_mode_data, in place of boot_volume_data.
+3. ~ MacOS::VERSION: /0.49.6/0.49.7/
+
+0.49.6: ~ MacOS::Keychain.wifi_password: nil where the keychain has no password for the network, rather than a NoMethodError.
+
+1. ~ MacOS::Keychain.wifi_password: stderr[/password: "(.+)"/, 1], in place of stderr.match(/password: "(.+)"/)[1], which called [] on nil when nothing matched.
+2. ~ MacOS::VERSION: /0.49.5/0.49.6/
+
+0.49.5: ~ MacOS::LaunchControl: An instance holds the plist it's made with, and unloads it.
+
+1. ~ MacOS::LaunchControl#initialize: /init/initialize/. As init, new(path_to_plist) raised an ArgumentError and new left the path unset.
+2. ~ MacOS::LaunchControl#unload: path_to_plist defaults to the instance's own, as #load uses.
+3. ~ MacOS::LaunchControl.load, .unload: The plist's path escaped for the shell, so as a path with a space in it is one argument; + require 'shellwords'.
+4. ~ MacOS::VERSION: /0.49.4/0.49.5/
+
+0.49.4: ~ MacOS::Defaults: Every domain, rather than one; a Defaults for each, rather than an ArgumentError; and from_yaml writes what to_yaml wrote.
+
+1. ~ MacOS::Defaults.domains: `defaults domains`.chomp.split(', '), in place of .split('\n'), which split on a backslash and an n. defaults domains gives every domain on one line, separated by commas.
+2. ~ MacOS::Defaults.all, .bulk_export_to_plist_files, .bulk_import_from_plist_files, .from_yaml: new(domain: domain), in place of new(domain), initialize taking domain: only.
+3. ~ MacOS::Defaults.from_yaml: DEFAULT_YAML_FILENAME, in place of DEFAULT_YAML_FILE, which isn't defined.
+4. ~ MacOS::Defaults#from_yaml: + attributes, the list of single key: value pairs to_yaml writes for the domain, each written with defaults write; true where every write succeeds. It read an attributes it was never given.
+5. ~ MacOS::Defaults.from_yaml: Each domain's attributes passed on to #from_yaml.
+6. + MacOS::Defaults#defaults_arguments, private: a value as defaults write takes it, with -bool, -int, -float, -array, -dict or -string as its type.
+7. ~ MacOS::VERSION: /0.49.3/0.49.4/
+
+0.49.3: Core Ruby in place of the extension libraries other than Version, each of which patched a core class of any program loading macos.rb.
+
+1. ~ MacOS::Applications.start: system('open', path, exception: true), in place of Kernel.run.
+2. ~ MacOS::Applications: alias_method for launch, open and run, in place of alias_methods; - require 'Kernel/run', 'Module/alias_methods'.
+3. ~ MacOS::Dmg: alias_method for filename, dmg_filename and image_name, and their writers, in place of alias_methods; - require 'Array/all_but_last', which nothing used, and 'Module/alias_methods'.
+4. ~ MacOS::HardwarePort.parse: line.match(...)&.captures, in place of line.captures(...); - require 'Thoran/String/Captures/captures'.
+5. ~ MacOS::IfConfig.parse: line[..., 1] and line.match(...)&.captures, in place of line.capture and line.captures.
+6. ~ MacOS::IfConfig.all_matching: Regexp.union(pattern), in place of pattern.to_regexp; a String is still matched literally.
+7. ~ MacOS::IfConfig.bring_down_interface, .destroy_interface: system(..., exception: true), in place of run.
+8. ~ lib/MacOS/IfConfig.rb: - require 'Kernel/run', 'Regexp/to_regexp', 'String/to_regexp', 'Thoran/String/Capture/capture', 'Thoran/String/Captures/captures'.
+9. ~ MacOS::SystemProfiler: + .field, private, giving a field's value with system_profiler_output[/<name>: (?<value>.+)$/, :value], in place of grep and split in each of the nine; split[1] and split[3], in place of second and fourth; - require 'Ordinal/Array', 'String/grep'.
+10. ~ MacOS::Defaults::NSGlobalDomain::NSUserKeyEquivalents.read_keys: plist_dict.lines.grep(/=/), in place of String#grep; - require 'String/grep'.
+11. - lib/Kernel/run.rb: Kernel#run 0.3.1
+12. - lib/Regexp/to_regexp.rb: Regexp#to_regexp 0.0.0
+13. - lib/String/grep.rb: String#grep 0.2.0
+14. - lib/String/to_regexp.rb: String#to_regexp 0.3.0
+15. - lib/Thoran/String/Captures/captures.rb: Thoran::String::Captures#captures 0.3.0
+16. ~ MacOS::VERSION: /0.49.2/0.49.3/
+
+0.49.2: ~ MacOS::USBFlashDrive.all_mount_points: Every mount point, rather than the first.
+
+1. ~ MacOS::USBFlashDrive.all_mount_points: stdout.scan(/Mount Point: (.+)$/).flatten, in place of stdout.captures(/Mount Point: (.+)$/), which gives the groups of the first match only.
+2. ~ lib/MacOS/USBFlashDrive.rb: - require 'Thoran/String/Captures/captures', which nothing in it uses now.
+3. ~ MacOS::VERSION: /0.49.1/0.49.2/
+
+0.49.1: ~ MacOS::IfConfig.parse: Each call starts afresh, and reads its lines with or without a trailing space; MacOS::IfConfig.output is private again.
+
+1. ~ MacOS::IfConfig.parse: ifconfigs and ifconfig are locals, in place of @ifconfigs and @ifconfig on the class. @ifconfig was never reset, so every call after the first began with the previous call's last interface, and returned it twice.
+2. ~ MacOS::IfConfig.parse: - the unused local interface.
+3. ~ MacOS::IfConfig.parse: Output with no interfaces gives [], rather than [nil].
+4. ~ MacOS::IfConfig.parse: / *ether (.+?) ?$/, in place of / *ether (.+) $/. ifconfig no longer ends these lines with a space, so no interface had a MAC address.
+5. ~ MacOS::IfConfig.parse: / *inet (\d+(?:\.\d+){3}) netmask (.+?) ?$/, in place of one ending (.+) $/. Nor does it end an inet line without a broadcast address with one, so loopback had no IPv4 address.
+6. ~ MacOS::IfConfig.output: private, as it was until IfConfig 0.6.1 commented the line out.
+7. ~ MacOS::VERSION: /0.49.0/0.49.1/
+
+0.49.0: + lib/MacOS/VERSION.rb; - each file's own date, version and changes from its header; + CHANGELOG.
+
+1. + lib/MacOS/VERSION.rb: MacOS::VERSION, the library's version.
+2. ~ lib/MacOS.rb: + require 'MacOS/VERSION'
+3. ~ lib/MacOS.rb and every file under lib/MacOS: - the date and version lines and the changes noted since the last version, the library's version and the CHANGELOG taking their place.
+4. + CHANGELOG: an entry for every version from 0.0.0, each what its commit says.
+
+0.48.0: MacOS 0.1.0: Require every library; + MacOS.version, in place of lib/MacOS/Version.rb.
+
+1. + require 'MacOS/Apple80211', 'MacOS/Applications', 'MacOS/Defaults/ComAppleDock', 'MacOS/Defaults/NSGlobalDomain/NSUserKeyEquivalents', 'MacOS/DiskUtil', 'MacOS/Keychain', 'MacOS/USBFlashDrive', 'MacOS/Users', 'MacOS/Voice' and 'MacOS/VPN'.
+2. - require 'MacOS/Version'
+3. + MacOS.version, taken from lib/MacOS/Version.rb 0.1.0.
+4. - lib/MacOS/Version.rb, and with it MacOS::VERSION::STRING, which MacOS.version.to_s gives.
+
+0.47.2: /module Defaults/class Defaults/ for ComAppleDock and NSUserKeyEquivalents, so as they load beside MacOS::Defaults, which is a class.
+
+1. ~ MacOS::Defaults::ComAppleDock 0.5.3: /module Defaults/class Defaults/
+2. ~ MacOS::Defaults::NSGlobalDomain::NSUserKeyEquivalents 0.2.1: /module Defaults/class Defaults/
+
+0.47.1: MacOS::Voice 0.0.1: Quote say's ?; read names with spaces in them whole; - the newline at the end of each description.
+
+1. ~ all(): say -v '?', the shell otherwise matching ? against one-character filenames.
+2. ~ new_from_line(): A name with spaces in it, as Bad News, is read whole, rather than its first word being taken as the name and its second as the localisation.
+3. ~ new_from_line(): - the newline at the end of the description.
+
+0.47.0: MacOS::Voice 0.0.0: + MacOS::Voice: the voices say knows, each with its name, localisation and description, and a random one, taken from Kernel/say.rb 0.4.2.
+
+1. ~ lib/Kernel/run.rb: Kernel#run /0.3.0/0.3.1/
+
+
+## 20260605
+
+0.46.0: MacOS::Applications 0.0.0: + MacOS::Applications: finding installed .app bundles across the system, local and user domains, as which does for executables.
+
+0.45.0: MacOS::Users 0.0.0: + MacOS::Users: the real user accounts, without the system and service ones.
+
+1. - lib/Array/extract_optionsX.rb: Array#extract_options! 0.2.0
+2. ~ lib/Kernel/run.rb: Kernel#run /0.1.5/0.3.0/
+3. - lib/Thoran/Array/ExtractOptionsX/extract_optionsX.rb: Thoran::Array::ExtractOptions#extract_options! 0.2.0
+
+
+## 20260125
+
+0.44.0: MacOS::IfConfig 0.7.0: Virtual and tunnel interfaces (utun and the like), bringing interfaces down and destroying them, and finding interfaces by pattern.
+
+1. + require 'Kernel/run'
+2. + require 'Regexp/to_regexp'
+3. + require 'String/to_regexp'
+4. ~ parse(): Parse flags from interface header line to support virtual interfaces.
+5. + alias_method :all_interfaces, :parse
+6. + all_matching(pattern): Find all interfaces matching a pattern.
+7. + bring_down_interface(interface_name): Bring down a specific interface.
+8. + bring_down_matching_interfaces(pattern): Bring down all interfaces matching a pattern.
+9. + destroy_interface(interface_name): Destroy a specific interface.
+10. + attr_accessor :flags
+11. ~ initialize(): Add flags parameter.
+12. ~ up?(): Check both physical (status-based) and virtual (flags-based) interfaces.
+13. + virtual?(): Detect if interface is virtual/tunnel interface.
+14. + lib/Array/extract_optionsX.rb: Array#extract_options! 0.2.0
+15. + lib/Kernel/run.rb: Kernel#run 0.1.5
+16. + lib/Regexp/to_regexp.rb: Regexp#to_regexp 0.0.0
+17. + lib/String/to_regexp.rb: String#to_regexp 0.3.0
+18. + lib/Thoran/Array/ExtractOptionsX/extract_optionsX.rb: Thoran::Array::ExtractOptions#extract_options! 0.2.0
+
+
+## 20250925
+
+0.43.0: MacOS::VPN 0.0.0: + MacOS::VPN.up?, taken from mercurial 0.4.3.
+
+
+## 20250506
+
+0.42.0: MacOS::Dmg 0.8.0: Explicitly specify the mount point or fallback to using the disk image name (sans '.pkg') if the mount point isn't specified, rather than assume that it will be the same as the package name.
+
+1. Switch to using named arguments in a number of places.
+2. + #mount_point(): Previously the package name was assumed, but that's not always true.
+3. + self.full_path_to_mount_point()
+4. - #path_to_dmg=(): Replaced with `attr_accessor :path_to_dmg`.
+5. - #package(): Not necessary and replaced with `attr_accessor :package` also.
+6. ~ self.run_installer(): Pass in mount point instead and use named arguments.
+7. ~ self.unmount(): Properly use the mount_point argument.
+
+
+## 20250419
+
+0.41.3: MacOS::IfConfig 0.6.1: ~ MacOS::Ifconfig.parse: Rework the regex for the '-->' case.
+
+
+## 20250212
+
+0.41.2: MacOS::Defaults::ComAppleDock 0.5.2: ~ read()
+
+0.41.1: MacOS::Defaults::ComAppleDock 0.5.1: + boolean_to_yes_no()
+
+1. + boolean_to_yes_no()
+2. ~ peristent_app_paths(), ~ read(), ~ to_yaml()
+
+0.41.0: MacOS::Defaults::ComAppleDock 0.5.0: Reading the Dock's persistent apps back, and writing them as YAML.
+
+1. + peristent_app_paths(), + read(), + to_yaml()
+
+
+## 20250211
+
+0.40.0: MacOS::Defaults::NSGlobalDomain::NSUserKeyEquivalents 0.2.0: Reading the shortcuts back, and writing them as YAML.
+
+1. + load(), + read_keys(), + parse_key_code(), + to_yaml()
+2. ~ key_code()
+
+0.39.0: MacOS::Defaults::ComAppleDock 0.4.0: One writer for general and boolean attributes alike.
+
+1. - general_attribute_write_command_string(), - boolean_attribute_write_command_string(), - load_general_attribute(), - load_boolean_attribute()
+2. + attribute_write_command(), + load_attribute()
+3. ~ load()
+4. - lib/FalseClass/to_boolean.rb: FalseClass#to_boolean 0.0.0
+5. - lib/Integer/to_boolean.rb: Integer#to_boolean 0.0.0
+6. - lib/NilClass/to_boolean.rb: NilClass#to_boolean 0.0.0
+7. - lib/String/to_boolean.rb: String#to_boolean 0.9.0
+8. - lib/TrueClass/to_boolean.rb: TrueClass#to_boolean 0.0.0
+9. - lib/_meta/to_boolean.rb: _meta/to_boolean 0.0.0
+
+0.38.0: MacOS::Defaults::ComAppleDock 0.3.0: Persistent apps rather than items, and general and boolean attributes apart.
+
+1. - item_plist(), - urlified_item_string(), - defaults_write_command(), - add_item(), - load_items(), - delete_items()
+2. + app_plist_data(), + urlified_app_string(), + persistent_app_write_command(), + add_persistent_app(), + load_persistent_apps()
+3. + delete_item()
+4. - attribute_command_string(), - load_attribute(), - load_attributes()
+5. + general_attribute_write_command_string(), + boolean_attribute_write_command_string(), + load_general_attribute(), + load_boolean_attribute()
+6. ~ delete_all_items(), ~ load()
+7. + lib/FalseClass/to_boolean.rb: FalseClass#to_boolean 0.0.0
+8. + lib/Integer/to_boolean.rb: Integer#to_boolean 0.0.0
+9. + lib/NilClass/to_boolean.rb: NilClass#to_boolean 0.0.0
+10. + lib/String/to_boolean.rb: String#to_boolean 0.9.0
+11. + lib/TrueClass/to_boolean.rb: TrueClass#to_boolean 0.0.0
+12. + lib/_meta/to_boolean.rb: _meta/to_boolean 0.0.0
+
+0.37.0: MacOS::Defaults::ComAppleDock 0.2.0: Adding, loading and deleting items, and loading the Dock's attributes.
+
+1. - write_item(), - write_items(), - delete()
+2. + add_item(), + load_items(), + delete_items()
+3. + attribute_command_string(), + load_attribute(), + load_attributes(), + load()
+4. ~ delete_all_items()
+
+
+## 20250210
+
+0.36.0: MacOS::Defaults::ComAppleDock 0.1.0: Items rather than dock items, and deleting them.
+
+1. - dock_item(), - urlified_dock_item_string(), - write_dock_item(), - write_dock_items()
+2. + item_plist(), + urlified_item_string(), + write_item(), + write_items()
+3. + delete(), + delete_all_items()
+4. ~ defaults_write_command()
+
+0.35.0: MacOS::Defaults::ComAppleDock 0.0.0: + MacOS::Defaults::ComAppleDock: the Dock's items.
+
+0.34.0: MacOS::Defaults::NSGlobalDomain::NSUserKeyEquivalents 0.1.0: ~ key_code()
+
+0.33.0: MacOS::Defaults::NSGlobalDomain::NSUserKeyEquivalents 0.0.0: + MacOS::Defaults::NSGlobalDomain::NSUserKeyEquivalents: the keyboard shortcuts set for menu items.
+
+
+## 20240113
+
+0.32.0: MacOS::DiskUtil 0.0.0: + MacOS::DiskUtil: volumes and their partitions, from diskutil's plist output.
+
+
+## 20230212
+
+0.31.0: MacOS::Dmg 0.7.0: ~ self.unmount(): Rather than assume the path or the name of the package, specify the mount point to unmount.
+
+1. ~ lib/Ordinal.rb, lib/Ordinal/Array.rb: Ordinal /0.2.0/0.2.1/
+2. ~ lib/Version.rb: Version /0.13.1/0.14.0/
+
+
+## 20210301
+
+0.30.0: MacOS::USBFlashDrive 0.0.0: + MacOS::USBFlashDrive: the mount points of USB flash drives, from system_profiler.
+
+
+## 20210220
+
+0.29.1: MacOS::Keychain 0.1.1: Shellwords for the key given to security.
+
+1. + require 'shellwords'
+2. ~ find_generic_password_command()
+
+
+## 20210212
+
+0.29.0: MacOS::Keychain 0.1.0: Open3 rather than backticks, security writing the password to standard error.
+
+1. + require 'open3'
+2. + find_generic_password_command()
+3. ~ find_generic_password()
+4. ~ wifi_password()
+
+
+## 20201218, 20210206
+
+0.28.0: MacOS::Keychain 0.0.0: + MacOS::Keychain: generic passwords, and a Wi-Fi network's password.
+
+
+## 20210206
+
+0.27.0: MacOS::Apple80211 0.0.0: + MacOS::Apple80211: the Wi-Fi connection's attributes, among them its channel, SSID and link auth.
+
+1. - lib/String/each.rb: String#each 0.1.0
+2. ~ lib/String/grep.rb: String#grep /0.1.1/0.2.0/
+
+
+## 20200429
+
+0.26.0: MacOS::IfConfig 0.6.0: Finders by interface, MAC address and IPv4 address.
+
+1. + MacOS::Ifconfig.find_by_interface
+2. + MacOS::Ifconfig.find_by_mac_address
+3. + MacOS::Ifconfig.find_by_ipv4_address
+
+
+## 20200428
+
+0.25.1: MacOS::IfConfig 0.5.1: ~ MacOS::IfConfig.parse, so as it correctly handles the last interface.
+
+0.25.0: MacOS::IfConfig 0.5.0: VPN tunnels, and interfaces by status: active, inactive and up.
+
+1. ~ MacOS::IfConfig.parse, so as it can handle VPN tunnels.
+2. ~ MacOS::IfConfig.parse, so that it now loads an instance with the value of the status field.
+3. + MacOS::IfConfig.inactive_interfaces
+4. + MacOS::IfConfig.inactive_interfaces_names
+5. + MacOS::IfConfig.up_interfaces
+6. + MacOS::IfConfig.up_interfaces_names
+7. /MacOS::IfConfig @active/MacOS::IfConfig @status/
+8. + MacOS::IfConfig#status
+9. ~ MacOS::IfConfig#active?, so as to make use of @status
+10. + MacOS::IfConfig#inactive?
+11. + MacOS::IfConfig#up?
+
+0.24.0: MacOS::IfConfig 0.4.0: Aligned MacOS::IfConfig more closely with MacOS::HardwarePort.
+
+1. ~ MacOS::IfConfig#parse --> MacOS::IfConfig.parse
+2. ~ MacOS::IfConfig#interfaces --> MacOS::IfConfig.interfaces && now returns the same as parse.
+3. ~ MacOS::IfConfig#output --> MacOS::IfConfig.output
+4. ~ MacOS::IfConfig#active_interfaces --> MacOS::IfConfig.active_interfaces
+5. + MacOS::IfConfig.interface_names (formerly MacOS::IfConfig#interfaces)
+6. + MacOS::IfConfig.active_interfaces_names
+7. + MacOS::IfConfig.mac_addresses
+8. + MacOS::IfConfig.ipv4_addresses
+9. + require 'Thoran/String/Capture/capture', so as to support the increased complexity in MacOS::IfConfig.parse.
+
+
+## 20191120, 21
+
+0.23.1: MacOS::IfConfig 0.3.1: /new()/initialize()/, a constructor which had been defining new.
+
+1. /new()/initialize()/ (Really!? I did that!?)
+2. Changed the self-run block to use p instead of pp.
+
+
+## 20190901
+
+0.23.0: MacOS 0.0.0: + lib/MacOS.rb, requiring the MacOS libraries.
+
+
+## 20190831
+
+0.22.0: MacOS::SystemProfiler 0.3.0: The rest of the software overview: kernel, boot volume and mode, computer and user name, secure virtual memory, system integrity protection and time since boot.
+
+1. + system_profiler_output(), + system_version_data(), + system_version_string()
+2. + kernel_version_data(), + kernel_name(), + kernel_version_string(), + kernel_version()
+3. + boot_volume_data(), + boot_mode_data(), + computer_name_data(), + username_data()
+4. + secure_virtual_memory_data(), + system_integrity_protection_data(), + time_since_boot_data()
+5. ~ system_version()
+
+0.21.0: MacOS.version 0.1.0: MacOS::VERSION::STRING, the parts being left to the Version.
+
+1. - major_version(), - minor_version(), - tiny_version()
+2. ~ version()
+3. + MacOS::VERSION::STRING
+
+0.20.0: MacOS.version 0.0.0: + MacOS.version, and its major, minor and tiny parts.
+
+0.19.0: MacOS::SystemProfiler 0.2.0: A Version rather than a string.
+
+1. + require 'Version'
+2. ~ system_version()
+3. ~ major_system_version()
+4. ~ minor_system_version()
+5. ~ tiny_system_version()
+6. + lib/Thoran/String/Capture/capture.rb: Thoran::String::Capture#capture 0.3.1
+7. + lib/Version.rb: Version 0.13.1
+
+0.18.0: MacOS::SystemProfiler 0.1.0: + MacOS::SystemProfiler, taken from Platform's Platform::OS::OSX::SystemProfiler, reading the version of MacOS 10.14 as well as of OSX 10.4 to 10.9.
+
+1. + lib/Ordinal.rb, lib/Ordinal/Array.rb: Ordinal 0.2.0
+2. + lib/String/each.rb: String#each 0.1.0
+3. + lib/String/grep.rb: String#grep 0.1.1
+
+
+## 20190829
+
+0.17.1: MacOS::HardwarePort 0.3.1: Finding by interface rather than by device.
+
+1. /MacOS::HardwarePort.find_by_device/MacOS::HardwarePort.find_by_interface/
+2. + alias_method :find_by_device, :find_by_interface
+3. + MacOS::HardwarePort#interface
+4. + alias_method :find_by_hardware_port, :find_by_name
+
+
+## 20190828
+
+0.17.0: MacOS::HardwarePort 0.3.0: One entry per hardware port, finders by name and by Ethernet address, and #mac_address.
+
+1. /Hardware/HardwarePort at the top of the file.
+2. /new()/initialize()/ (Really!? I did that!? Twice!)
+3. ~ MacOS::HardwarePort.parse, so that it only puts in one entry per hardware port.
+4. - all()
+5. + alias_method :all, :parse
+6. + alias_method :hardware_ports, :parse
+7. + alias_method :ports, :parse
+8. + MacOS::HardwarePort.find_by_name
+9. + MacOS::HardwarePort.find_by_ethernet_address
+10. + MacOS::HardwarePort#mac_address
+
+0.16.0: /OSX/MacOS/ for HardwarePort, IfConfig, Dmg, Defaults and LaunchControl.
+
+1. ~ MacOS::HardwarePort 0.2.0: /OSX/MacOS/
+2. ~ MacOS::IfConfig 0.3.0: /OSX/MacOS/
+3. ~ MacOS::Dmg 0.6.0: /OSX/MacOS/
+4. ~ MacOS::Defaults 0.4.0: /OSX/MacOS/
+5. ~ MacOS::LaunchControl 0.1.0: /OSX/MacOS/
+
+
+## 20190321
+
+0.15.1: OSX::Defaults 0.3.1: + from_yaml()
+
+1. + from_yaml()
+2. ~ to_yaml()
+
+
+## 20181023
+
+0.15.0: OSX::Defaults 0.3.0: ~ to_yaml()
+
+0.14.0: OSX::Defaults 0.2.0: + to_yaml()
+
+0.13.0: OSX::Defaults 0.1.0: Exporting and importing one domain, beside all of them.
+
+1. + export()
+2. + import()
+3. + domain_valid?()
+4. + global_domain?()
+5. ~ domains()
+6. ~ bulk_export_to_plist_files()
+7. ~ bulk_import_from_plist_files()
+8. ~ to_h()
+
+0.12.0: OSX::Defaults 0.0.0: + OSX::Defaults: the defaults domains, exported to and imported from plist files in bulk.
+
+1. - lib/Array/lastX.rb: Array#lastX 20060630
+2. ~ lib/Module/alias_methods.rb: Module#alias_methods /0.0.0/0.1.0/
+3. + lib/Thoran/Array/AllButLast/all_but_last.rb: Thoran::Array::AllButLast#all_but_last 0.1.0
+4. + lib/Thoran/Array/LastX/lastX.rb: Thoran::Array::LastX#last! 0.2.3
+5. + lib/Thoran/Module/AliasMethods/alias_methods.rb: Thoran::Module::AliasMethods#alias_methods 0.1.0
+
+
+## 20180209
+
+0.11.0: OSX::IfConfig 0.2.0: + OSX namespace, under the assumption that the output of ifconfig on OSX is different from other operating systems.
+
+0.10.0: IfConfig 0.1.0: String#captures required from the Thoran namespace.
+
+1. - require 'String/captures'
+2. + require 'Thoran/String/Captures/captures'
+3. - lib/String/captures.rb: String#captures 0.0.0
+
+0.9.2: OSX::Dmg 0.5.2: Moved Dmg.rb into the newly created OSX directory.
+
+0.9.1: OSX::HardwarePort 0.1.1: String#captures required from the Thoran namespace.
+
+1. - require 'String/captures'
+2. + require 'Thoran/String/Captures/captures'
+3. + lib/Thoran/String/Captures/captures.rb: Thoran::String::Captures#captures 0.3.0
+
+
+## 20161227
+
+0.9.0: OSX::HardwarePort 0.1.0: + name()
+
+0.8.1: OSX::HardwarePort 0.0.1: ~ parse(): An empty last line ends a port as a blank line does.
+
+0.8.0: OSX::HardwarePort 0.0.0: + OSX::HardwarePort: the hardware ports networksetup lists, each with its device and Ethernet address.
+
+0.7.0: IfConfig 0.0.0: + IfConfig: the interfaces ifconfig lists, and which of them are active.
+
+1. + lib/String/captures.rb: String#captures 0.0.0
+
+
+## 20140408
+
+0.6.1: OSX::Dmg 0.5.1: ~ path_to_dmg(), because it had a copy/paste error: /path_to_dmg/image_name/.
+
+
+## 20130624
+
+0.6.0: OSX::LaunchControl 0.0.0: + OSX::LaunchControl: loading and unloading launchd plists.
+
+
+## 20130623, 24
+
+0.5.0: OSX::Dmg 0.5.0: Aliases: attach, detach and filename.
+
+1. + alias_method :attach, :mount.
+2. + alias_method :detach, :unmount.
+3. + alias_method :filename, :path_to_dmg.
+4. + alias_method :filename=, :path_to_dmg=.
+
+0.4.0: OSX::Dmg 0.4.0: OSX::Dmg.install mounts, installs and unmounts in one go.
+
+1. + OSX::Dmg.install.
+2. + OSX::Dmg#run_installer, so as it does what OSX::Dmg#install used to do.
+3. ~ OSX::Dmg.install, so as it now mounts, installs, and ummounts.
+4. /dismount/unmount/.
+
+
+## 20130622
+
+0.3.0: OSX::Dmg 0.3.0: A path to the disk image rather than a URL.
+
+1. ~ OSX::Dmg#initialize, so as to remove url and to add path_to_dmg.
+2. require 'Array/extract_optionsX'.
+3. - OSX::Dmg#url, since something to handle disk images shouldn't know anything about URLs probably...
+4. ~ OSX::Dmg.mount: /disk_image_name/path_to_dmg/.
+5. ~ OSX::Dmg.install, so as the pkg_name argument can be optional, since on many occasions it can be derived happily from adding '.pkg' to the package name.
+6. ~ OSX::Dmg.install, so as the pwd is returned to the starting working directory.
+7. + OSX::Dmg#path_to_dmg (and aliases).
+8. + OSX::Dmg#path_to_dmg= (and aliases).
+9. - lib/Array/extract_optionsX.rb: Array#extract_optionsX 0.1.0
+10. + lib/Module/alias_methods.rb: Module#alias_methods 0.0.0
+
+0.2.0: OSX::Dmg 0.2.0: Instances which mount, install and dismount, the class methods renamed to match.
+
+1. + attr_accessor :verbose in class-level.
+2. ~ initialize, so that it actually does something!
+3. + OSX::Dmg#mount.
+4. + OSX::Dmg#install.
+5. + OSX::Dmg#dismount.
+6. + working self-run section.
+7. /mount_disk_image/mount/.
+8. /run_installer/install/.
+9. /dismount_disk_image/dismount/.
+10. ~ OSX::Dmg#image_name, so as it makes use of directly set values via options rather than derived from the url.
+11. ~ OSX::Dmg#package, so as it makes use of directly set values via options rather than derived from the url.
+12. ~ OSX::Dmg#pkg_name, so as it makes use of directly set values via options rather than derived from the url.
+
+
+## 20130603, 22
+
+0.1.0: OSX::Dmg 0.1.0: Shellwords for what is passed to the shell.
+
+1. + require 'shellwords'
+2. ~ OSX?::Dmg.mount_disk_image, so as to make use of Shellwords.
+3. ~ OSX?::Dmg.run_installer, so as to make use of Shellwords.
+4. ~ OSX?::Dmg.dismount_disk_image, so as to make use of Shellwords.
+5. + lib/Array/all_but_last.rb: Array#all_but_last 0.1.0
+6. + lib/Array/extract_optionsX.rb: Array#extract_optionsX 0.1.0
+7. + lib/Array/lastX.rb: Array#lastX 20060630
+
+0.0.0: OSX::Dmg 0.0.0: + OSX::Dmg: mounting a disk image, running the installer in it, and dismounting it.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2013-2026 thoran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.