winreg 0.1.0 → 0.1.1

metadata

@@ -1,108 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: winreg
 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: |
-  winreg is a native extension exposing the Win32 registry through a typed,
-  hard-to-misuse Ruby API: strict typed readers and writers for REG_SZ,
-  REG_EXPAND_SZ (never auto-expanded), REG_MULTI_SZ (correct double-NUL wire
-  format), REG_DWORD/REG_QWORD (range-checked), and REG_BINARY, with raw
-  escape hatches for adversarial data; default-value access; 32/64-bit
-  registry views as a first-class option applied consistently to child
-  operations; least-privilege KEY_READ defaults; and RegNotifyChangeKeyValue
-  change watching (thread-agnostic registrations, rearm-before-deliver) that
-  blocks cooperatively under a Fiber scheduler and releases the GVL standalone.
-  Windows MSVC (mswin) Ruby only.
+dependencies: []
+description: winreg is discontinued. This final release contains no code and exists
+  only so that installing winreg explains the discontinuation instead of building
+  an unmaintained native extension.
 executables: []
-extensions:
-- ext/winreg/extconf.rb
+extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - LICENSE.txt
 - README.md
-- ext/winreg/extconf.rb
-- ext/winreg/winreg.c
 - lib/winreg.rb
-- lib/winreg/version.rb
-homepage: https://github.com/main-path/winreg
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/main-path/winreg
-  source_code_uri: https://github.com/main-path/winreg
-  changelog_uri: https://github.com/main-path/winreg/blob/main/CHANGELOG.md
-  bug_tracker_uri: https://github.com/main-path/winreg/issues
   rubygems_mfa_required: 'true'
+post_install_message: winreg is discontinued and this release contains no code. Use
+  win32-registry (Ruby's bundled `require "win32/registry"`) instead.
 rdoc_options: []
 require_paths:
 - lib
@@ -110,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:
   - - ">="
@@ -119,6 +41,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: 'Typed Windows registry access for Ruby: exact wire formats, WOW64 views,
-  least-privilege opens, and change notification.'
+summary: Discontinued. Use win32-registry (Ruby's bundled `require "win32/registry"`)
+  instead.
 test_files: []

data/CHANGELOG.md

@@ -1,42 +0,0 @@
-# Changelog
-
-## [0.1.0] - 2026-06-01
-
-Initial release.
-
-- **Typed reads** — strict `string`/`dword`/`qword`/`multi_string`/`binary`
-  readers (and their `?` no-raise-on-missing variants) plus a generic
-  `read`/`read?` returning `[type, value]`. REG_SZ/REG_EXPAND_SZ decode to UTF-8
-  with at most one trailing NUL stripped (unterminated values round-trip);
-  REG_EXPAND_SZ is never auto-expanded; REG_MULTI_SZ decodes to `Array<String>`
-  tolerating missing/excess terminators; REG_DWORD/REG_QWORD are size-checked.
-- **Typed writes** — `write_string`, `write_expand_string`, `write_multi_string`
-  (correct double-NUL wire format), range-checked `write_dword`/`write_qword`,
-  `write_binary`, and the generic `write(name, type, value)`. Embedded NULs and
-  empty REG_MULTI_SZ elements are rejected, so the gem never produces a malformed
-  value.
-- **Raw escape hatches** — `raw`/`write_raw` move exact bytes under an arbitrary
-  type tag, never decoding, for forensic and adversarial data.
-- **Default value** — `nil`/`""` addresses the unnamed default value for every
-  read/write/delete/probe.
-- **WOW64 views** — `view: :v64`/`:v32` is a first-class constructor option,
-  stored on the `Key` and re-applied consistently to every child open/create,
-  `delete_key`, `key?` probe, and `Watch` handle; children cannot override it.
-- **Least-privilege opens** — `access: :read` is `KEY_READ`; writes demand an
-  explicit `access: :read_write`; `KEY_ALL_ACCESS` appears nowhere.
-- **Enumeration & metadata** — `each_value`/`each_key`/`value_names`/`key_names`
-  (16,383-char value names) and `info` (counts + 100ns-precision
-  `last_write_time`).
-- **Subkeys** — handle-relative `open`/`create` and `delete_key`
-  (`recursive: true` does a view-aware, interruptible, deepest-first walk).
-- **Change notification** — `Key#watch` returns a `Winreg::Watch` (or loops in
-  block form); `wait` returns `:changed`/`:deleted`/`nil`. Registrations are
-  `REG_NOTIFY_THREAD_AGNOSTIC` and rearmed before delivery (no final state is
-  ever missed); waits release the GVL and are interruptible standalone, and run
-  cooperatively under a fiber scheduler (winloop) via a worker-thread offload.
-- Error taxonomy under `Winreg::Error`: `OSError` (with `#code`) and its
-  `NotFound`/`AccessDenied`/`KeyDeleted` subclasses, plus `TypeMismatch`,
-  `MalformedValue`, and `Closed`.
-
-Pure C extension over advapi32 + kernel32 (`rb_raise`/longjmp-safe; every handle
-freed by a TypedData finalizer). Windows MSVC (mswin) Ruby only.

data/ext/winreg/extconf.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-#
-# extconf.rb for the winreg extension — typed Windows registry access and
-# change notification (RegNotifyChangeKeyValue).
-
-require "mkmf"
-
-unless RbConfig::CONFIG["target_os"] =~ /mswin/
-  abort <<~MSG
-    winreg requires a native Windows MSVC (mswin) Ruby — it binds the Win32
-    registry (RegOpenKeyExW/RegSetValueExW/RegNotifyChangeKeyValue) and is
-    built with cl.exe. Your Ruby is "#{RbConfig::CONFIG['arch']}".
-  MSG
-end
-
-# System import libs (bare "NAME.lib" tokens on mswin):
-#   advapi32 - registry APIs (RegOpenKeyExW/RegQueryValueExW/RegSetValueExW/
-#              RegEnumValueW/RegEnumKeyExW/RegQueryInfoKeyW/RegDeleteKeyExW/
-#              RegDeleteValueW/RegNotifyChangeKeyValue)
-# kernel32 (events, WaitForMultipleObjects, ExpandEnvironmentStringsW) is
-# linked by default. Pure C — no -EHsc, so rb_raise/longjmp is the normal,
-# safe error mechanism.
-$libs = [$libs, "advapi32.lib"].join(" ")
-
-create_makefile("winreg/winreg")