hackmac 1.8.3 → 1.8.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09d1c9d86b5f82faf58a2b4b86aff4a2bf315e81f2f30b4cf967e6fb6dfd33ca'
-  data.tar.gz: e642ea32afa25bcec1026b4e1d1cfb1ce71309aab7d32d42b55ad31b78d836fd
+  metadata.gz: 4e6a5eddb6a8534ec0ab25e387690e533805343b7531b380bf0916ac4f181d72
+  data.tar.gz: 6906f6c55a4d2dd6f46b70cd44cb3bcfff16283e14871992d19cb22dc8a71ecf
 SHA512:
-  metadata.gz: ce6b64440555a2236fa91cf059cfe8413bb6aa2361b453f694d6791fcd76a95ef397b3bd401bf9747936c3d85d46deb58e5eaed76e89600ffa9f7fe691764178
-  data.tar.gz: '092da979e7b49732c26ba139f36d58df9c11f22790bea9ff6bfa7289025562b751c5a77651632966aed4ab6cbbfacc441a1d8a97490fc43cdde6f4501c774b31'
+  metadata.gz: f45158ccc125e01999b97272f89e3257a1d36b5a32546f3438af5cd99a2a5a1192004d62e9346eb28b12eafbbc28404f16ff2d310aaa95b93737d8a9a3fe5033
+  data.tar.gz: 98b0c59693b5f94146d12a49c7d2ace14f37bec4d9548ad1ca851d4ab1b1cd3777208fbe9cc7fa5003d4ae44c4f662335eb86cc2794242857c1fa56a55beb526

data/CHANGES.md

@@ -1,5 +1,37 @@
 # Changes
 
+## 2025-10-14 v1.8.5
+
+- Improved version parsing in `github_source.rb` by adding regex validation
+  `/\A\d+\.\d+\.\d+\z/` before creating `Version` objects
+- Enhanced version parsing in `kext.rb` with regex validation
+  `/\A\d+\.\d+\.\d+\z/` before parsing `CFBundleShortVersionString()` as a
+  version
+- Both changes ensure only valid semantic version strings are processed by the
+  `Version` class, preventing errors from malformed version identifiers
+
+## 2025-09-20 v1.8.4
+
+- Added a new section titled "Documentation" to the README with a link to the
+  API documentation hosted at GitHub.io
+- Renamed `.context/code_comment.rb` to `.contexts/code_comment.rb` and updated
+  the directory structure for code comment context files while maintaining all
+  existing functionality
+- Added a new GitHub Actions workflow file `.github/workflows/static.yml` to
+  deploy static content to GitHub Pages
+- Updated the `Rakefile` to include the `.github` directory in the
+  `package_ignore` list and configured the workflow to run on push to the
+  master branch and manual dispatch
+- Set up permissions for deployment to GitHub Pages and installed the
+  `gem_hadar` gem to generate documentation using `rake doc`
+- Added `.yardoc` and `doc` directories to `.gitignore` and updated the
+  `Rakefile` to ignore these directories while removing `.byebug_history` from
+  both files
+- Fixed markdown escaping in documentation comments, specifically updating the
+  `@param` documentation tag in `asset_tools.rb` to yield instead of block and
+  escaping `\@format_value` and `\@plist` references in `graph.rb` and
+  `plist.rb` respectively
+
 ## 2025-09-19 v1.8.3
 
 - Enhanced README with improved formatting and detailed tool descriptions

data/README.md

@@ -7,6 +7,10 @@ customizing Hackintosh configurations. While primarily intended for users with
 Hackintosh setups, it may also be useful for ordinary Mac users who want to
 leverage its features for monitoring system performance using `gfxmon`.
 
