philiprehberger-file_watcher 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72955a87c0c7532aaae1770f832fa481ebdb5e8e7486a6256cd3efe22b96980a
-  data.tar.gz: 30fe17eb9808992fdbb081af22539beeef4ee3b8eeeda33db86222a95fc77d3d
+  metadata.gz: a915f31902d0bdde628463388067c0705492168b86f4b837cef701a5cce4a3cc
+  data.tar.gz: f55c07836c8c9057066e1d178c12c4e2a0230758778517accf156f6dcb36e446
 SHA512:
-  metadata.gz: 932825e2603306e53383ce80b69c1aeac3690bc3e5de594b71cf65b065c6cb33adc685dc63d39e7aa829f3616bb118fa81d674e2271cc0039446826fa73f7cf1
-  data.tar.gz: e271b72444e9221cc59954c4f2d9c4c1a601b79ce90386848638f018d3a6c4aecf9a11108acf97df96c39caefb535d5a9556e492ef7540b0bc2e4b89bba5276a
+  metadata.gz: 1a46bd5ae6d94a4040b8cedd836466f5543bc67ca739ad6af17b6af09ca381ede30f1dcb4730bf0b2fae3e68dae567b7ac7cd903a703ec0985ed0bc00e206e15
+  data.tar.gz: a558ec156f7e6f0b7a30812b60b603499f4b022b92e401715e8eea849ed2cf716b5fa197f3ec6faca534f5ea5dff3b777aead24d382e46d7a9ab2a7151c1e40b

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-26
+
+### Added
+
+- `Watcher#stats` returning a hash with `:tracked_files`, `:total_changes`, and `:last_change_at`
+
 ## [0.3.0] - 2026-04-10
 
 ### Added

data/README.md

@@ -133,6 +133,18 @@ snapshot.each do |path, info|
 end
 ```
 
+### Stats
+
+```ruby
+require "philiprehberger/file_watcher"
+
+watcher = Philiprehberger::FileWatcher::Watcher.new("./src")
+watcher.start
+
+stats = watcher.stats
+# => { tracked_files: 42, total_changes: 7, last_change_at: 2026-04-26 12:00:00 +0000 }
+```
+
 ## API
 
 ### `FileWatcher.watch(paths, interval:, glob:, exclude:, debounce:, &block)`
@@ -161,6 +173,7 @@ Blocking method. Stops on `Interrupt` (Ctrl+C).
 | `#resume` | Resume change detection with a fresh snapshot |
 | `#paused?` | Returns `true` if the watcher is currently paused |
 | `#snapshot` | Returns a hash of `{path => {mtime:, size:}}` for all tracked files |
+| `#stats` | Returns a hash with `:tracked_files`, `:total_changes`, and `:last_change_at` |
 
 ### `FileWatcher::Change`
 

data/lib/philiprehberger/file_watcher/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module FileWatcher
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/file_watcher/watcher.rb

@@ -27,6 +27,8 @@ module Philiprehberger
         @paused = false
         @snapshot = {}
         @pending_debounce = {}
+        @total_changes = 0
+        @last_change_at = nil
       end
 
       # Register a callback for a specific change type.
@@ -122,6 +124,22 @@ module Philiprehberger
         end
       end
 
+      # Return runtime statistics for the watcher.
+      #
+      # The returned hash is a fresh copy on each call and safe to mutate.
+      #
+      # @return [Hash] with keys :tracked_files (Integer), :total_changes (Integer),
+      #   and :last_change_at (Time or nil)
+      def stats
+        @mutex.synchronize do
+          {
+            tracked_files: @snapshot.size,
+            total_changes: @total_changes,
+            last_change_at: @last_change_at
+          }
+        end
+      end
+
       private
 
       def poll_loop
@@ -148,6 +166,10 @@ module Philiprehberger
         @mutex.synchronize do
           changes = diff_snapshots(@snapshot, current)
           @snapshot = current
+          unless changes.empty?
+            @total_changes += changes.size
+            @last_change_at = Time.now
+          end
           changes
         end
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-file_watcher
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-10 00:00:00.000000000 Z
+date: 2026-04-27 00:00:00.000000000 Z
 dependencies: []
 description: Watch files and directories for changes using polling. Detects created,
   modified, and deleted files with configurable intervals and glob patterns.