vcdeps 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cadbf9c576136cf47846e8c790890fd9225e01aea337edc0a83786b8aa4dfe11
-  data.tar.gz: 7e5a5401c339286ed4c03cf40536446c97ba02c1713525913bdee2e2107d29ab
+  metadata.gz: a72a92f5f224eac26210881a8d240687611f1a143dd3b9d1f648bc2593db9e4a
+  data.tar.gz: 61ca6e252ee0455c494b5290290bbc97fba66c960580562f967b6f1143bfe97d
 SHA512:
-  metadata.gz: a774c5f893e1b28d4e9db594b45d45fc199f8e91543fd18b05c8b23295a7a89b458347d0173adf6fd54efe8e8566a002f065fb3409433f228f044b2ebfe0c70c
-  data.tar.gz: 0ba6b42201244938ac887d4e9755f1c25d398c6d62a50fd6d28f09033565d33f581a6b6b977aa257450d17d83f4328a433c094b37e34e53c7bfc2df34521797f
+  metadata.gz: 65e2725d60ace8635b5434e73cc9ec34cd6bcd0debb0996aeaeb83504c63352e81184502571d5efe4677117203408ac8b30384cbd6abeab288b0f7f2610002b0
+  data.tar.gz: dbbcdf8aa111ff94b23b611a5275dea4646b9d55c1d1ca4a2c093bdc7d867879fce3cbedbbb22809ad44a84626403459f9e1ba69acdc18dea9b38ad12f6064dd

data/README.md

