build-files-monitor 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc294beb63007df048c526b2abe799af14d0aa5d040e3214ed31d591069e6d7a
-  data.tar.gz: 06c730436214773e196f13609b14480abf13bed1f36b12931460e15d65cb6824
+  metadata.gz: 435b84b61738b4e31fed992817a7580797c30f2099e1d3e4188e3ce535f92cf0
+  data.tar.gz: ea1f935718b7982f5469a2609603527758b5287f0869058f98d6ba6451fff82b
 SHA512:
-  metadata.gz: 24de9553d6f3e355647ab78f40091ced0312384b21b7d83dca687b245b576247d436c85d3be0ce44c93b85098653d6e9f640cf414c751183474ffd41bfb0f2ca
-  data.tar.gz: 923acb9c41bd4907c116f8a233e8978c945ba926279caab15ade0e5195796eabd9528c62c73e89fd983f036b3527699a1c1f2e139f7de88bee948c7636d2f0f1
+  metadata.gz: d5efe0b08fd6565f8a9e4b8a6f63839f226b76412854e24b5b65361ce1dc40ae06c63a4da9cdb4fe3fa3bdfdd9378a2de37e78730ff4b20eb095fdddfa5b0343
+  data.tar.gz: 9f628a544ac79fad1d0d908e8f9253c4180ec3cfd54d539fb319f53c297d0d5a626978cde1373df708b96f71fa8ce42e539413f9f4e11c0f12579fe01c7ff201

data/lib/build/files/monitor/handle.rb

@@ -1,45 +1,46 @@
-# Copyright, 2014, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
+# frozen_string_literal: true
 
-require 'build/files/state'
+# Released under the MIT License.
+# Copyright, 2021-2025, by Samuel Williams.
+
+require "build/files/state"
 
 module Build
 	module Files
 		module Monitor
+			# Represents a tracked set of files with an associated callback.
+			# 
+			# A handle is created when you call {Polling#track_changes} and connects a set of files to a callback block that fires when changes are detected. The handle maintains the state of monitored files and can be removed from the monitor when no longer needed.
 			class Handle
+				# Initialize a new handle.
+				# 
+				# @parameter monitor [Polling] The monitor that owns this handle.
+				# @parameter files [List] The list of files to track.
+				# @parameter block [Proc] The callback to invoke when changes are detected.
 				def initialize(monitor, files, &block)
 					@monitor = monitor
 					@state = State.new(files)
 					@block = block
 				end
-			
+				
+				# @attribute [Polling] The monitor that owns this handle.
 				attr :monitor
-			
+				
+				# Update the internal state of tracked files.
+				# 
+				# This method forces an update of the file state without invoking the callback.
 				def commit!
 					@state.update!
 				end
-			
+				
+				# @returns [Array(Path)] The root directories being monitored by this handle.
 				def directories
 					@state.files.roots
 				end
-			
+				
+				# Remove this handle from the monitor.
+				# 
+				# After calling this method, the callback will no longer be invoked when changes are detected.
 				def remove!
 					@monitor.delete(self)
 				end
@@ -52,6 +53,7 @@ module Build
 					end
 				end
 				
+				# @returns [String] A string representation of the handle.
 				def to_s
 					"\#<#{self.class} @state=#{@state} @block=#{@block}>"
 				end

data/lib/build/files/monitor/native.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2021-2025, by Samuel Williams.
+
+require_relative "polling"
+require "io/watch"
+
+module Build
+	module Files
+		module Monitor
+			# A platform-specific filesystem monitor using native OS APIs.
+			# 
+			# This implementation uses platform-specific APIs (FSEvent on macOS, INotify on Linux) for efficient, event-driven file monitoring. It extends {Polling} but replaces the polling mechanism with native filesystem events.
+			class Native < Polling
+				# Run the monitor using native filesystem events.
+				# 
+				# This method blocks until interrupted via `throw :interrupt`. Unlike {Polling#run}, this uses native OS events rather than polling.
+				# 
+				# @yields After each filesystem event.
+				def run(**options, &block)
+					catch(:interrupt) do
+						while true
+							run_roots(self.roots, **options, &block)
+						end
+					end
+				end
+				
+				# Monitor the specified roots for changes using native events.
+				# 
+				# @parameter roots [Array(String)] The root directories to monitor.
+				# @yields {...} After each filesystem event.
+				# @returns [Boolean] True if the set of monitored directories was updated.
+				def run_roots(roots, **options, &block)
+					monitor = IO::Watch::Monitor.new(self.roots, **options)
+					
+					monitor.run do |event|
+						if root = event[:root]
+							self.update([root])
+							
+							yield if block_given?
+							
+							if self.updated
+								return true
+							end
+						end
+					end
+					
+					return false
+				end
+			end
+		end
+	end
+end

