philiprehberger-pathname_kit 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 022ccd8f2453dd90ab6292f5205556455f03bb4e2cca39e8257cd07cdfa0b0e4
-  data.tar.gz: c187ad87694fb30b811f4aa63df279a1bec167bbc0ed13abfaa8d766b97bf17d
+  metadata.gz: 76ddd3566c382deffcfaa116b8f24e6715f9b6a724301b3c0f1cfd8168abff7b
+  data.tar.gz: e373af1ca11000c3512a96a6c0e7f5c7a476dc7536fb2b595bb8deb1767321b3
 SHA512:
-  metadata.gz: 68aa6e2e50196068b4f317e8e9f55437ed796d0c021574f8c95f0bdd92b9afb7d573b9c02de444dfa0b72e11974450b084f2637f15c22797669e511f1c2a0e73
-  data.tar.gz: faceb9ba3beebd59965beea08d5f7cc6afb1ec76c6f03ede7c30d41fdd25fb8b923442f2eca9995e4bb98d1b6602d11bb785c9db818492a94a4ecc67f121e28d
+  metadata.gz: e3c3f9a0c310b8cb644d0740b22b7242aca2b97f64dc6085026734ef762010c0d1c6a02e93450ffcaf1ca949c58c26416f6c2b600d2cfe16a3bf0dfc9b864880
+  data.tar.gz: 9233e060d7a9cfdd6754cad84bcdbf27e961eb82bdf3ada5f26f72b4aad937eecd8ce3502408f3b1181e6b9428a2c9910b342577476e46caa83ddd354e94c782

data/CHANGELOG.md

@@ -7,6 +7,11 @@ 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

data/README.md

@@ -140,6 +140,13 @@ 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 |
@@ -169,6 +176,7 @@ Philiprehberger::PathnameKit.mtime("config/app.yml")           # => 2026-04-14 1
 | `.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.5.0'
+    VERSION = '0.6.0'
   end
 end

data/lib/philiprehberger/pathname_kit.rb

@@ -320,6 +320,25 @@ 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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-pathname_kit
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-14 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,