philiprehberger-pathname_kit 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 022ccd8f2453dd90ab6292f5205556455f03bb4e2cca39e8257cd07cdfa0b0e4
-  data.tar.gz: c187ad87694fb30b811f4aa63df279a1bec167bbc0ed13abfaa8d766b97bf17d
+  metadata.gz: 20819d82a21880e8492296309312b448ff83c13c08c6cabedfd1a4a9b931765a
+  data.tar.gz: ac0609e05c9f3ffe88267588c4c1b5554445719a0fa290521e56735324a48297
 SHA512:
-  metadata.gz: 68aa6e2e50196068b4f317e8e9f55437ed796d0c021574f8c95f0bdd92b9afb7d573b9c02de444dfa0b72e11974450b084f2637f15c22797669e511f1c2a0e73
-  data.tar.gz: faceb9ba3beebd59965beea08d5f7cc6afb1ec76c6f03ede7c30d41fdd25fb8b923442f2eca9995e4bb98d1b6602d11bb785c9db818492a94a4ecc67f121e28d
+  metadata.gz: '08fd38afb8c71fb98eecdabe34daccad18236b604a32a6eb62e1c4a32611f7b61e709105e252985b8f156b0a69b3772a9de2562685475d6ded4888bad27630cd'
+  data.tar.gz: 41b84e7711008b394b62746cf95edd4db1ff2e8de8f735d8451abc3b520e7c10c843b1c45dc0495984aefb0faf9538f735af2d9d3d55436425e2cbe653d491ef

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-04-28
+
+### Added
+- `tail(path, n = 10)` — return the last `n` lines of a file as an Array. Streams the file through a bounded ring so memory usage stays constant for large files.
+
+## [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

@@ -92,6 +92,16 @@ end
 Philiprehberger::PathnameKit.size("logs/app.log") # => 4096
 ```
 
+### Tail
+
+Read the last `n` lines of a file (defaults to 10). Memory usage is bounded
+regardless of file size:
+
+```ruby
+Philiprehberger::PathnameKit.tail("logs/app.log")        # => last 10 lines
+Philiprehberger::PathnameKit.tail("logs/app.log", 50)    # => last 50 lines
+```
+
 ### Tempdir Helper
 
 ```ruby
@@ -140,6 +150,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 |
@@ -151,6 +168,7 @@ Philiprehberger::PathnameKit.mtime("config/app.yml")           # => 2026-04-14 1
 | `.tempfile(ext) { \|path\| }` | Create a temp file and yield its path |
 | `.touch(path)` | Create or update a file's modification time |
 | `.line_count(path)` | Count the number of lines in a file |
+| `.tail(path, n = 10)` | Return the last n lines of a file as an Array |
 | `.copy(src, dest)` | Copy file with parent directory creation |
 | `.move(src, dest)` | Move file with parent directory creation |
 | `.checksum(path, algorithm: :sha256)` | Compute file digest (md5, sha1, sha256, sha512) |
@@ -169,6 +187,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.7.0'
   end
 end

data/lib/philiprehberger/pathname_kit.rb

@@ -118,6 +118,29 @@ module Philiprehberger
       File.readlines(path).size
     end
 
+    # Return the last n lines of a file as an Array.
+    #
+    # Streams the file line by line through a bounded ring of size n so memory
+    # usage stays constant regardless of file size.
+    #
+    # @param path [String] the file path
+    # @param n [Integer] number of trailing lines to return
+    # @return [Array<String>] the last n lines (or fewer if the file is shorter)
+    # @raise [Error] if path is nil/empty, n is non-positive, or the file does not exist
+    def self.tail(path, n = 10)
+      raise Error, 'path cannot be nil' if path.nil?
+      raise Error, 'path cannot be empty' if path.to_s.empty?
+      raise Error, 'n must be positive' unless n.is_a?(Integer) && n.positive?
+      raise Error, "file not found: #{path}" unless File.exist?(path)
+
+      buffer = []
+      File.foreach(path) do |line|
+        buffer << line
+        buffer.shift if buffer.size > n
+      end
+      buffer
+    end
+
     # Copies a file to a destination, creating parent directories as needed.
     #
     # @param src [String] source file path
@@ -320,6 +343,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.7.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-14 00:00:00.000000000 Z
+date: 2026-04-29 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,