data/lib/build/files/monitor/polling.rb

@@ -1,32 +1,23 @@
-# Copyright, 2014, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
+# frozen_string_literal: true
 
-require 'set'
-require 'logger'
+# Released under the MIT License.
+# Copyright, 2021-2025, by Samuel Williams.
 
-require_relative 'handle'
+require "set"
+require "logger"
+
+require_relative "handle"
 
 module Build
 	module Files
 		module Monitor
+			# A cross-platform filesystem monitor that uses polling to detect changes.
+			# 
+			# This implementation works on all platforms by periodically checking file modification times. While less efficient than platform-specific native implementations, it provides a reliable fallback for platforms without native filesystem event support.
 			class Polling
+				# Initialize a new polling monitor.
+				# 
+				# @parameter logger [Logger] Optional logger for debugging monitor activity.
 				def initialize(logger: nil)
 					@directories = Hash.new do |hash, key|
 						hash[key] = Set.new
@@ -39,6 +30,7 @@ module Build
 					@logger = logger || Logger.new(nil)
 				end
 				
+				# @attribute [Boolean] Whether the set of monitored directories has been updated.
 				attr :updated
 				
 				# Notify the monitor that files in these directories have changed.
@@ -59,10 +51,14 @@ module Build
 					end
 				end
 				
+				# @returns [Array(String)] The root directories currently being monitored.
 				def roots
 					@directories.keys
 				end
 				
+				# Delete a handle from the monitor.
+				# 
+				# @parameter handle [Handle] The handle to remove.
 				def delete(handle)
 					if @deletions
 						@logger.debug{"Delayed delete handle: #{handle}"}
@@ -72,12 +68,22 @@ module Build
 					end
 				end
 				
+				# Track changes to a set of files.
+				# 
+				# @parameter files [List] The list of files to monitor.
+				# @yields {|state| ...} When changes are detected.
+				# 	@parameter state [State] The current state with information about added, changed, and removed files.
+				# @returns [Handle] A handle that can be used to stop tracking these files.
 				def track_changes(files, &block)
 					handle = Handle.new(self, files, &block)
 					
 					add(handle)
 				end
 				
+				# Add a handle to the monitor.
+				# 
+				# @parameter handle [Handle] The handle to add.
+				# @returns [Handle] The added handle.
 				def add(handle)
 					@logger.debug{"Adding handle: #{handle}"}
 					
@@ -97,14 +103,20 @@ module Build
 					handle
 				end
 				
-				def run(**options, &block)
+				# Run the monitor loop, checking for changes at regular intervals.
+				# 
+				# This method blocks until interrupted via `throw :interrupt`. It continuously polls the filesystem for changes and invokes registered callbacks.
+				# 
+				# @parameter latency [Numeric] The time in seconds to wait between checks (default: 0.1).
+				# @yields After each check cycle.
+				def run(latency: 0.1, **options, &block)
 					catch(:interrupt) do
 						while true
-							monitor.update(monitor.roots)
+							self.update(self.roots)
 							
-							yield
+							yield if block_given?
 							
-							sleep(options[:latency] || 1.0)
+							sleep(latency)
 						end
 					end
 				end

data/lib/build/files/monitor/version.rb

@@ -1,29 +1,12 @@
 # frozen_string_literal: true
 
-# Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
+# Released under the MIT License.
+# Copyright, 2021-2024, by Samuel Williams.
 
 module Build
 	module Files
 		module Monitor
-			VERSION = "0.2.1"
+			VERSION = "0.4.0"
 		end
 	end
 end

data/lib/build/files/monitor.rb

@@ -1,43 +1,24 @@
-# Copyright, 2014, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
+# frozen_string_literal: true
 
+# Released under the MIT License.
+# Copyright, 2021-2025, by Samuel Williams.
+
+require_relative "monitor/native"
+
+# @namespace
 module Build
+	# @namespace
 	module Files
+		# @namespace
 		module Monitor
