mkmf-lite 0.7.5 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d3876fab22593f1d61c44718bc4fa4a582ce639230745ebed95c61b99a2a164
-  data.tar.gz: 74188f32f661c473e575412c095ea7cdd78493af4a25bfbde1934bad604b04ec
+  metadata.gz: b780dd7e2e0e1b2be89941ce19c6cd891de5318b53cb199e6b3cbfead5c174be
+  data.tar.gz: 7b8afafe384f433f17b309416b24a467c488696b6b2e98560c4f2e545bfd9c77
 SHA512:
-  metadata.gz: 30e2efbd8e802dbcf0237a9a5a514e7f39218702a0713ae7868135b06b9052e43be975e4a4ca9e347135f437ff1d48bbeaf8692d7d76db523b76f26aaaf1072d
-  data.tar.gz: d7c9e01c1cdcb5f8ad94a7a2a82c16c143f2e4140da64a78c7f399a69e15830270b99c290c0844577cd738a136266490fa1cec5e376e45d50e80c4d8ad2448ca
+  metadata.gz: 1a80776330561d06936541572c984baec486bbacce69fa15bf07c3e8578981791a2769e17d94e793781f5203339b037860a5ba7d86bed1d67b65216885cde910
+  data.tar.gz: 98dc7c4df08d005d8628b4509f1b58059a2995bc321798138315d794d98ffadad2ef48b383afe5374ac66b162e8c5c9108376ceb6e2d33701e89cf596b8731ae

data/CHANGES.md

@@ -1,3 +1,19 @@
+## 0.8.1 - 30-Jun-2026
+* Improved generated C formatting for size, offset, and constant probes.
+* Simplified struct member probes to use a compile-only member check.
+* Added regression coverage for generated C, linker arguments, library names,
+  and parallel probe invocations.
+* Expanded documentation for portability, diagnostics, FFI use, and
+  memoization.
+
+## 0.8.0 - 29-Jun-2026
+* Removed implicit Linux-style library flags from compiler probes.
+* Compile probes now use argv-style command execution and per-probe temporary
+  directories.
+* Improved support for include directories with spaces.
+* Added FreeBSD CI coverage.
+* Updated RuboCop configuration for current rubocop-rspec.
+
 ## 0.7.5 - 24-Dec-2025
 * Automatically include homebrew lib for have_library on Macs.
 * Modified the have_library to work with or without leading "lib".

data/README.md

@@ -10,7 +10,9 @@ A light version of mkmf designed for use within programs.
 `gem cert --add <(curl -Ls https://raw.githubusercontent.com/djberg96/mkmf-lite/main/certs/djberg96_pub.pem)`
 
 ## Prerequisites
