rcee_precompiled 0.5.0-arm64-darwin → 0.5.1-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c7ede9eca5fdeee84140fc01fd8bb1c5818e0c923a151766321543cfc51867a
-  data.tar.gz: 628820124e8ca741bc956342a141b0e9d758107cfa7b5a783b2c9d7e6f332aea
+  metadata.gz: 82395af820b053862536b578daa22a17561ae82015b5bd97fcc3053c0013e097
+  data.tar.gz: a1f9429f21e08e24e0995eba31130c7291abd34c0bdcc938b923432af93a52b4
 SHA512:
-  metadata.gz: 414bc4305791a66c55f851944ac51762f54446aa9a88430e82a649618dab98d5805cbb21dbc8a487bd5308110189f2345a7c8ca0b8b9aeb34d7ed67c9890b74e
-  data.tar.gz: c6f08d8f7e8b14a98fb0b3397d6d2877e5c441552f57a29ea3b5d1905b38a8fe5b3433e92bc554ddd3352c47afd95a1f88ba5dc61362d59faef9663123ee4263
+  metadata.gz: 64b8252f6bb752f7338afec7d1717d2daf635da9961a69b9bf2c93b9284054972489fbba86fa9ee6aedd575fc84c8971b1cd5707eff48e2f24bada44233ca0a2
+  data.tar.gz: 72e66b6a2bb0e40551f75c605158dc7cfd87b97c03dba5bff1d54f6f6955b66ea1658278d92c388df9bfc6146571971fdaf237a4167bf892d393e7f2280c17ad

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: arm64-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: