rcee_precompiled 0.5.0-x86_64-darwin → 0.5.1-x86_64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 223449b686a5334c944b1fc8deb7ea8a03154c780adaaddeb4319facdb208e0d
-  data.tar.gz: ec4d0debe073b6611b8ec23a30c5867ed365d7c741be243c54143e7c5188a983
+  metadata.gz: 9ab06301865ea3ee079c775fe449ddad922f08144267d4d74c0f2cd688a5d86b
+  data.tar.gz: d402a4a46bd49fd47faf853465955196cc45b5d67840b63d8419850da4747a2c
 SHA512:
-  metadata.gz: 4b06302e05375f2379440db1c4e1445c8be92b6fb4144e30ef36ce99f55ed5acec16f906b1d0d0c144170a9636014e56e608a179ef57762c7b57752a9fadb5d0
-  data.tar.gz: 820dead55b9b17aa758d930ec8108f9a206c191da5c626ed08fd65c3d364b8db3d66a4d5dafe995dd9fc6a6afb1a273b3bc76f37f1b94cee5d80b10a151de074
+  metadata.gz: c74ae945326700ea6276b8d43979a8e1a4cf063b3371d2c9b0b4f75988f2e24e680f0db4ffb5b3b7b1167c87e803fe63b97a6e0339f2c62cd408fd199599f30a
+  data.tar.gz: f0c4bf142c712bea766a68243651eba46742b693cb3f9c7c31d791aae5eb81c5b45f788e89a5db5b1a333c2dfd58ba36461b8e9c80867a4d25d8220aaf69e899

data/README.md

@@ -28,13 +28,18 @@ First, we need to add some features to our `Rake::ExtensionTask` in `Rakefile`:
 ``` ruby
 cross_rubies = ["3.3.0", "3.2.0", "3.1.0", "3.0.0"]
 cross_platforms = [
-  "x64-mingw32",
+  "aarch64-linux-gnu",
+  "aarch64-linux-musl",
+  "arm-linux-gnu",
+  "arm-linux-musl",
+  "arm64-darwin",
   "x64-mingw-ucrt",
-  "x86-linux",
-  "x86_64-linux",
-  "aarch64-linux",
+  "x64-mingw32",
+  "x86-linux-gnu",
+  "x86-linux-musl",
   "x86_64-darwin",
-  "arm64-darwin",
+  "x86_64-linux-gnu",
+  "x86_64-linux-musl",
 ]
 ENV["RUBY_CC_VERSION"] = cross_rubies.join(":")
 
@@ -161,6 +166,22 @@ end
 Go ahead and try it! `gem install rcee_precompiled`. If you're on windows, linux, or macos you should get a precompiled version that installs in under a second. Everyone else (hello FreeBSD people!) it'll take a few more seconds to build the vanilla gem's packaged tarball.
 
 
+### Windows notes
+
+You may have noticed that the gem for `x64-mingw32` only contains `.../3.0/precompiled.so` and not a shared library for 3.1, 3.2, or 3.3. Conversely, the gem for `x64-mingw-ucrt` does *not* contain 3.0 (but contains 3.1..3.3 inclusive).
+
+This is because the Windows installer for Ruby switched from `msvcrt` to `ucrt` for the C standard library. Rubies 3.0 and earlier use `msvcrt` but later Rubies use `ucrt`. So if you're on Ruby 3.0 on Windows, bundler will resolve your platform as `x64-mingw32`; but if you're on Ruby 3.1 or later, bundler will resolve your platform as `x64-mingw-ucrt`. See [the rubyinstaller release notes](https://rubyinstaller.org/2021/12/31/rubyinstaller-3.1.0-1-released.html) for more information.
+
+This is all taken care of for you by `rake-compiler-dock` and there's no additional work necessary to create those specialized native gems. However, you'll see this libc transition in the CI testing matrix in `.github/workflows/precompiled.yml`.
+
+
+### Linux notes
+
+On Linux, the default C library for a long time was GNU libc, and so when you see native gem platforms like `x86_64-linux` the _implied_ libc is `gnu`. However, in recent years the `musl` libc project has gotten off the ground in distributions like Alpine. Often, `musl` systems are able to run code compiled on (and for) `gnu` systems; but not always. And in those incompatible cases, users had to work around it or avoid Alpine.
+
+As of Rubygems 3.3.22, the `gem` and `bundle` tools are able to distinguish platforms by their libc type (e.g., `x86_64-linux-gnu` versus `x86_64-linux-musl`); and `rake-compiler-dock` started to be able to build `musl` native gems as of v1.5.0.
+
+
 ## Testing
 
 See [.github/workflows/precompiled.yml](../.github/workflows/precompiled.yml)

data/Rakefile

@@ -8,17 +8,17 @@ require "rake_compiler_dock"
 
 cross_rubies = ["3.3.0", "3.2.0", "3.1.0", "3.0.0"]
 cross_platforms = [
-  "aarch64-linux",
+  "aarch64-linux-gnu",
   "aarch64-linux-musl",
-  "arm-linux",
+  "arm-linux-gnu",
   "arm-linux-musl",
   "arm64-darwin",
   "x64-mingw-ucrt",
   "x64-mingw32",
-  "x86-linux",
+  "x86-linux-gnu",
   "x86-linux-musl",
   "x86_64-darwin",
-  "x86_64-linux",
+  "x86_64-linux-gnu",
   "x86_64-linux-musl",
 ]
 ENV["RUBY_CC_VERSION"] = cross_rubies.join(":")
@@ -42,6 +42,11 @@ Rake::ExtensionTask.new("precompiled", rcee_precompiled_spec) do |ext|
     # remove things not needed for precompiled gems
     spec.dependencies.reject! { |dep| dep.name == "mini_portile2" }
     spec.files.reject! { |file| File.fnmatch?("*.tar.gz", file) }
+
+    if spec.platform.os == "linux"
+      # the `-gnu` suffix is not recognized in earlier versions of rubygems
+      spec.required_rubygems_version.concat([">= 3.3.22"])
+    end
   end
 end
 

data/lib/rcee/precompiled/version.rb

@@ -2,6 +2,6 @@
 
 module RCEE
   module Precompiled
-    VERSION = "0.5.0"
+    VERSION = "0.5.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rcee_precompiled
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: x86_64-darwin
 authors:
 - Mike Dalessio
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-01-27 00:00:00.000000000 Z
+date: 2024-01-28 00:00:00.000000000 Z
 dependencies: []
 description: Part of a project to explain how Ruby C extensions work.
 email: