philiprehberger-pathname_kit 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76ddd3566c382deffcfaa116b8f24e6715f9b6a724301b3c0f1cfd8168abff7b
-  data.tar.gz: e373af1ca11000c3512a96a6c0e7f5c7a476dc7536fb2b595bb8deb1767321b3
+  metadata.gz: 20819d82a21880e8492296309312b448ff83c13c08c6cabedfd1a4a9b931765a
+  data.tar.gz: ac0609e05c9f3ffe88267588c4c1b5554445719a0fa290521e56735324a48297
 SHA512:
-  metadata.gz: e3c3f9a0c310b8cb644d0740b22b7242aca2b97f64dc6085026734ef762010c0d1c6a02e93450ffcaf1ca949c58c26416f6c2b600d2cfe16a3bf0dfc9b864880
-  data.tar.gz: 9233e060d7a9cfdd6754cad84bcdbf27e961eb82bdf3ada5f26f72b4aad937eecd8ce3502408f3b1181e6b9428a2c9910b342577476e46caa83ddd354e94c782
+  metadata.gz: '08fd38afb8c71fb98eecdabe34daccad18236b604a32a6eb62e1c4a32611f7b61e709105e252985b8f156b0a69b3772a9de2562685475d6ded4888bad27630cd'
+  data.tar.gz: 41b84e7711008b394b62746cf95edd4db1ff2e8de8f735d8451abc3b520e7c10c843b1c45dc0495984aefb0faf9538f735af2d9d3d55436425e2cbe653d491ef

data/CHANGELOG.md

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

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
@@ -158,6 +168,7 @@ Philiprehberger::PathnameKit.relative_to("/a/foo", "/a/bar")    # => "../foo"
 | `.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) |

data/lib/philiprehberger/pathname_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module PathnameKit
-    VERSION = '0.6.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

metadata

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