winsvc 0.1.0 → 0.1.1

metadata

@@ -1,107 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: winsvc
 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: |
-  winsvc runs a Ruby process as a Windows service (SERVICE_WIN32_OWN_PROCESS)
-  with correct service-control-manager integration: the control handler is
-  pure C (no Ruby ever runs on an SCM thread), controls arrive on a
-  Thread::Queue (fiber-scheduler cooperative), SERVICE_STOPPED is reported
-  exactly once, and checkpoints are only ever honest. The same block runs
-  unchanged as a console program for development. Includes a minimal
-  installer (CreateServiceW, delayed auto-start, restart-on-failure recovery)
-  and a correctly quoted sc.exe command generator. Windows MSVC (mswin) Ruby
-  only.
+dependencies: []
+description: winsvc is discontinued. This final release contains no code and exists
+  only so that installing winsvc explains the discontinuation instead of building
+  an unmaintained native extension.
 executables: []
-extensions:
-- ext/winsvc/extconf.rb
+extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - LICENSE.txt
 - README.md
-- ext/winsvc/extconf.rb
-- ext/winsvc/winsvc.c
 - lib/winsvc.rb
-- lib/winsvc/version.rb
-homepage: https://github.com/main-path/winsvc
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/main-path/winsvc
-  source_code_uri: https://github.com/main-path/winsvc
-  changelog_uri: https://github.com/main-path/winsvc/blob/main/CHANGELOG.md
-  bug_tracker_uri: https://github.com/main-path/winsvc/issues
   rubygems_mfa_required: 'true'
+post_install_message: winsvc is discontinued and this release contains no code. Use
+  win32-service, or a service wrapper such as WinSW, Servy or shawl instead.
 rdoc_options: []
 require_paths:
 - lib
@@ -109,7 +32,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -118,5 +41,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: 'Host Ruby as a Windows service: SCM integration with a console dev mode.'
+summary: Discontinued. Use win32-service, or a service wrapper such as WinSW, Servy
+  or shawl instead.
 test_files: []

data/CHANGELOG.md

@@ -1,53 +0,0 @@
-# Changelog
-
-## [0.1.0] - 2026-06-27
-
-Initial release.
-
-- **`Winsvc.run(name, accept:, start_wait_hint:, stop_wait_hint:, manual_ready:,
-  log:) { |svc| ... }`** — host a Ruby process as a
-  `SERVICE_WIN32_OWN_PROCESS` Windows service. The control handler is pure C (no
-  Ruby ever runs on an SCM thread); controls are marshalled through a fixed-size
-  C ring + kernel event into a real Ruby pump thread that drains them onto a
-  `Thread::Queue`. The identical block runs unchanged as a **console program**
-  (dispatcher failure 1063 ⇒ console mode), where Ctrl-C/Ctrl-Break injects a
-  synthetic `:stop` and a second Ctrl-C terminates. `SERVICE_STOPPED` is reported
-  **exactly once**, from `ServiceMain`, after Ruby has fully unwound; every
-  status report executes atomically under one host critical section. A block
-  exception writes its backtrace to the log and flushes it **before** STOPPED,
-  then reports `1066`/specific `1` and re-raises.
-- **`Winsvc::Service`** — the yielded object: `wait(timeout:)` (parks the fiber
-  under a scheduler, blocks the thread without one), `stop_requested?`
-  (interlocked, earlier than queue delivery), `each_control`, `ready!` /
-  `running!` / `paused!` / `checkpoint!(wait_hint:)` (no-ops in console mode,
-  after a latched stop, and after STOPPED — guarded under the host lock),
-  `args` (start parameters / ARGV), `service?` / `console?`.
-- **`Winsvc::Control`** — a frozen struct (`control`, `event_type`, `session_id`,
-  `data`, `time`, `stop?`) for `:stop`, `:shutdown`, `:preshutdown`, `:pause`,
-  `:continue`, `:power` (raw `POWERBROADCAST_SETTING` bytes, ≤ 512, truncated),
-  and `:session_change` (`WTS_*` + session id).
-- **`Winsvc.install` / `Winsvc.uninstall` / `Winsvc.install_command`** — a
-  minimal installer over `CreateServiceW` with `:demand` / `:auto` /
-  `:delayed_auto` start, account/password, description, `preshutdown_timeout:`,
-  and `restart_on_failure:` (three `SC_ACTION_RESTART` entries +
-  failure-actions-on-non-crash flag, composing with the 1066 exception exit).
-  `install` composes binPath with correct quoting and refuses embedded double
-  quotes; config-step failures roll the create back via `DeleteService`.
-  `uninstall` stops the service first (bounded poll, retrying 1061/1062) and
-  raises `TimeoutError` rather than zombifying a running service.
-  `install_command` emits the correctly quoted `sc.exe` incantation(s) and is a
-  pure function sharing the binPath composer with `install`.
-- **Cooperative under [winloop](https://github.com/main-path/winloop)** with zero
-  winloop-specific code — the integration point is `Thread::Queue`. Blocking C
-  waits release the GVL with a cancel-capable unblock function, so `Thread#kill` /
-  Ctrl-C / VM shutdown break them.
-- Error taxonomy under `Winsvc::Error`: `OSError` (with `#code`) → `AccessDenied`,
-  `Exists`, `NotFound`, `MarkedForDelete`, `TimeoutError`; plus `StateError` for
-  API misuse.
-
-Pure C extension over advapi32 (+ kernel32) — `rb_raise`/longjmp-safe; native
-state is a documented process singleton (one `StartServiceCtrlDispatcherW` per
-process, ever). Requires Ruby **3.2+** (`Thread::Queue#pop(timeout:)`). Windows
-MSVC (mswin) Ruby only.
-
-[0.1.0]: https://github.com/main-path/winsvc/releases/tag/v0.1.0

data/ext/winsvc/extconf.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-#
-# extconf.rb for the winsvc extension — hosts a Ruby process as a Windows
-# service (SERVICE_WIN32_OWN_PROCESS) with correct SCM integration.
-
-require "mkmf"
-
-unless RbConfig::CONFIG["target_os"] =~ /mswin/
-  abort <<~MSG
-    winsvc requires a native Windows MSVC (mswin) Ruby — it binds the Windows
-    service control manager (StartServiceCtrlDispatcherW / SetServiceStatus /
-    CreateServiceW) 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.
-# System import libs (bare "NAME.lib" tokens on mswin); kernel32 (events, CS,
-# _beginthreadex via the CRT) is linked by default:
-#   advapi32 - all winsvc.h APIs (dispatcher, handler registration, status, SCM client)
-$libs = [$libs, "advapi32.lib"].join(" ")
-
-create_makefile("winsvc/winsvc")