-A C compiler somewhere on your system.
+A C compiler somewhere on your system. `mkmf-lite` uses the compiler Ruby was
+configured with when possible, falling back to common compiler names on your
+`PATH`.
 
 ## Synopsis
 ```ruby
@@ -43,9 +45,80 @@ used in conjunction with FFI. Also, the source code is quite readable.
 It does not package C extensions, nor generate a log file or a Makefile. It
 does, however, require that you have a C compiler somewhere on your system.
 
-As of version 0.6.0 it memoizes the results of any checks that you make
-since they wouldn't ever change without requiring a reboot/restart of your
-server, container, etc, anyway.
+## Portability model
+Each probe generates a tiny C program in a per-probe temporary directory and
+asks Ruby's configured compiler to compile it. Boolean probes return whether
+that compile or link step succeeded. Value probes compile and run a small
+program that prints the requested integer value.
+
+The generated source is intentionally small and portable. `mkmf-lite` avoids
+assuming Linux-specific libraries or global temporary filenames, and it passes
+compiler arguments as argv-style command parts so paths with spaces can work.
+
+Unlike stdlib `mkmf`, this library does not create a `Makefile`, does not build
+an extension, does not write an `mkmf.log`, and keeps its API inside
+`Mkmf::Lite` instead of relying on top-level methods.
+
+## Diagnostics
+Boolean probes such as `have_header`, `have_func`, `have_library`, and
+`have_struct_member` are quiet by default and return `true` or `false`.
+
+Value probes such as `check_valueof`, `check_sizeof`, and `check_offsetof`
+raise `StandardError` if their generated C cannot be compiled. The exception
+message includes the compiler command, compiler stderr, and generated source so
+you can see what failed without hunting for a separate log file.
+
+## FFI examples
+Use `mkmf-lite` to decide which declarations are safe to expose through FFI:
+
+```ruby
+require 'ffi'
+require 'mkmf/lite'
+
+module LibC
+  extend FFI::Library
+  extend Mkmf::Lite
+
+  ffi_lib FFI::Library::LIBC
+
+  attach_function :getpid, [], :int if have_func('getpid', 'unistd.h')
+end
+```
+
+You can also use it to size native structs:
+
+```ruby
+class StatLayout
+  extend Mkmf::Lite
+
+  STAT_SIZE = check_sizeof('struct stat', 'sys/stat.h')
+  UID_OFFSET = check_offsetof('struct stat', 'st_uid', 'sys/stat.h')
+  HAS_BIRTHTIME = have_struct_member('struct stat', 'st_birthtime', 'sys/stat.h')
+end
+```
+
+For libraries installed outside the compiler's default include path, pass
+include directories to probes that accept them:
+
+```ruby
+class LocalHeader
+  extend Mkmf::Lite
+
+  HAVE_FOO = have_header('foo.h', '/usr/local/include')
+  FOO_VERSION = check_valueof('FOO_VERSION', 'foo.h', '/usr/local/include')
+end
+```
+
+## Memoization
+As of version 0.6.0, public probe results are memoized for the lifetime of the
+object that extends `Mkmf::Lite`. The method arguments are part of the cache
+key, so `have_header('foo.h')` and `have_header('foo.h', '/usr/local/include')`
+are distinct checks.
+
+This fits the normal use case where compiler configuration, headers, and system
+libraries do not change while the Ruby process is running. If you need to probe
+again after changing the environment, create a new object or restart the
+process.
 
 ## Known Issues
 JRuby may emit warnings on some platforms.
@@ -54,7 +127,7 @@ JRuby may emit warnings on some platforms.
 Apache-2.0
 
 ## Copyright
-(C) 2010-2025 Daniel J. Berger
+(C) 2010-2026 Daniel J. Berger
 All Rights Reserved
 
 ## Warranty

data/ROADMAP.md

@@ -0,0 +1,148 @@
+# Roadmap
+
+This branch focuses on improving `mkmf-lite` without turning it into stdlib
+`mkmf`. The guiding rule is to add clearer extension points and better
+diagnostics while preserving the small public API that existing callers use.
+
+## Released
+
+### 0.8.0 - Portability Foundation
+
+Released 29-Jun-2026.
+
+* Removed implicit Linux-style library flags from compiler probes.
+* Replaced shell-built compiler command strings with argv-style execution.
+* Used per-probe temporary directories instead of shared `conftest.c` and
+  `conftest.exe` files in `Dir.tmpdir`.
+* Avoided global `Dir.chdir` during probe compilation.
+* Captured compiler diagnostics internally.
+* Improved support for include directories with spaces.
+* Added FreeBSD CI coverage.
+
+## 0.9.0 - C Probe Correctness
+
+Improve the generated C probes first, keeping the Ruby API stable and avoiding
+changes that could surprise existing callers.
+
+### Generated C Types
+
+Improve generated C for sizes, offsets, and stricter compilers.
+
+Status: Done.
+
+* [x] Print `sizeof` results using `size_t` and `%zu`.
+* [x] Print `offsetof` results using `size_t` and `%zu`.
+* [x] Avoid casting sizes and offsets down to `int`.
+* [x] Review `check_valueof` output formatting for constants wider than `int`.
+* [x] Keep return values as Ruby integers.
+
+### Function Probes
+
+Review function detection under stricter C modes.
+
+* Avoid relying on implicit declarations.
+* Avoid old-style function assumptions where practical.
+* Keep support for checking functions with and without caller-provided headers.
+* Preserve the current boolean behavior of `have_func`.
+
+### Compile-Only Probes
+
+Prefer compile-time checks where a probe only needs success or failure.
+
+Status: Done.
+
+* [x] Consider compile-time assertions for struct member checks.
+* [x] Keep generated source small and readable for diagnostics.
+* [x] Avoid adding platform-specific C unless no portable form exists.
+
+### Diagnostics
+
+Make failed probes easier to understand without printing unexpected output.
+
+* Store the last compile command, stdout, stderr, exit status, and generated C
+  source for inspection.
+* Add a public diagnostics reader with a small stable shape.
+* Keep normal boolean probes quiet by default.
+* Improve raised errors from `check_valueof`, `check_sizeof`, and
+  `check_offsetof` with captured compiler output.
+
+### Tests
+
+Broaden tests around generated C, failure modes, and platform config.
+
+* [x] Add specs for `sizeof` and `offsetof` values that should not be truncated.
+* [x] Add specs for generated compiler/linker arguments.
+* [x] Test library names with and without a leading `lib` prefix.
+* [x] Test parallel probe invocations.
+* Add mocked `RbConfig` coverage for Linux, macOS, FreeBSD, Windows/MSVC, and
+  JRuby.
+* Add specs for captured diagnostics from failed probes.
+
+### Documentation
+
+Document the portability model and diagnostic behavior.
+
+Status: Done.
+
+* [x] Explain that probes compile tiny C programs using Ruby's configured compiler.
+* [x] Clarify how `mkmf-lite` differs from stdlib `mkmf`.
+* [x] Add FFI-oriented examples for common Unix-like use cases.
+* [x] Document memoization behavior and how it interacts with probe inputs.
+
+## Later
+
+### API Options
+
+Keyword arguments may be useful, but they should wait until the lower-level
+probe behavior is settled and the compatibility tradeoffs are clearer.
+
+* Add `include_dirs:` as a keyword alternative to positional include directory
+  arguments.
+* Add `lib_dirs:` for library search paths.
+* Add `cflags:` for extra compile flags.
+* Add `ldflags:` for extra link flags.
+* Keep existing positional forms compatible.
+* Make option handling consistent across `have_header`, `have_func`,
+  `have_library`, `have_struct_member`, `check_valueof`, `check_sizeof`, and
+  `check_offsetof`.
+
+Example target API:
+
+```ruby
+have_header('foo.h', include_dirs: ['/usr/local/include'])
+have_library(
+  'foo',
+  'foo_init',
+  headers: ['foo.h'],
+  lib_dirs: ['/usr/local/lib'],
+  cflags: ['-D_GNU_SOURCE']
+)
+```
+
+### Configuration
+
+Consider a small configuration API if repeated keyword arguments become noisy.
+
+* Evaluate `Mkmf::Lite.configure` for global defaults.
+* Support compiler, include directories, library directories, compile flags,
+  and link flags as possible defaults.
+* Make configuration interaction with memoized probe results explicit.
+
+### 1.0.0 - Stable Contract
+
+Finalize the behavior expected by downstream users.
+
+* Document the supported public API and compatibility expectations.
+* Document compiler selection, probe memoization, error handling, and platform
+  support.
+* Keep the library focused on lightweight compile/link probes rather than
+  becoming a replacement for stdlib `mkmf`.
+
+### Dependency Reduction
+
+Reducing dependencies is useful, but should not distract from the 0.9 API work.
+
+* Remove `ptools` if it is only needed for `File.which`.
+* Replace `File.which` with a small internal executable lookup based on
+  `ENV['PATH']`.
+* Reevaluate `memoist` after the probe and command execution behavior is stable.

data/lib/mkmf/lite.rb

@@ -4,8 +4,8 @@ require 'erb'
 require 'rbconfig'
 require 'tmpdir'
 require 'open3'
+require 'shellwords'
 require 'ptools'
-require 'fileutils'
 require 'memoist'
 
 # The Mkmf module serves as a namespace only.
@@ -16,7 +16,7 @@ module Mkmf
     extend Memoist
 
     # The version of the mkmf-lite library
-    MKMF_LITE_VERSION = '0.7.5'
+    MKMF_LITE_VERSION = '0.8.1'
 
     private
 
@@ -51,24 +51,16 @@ module Mkmf
       'conftest.c'
     end
 
-    def cpp_out_file
+    def cpp_out_file(output_file = 'conftest.exe')
       if windows_with_cl_compiler?
-        '/Feconftest.exe'
+        "/Fe#{output_file}"
       else
-        '-o conftest.exe'
+        ['-o', output_file]
       end
     end
 
-    memoize :cpp_out_file
-
     def cpp_libraries
-      return nil if windows_with_cl_compiler? || jruby?
-
-      if cpp_command.match?(/clang/i)
-        '-Lrt -Ldl -Lcrypt -Lm'
-      else
-        '-lrt -ldl -lcrypt -lm'
-      end
+      nil
     end
 
     memoize :cpp_libraries
@@ -84,7 +76,7 @@ module Mkmf
         paths << '-L/usr/local/lib' if File.directory?('/usr/local/lib')
       end
 
-      paths.empty? ? nil : paths.join(' ')
+      paths.empty? ? nil : paths
     end
 
     memoize :cpp_library_paths
@@ -241,35 +233,31 @@ module Mkmf
     def build_directory_options(directories)
       return nil if directories.empty?
 
-      directories.map { |dir| "-I#{dir}" }.join(' ')
+      directories.flatten.map { |dir| "-I#{dir}" }
     end
 
-    def build_compile_command(command_options = nil, library_options = nil)
-      command_parts = [cpp_command]
-      command_parts << command_options if command_options
-      command_parts << cpp_library_paths if cpp_library_paths
-      command_parts << cpp_libraries if cpp_libraries
-      command_parts << cpp_defs
-      command_parts << cpp_out_file
-      command_parts << cpp_source_file
-      command_parts << library_options if library_options
-
-      command_parts.compact.join(' ')
-    end
+    def build_compile_command(command_options = nil, library_options = nil, paths = {})
+      source_file = paths.fetch(:source_file, cpp_source_file)
+      output_file = paths.fetch(:output_file, 'conftest.exe')
 
-    def with_suppressed_output
-      stderr_orig = $stderr.dup
-      stdout_orig = $stdout.dup
+      command_parts = shellwords(cpp_command)
+      command_parts.concat(shellwords(command_options))
+      command_parts.concat(shellwords(cpp_library_paths))
+      command_parts.concat(shellwords(cpp_libraries))
+      command_parts.concat(shellwords(cpp_defs))
+      command_parts.concat(shellwords(cpp_out_file(output_file)))
+      command_parts << source_file
+      command_parts.concat(shellwords(library_options))
 
-      $stderr.reopen(IO::NULL)
-      $stdout.reopen(IO::NULL)
+      command_parts
+    end
 
-      yield
-    ensure
-      $stderr.reopen(stderr_orig)
-      $stdout.reopen(stdout_orig)
-      stderr_orig.close
-      stdout_orig.close
+    def shellwords(options)
+      if options.is_a?(Array)
+        options.flatten.compact.map(&:to_s)
+      else
+        Shellwords.split(options.to_s)
+      end
     end
 
     # Take an array of header file names (or convert it to an array if it's a
@@ -303,56 +291,53 @@ module Mkmf
     # The code generated is expected to print a number to STDOUT, which
     # is then grabbed and returned as an integer.
     #
-    # Note that $stderr is temporarily redirected to the null device because
-    # we don't actually care about the reason for failure, though a Ruby
-    # error is raised if the compilation step fails.
-    #
     def try_to_execute(code, command_options = nil)
       result = 0
 
-      Dir.chdir(Dir.tmpdir) do
-        File.write(cpp_source_file, code)
-        command = build_compile_command(command_options)
-
-        compilation_successful = with_suppressed_output { system(command) }
-
-        if compilation_successful
-          conftest = File::ALT_SEPARATOR ? 'conftest.exe' : './conftest.exe'
-
-          Open3.popen3(conftest) do |stdin, stdout, stderr|
-            stdin.close
-            stderr.close
-            output = stdout.gets
-            result = output&.chomp&.to_i || 0
-          end
+      Dir.mktmpdir('mkmf-lite') do |dir|
+        source_file = File.join(dir, cpp_source_file)
+        output_file = File.join(dir, 'conftest.exe')
+        File.write(source_file, code)
+        command = build_compile_command(
+          command_options,
+          nil,
+          :source_file => source_file,
+          :output_file => output_file
+        )
+
+        _stdout, stderr, status = Open3.capture3(*command)
+
+        if status.success?
+          output, = Open3.capture2(output_file)
+          result = output.chomp.to_i
         else
-          raise StandardError, "Failed to compile source code with command '#{command}':\n===\n#{code}==="
+          message = "Failed to compile source code with command '#{command.shelljoin}':\n#{stderr}===\n#{code}==="
+          raise StandardError, message
         end
       end
 
       result
-    ensure
-      FileUtils.rm_f(File.join(Dir.tmpdir, cpp_source_file))
-      FileUtils.rm_f(File.join(Dir.tmpdir, 'conftest.exe'))
     end
 
     # Create a temporary bit of C source code in the temp directory, and
     # try to compile it. If it succeeds, return true. Otherwise, return
     # false.
     #
-    # Note that $stderr is temporarily redirected to the null device because
-    # we don't actually care about the reason for failure.
-    #
     def try_to_compile(code, command_options = nil, library_options = nil)
-      Dir.chdir(Dir.tmpdir) do
-        File.write(cpp_source_file, code)
-        command = build_compile_command(command_options, library_options)
-
-        with_suppressed_output { system(command) }
+      Dir.mktmpdir('mkmf-lite') do |dir|
+        source_file = File.join(dir, cpp_source_file)
+        output_file = File.join(dir, 'conftest.exe')
+        File.write(source_file, code)
+        command = build_compile_command(
+          command_options,
+          library_options,
+          :source_file => source_file,
+          :output_file => output_file
+        )
+
+        _stdout, _stderr, status = Open3.capture3(*command)
+        status.success?
       end
-    ensure
-      FileUtils.rm_f(File.join(Dir.tmpdir, cpp_source_file))
-      FileUtils.rm_f(File.join(Dir.tmpdir, 'conftest.exe'))
     end
 
     # Slurp the contents of the template file for evaluation later.

data/lib/mkmf/templates/check_offsetof.erb

@@ -3,9 +3,7 @@
 
 <%= headers %>
 
-int conftest_const = (int)(offsetof(<%= struct_type %>, <%= field %>));
-
 int main(){
-  printf("%d\n", conftest_const);
+  printf("%zu\n", offsetof(<%= struct_type %>, <%= field %>));
   return 0;
 }

data/lib/mkmf/templates/check_sizeof.erb

@@ -1,10 +1,9 @@
 #include <stdio.h>
+#include <stddef.h>
 
 <%= headers %>
 
-int conftest_const = (int)(sizeof(<%= type %>));
-
 int main(){
-  printf("%d\n", conftest_const);
+  printf("%zu\n", sizeof(<%= type %>));
   return 0;
 }

data/lib/mkmf/templates/check_valueof.erb

@@ -1,8 +1,15 @@
 #include <stdio.h>
+#include <stdint.h>
+#include <inttypes.h>
 
 <%= headers %>
 
 int main(){
-  printf("%d\n", <%= constant %>);
+  if ((<%= constant %>) < 0) {
+    printf("%" PRIdMAX "\n", (intmax_t)(<%= constant %>));
+  } else {
+    printf("%" PRIuMAX "\n", (uintmax_t)(<%= constant %>));
+  }
+
   return 0;
 }

data/lib/mkmf/templates/have_struct_member.erb

@@ -1,6 +1,6 @@
 <%= headers %>
 
 int main(){
-  int s = (char *)&((<%= struct_type %>*)0)-><%= struct_member %> - (char *)0;
+  (void)sizeof(((<%= struct_type %>*)0)-><%= struct_member %>);
   return 0;
 }

data/mkmf-lite.gemspec

@@ -3,7 +3,7 @@ require 'rubygems'
 Gem::Specification.new do |spec|
   spec.name       = 'mkmf-lite'
   spec.summary    = 'A lighter version of mkmf designed for use as a library'
-  spec.version    = '0.7.5'
+  spec.version    = '0.8.1'
   spec.author     = 'Daniel J. Berger'
   spec.license    = 'Apache-2.0'
   spec.email      = 'djberg96@gmail.com'

data/spec/mkmf_lite_spec.rb

@@ -9,10 +9,29 @@ require 'rubygems'
 require 'rspec'
 require 'mkmf/lite'
 require 'fileutils'
+require 'tmpdir'
 
 RSpec.describe Mkmf::Lite do
   subject { Class.new{ |obj| obj.extend Mkmf::Lite } }
 
+  def new_probe
+    Class.new{ |obj| obj.extend Mkmf::Lite }
+  end
+
+  def template_source(file)
+    File.read(File.expand_path("../lib/mkmf/templates/#{file}", __dir__))
+  end
+
+  def parallel_probe_result
+    probe = new_probe
+
+    [probe.have_header('stdio.h'), probe.check_sizeof('int'), probe.check_valueof('EOF')]
+  end
+
+  def compile_command_with_linker_arguments(probe)
+    probe.send(:build_compile_command, nil, ['-L/tmp/lib dir', '-lfoo'])
+  end
+
   let(:st_type)   { 'struct stat' }
   let(:st_member) { 'st_uid' }
   let(:st_header) { 'sys/stat.h' }
@@ -20,7 +39,7 @@ RSpec.describe Mkmf::Lite do
 
   describe 'constants' do
     example 'version information' do
-      expect(described_class::MKMF_LITE_VERSION).to eq('0.7.5')
+      expect(described_class::MKMF_LITE_VERSION).to eq('0.8.1')
       expect(described_class::MKMF_LITE_VERSION).to be_frozen
     end
   end
@@ -39,6 +58,16 @@ RSpec.describe Mkmf::Lite do
       expect{ subject.have_header('stdio.h', '/usr/local/include') }.not_to raise_error
       expect{ subject.have_header('stdio.h', '/usr/local/include', '/usr/include') }.not_to raise_error
     end
+
+    example 'have_header accepts a directory with spaces' do
+      Dir.mktmpdir('mkmf lite') do |dir|
+        header = 'mkmf_lite_space_header.h'
+
+        File.write(File.join(dir, header), "#define MKMF_LITE_SPACE_HEADER 1\n")
+
+        expect(subject.have_header(header, dir)).to be(true)
+      end
+    end
   end
 
   context 'have_func' do
@@ -76,6 +105,14 @@ RSpec.describe Mkmf::Lite do
       expect(subject.have_struct_member(st_type, st_member)).to be(false)
     end
 
+    example 'have_struct_member generates a compile-only member check' do
+      source = template_source('have_struct_member.erb')
+
+      expect(source).to include('(void)sizeof(((')
+      expect(source).not_to include('(char *)&')
+      expect(source).not_to include('- (char *)0')
+    end
+
     example 'have_struct_member requires at least two arguments' do
       expect{ subject.have_struct_member() }.to raise_error(ArgumentError)
       expect{ subject.have_struct_member('struct passwd') }.to raise_error(ArgumentError)
@@ -110,6 +147,23 @@ RSpec.describe Mkmf::Lite do
       expect(value).to be_a(Integer)
       expect(value).to eq(-1)
     end
+
+    example 'check_valueof returns a wider than int integer value' do
+      char_bit = subject.check_valueof('CHAR_BIT', 'limits.h')
+      ullong_size = subject.check_sizeof('unsigned long long', 'limits.h')
+      value = subject.check_valueof('ULLONG_MAX', 'limits.h')
+
+      expect(value).to be_a(Integer)
+      expect(value).to eq((1 << (ullong_size * char_bit)) - 1)
+    end
+
+    example 'check_valueof generates portable integer formatting' do
+      source = template_source('check_valueof.erb')
+
+      expect(source).to include('#include <stdint.h>', '#include <inttypes.h>')
+      expect(source).to include('PRIdMAX', 'PRIuMAX')
+      expect(source).not_to include('printf("%d')
+    end
   end
 
   context 'check_offsetof' do
@@ -137,6 +191,14 @@ RSpec.describe Mkmf::Lite do
       expect(size1).to eq(0)
       expect(size2).to be > size1
     end
+
+    example 'check_offsetof generates size_t output formatting' do
+      source = template_source('check_offsetof.erb')
+
+      expect(source).to include('printf("%zu\\n", offsetof(')
+      expect(source).not_to include('(int)(offsetof')
+      expect(source).not_to include('printf("%d')
+    end
   end
 
   context 'check_sizeof' do
@@ -163,6 +225,14 @@ RSpec.describe Mkmf::Lite do
       expect(size).to be_a(Integer)
       expect(size).to be > 0
     end
+
+    example 'check_sizeof generates size_t output formatting' do
+      source = template_source('check_sizeof.erb')
+
+      expect(source).to include('printf("%zu\\n", sizeof(')
+      expect(source).not_to include('(int)(sizeof')
+      expect(source).not_to include('printf("%d')
+    end
   end
 
   context 'have_library' do
@@ -176,6 +246,11 @@ RSpec.describe Mkmf::Lite do
       expect(subject.have_library('nonexistent_library_xyz')).to be(false)
     end
 
+    example 'have_library accepts a leading lib prefix' do
+      expect(subject.have_library('libm')).to be(true)
+      expect(subject.have_library('libm', 'sqrt', 'math.h')).to be(true)
+    end
+
     example 'have_library with function argument returns expected boolean value' do
       expect(subject.have_library('m', 'sqrt', 'math.h')).to be(true)
       expect(subject.have_library('m', 'nonexistent_function_xyz', 'math.h')).to be(false)
@@ -194,4 +269,44 @@ RSpec.describe Mkmf::Lite do
       expect{ subject.have_library('m', 'sqrt', 'math.h', 'bogus') }.to raise_error(ArgumentError)
     end
   end
+
+  describe 'command construction' do
+    let(:command_with_spaces) do
+      subject.send(
+        :build_compile_command,
+        ['-I/tmp/include dir'],
+        nil,
+        :source_file => 'source.c',
+        :output_file => 'output file'
+      )
+    end
+
+    example 'build_compile_command returns argv-style command parts' do
+      expect(command_with_spaces).to include('-I/tmp/include dir')
+      expect(command_with_spaces).to include('source.c')
+      expect(command_with_spaces.any? { |part| part.include?('output file') }).to be(true)
+    end
+
+    example 'build_compile_command does not include implicit Linux libraries' do
+      command = subject.send(:build_compile_command)
+
+      expect(command).not_to include('-Lrt', '-Ldl', '-Lcrypt', '-Lm')
+      expect(command).not_to include('-lrt', '-ldl', '-lcrypt', '-lm')
+    end
+
+    example 'build_compile_command appends linker arguments' do
+      command_with_linker_arguments = compile_command_with_linker_arguments(subject)
+
+      expect(command_with_linker_arguments).to include('-L/tmp/lib dir', '-lfoo')
+      expect(command_with_linker_arguments.index('-lfoo')).to be > command_with_linker_arguments.index('conftest.c')
+    end
+  end
+
+  describe 'parallel probe invocations' do
+    example 'run independently without temporary file collisions' do
+      results = Array.new(6) { Thread.new { parallel_probe_result } }.map(&:value)
+
+      expect(results).to all(satisfy { |header, size, value| header && size.positive? && value == -1 })
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mkmf-lite
 version: !ruby/object:Gem::Version
-  version: 0.7.5
+  version: 0.8.1
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -136,10 +136,9 @@ files:
 - LICENSE
 - MANIFEST.md
 - README.md
+- ROADMAP.md
 - Rakefile
 - certs/djberg96_pub.pem
-- conftest.c
-- conftest.exe
 - lib/mkmf-lite.rb
 - lib/mkmf/lite.rb
 - lib/mkmf/templates/check_offsetof.erb
@@ -179,7 +178,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.12
 specification_version: 4
 summary: A lighter version of mkmf designed for use as a library
 test_files:

data/conftest.c

@@ -1,5 +0,0 @@
-#include <foobar.h>
-
-int main(){
-  return 0;
-}