philiprehberger-pathname_kit 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70f1ab2f8c2df10d03e935684cbd544d696884eb518779df881f59ff0e024dd5
-  data.tar.gz: 9c8eca57f7b70ac5d396907620ca18f9c9549b3ac85554215334723f3b9fe76b
+  metadata.gz: 022ccd8f2453dd90ab6292f5205556455f03bb4e2cca39e8257cd07cdfa0b0e4
+  data.tar.gz: c187ad87694fb30b811f4aa63df279a1bec167bbc0ed13abfaa8d766b97bf17d
 SHA512:
-  metadata.gz: 15195cbcb038979ea6bde46189b78df00c6518c49680c2a83595949b23c19b61cac7d905c44bc82973fc30e97a2fc4092f860dd2603258a74109c4918870dcfd
-  data.tar.gz: 4ba0a4061aad79d70d6ed83d021f0d94494b3c2874441600b7abd5b34044fd30276ffe40e526bf7ec693621027cbd24091d54edafe9403b7177ddc8148f6c933
+  metadata.gz: 68aa6e2e50196068b4f317e8e9f55437ed796d0c021574f8c95f0bdd92b9afb7d573b9c02de444dfa0b72e11974450b084f2637f15c22797669e511f1c2a0e73
+  data.tar.gz: faceb9ba3beebd59965beea08d5f7cc6afb1ec76c6f03ede7c30d41fdd25fb8b923442f2eca9995e4bb98d1b6602d11bb785c9db818492a94a4ecc67f121e28d

data/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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,16 @@ 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
+```
+
 ## API
 
 | Method | Description |
@@ -154,6 +164,11 @@ 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 |
 
 ## Development
 

data/lib/philiprehberger/pathname_kit/version.rb

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

data/lib/philiprehberger/pathname_kit.rb

@@ -319,5 +319,66 @@ module Philiprehberger
 
       File.expand_path(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.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-11 00:00:00.000000000 Z
+date: 2026-04-14 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,