winwatch 0.1.0 → 0.1.1

metadata

@@ -1,109 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: winwatch
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - ned
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rake-compiler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: vcvars
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.1.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.1.1
-description: |
-  winwatch watches a directory (optionally a whole subtree) with a single
-  overlapped ReadDirectoryChangesW operation and delivers :added/:modified/
-  :removed/:renamed events with absolute UTF-8 paths. Kernel buffer overflow is
-  surfaced as an explicit :rescan event (never silently dropped) and a dying
-  watch (root deleted, network loss) as a terminal :gone event. Blocking pulls
-  release the GVL and are interrupt-safe; under the winloop fiber scheduler the
-  watcher parks fibers on the loop's completion port with zero extra threads.
-
-  Public API: Winwatch.watch(path, recursive:, filter:, buffer_size:,
-  normalize_names:) with a block form, Watcher#take/#each/#close, and a frozen
-  Winwatch::Event struct. Windows MSVC (mswin) Ruby only.
+dependencies: []
+description: winwatch is discontinued. This final release contains no code and exists
+  only so that installing winwatch explains the discontinuation instead of building
+  an unmaintained native extension.
 executables: []
-extensions:
-- ext/winwatch/extconf.rb
+extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - LICENSE.txt
 - README.md
-- ext/winwatch/extconf.rb
-- ext/winwatch/winwatch.c
 - lib/winwatch.rb
-- lib/winwatch/version.rb
-homepage: https://github.com/main-path/winwatch
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/main-path/winwatch
-  source_code_uri: https://github.com/main-path/winwatch
-  changelog_uri: https://github.com/main-path/winwatch/blob/main/CHANGELOG.md
-  bug_tracker_uri: https://github.com/main-path/winwatch/issues
   rubygems_mfa_required: 'true'
+post_install_message: winwatch is discontinued and this release contains no code.
+  Use listen (with wdm on Windows) instead.
 rdoc_options: []
 require_paths:
 - lib
@@ -111,7 +32,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -120,6 +41,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: ReadDirectoryChangesW directory watching for Ruby — lossless overflow signaling,
-  fiber-cooperative under winloop.
+summary: Discontinued. Use listen (with wdm on Windows) instead.
 test_files: []

data/CHANGELOG.md

@@ -1,35 +0,0 @@
-# Changelog
-
-## [0.1.0] - 2026-06-27
-
-Initial release.
-
-- `Winwatch.watch(path, recursive:, filter:, buffer_size:, normalize_names:)` — the single
-  validated entry point, with a block form that ensure-closes the watcher.
-- `Winwatch::Watcher#take(timeout:)` — the blocking pull; returns a non-empty
-  `Array<Winwatch::Event>` or `nil` on timeout, releases the GVL, and is interrupt-safe
-  (`Thread#kill` / Ctrl-C / `Timeout` break an infinite wait via a per-op `CancelIoEx`).
-- `Winwatch::Watcher#each` — yields events forever; returns after the terminal `:gone` event
-  or when the watcher is closed from elsewhere.
-- `Winwatch::Watcher#close` / `#closed?` — idempotent, safe from any thread/fiber.
-- `Winwatch::Watcher#path` / `#recursive?` / `#filter` / `#buffer_size` / `#mode`.
-- `Winwatch::Event(type, path, from, code)` — frozen, pattern-matchable; six types
-  `:added` / `:modified` / `:removed` / `:renamed` / `:rescan` / `:gone`. Paths are absolute,
-  UTF-8, forward-slash separated.
-- **Lossless overflow signaling**: a kernel buffer overflow surfaces as one `:rescan` event
-  (all three RDCW spellings funnel to it), never a silent drop and never an exception.
-- **Terminal `:gone`**: a dying watch (root deleted, volume dismounted, network loss) surfaces
-  as one `:gone` event with the Win32 `code`, then auto-closes. `FILE_SHARE_DELETE` means the
-  watched root stays deletable.
-- **Fiber-cooperative under winloop**: a `:winloop` mode (gate
-  `Fiber.scheduler.respond_to?(:await_op)`, winloop ≥ 0.2) parks fibers on the loop's IOCP
-  with zero extra threads; a `:standalone` mode works everywhere else, offloading to a
-  `run_blocking` worker under any other active scheduler.
-- `Winwatch.run_blocking` / `Winwatch.ms_for` — the suite's worker-offload and timeout
-  helpers.
-- Errors: `Winwatch::Error` → `OSError` (`#code`) → `NotFound` / `AccessDenied` /
-  `Unsupported`; `NotADirectory` and `Closed` subclass `Error` directly.
-
-Windows MSVC (mswin) Ruby only.
-
-[0.1.0]: https://github.com/main-path/winwatch/releases/tag/v0.1.0

data/ext/winwatch/extconf.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-#
-# extconf.rb for the winwatch extension — ReadDirectoryChangesW directory
-# watching with overlapped (async) directory I/O.
-
-require "mkmf"
-
-unless RbConfig::CONFIG["target_os"] =~ /mswin/
-  abort <<~MSG
-    winwatch requires a native Windows MSVC (mswin) Ruby — it binds
-    ReadDirectoryChangesW and overlapped directory I/O, and is built with
-    cl.exe. Your Ruby is "#{RbConfig::CONFIG['arch']}".
-  MSG
-end
-
-# Pure C — no -EHsc, so rb_raise/longjmp is the normal, safe error mechanism.
-# kernel32 only (linked by default): CreateFileW / ReadDirectoryChangesW /
-# CancelIoEx / event waits / GetOverlappedResult / GetLongPathNameW.
-create_makefile("winwatch/winwatch")