vcvars 0.1.0

data/lib/vcvars.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "rbconfig"
+require "vcvars/version"
+require "vcvars/locator"
+require "vcvars/environment"
+
+# vcvars — locate Visual Studio and load the MSVC build environment so that
+# native C extensions build under an mswin (MSVC) Ruby without first opening a
+# "Developer Command Prompt".
+#
+#   require "vcvars"
+#   Vcvars.activate!            # cl.exe / nmake.exe now on PATH in this process
+#
+# Or, in a Rakefile that uses rake-compiler:
+#
+#   require "vcvars/rake"       # auto-activates; then Rake::ExtensionTask.new ...
+module Vcvars
+  class Error < StandardError; end
+
+  module_function
+
+  # True when the running Ruby is a native MSVC (mswin) build.
+  def mswin?
+    RbConfig::CONFIG["target_os"].to_s =~ /mswin/ ? true : false
+  end
+
+  # Locate VS and import the MSVC environment into this process's ENV.
+  # No-op (returns false) if a developer environment is already active.
+  def activate!(arch: Locator.default_arch, force: false)
+    Environment.activate!(arch: arch, force: force)
+  end
+
+  # Is a developer environment already active in this process?
+  def active?
+    Environment.active?
+  end
+
+  # Locate the Visual Studio installation. Returns a Locator::Installation or nil.
+  def locate(arch: Locator.default_arch)
+    Locator.find(arch: arch)
+  end
+
+  # The MSVC environment variables vcvars would add/change (without mutating ENV).
+  def env(arch: Locator.default_arch)
+    Environment.delta(arch: arch)
+  end
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: vcvars
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ned
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !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: 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'
+description: |
+  vcvars locates a Visual Studio / Build Tools install via vswhere and loads the
+  MSVC toolchain (vcvars*.bat) into the current process, so C extensions build
+  under an mswin Ruby without first opening a "Developer Command Prompt".
+
+  It provides a library API (Vcvars.activate!), a Rake integration
+  (require "vcvars/rake"), a `vcvars exec -- <cmd>` runner, a `vcvars doctor`
+  that diagnoses the classic MSVC extension-build failures, a `vcvars env`
+  shell-env emitter, and a `vcvars new` scaffolder for MSVC-ready extension gems.
+  It is "ridk enable", but for MSVC. Pure Ruby, no compiler required to install.
+executables:
+- vcvars
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- exe/vcvars
+- lib/vcvars.rb
+- lib/vcvars/cli.rb
+- lib/vcvars/doctor.rb
+- lib/vcvars/environment.rb
+- lib/vcvars/locator.rb
+- lib/vcvars/rake.rb
+- lib/vcvars/scaffold.rb
+- lib/vcvars/version.rb
+homepage: https://github.com/main-path/vcvars
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/main-path/vcvars
+  source_code_uri: https://github.com/main-path/vcvars
+  changelog_uri: https://github.com/main-path/vcvars/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/main-path/vcvars/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Load the MSVC (Visual Studio) build environment for native Ruby extensions
+  on Windows.
+test_files: []