philiprehberger-pathname_kit 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70f1ab2f8c2df10d03e935684cbd544d696884eb518779df881f59ff0e024dd5
-  data.tar.gz: 9c8eca57f7b70ac5d396907620ca18f9c9549b3ac85554215334723f3b9fe76b
+  metadata.gz: 76ddd3566c382deffcfaa116b8f24e6715f9b6a724301b3c0f1cfd8168abff7b
+  data.tar.gz: e373af1ca11000c3512a96a6c0e7f5c7a476dc7536fb2b595bb8deb1767321b3
 SHA512:
-  metadata.gz: 15195cbcb038979ea6bde46189b78df00c6518c49680c2a83595949b23c19b61cac7d905c44bc82973fc30e97a2fc4092f860dd2603258a74109c4918870dcfd
-  data.tar.gz: 4ba0a4061aad79d70d6ed83d021f0d94494b3c2874441600b7abd5b34044fd30276ffe40e526bf7ec693621027cbd24091d54edafe9403b7177ddc8148f6c933
+  metadata.gz: e3c3f9a0c310b8cb644d0740b22b7242aca2b97f64dc6085026734ef762010c0d1c6a02e93450ffcaf1ca949c58c26416f6c2b600d2cfe16a3bf0dfc9b864880
+  data.tar.gz: 9233e060d7a9cfdd6754cad84bcdbf27e961eb82bdf3ada5f26f72b4aad937eecd8ce3502408f3b1181e6b9428a2c9910b342577476e46caa83ddd354e94c782

data/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-04-15
+
+### Added
+- `relative_to(path, base)` for expressing a path relative to a base path
+
+## [0.5.0] - 2026-04-14
+
+### Added
+- `exists?(path)` for checking if a file or directory exists
+- `directory?(path)` for checking if a path is a directory
+- `basename(path)` for getting the filename component of a path
+- `dirname(path)` for getting the directory component of a path
+- `mtime(path)` for getting the last modification time
+
 ## [0.4.0] - 2026-04-10
 
 ### Added

data/README.md

@@ -130,6 +130,23 @@ Philiprehberger::PathnameKit.extension("archive.tar.gz")  # => ".gz"
 Philiprehberger::PathnameKit.expand("~/docs/notes.md")    # => "/home/user/docs/notes.md"
 ```
 
+### Path Queries
+
+```ruby
+Philiprehberger::PathnameKit.exists?("config/app.yml")         # => true or false
+Philiprehberger::PathnameKit.directory?("config")              # => true or false
+Philiprehberger::PathnameKit.basename("/path/to/file.txt")     # => "file.txt"
+Philiprehberger::PathnameKit.dirname("/path/to/file.txt")      # => "/path/to"
+Philiprehberger::PathnameKit.mtime("config/app.yml")           # => 2026-04-14 12:00:00 +0000
+```
+
+### Relative Paths
+
+```ruby
+Philiprehberger::PathnameKit.relative_to("/a/b/c.txt", "/a/b")  # => "c.txt"
+Philiprehberger::PathnameKit.relative_to("/a/foo", "/a/bar")    # => "../foo"
+```
+
 ## API
 
 | Method | Description |
@@ -154,6 +171,12 @@ Philiprehberger::PathnameKit.expand("~/docs/notes.md")    # => "/home/user/docs/
 | `.empty?(path)` | Check if a file is zero bytes |
 | `.extension(path)` | Get the file extension (e.g. `".rb"`) |
 | `.expand(path)` | Expand to absolute path with tilde expansion |
+| `.exists?(path)` | Check if a file or directory exists |
+| `.directory?(path)` | Check if a path is a directory |
+| `.basename(path)` | Get the filename component of a path |
+| `.dirname(path)` | Get the directory component of a path |
+| `.mtime(path)` | Get the last modification time |
+| `.relative_to(path, base)` | Express a path relative to a base path |
 
 ## Development
 

data/lib/philiprehberger/pathname_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module PathnameKit
-    VERSION = '0.4.0'
+    VERSION = '0.6.0'
   end
 end

data/lib/philiprehberger/pathname_kit.rb

@@ -319,5 +319,85 @@ module Philiprehberger
 
       File.expand_path(path.to_s)
     end
+
+    # Return +path+ expressed relative to +base+ as a String.
+    #
+    # Both arguments may be String or Pathname. Inputs are wrapped in
+    # Pathname and expanded so relative inputs are resolved against the
+    # current working directory before the relative path is computed.
+    #
+    # @param path [String, Pathname] the target path
+    # @param base [String, Pathname] the base path to compute relativity against
+    # @return [String] the relative path
+    # @raise [Error] if either argument is nil or empty
+    def self.relative_to(path, base)
+      raise Error, 'path cannot be nil' if path.nil?
+      raise Error, 'path cannot be empty' if path.to_s.empty?
+      raise Error, 'base cannot be nil' if base.nil?
+      raise Error, 'base cannot be empty' if base.to_s.empty?
+
+      Pathname.new(path.to_s).expand_path.relative_path_from(Pathname.new(base.to_s).expand_path).to_s
+    end
+
+    # Check if a file or directory exists at the given path.
+    #
+    # @param path [String] the file or directory path
+    # @return [Boolean] true if the path exists
+    # @raise [Error] if path is nil or empty
+    def self.exists?(path)
+      raise Error, 'path cannot be nil' if path.nil?
+      raise Error, 'path cannot be empty' if path.to_s.empty?
+
+      File.exist?(path.to_s)
+    end
+
+    # Check if the given path is a directory.
+    #
+    # @param path [String] the path to check
+    # @return [Boolean] true if the path is a directory
+    # @raise [Error] if path is nil or empty
+    def self.directory?(path)
+      raise Error, 'path cannot be nil' if path.nil?
+      raise Error, 'path cannot be empty' if path.to_s.empty?
+
+      File.directory?(path.to_s)
+    end
+
+    # Get the filename component of a path (without directory).
+    #
+    # @param path [String] the file path
+    # @return [String] the filename
+    # @raise [Error] if path is nil or empty
+    def self.basename(path)
+      raise Error, 'path cannot be nil' if path.nil?
+      raise Error, 'path cannot be empty' if path.to_s.empty?
+
+      File.basename(path.to_s)
+    end
+
+    # Get the directory component of a path.
+    #
+    # @param path [String] the file path
+    # @return [String] the directory portion
+    # @raise [Error] if path is nil or empty
+    def self.dirname(path)
+      raise Error, 'path cannot be nil' if path.nil?
+      raise Error, 'path cannot be empty' if path.to_s.empty?
+
+      File.dirname(path.to_s)
+    end
+
+    # Get the last modification time of a file or directory.
+    #
+    # @param path [String] the file or directory path
+    # @return [Time] the modification time
+    # @raise [Error] if path is nil/empty or does not exist
+    def self.mtime(path)
+      raise Error, 'path cannot be nil' if path.nil?
+      raise Error, 'path cannot be empty' if path.to_s.empty?
+      raise Error, "path not found: #{path}" unless File.exist?(path.to_s)
+
+      File.mtime(path.to_s)
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-pathname_kit
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-11 00:00:00.000000000 Z
+date: 2026-04-15 00:00:00.000000000 Z
 dependencies: []
 description: Pathname utility library providing atomic writes, safe deletes, directory
   creation, glob-based file finding, tempfile helpers, copy, move, checksum, append,