@@ -1,258 +1,11 @@
-# vcdeps
-
-**vcpkg-powered native dependencies for Ruby C extensions on Windows — declare ports in a manifest, get correct mkmf flags and loadable runtime DLLs, no global state.**
-
-Building a Ruby C extension against zlib, bzip2, or libxml2 on a native MSVC
-(mswin) Ruby has two classic walls. First the compiler can't find the headers:
-
-```
-fatal error C1083: Cannot open include file: 'zlib.h': No such file or directory
-```
-
-You fix that, link, build a `.so` — and then it still won't load:
-
-```
-LoadError: 126: The specified module could not be found - .../foo.so
-```
-
-because Windows resolves a `.so`'s dependent DLLs through the standard search
-order, which **never** looks in the `.so`'s own directory. vcdeps closes both
-gaps: you declare your native dependencies in a `vcpkg.json` under `ext/`, call
-`Vcdeps.mkmf!` from `extconf.rb`, and vcdeps locates (or bootstraps) vcpkg,
-installs the ports **out of tree** with the dynamic-CRT triplet that matches an
-`-MD` Ruby, prepends the include/lib paths so they win over Ruby's own opt-dir,
-and vendors the runtime DLLs with a generated `Fiddle`-preload shim so the built
-extension actually loads.
-
-It is first of its kind. rake-compiler-dock is author-side MinGW-only
-cross-compilation; rb_sys and ffi-compiler are GCC-oriented; nothing wired vcpkg
-into mkmf before. vcdeps is the companion to [vcvars](https://github.com/main-path/vcvars)
-(which loads the toolchain) the way vcpkg is the companion to MSVC.
-
-## API summary
-
-| What | API |
-|---|---|
-| extconf entry point (install + wire + vendor) | `Vcdeps.mkmf!(vendor:)` |
-| install a manifest's ports out of tree | `Vcdeps.install!(manifest:)` |
-| sync DLLs + licenses + preload shim into a gem | `Vcdeps.vendor!(installed, into:)` |
-| add/refresh `builtin-baseline` | `Vcdeps.baseline!(manifest:)` |
-| locate vcpkg (or raise with remedies) | `Vcdeps.tool` / `Vcdeps.tool!` |
-| bootstrap a private vcpkg | `Vcdeps.bootstrap!` |
-| CLI | `vcdeps doctor / where / install / vendor / baseline / bootstrap` |
-
-## Requirements
-
-- Windows with a native **MSVC (mswin)** Ruby (`RbConfig::CONFIG["target_os"]`
-  matches `/mswin/`). **Not supported on MinGW/UCRT.**
-- Visual Studio 2017+ or Build Tools with the **Desktop development with C++**
-  workload (for `cl.exe` / `nmake`).
-- A vcpkg instance. vcdeps finds one in this order: an explicit `VCPKG_ROOT`,
-  the VS-bundled vcpkg (the **vcpkg package manager** component —
-  `Microsoft.VisualStudio.Component.Vcpkg`, *Recommended* in that workload), a
-  validated `VCPKG_INSTALLATION_ROOT` (GitHub Actions), or a private instance
-  created by `vcdeps bootstrap`.
-- [vcvars](https://github.com/main-path/vcvars) — installed automatically as a
-  runtime dependency.
-
-## Install
-
-```sh
-gem install vcdeps
-```
-
-## Quick start
-
-Four files turn a C extension into a vcpkg-backed gem.
-
-```json
-// ext/foo/vcpkg.json — builtin-baseline is MANDATORY (the VS-bundled and
-// standalone vcpkg are git-registry instances; vcdeps hard-fails without it).
-// Get a SHA with: vcdeps baseline --manifest ext/foo
-{
-  "name": "foo",
-  "version": "0.1.0",
-  "dependencies": ["zlib", "bzip2"],
-  "builtin-baseline": "e5a1490e1409d175932ef6014519e9ae149ddb7c"
-}
-```
-
-```ruby
-# ext/foo/extconf.rb
-# frozen_string_literal: true
-require "mkmf"
-
-unless RbConfig::CONFIG["target_os"] =~ /mswin/
-  abort <<~MSG
-    foo requires a native Windows MSVC (mswin) Ruby — it links vcpkg-built
-    native libraries and is built with cl.exe. Your Ruby is "#{RbConfig::CONFIG['arch']}".
-  MSG
-end
-
-require "vcdeps/mkmf"
-Vcdeps.mkmf!(vendor: File.expand_path("../../lib/foo/vendor", __dir__))
-
-have_header("zlib.h")  or abort "zlib.h not found — run `vcdeps doctor`"
-have_library("zlib")   or abort "zlib.lib not found"   # bare name; LIBARG adds .lib
-have_header("bzlib.h") or abort "bzlib.h not found"
-have_library("bz2")    or abort "bz2.lib not found"    # import-lib name != port name
-create_makefile("foo/foo")
-```
-
-```ruby
-# lib/foo.rb
-# frozen_string_literal: true
-require "foo/version"
-preload = File.expand_path("foo/vendor/preload.rb", __dir__)
-require preload if File.exist?(preload)   # shim absent for static-md / no-DLL builds
-require "foo/foo"                          # the compiled extension
-```
-
-```ruby
-# Rakefile — unchanged suite shape; vcdeps needs no Rake hook (extconf does it all)
-require "vcvars/rake"        # load the MSVC build env so `rake compile` just works
-require "rake/extensiontask"
-require "rake/testtask"
-spec = Gem::Specification.load("foo.gemspec")
-Rake::ExtensionTask.new("foo", spec) { |ext| ext.lib_dir = "lib/foo" }
-Rake::TestTask.new(test: :compile) do |t|
-  t.libs << "test" << "lib"
-  t.test_files = FileList["test/**/test_*.rb"]
-  t.warning = false
-end
-task default: :test
-```
-
-Then `rake compile && rake test`. End users override at install time with
-standard mkmf semantics:
-
-```sh
-gem install foo -- --with-vcdeps-triplet=x64-windows-static-md  # link static, ship no DLLs
-gem install foo -- --with-vcdeps-dir=C:\prebuilt\foo-deps       # bypass vcpkg entirely
-set VCDEPS_BOOTSTRAP=1 && gem install foo                       # consent to private bootstrap
-```
-
-## How loading works
-
-Beside-the-`.so` **does not work**: Windows resolves an extension's dependent
-DLLs as if loaded by module name only, and the search order never checks the
-`.so`'s own directory. "It worked when I ran it from that folder" is the current
-directory (search step 11) fooling you — move the cwd and it breaks. vcdeps
-generates a `preload.rb` shim that `Fiddle.dlopen`s each vendored DLL by
-**absolute path** before the extension loads, so the loaded-module list (search
-step 4, consulted before PATH) satisfies the imports. The
-`x64-windows-static-md` triplet sidesteps the whole problem by linking the
-libraries statically into the `.so` (no DLLs to vendor). One caveat: Ruby's own
-`bin` ships `zlib1.dll` / `ffi-8.dll` / `yaml.dll`; if one is already loaded
-under that name, it wins process-wide — `vcdeps doctor` and `vendor!` warn on
-base-name collisions.
-
-## Precompiled platform gems
-
-The primary audience is **gem authors and their Windows CI** shipping
-precompiled `x64-mswin64-140` gems so end users never compile. Build on Windows
-CI, run `vcdeps vendor --into lib/<gem>/vendor`, then flip
-`spec.platform = Gem::Platform.local`, drop `spec.extensions`, and include
-`lib/<gem>/vendor/**/*` (the DLLs + `preload.rb` shim) in `spec.files`. The
-source path (`gem install` → extconf → vcdeps → vcpkg) still works — it is the
-author's dev loop and the fallback for exotic setups — but a cold libxml2-class
-build at end-user install time is an accepted-but-discouraged slow path: vcdeps
-streams vcpkg output live and leans on vcpkg's binary cache, so it is slow once,
-never silent.
-
-**License note:** vendored ports' `copyright` files ship in `vendor/licenses/`
-for DLL builds **and** static-md builds (under static-md the port code is
-statically linked into the shipped `.so`, so its copyright files are still
-redistributed alongside it). Mind relink obligations for LGPL ports.
-
-## CI recipe
-
-`windows-latest`, a self-provided mswin Ruby (ruby/setup-ruby's `mswin` build is
-x64 ruby-master; there are no RubyInstaller mswin builds). Invoke vcpkg by
-explicit path, let `vcvars/rake` + vcdeps do the rest, and cache the binary
-archives:
-
-```yaml
-- uses: actions/cache@v4
-  with:
-    path: ~/AppData/Local/vcpkg/archives          # or $VCPKG_DEFAULT_BINARY_CACHE
-    key: vcpkg-${{ hashFiles('ext/**/vcpkg.json') }}-x64-windows-${{ env.VCPKG_TOOL_VERSION }}
-- run: bundle exec rake compile
-```
-
-The default `files` binary-cache provider needs no secrets and is immune to
-provider churn (the `x-gha` provider was removed upstream in June 2025 — vcdeps
-never references it). The NuGet-on-GitHub-Packages alternative is also viable;
-note that Microsoft's own docs currently contradict themselves on whether the
-workflow `GITHUB_TOKEN` (with `packages: write`) suffices or a classic PAT is
-required — try `GITHUB_TOKEN` first and fall back to a PAT if pushes return 401.
-
-## Library API
-
-```ruby
-require "vcdeps"
-
-Vcdeps.default_triplet            # => "x64-windows"  (arm64 -> "arm64-windows")
-Vcdeps.home                       # => "C:\\Users\\me\\AppData\\Local\\vcdeps"
-
-Vcdeps.tool                       # => #<struct Vcdeps::Tool ... source=:devenv> or nil
-Vcdeps.tool!                      # raises Vcdeps::ToolNotFound (with remedies) on a miss
-Vcdeps.bootstrap!                 # private vcpkg under <home>\vcpkg (consent-gated)
-
-inst = Vcdeps.install!(manifest: "ext/foo")
-inst.prefix                       # => "...\\installed\\<key>\\x64-windows"
-inst.ports                        # => [#<struct Vcdeps::Port name="zlib" version="1.3.1" ...>]
-inst.dlls                         # => ["...\\bin\\zlib1.dll", ...] (release only, never debug)
-
-Vcdeps.vendor!(inst, into: "lib/foo/vendor")  # DLLs + licenses + preload.rb (a SYNC)
-Vcdeps.install!(manifest: "ext/foo")          # 2nd call: marker hit, returns in <100 ms
-Vcdeps.baseline!(manifest: "ext/foo")         # => "9f3dca…" (writes builtin-baseline)
-```
-
-## Configuration
-
-| Env var | Effect |
-|---|---|
-| `VCDEPS_HOME` | State root (default `%LOCALAPPDATA%\vcdeps`); keep it short + ASCII. |
-| `VCDEPS_TRIPLET` | Triplet override (between `--with-vcdeps-triplet` and the derived default). |
-| `VCDEPS_BOOTSTRAP` | `=1` consents to a private bootstrap from a non-interactive `gem install`. |
-| `VCDEPS_METRICS` | `=1` re-enables vcpkg telemetry (disabled by default — a `gem install` must not phone home). |
-
-Honored vcpkg vars pass through untouched: `VCPKG_ROOT`,
-`VCPKG_DEFAULT_BINARY_CACHE`, `VCPKG_BINARY_SOURCES`, `VCPKG_DOWNLOADS`.
-**Ignored on purpose:** `VCPKG_DEFAULT_TRIPLET` — a machine-global default for
-unrelated C++ projects must never silently change a Ruby extension's ABI.
-
-## Errors
-
-```
-Vcdeps::Error                 (root; everything vcdeps raises)
-├── Vcdeps::ToolNotFound      (no usable vcpkg anywhere — message lists remedies)
-├── Vcdeps::BootstrapError    (private bootstrap failed: download / bootstrap-standalone)
-├── Vcdeps::ManifestError     (vcpkg.json missing/unparsable/missing builtin-baseline)
-├── Vcdeps::TripletError      (unknown arch, static-CRT triplet, arch mismatch)
-└── Vcdeps::InstallError      (`vcpkg install` exited nonzero; carries #command/#status/#log_tail)
-```
-
-API-misuse uses Ruby's own `ArgumentError`/`TypeError`. No error ever prints a
-multi-screen dump; `InstallError#log_tail` is capped at 4000 chars.
-
-## Limitations
-
-- **Manifest mode only** — the VS-bundled and standalone vcpkg instances have no
-  classic mode; vcdeps cannot offer one.
-- **x64 support.** arm64-mswin is expected to work (the code is arch-neutral and
-  triplets derive from `RbConfig`) but is untested and unsupported until an
-  arm64-mswin Ruby distribution exists.
-- **Cold builds are slow** — libxml2-class ports are tens of minutes the first
-  time; the binary cache amortizes it. The first use of a baseline needs network
-  for the registry git-tree fetch.
-- **DLL base-name collisions** across gems, and against Ruby's own `bin\zlib1.dll`
-  et al.: first-loaded wins. vcdeps warns; it cannot arbitrate.
-- **Ctrl-C during an install** kills `vcpkg.exe` (so its install-root lock is
-  released) but not the helper build processes it spawned (`git`/`cmake`/`ninja`/
-  `cl`); they exit on their own. Wait a moment, then rerun.
-
-## License
-
-[MIT](LICENSE.txt).
+# vcdeps (discontinued)
+
+**vcdeps is no longer maintained.** This final release (0.1.1) contains no
+code: installing it compiles nothing, and `require "vcdeps"` raises a
+`LoadError` explaining the discontinuation.
+
+Use `vcpkg install <port>` with mkmf's --with-opt-dir, and Ruby core's `rb msvc` for the toolchain instead.
+
+Earlier releases remain on RubyGems only because RubyGems does not allow
+versions older than 30 days to be yanked. They are unmaintained and not
+recommended.

data/lib/vcdeps.rb

@@ -1,180 +1,4 @@
-# frozen_string_literal: true
-
-require "rbconfig"
-require "fileutils"
-require "tmpdir"
-require "vcdeps/version"
-
-# vcdeps — vcpkg-powered native dependencies for Ruby C extensions on Windows
-# (MSVC). Declare ports in a manifest, get correct mkmf flags and loadable
-# runtime DLLs, no global state. Companion to vcvars (the toolchain) the way
-# vcpkg is companion to MSVC.
-#
-#   # in ext/<gem>/extconf.rb, after require "mkmf":
-#   require "vcdeps/mkmf"
-#   Vcdeps.mkmf!(vendor: File.expand_path("../../lib/foo/vendor", __dir__))
-#
-# Library use:
-#
-#   require "vcdeps"
-#   inst = Vcdeps.install!(manifest: "ext/foo")
-#   Vcdeps.vendor!(inst, into: "lib/foo/vendor")
-#
-# Windows MSVC (mswin) Ruby only. Pure Ruby — no compiler required to install.
-module Vcdeps
-  class Error          < StandardError; end # root; everything vcdeps raises
-  class ToolNotFound   < Error; end         # no usable vcpkg anywhere
-  class BootstrapError < Error; end         # private bootstrap failed
-  class ManifestError  < Error; end         # vcpkg.json missing/unparsable/no baseline
-  class TripletError   < Error; end         # unknown arch, static-CRT triplet, arch mismatch
-
-  # `vcpkg install` exited nonzero. Carries the exact failing argv, the child
-  # exit status, and the last <= 4000 chars of combined output (UTF-8 scrubbed).
-  class InstallError < Error
-    attr_reader :command, :status, :log_tail
-
-    def initialize(message, command:, status:, log_tail:)
-      super(message)
-      @command = command
-      @status = status
-      @log_tail = log_tail
-    end
-  end
-
-  module_function
-
-  # The vcdeps state root: ENV["VCDEPS_HOME"] or %LOCALAPPDATA%\vcdeps.
-  # Deliberately a SHORT path (vcpkg port builds break in deep trees, R§7).
-  def home
-    base = ENV["VCDEPS_HOME"]
-    base = File.join(ENV["LOCALAPPDATA"] || Dir.tmpdir, "vcdeps") if base.nil? || base.empty?
-    base.tr("/", "\\")
-  end
-
-  # Triplet for this Ruby (x64 -> "x64-windows", arm64 -> "arm64-windows", ...).
-  # Raises Vcdeps::TripletError for an unrecognized arch.
-  def default_triplet(arch = RbConfig::CONFIG["arch"])
-    Triplet.default(arch)
-  end
-
-  # Locate a usable vcpkg (§2.3 resolution order). Returns a Tool or nil; with
-  # bootstrap: true a miss bootstraps a private instance instead of nil.
-  def tool(bootstrap: false, out: $stderr)
-    ToolFinder.find(bootstrap: bootstrap, out: out)
-  end
-
-  # tool(), but raises Vcdeps::ToolNotFound (with the three remedies) on a miss.
-  # Default consent for bootstrap comes from ENV so `gem install` can be
-  # unblocked without editing anything.
-  def tool!(bootstrap: ENV["VCDEPS_BOOTSTRAP"] == "1", out: $stderr)
-    found = tool(bootstrap: bootstrap, out: out)
-    return found if found
-
-    raise ToolNotFound, <<~MSG.strip
-      vcdeps: no usable vcpkg found. Pick one of:
-        (a) Install the VS "vcpkg package manager" component
-            (Microsoft.VisualStudio.Component.Vcpkg) — it is Recommended (not
-            Required) in the "Desktop development with C++" workload, so a
-            cl-capable box can still lack it.
-        (b) Set VCPKG_ROOT to an existing vcpkg instance.
-        (c) Run `vcdeps bootstrap` (or set VCDEPS_BOOTSTRAP=1 for non-interactive
-            installs).
-      See `vcdeps doctor` for details.
-    MSG
-  end
-
-  # Create the private, registration-free vcpkg instance under <home>\vcpkg
-  # (the vcpkg-init mechanism, R§2.4). Idempotent. Raises BootstrapError.
-  def bootstrap!(out: $stderr)
-    require "vcdeps/bootstrap"
-    Bootstrap.run!(out: out)
-  end
-
-  # Run `vcpkg install` for <manifest>\vcpkg.json into <home>\installed\<key>.
-  # Streams combined output to `out` (nil to silence). Fast path: a present
-  # .vcdeps-complete marker means the install is provably current and vcpkg is
-  # not invoked (force: true bypasses it). Triplet precedence: kwarg >
-  # ENV["VCDEPS_TRIPLET"] > default_triplet.
-  #
-  # Raises ManifestError / TripletError / ToolNotFound / InstallError.
-  def install!(manifest: Dir.pwd, triplet: nil, tool: nil, force: false, out: $stderr)
-    manifest_dir = File.expand_path(manifest)
-
-    # Pre-flight the manifest BEFORE locating the tool (a missing vcpkg.json or
-    # missing baseline must never invoke vcpkg, §5.1/§5.2).
-    Manifest.load!(manifest_dir)
-
-    resolved_triplet = resolve_triplet(triplet)
-    Triplet.validate!(resolved_triplet)
-
-    resolved_tool = tool || tool!(out: out)
-
-    key = Manifest.key(manifest_dir, resolved_triplet, resolved_tool.version)
-    install_root = File.join(home, "installed", key).tr("/", "\\")
-
-    installed = Installed.new(root: install_root, triplet: resolved_triplet,
-                              manifest_dir: manifest_dir, key: key, tool: resolved_tool)
-
-    # Fast path: marker present and not forced.
-    return installed if !force && Runner.marker_present?(install_root)
-
-    FileUtils.mkdir_p(install_root)
-    command = Runner.install_args(resolved_tool.exe, resolved_triplet,
-                                  manifest_dir, install_root, home)
-    Runner.run_install(command, env: Runner.child_env(resolved_tool.root),
-                       chdir: manifest_dir, out: out)
-    Runner.write_marker!(install_root, key, resolved_tool.version)
-
-    installed
-  end
-
-  # Sync an Installed's runtime DLLs (+ copyright files, + preload shim) into
-  # `into` (§2.2). SYNC, not copy: owns <into>\*.dll, <into>\licenses\* and
-  # <into>\preload.rb. Returns the list of files written.
-  def vendor!(installed, into:, licenses: true, shim: true, out: $stderr)
-    require "vcdeps/vendor"
-    Vendor.sync!(installed, into: File.expand_path(into),
-                 licenses: licenses, shim: shim, out: out)
-  end
-
-  # Write/update "builtin-baseline" in <manifest>\vcpkg.json by running
-  # `vcpkg x-update-baseline --add-initial-baseline` with chdir: manifest.
-  # Returns the resulting baseline SHA (re-read from the manifest).
-  # Raises ManifestError / ToolNotFound / InstallError.
-  def baseline!(manifest: Dir.pwd, tool: nil, out: $stderr)
-    manifest_dir = File.expand_path(manifest)
-    path = File.join(manifest_dir, Manifest::MANIFEST_NAME)
-    unless File.exist?(path)
-      raise ManifestError, "vcdeps: no manifest at #{path.tr('/', '\\')} to add a " \
-        "baseline to."
-    end
-
-    resolved_tool = tool || tool!(out: out)
-    command = [resolved_tool.exe, "x-update-baseline", "--add-initial-baseline"]
-    Runner.run(command, env: Runner.child_env(resolved_tool.root),
-               chdir: manifest_dir, out: out)
-
-    manifest = Manifest.read_json(path)
-    manifest["builtin-baseline"].to_s
-  end
-
-  # Triplet precedence for install! (kwarg > VCDEPS_TRIPLET > default).
-  def resolve_triplet(kwarg)
-    return kwarg if kwarg && !kwarg.to_s.empty?
-
-    env = ENV["VCDEPS_TRIPLET"]
-    return env if env && !env.empty?
-
-    default_triplet
-  end
-  private_class_method :resolve_triplet
-end
-
-require "vcdeps/triplet"
-require "vcdeps/tool"
-require "vcdeps/manifest"
-require "vcdeps/runner"
-require "vcdeps/installed"
-# NOTE: vcdeps/mkmf, vcdeps/vendor, vcdeps/bootstrap, vcdeps/doctor and
-# vcdeps/cli are required lazily (mkmf must never be loaded into a normal
-# process; the others are CLI-only or pulled in on first use).
+# frozen_string_literal: true
+
+raise LoadError, "vcdeps is discontinued and this release contains no code. Use `vcpkg install <port>` with mkmf's --with-opt-dir, and Ruby core's `rb msvc` for the toolchain instead." \
+  " Earlier vcdeps releases are unmaintained and not recommended."

metadata

@@ -1,105 +1,31 @@
 --- !ruby/object:Gem::Specification
 name: vcdeps
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - ned
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies:
-- !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: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.1.1
-- !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: 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'
-description: |
-  vcdeps wires Microsoft's vcpkg package manager into mkmf: declare native
-  dependencies in ext/<gem>/vcpkg.json, call Vcdeps.mkmf! from extconf.rb, and
-  vcdeps locates (or bootstraps) vcpkg, installs the ports out of tree with the
-  correct dynamic-CRT triplet, prepends the include/lib paths so they win over
-  Ruby's own opt-dir, and vendors the runtime DLLs with a generated
-  Fiddle-preload shim so the built extension actually loads.
-
-  It provides a library API (install!/vendor!/baseline!/tool!), the extconf
-  entry point Vcdeps.mkmf!, and a CLI (vcdeps doctor/where/install/vendor/
-  baseline/bootstrap). Manifest mode only; builds and caches live under
-  %LOCALAPPDATA%\vcdeps, never inside the gem. Windows MSVC (mswin) Ruby
-  only. Pure Ruby — no compiler required to install vcdeps itself.
-executables:
-- vcdeps
+dependencies: []
+description: vcdeps is discontinued. This final release contains no code and exists
+  only so that installing vcdeps explains the discontinuation instead of building
+  an unmaintained native extension.
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - LICENSE.txt
 - README.md
-- exe/vcdeps
 - lib/vcdeps.rb
-- lib/vcdeps/bootstrap.rb
-- lib/vcdeps/cli.rb
-- lib/vcdeps/doctor.rb
-- lib/vcdeps/installed.rb
-- lib/vcdeps/manifest.rb
-- lib/vcdeps/mkmf.rb
-- lib/vcdeps/runner.rb
-- lib/vcdeps/tool.rb
-- lib/vcdeps/triplet.rb
-- lib/vcdeps/vendor.rb
-- lib/vcdeps/version.rb
-homepage: https://github.com/main-path/vcdeps
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/main-path/vcdeps
-  source_code_uri: https://github.com/main-path/vcdeps
-  changelog_uri: https://github.com/main-path/vcdeps/blob/main/CHANGELOG.md
-  bug_tracker_uri: https://github.com/main-path/vcdeps/issues
   rubygems_mfa_required: 'true'
+post_install_message: vcdeps is discontinued and this release contains no code. Use
+  `vcpkg install <port>` with mkmf's --with-opt-dir, and Ruby core's `rb msvc` for
+  the toolchain instead.
 rdoc_options: []
 require_paths:
 - lib
@@ -107,7 +33,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:
   - - ">="
@@ -116,6 +42,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: vcpkg-powered native dependencies for Ruby C extensions on Windows (MSVC),
-  companion to vcvars.
+summary: Discontinued. Use `vcpkg install <port>` with mkmf's --with-opt-dir, and
+  Ruby core's `rb msvc` for the toolchain instead.
 test_files: []

data/CHANGELOG.md

@@ -1,43 +0,0 @@
-# Changelog
-
-## [0.1.0] - 2026-06-27
-
-Initial release.
-
-- `Vcdeps.tool` / `Vcdeps.tool!` — locate a usable vcpkg, validated
-  (vcpkg.exe + `.vcpkg-root`), in resolution order: explicit `VCPKG_ROOT`, the
-  VS developer-env `VCPKG_ROOT`, the VS-bundled `VC\vcpkg`, a validated
-  `VCPKG_INSTALLATION_ROOT` (GitHub Actions), then a private bootstrap. `tool!`
-  raises `Vcdeps::ToolNotFound` with three actionable remedies.
-- `Vcdeps.bootstrap!` — create a private, registration-free vcpkg under
-  `%LOCALAPPDATA%\vcdeps\vcpkg` (download `vcpkg.exe` over TLS, then
-  `bootstrap-standalone`). Idempotent; never elevates or touches the registry.
-- `Vcdeps.install!` — run `vcpkg install` for `<manifest>\vcpkg.json` into an
-  out-of-tree root keyed on (manifest, triplet, tool version), streaming child
-  output live. A `.vcdeps-complete` marker makes a current install a no-op;
-  `force:` bypasses it. Builds/caches live under `%LOCALAPPDATA%\vcdeps`, never
-  inside the gem (the deep-path port-build trap).
-- `Vcdeps.vendor!` — sync an install's runtime DLLs, per-port `copyright` files,
-  and a generated standalone `Fiddle`-preload shim into a vendor dir. SYNC, not
-  copy: it owns `*.dll`, `licenses\*`, and `preload.rb`, deleting stale owned
-  files so a removed port leaves no orphan DLL.
-- `Vcdeps.baseline!` — add/refresh `builtin-baseline` via
-  `vcpkg x-update-baseline --add-initial-baseline`.
-- `Vcdeps.mkmf!` — the extconf entry point: activate vcvars, install the ports
-  (or bypass via `--with-vcdeps-dir`), PREPEND the include/lib paths so the
-  vcpkg tree wins over Ruby's build-time opt-dir, and vendor the DLLs.
-- `Vcdeps.default_triplet` and `Vcdeps::Triplet.validate!` — derive
-  `<arch>-windows` from `RbConfig`; reject static-CRT triplets and arch
-  mismatches; `VCPKG_DEFAULT_TRIPLET` is deliberately ignored.
-- `vcdeps` CLI — `doctor`, `where`, `install`, `vendor`, `baseline`,
-  `bootstrap`, `version`, `help`.
-- `vcdeps doctor` — diagnoses resolution, manifest baseline, opt-dir shadowing,
-  Ruby-bin DLL collisions, triplet sanity, binary-cache / offline readiness, and
-  `VCDEPS_HOME` hygiene.
-
-Manifest mode only. Telemetry is disabled in every child unless
-`VCDEPS_METRICS=1`. Supported platform: native MSVC (mswin) Ruby, x64.
-arm64-mswin is expected to work (arch-neutral) but is untested and unsupported
-until an arm64-mswin Ruby distribution exists. Windows MSVC (mswin) Ruby only.
-
-[0.1.0]: https://github.com/main-path/vcdeps/releases/tag/v0.1.0

data/exe/vcdeps

@@ -1,6 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "vcdeps/cli"
-
-exit Vcdeps::CLI.start(ARGV)