-			case RUBY_PLATFORM
-			when /linux/i
-				require_relative 'monitor/inotify'
-				Native = INotify
-				Default = Native
-			when /darwin/i
-				require_relative 'monitor/fsevent'
-				Native = FSEvent
-				Default = Native
-			else 
-				require_relative 'monitor/polling'
-				Default = Polling
-			end
-		
+			# Create a new monitor instance.
+			# 
+			# This factory method creates a monitor that uses platform-specific native filesystem event APIs (FSEvent on macOS, INotify on Linux, etc.) via the `io-watch` gem for efficient, event-driven file monitoring.
+			# 
+			# @returns [Native] A new native monitor instance.
 			def self.new(*arguments, **options)
-				Default.new(*arguments, **options)
+				Native.new(*arguments, **options)
 			end
 		end
 	end
-end
+end

data/license.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright, 2021-2025, by Samuel Williams.  
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/readme.md

@@ -0,0 +1,55 @@
+# Build::Files::Monitor
+
+Efficiently monitor the filesystem for changes.
+
+[![Development Status](https://github.com/ioquatix/build-files-monitor/workflows/Test/badge.svg)](https://github.com/ioquatix/build-files-monitor/actions?workflow=Test)
+
+## Usage
+
+Please see the [project documentation](https://ioquatix.github.io/build-files-monitor/) for more details.
+
+  - [Getting Started](https://ioquatix.github.io/build-files-monitor/guides/getting-started/index) - This guide explains how to use `build-files-monitor` to efficiently monitor the filesystem for changes.
+
+## Releases
+
+Please see the [project releases](https://ioquatix.github.io/build-files-monitor/releases/index) for all releases.
+
+### v0.4.0
+
+  - Use `io-watch` for filesystem monitoring.
+
+### v0.3.0
+
+  - Internal refactoring.
+
+### v0.2.1
+
+  - Fixed compatibility of keyword arguments in `Monitor.new` to properly forward both positional and keyword arguments.
+
+### v0.2.0
+
+  - Moved `State` class to `build-files` gem. Users should now `require 'build/files/state'` instead of `require 'build/files/monitor/state'`.
+
+### v0.1.0
+
+  - Initial release.
+  - Support for filesystem monitoring with platform-specific implementations (`Build::Files::Monitor::Native` using FSEvent/INotify).
+  - Fallback polling implementation (`Build::Files::Monitor::Polling`).
+
+## Contributing
+
+We welcome contributions to this project.
+
+1.  Fork it.
+2.  Create your feature branch (`git checkout -b my-new-feature`).
+3.  Commit your changes (`git commit -am 'Add some feature'`).
+4.  Push to the branch (`git push origin my-new-feature`).
+5.  Create new Pull Request.
+
+### Developer Certificate of Origin
+
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
+
+### Community Guidelines
+
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

data/releases.md

@@ -0,0 +1,23 @@
+# Releases
+
+## v0.4.0
+
+  - Use `io-watch` for filesystem monitoring.
+
+## v0.3.0
+
+  - Internal refactoring.
+
+## v0.2.1
+
+  - Fixed compatibility of keyword arguments in `Monitor.new` to properly forward both positional and keyword arguments.
+
+## v0.2.0
+
+  - Moved `State` class to `build-files` gem. Users should now `require 'build/files/state'` instead of `require 'build/files/monitor/state'`.
+
+## v0.1.0
+
+  - Initial release.
+  - Support for filesystem monitoring with platform-specific implementations (`Build::Files::Monitor::Native` using FSEvent/INotify).
+  - Fallback polling implementation (`Build::Files::Monitor::Polling`).

metadata

@@ -1,42 +1,42 @@
 --- !ruby/object:Gem::Specification
 name: build-files-monitor
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Samuel Williams
-autorequire:
 bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIEhDCCAuygAwIBAgIBATANBgkqhkiG9w0BAQsFADA3MTUwMwYDVQQDDCxzYW11
-  ZWwud2lsbGlhbXMvREM9b3Jpb250cmFuc2Zlci9EQz1jby9EQz1uejAeFw0yMTA4
-  MTYwNjMzNDRaFw0yMjA4MTYwNjMzNDRaMDcxNTAzBgNVBAMMLHNhbXVlbC53aWxs
-  aWFtcy9EQz1vcmlvbnRyYW5zZmVyL0RDPWNvL0RDPW56MIIBojANBgkqhkiG9w0B
-  AQEFAAOCAY8AMIIBigKCAYEAyXLSS/cw+fXJ5e7hi+U/TeChPWeYdwJojDsFY1xr
-  xvtqbTTL8gbLHz5LW3QD2nfwCv3qTlw0qI3Ie7a9VMJMbSvgVEGEfQirqIgJXWMj
-  eNMDgKsMJtC7u/43abRKx7TCURW3iWyR19NRngsJJmaR51yGGGm2Kfsr+JtKKLtL
-  L188Wm3f13KAx7QJU8qyuBnj1/gWem076hzdA7xi1DbrZrch9GCRz62xymJlrJHn
-  9iZEZ7AxrS7vokhMlzSr/XMUihx/8aFKtk+tMLClqxZSmBWIErWdicCGTULXCBNb
-  E/mljo4zEVKhlTWpJklMIhr55ZRrSarKFuW7en0+tpJrfsYiAmXMJNi4XAYJH7uL
-  rgJuJwSaa/dMz+VmUoo7VKtSfCoOI+6v5/z0sK3oT6sG6ZwyI47DBq2XqNC6tnAj
-  w+XmCywiTQrFzMMAvcA7rPI4F0nU1rZId51rOvvfxaONp+wgTi4P8owZLw0/j0m4
-  8C20DYi6EYx4AHDXiLpElWh3AgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8E
-  BAMCBLAwHQYDVR0OBBYEFB6ZaeWKxQjGTI+pmz7cKRmMIywwMC4GA1UdEQQnMCWB
-  I3NhbXVlbC53aWxsaWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWB
-  I3NhbXVlbC53aWxsaWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEB
-  CwUAA4IBgQBVoM+pu3dpdUhZM1w051iw5GfiqclAr1Psypf16Tiod/ho//4oAu6T
-  9fj3DPX/acWV9P/FScvqo4Qgv6g4VWO5ZU7z2JmPoTXZtYMunRAmQPFL/gSUc6aK
-  vszMHIyhtyzRc6DnfW2AiVOjMBjaYv8xXZc9bduniRVPrLR4J7ozmGLh4o4uJp7w
-  x9KCFaR8Lvn/r0oJWJOqb/DMAYI83YeN2Dlt3jpwrsmsONrtC5S3gOUle5afSGos
-  bYt5ocnEpKSomR9ZtnCGljds/aeO1Xgpn2r9HHcjwnH346iNrnHmMlC7BtHUFPDg
-  Ts92S47PTOXzwPBDsrFiq3VLbRjHSwf8rpqybQBH9MfzxGGxTaETQYOd6b4e4Ag6
-  y92abGna0bmIEb4+Tx9rQ10Uijh1POzvr/VTH4bbIPy9FbKrRsIQ24qDbNJRtOpE
-  RAOsIl+HOBTb252nx1kIRN5hqQx272AJCbCjKx8egcUQKffFVVCI0nye09v5CK+a
-  HiLJ8VOFx6w=
+  MIIE2DCCA0CgAwIBAgIBATANBgkqhkiG9w0BAQsFADBhMRgwFgYDVQQDDA9zYW11
+  ZWwud2lsbGlhbXMxHTAbBgoJkiaJk/IsZAEZFg1vcmlvbnRyYW5zZmVyMRIwEAYK
+  CZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJuejAeFw0yMjA4MDYwNDUz
+  MjRaFw0zMjA4MDMwNDUzMjRaMGExGDAWBgNVBAMMD3NhbXVlbC53aWxsaWFtczEd
+  MBsGCgmSJomT8ixkARkWDW9yaW9udHJhbnNmZXIxEjAQBgoJkiaJk/IsZAEZFgJj
+  bzESMBAGCgmSJomT8ixkARkWAm56MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIB
+  igKCAYEAomvSopQXQ24+9DBB6I6jxRI2auu3VVb4nOjmmHq7XWM4u3HL+pni63X2
+  9qZdoq9xt7H+RPbwL28LDpDNflYQXoOhoVhQ37Pjn9YDjl8/4/9xa9+NUpl9XDIW
+  sGkaOY0eqsQm1pEWkHJr3zn/fxoKPZPfaJOglovdxf7dgsHz67Xgd/ka+Wo1YqoE
+  e5AUKRwUuvaUaumAKgPH+4E4oiLXI4T1Ff5Q7xxv6yXvHuYtlMHhYfgNn8iiW8WN
+  XibYXPNP7NtieSQqwR/xM6IRSoyXKuS+ZNGDPUUGk8RoiV/xvVN4LrVm9upSc0ss
+  RZ6qwOQmXCo/lLcDUxJAgG95cPw//sI00tZan75VgsGzSWAOdjQpFM0l4dxvKwHn
+  tUeT3ZsAgt0JnGqNm2Bkz81kG4A2hSyFZTFA8vZGhp+hz+8Q573tAR89y9YJBdYM
+  zp0FM4zwMNEUwgfRzv1tEVVUEXmoFCyhzonUUw4nE4CFu/sE3ffhjKcXcY//qiSW
+  xm4erY3XAgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
+  BBYEFO9t7XWuFf2SKLmuijgqR4sGDlRsMC4GA1UdEQQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEBCwUAA4IBgQB5sxkE
+  cBsSYwK6fYpM+hA5B5yZY2+L0Z+27jF1pWGgbhPH8/FjjBLVn+VFok3CDpRqwXCl
+  xCO40JEkKdznNy2avOMra6PFiQyOE74kCtv7P+Fdc+FhgqI5lMon6tt9rNeXmnW/
+  c1NaMRdxy999hmRGzUSFjozcCwxpy/LwabxtdXwXgSay4mQ32EDjqR1TixS1+smp
+  8C/NCWgpIfzpHGJsjvmH2wAfKtTTqB9CVKLCWEnCHyCaRVuKkrKjqhYCdmMBqCws
+  JkxfQWC+jBVeG9ZtPhQgZpfhvh+6hMhraUYRQ6XGyvBqEUe+yo6DKIT3MtGE2+CP
+  eX9i9ZWBydWb8/rvmwmX2kkcBbX0hZS1rcR593hGc61JR6lvkGYQ2MYskBveyaxt
+  Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
+  voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2022-05-23 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: build-files
@@ -53,93 +53,38 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.8'
 - !ruby/object:Gem::Dependency
-  name: rb-fsevent
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rb-inotify
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: covered
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rspec
+  name: io-watch
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.4'
-  type: :development
+        version: '0.2'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.4'
-description:
-email:
+        version: '0.2'
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - lib/build/files/monitor.rb
-- lib/build/files/monitor/fsevent.rb
 - lib/build/files/monitor/handle.rb
-- lib/build/files/monitor/inotify.rb
+- lib/build/files/monitor/native.rb
 - lib/build/files/monitor/polling.rb
 - lib/build/files/monitor/version.rb
+- license.md
+- readme.md
+- releases.md
 homepage: https://github.com/ioquatix/build-files-monitor
 licenses:
 - MIT
 metadata:
+  documentation_uri: https://ioquatix.github.io/build-files-monitor/
   funding_uri: https://github.com/sponsors/ioquatix/
-post_install_message:
+  source_code_uri: https://github.com/ioquatix/build-files-monitor.git
 rdoc_options: []
 require_paths:
 - lib
@@ -147,15 +92,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Efficiently monitor changes to the file system.
 test_files: []

data/lib/build/files/monitor/fsevent.rb

@@ -1,55 +0,0 @@
-# Copyright, 2014, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require_relative 'polling'
-
-require 'rb-fsevent'
-
-module Build
-	module Files
-		module Monitor
-			class FSEvent < Polling
-				def run(**options, &block)
-					notifier = ::FSEvent.new
-					
-					catch(:interrupt) do
-						while true
-							notifier.watch self.roots do |directories|
-								directories.collect! do |directory|
-									File.expand_path(directory)
-								end
-								
-								self.update(directories)
-								
-								yield
-								
-								if self.updated
-									notifier.stop
-								end
-							end
-							
-							notifier.run
-						end
-					end
-				end
-			end
-		end
-	end
-end

data/lib/build/files/monitor/inotify.rb

@@ -1,53 +0,0 @@
-# Copyright, 2014, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require_relative 'polling'
-
-require 'rb-inotify'
-
-module Build
-	module Files
-		module Monitor
-			class INotify < Polling
-				def run(**options, &block)
-					notifier = ::INotify::Notifier.new
-					
-					catch(:interrupt) do
-						while true
-							self.roots.each do |root|
-								notifier.watch root, :create, :modify, :attrib, :delete do |event|
-									self.update([root])
-									
-									yield
-									
-									if self.updated
-										notifier.stop
-									end
-								end
-							end
-							
-							notifier.run
-						end
-					end
-				end
-			end
-		end
-	end
-end