+## Documentation
+
+Complete API documentation is available at: [GitHub.io](https://flori.github.io/hackmac/)
+
 ## Tools 🛠️
 
 ### `efi` - EFI Partition Management 📁

data/Rakefile

@@ -13,8 +13,8 @@ GemHadar do
   executables Dir['bin/*'].map(&File.method(:basename))
   test_dir    'tests'
   ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', '.rvmrc', '.AppleDouble',
-    'tags', '.bundle', '.DS_Store', '.byebug_history'
-  package_ignore '.gitignore', '.contexts'
+    'tags', '.bundle', '.DS_Store', '.yardoc', 'doc'
+  package_ignore '.gitignore', '.contexts', '.github'
 
   readme      'README.md'
 

data/VERSION

@@ -1 +1 @@
-1.8.3
+1.8.5

data/hackmac.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: hackmac 1.8.3 ruby lib
+# stub: hackmac 1.8.5 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "hackmac".freeze
-  s.version = "1.8.3".freeze
+  s.version = "1.8.5".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -13,7 +13,7 @@ Gem::Specification.new do |s|
   s.email = "flori@ping.de".freeze
   s.executables = ["efi".freeze, "gfxmon".freeze, "usb".freeze]
   s.extra_rdoc_files = ["README.md".freeze, "lib/hackmac.rb".freeze, "lib/hackmac/asset_tools.rb".freeze, "lib/hackmac/config.rb".freeze, "lib/hackmac/disks.rb".freeze, "lib/hackmac/github_source.rb".freeze, "lib/hackmac/graph.rb".freeze, "lib/hackmac/graph/display.rb".freeze, "lib/hackmac/ioreg.rb".freeze, "lib/hackmac/kext.rb".freeze, "lib/hackmac/kext_upgrader.rb".freeze, "lib/hackmac/oc.rb".freeze, "lib/hackmac/oc_upgrader.rb".freeze, "lib/hackmac/oc_validator.rb".freeze, "lib/hackmac/plist.rb".freeze, "lib/hackmac/url_download.rb".freeze, "lib/hackmac/utils.rb".freeze, "lib/hackmac/version.rb".freeze]
-  s.files = [".context/code_comment.rb".freeze, "CHANGES.md".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/efi".freeze, "bin/gfxmon".freeze, "bin/usb".freeze, "hackmac.gemspec".freeze, "img/gfxmon.png".freeze, "lib/hackmac.rb".freeze, "lib/hackmac/asset_tools.rb".freeze, "lib/hackmac/config.rb".freeze, "lib/hackmac/disks.rb".freeze, "lib/hackmac/github_source.rb".freeze, "lib/hackmac/graph.rb".freeze, "lib/hackmac/graph/display.rb".freeze, "lib/hackmac/hackmac.yml".freeze, "lib/hackmac/ioreg.rb".freeze, "lib/hackmac/kext.rb".freeze, "lib/hackmac/kext_upgrader.rb".freeze, "lib/hackmac/oc.rb".freeze, "lib/hackmac/oc_upgrader.rb".freeze, "lib/hackmac/oc_validator.rb".freeze, "lib/hackmac/plist.rb".freeze, "lib/hackmac/url_download.rb".freeze, "lib/hackmac/utils.rb".freeze, "lib/hackmac/version.rb".freeze]
+  s.files = ["CHANGES.md".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/efi".freeze, "bin/gfxmon".freeze, "bin/usb".freeze, "hackmac.gemspec".freeze, "img/gfxmon.png".freeze, "lib/hackmac.rb".freeze, "lib/hackmac/asset_tools.rb".freeze, "lib/hackmac/config.rb".freeze, "lib/hackmac/disks.rb".freeze, "lib/hackmac/github_source.rb".freeze, "lib/hackmac/graph.rb".freeze, "lib/hackmac/graph/display.rb".freeze, "lib/hackmac/hackmac.yml".freeze, "lib/hackmac/ioreg.rb".freeze, "lib/hackmac/kext.rb".freeze, "lib/hackmac/kext_upgrader.rb".freeze, "lib/hackmac/oc.rb".freeze, "lib/hackmac/oc_upgrader.rb".freeze, "lib/hackmac/oc_validator.rb".freeze, "lib/hackmac/plist.rb".freeze, "lib/hackmac/url_download.rb".freeze, "lib/hackmac/utils.rb".freeze, "lib/hackmac/version.rb".freeze]
   s.homepage = "http://github.com/flori/hackmac".freeze
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "Hackmac - Some useful tools for working with a Hackintosh".freeze, "--main".freeze, "README.md".freeze]
@@ -22,7 +22,7 @@ Gem::Specification.new do |s|
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 2.6".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 2.8".freeze])
   s.add_development_dependency(%q<debug>.freeze, [">= 0".freeze])
   s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.14".freeze])
   s.add_runtime_dependency(%q<term-ansicolor>.freeze, ["~> 1.10".freeze])

