simple_xdg 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8db25c3801d49ace447881c87f3dbdd9fb2ca4ff2df955adbf7554f5af69928b
-  data.tar.gz: b9ad844c2bab45f09c856025d9458a60955fd9d6966c01b52d68920eb0b78915
+  metadata.gz: e2033b305c79ff95d468ed8eb2bcb9fea640344031638af19ccebd28abb5c019
+  data.tar.gz: 126def79f3db5000139895fbd0af923e68eef454467915d1429981197cd8850d
 SHA512:
-  metadata.gz: 0f249d40422399854b4f2f40e73be9a40087a022a27fd62d199160a744ccf5495a556fa971a7085d3098f25376f10d7222571159e2dd3dbd96b8db59be1e2dc5
-  data.tar.gz: 6e48291c6b2c2b684f88ba660d7298c2540202143f8bfb87e0838d738b8d018a133aaa6992f82fec9aba1c17b080567065c6e662433c0753f9333f97e81f09d4
+  metadata.gz: 3870bf9165d96291219e509fa3e190567d1c7108054985e62738927a7ae5fea33fd16c06237afe4491406fa9c16bd59a156067eeb3c71ade5b09e690691db2e6
+  data.tar.gz: 995dced0b643b937a71d7d8471f98cfed5548582cf41e6fc24347351c188c80ce3505319c4b83bce3cc8e09c50283476ea859f02b0fa4659a0c7964782a76ed9

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release History
 
+### v0.1.2 / 2026-10-05
+
+* FIXED: Prevent an exception in home_dir in the rare case that Ruby is unable to determine the home dir
+* DOCS: Fixed typo in the readme
+
 ### v0.1.1 / 2026-05-04
 
 * DOCS: Fixed reference documentation generation

data/README.md

@@ -1,7 +1,7 @@
 # SimpleXDG
 
 `SimpleXDG` is a no-frills Ruby class implementing the XDG Base Directory
-Specification. This spech defines where certain user-specific application
+Specification. This spec defines where certain user-specific application
 files, such as configuration, cache, and saved state, should live on the user's
 file system. It specifies environment variables that contain this information,
 and defaults that should be used if those environment variables are unset. The

data/lib/simple_xdg/version.rb

@@ -5,5 +5,5 @@ class SimpleXDG
   # Version of the simple_xdg gem
   # @return [String]
   #
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/simple_xdg.rb

@@ -57,10 +57,16 @@ class SimpleXDG
   ##
   # Returns the absolute path to the current user's home directory.
   #
+  # Uses the value of the `$HOME` environment variable if it is an absolute
+  # path, otherwise falls back to the system's notion of the home directory.
+  # If no home directory can be determined (for example, when `$HOME` is
+  # unset and the current user has no passwd entry, as can happen in a
+  # container run under an arbitrary UID), returns the filesystem root `"/"`.
+  #
   # @return [String]
   #
   def home_dir
-    @home_dir ||= validate_dir_env("HOME") || ::Dir.home
+    @home_dir ||= validate_dir_env("HOME") || safe_home_dir
   end
 
   ##
@@ -362,6 +368,20 @@ class SimpleXDG
     ::File.absolute_path?(path) ? path : nil
   end
 
+  ##
+  # Get `Dir.home` with a fallback for the rare case where it raises due to
+  # there not being a home directory. The error case can be triggered, for
+  # example, by running a container under a UID with no passwd entry, where
+  # `$HOME` is explicitly unset. Also falls back if `Dir.home` returns a
+  # non-absolute path, which can happen if `$HOME` is empty or relative.
+  #
+  def safe_home_dir
+    home = ::Dir.home
+    ::File.absolute_path?(home) ? home : "/"
+  rescue ::ArgumentError
+    "/"
+  end
+
   ##
   # Given an environment variable name, returns nil if unset or empty,
   # otherwise returns a (possibly empty) array of the valid paths.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simple_xdg
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Daniel Azuma
@@ -45,8 +45,8 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/dazuma/simple_xdg/issues
-  changelog_uri: https://rubydoc.info/gems/simple_xdg/0.1.1/file/CHANGELOG.md
-  documentation_uri: https://rubydoc.info/gems/simple_xdg/0.1.1
+  changelog_uri: https://rubydoc.info/gems/simple_xdg/0.1.2/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/simple_xdg/0.1.2
   homepage_uri: https://github.com/dazuma/simple_xdg
 rdoc_options: []
 require_paths:
@@ -62,7 +62,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.20
 specification_version: 4
 summary: A simple implementation of the XDG Base Directory Specification.
 test_files: []