data/lib/hackmac/asset_tools.rb

@@ -26,7 +26,7 @@ module Hackmac
     # the provided block within that context. After the block completes, it
     # ensures proper cleanup of the temporary directory.
     #
-    # @param block [ Block ] the block to execute within the temporary
+    # @yield [ dir ] the block to execute within the temporary
     # directory context
     #
     # @return [ Object ] the return value of the yielded block

data/lib/hackmac/github_source.rb

@@ -47,13 +47,14 @@ module Hackmac
         JSON.parse(o.read, object_class: JSON::GenericObject)
       }
       if max_version = releases.map { |r|
-          next unless r.tag_name.include?(?.)
-          tag = r.tag_name.delete '^.0-9'
+        tag = r.tag_name
+        if tag =~ /\A\d+\.\d+\.\d+\z/
           begin
             [ Version.new(tag), r ]
           rescue ArgumentError
           end
-        }.compact.max_by(&:first)
+        end
+      }.compact.max_by(&:first)
       then
         @version, @release = max_version
       end

data/lib/hackmac/graph.rb

@@ -317,7 +317,7 @@ class Hackmac::Graph
   # formatting strategy
   #
   # This method applies the appropriate formatting to a value based on the
-  # @format_value instance variable configuration It supports different
+  # \@format_value instance variable configuration It supports different
   # formatting approaches including custom Proc objects, Symbol-based method
   # calls, and default formatting
   #

data/lib/hackmac/kext.rb

@@ -83,10 +83,12 @@ module Hackmac
     def version
       unless @version
         if version = CFBundleShortVersionString()
-          begin
-            @version = Version.new(version)
-          rescue ArgumentError
-            @version = version
+          if version =~ /\A\d+\.\d+\.\d+\z/
+            begin
+              @version = Version.new(version)
+            rescue ArgumentError
+              @version = version
+            end
           end
         end
       end

data/lib/hackmac/plist.rb

@@ -23,7 +23,7 @@ module Hackmac
     #
     # This method executes a shell command and parses its XML output into a
     # Ruby hash using the Plist library. The resulting hash is stored in the
-    # @plist instance variable for later access through other methods.
+    # \@plist instance variable for later access through other methods.
     #
     # @param cmd [Array<String>] command and arguments to execute
     #

data/lib/hackmac/version.rb

@@ -1,6 +1,6 @@
 module Hackmac
   # Hackmac version
-  VERSION         = '1.8.3'
+  VERSION         = '1.8.5'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hackmac
 version: !ruby/object:Gem::Version
-  version: 1.8.3
+  version: 1.8.5
 platform: ruby
 authors:
 - Florian Frank
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2.8'
 - !ruby/object:Gem::Dependency
   name: debug
   requirement: !ruby/object:Gem::Requirement
@@ -176,7 +176,6 @@ extra_rdoc_files:
 - lib/hackmac/utils.rb
 - lib/hackmac/version.rb
 files:
-- ".context/code_comment.rb"
 - CHANGES.md
 - Gemfile
 - LICENSE

data/.context/code_comment.rb

@@ -1,15 +0,0 @@
-context do
-  namespace "bin" do
-    Dir['bin/*'].each do |filename|
-      file filename, tags: 'bin'
-    end
-  end
-
-  namespace "lib" do
-    Dir['lib/**/*.rb'].each do |filename|
-      file filename, tags: 'lib'
-    end
-  end
-
-  file 'README.md', tags: [ 'documentation' ]
-end