mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
3df16924b4
Header file include/ruby/internal/abi.h contains RUBY_ABI_VERSION which is the ABI version. This value should be bumped whenever an ABI incompatible change is introduced. When loading dynamic libraries, Ruby will compare its own `ruby_abi_version` and the `ruby_abi_version` of the loaded library. If these two values don't match it will raise a `LoadError`. This feature can also be turned off by setting the environment variable `RUBY_RUBY_ABI_CHECK=0`. This feature will prevent cases where previously installed native gems fail in unexpected ways due to incompatibility of changes in header files. This will force the developer to recompile their gems to use the same header files as the built Ruby. In Ruby, the ABI version is exposed through `RbConfig::CONFIG["ruby_abi_version"]`.
43 lines
1.2 KiB
Ruby
43 lines
1.2 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
class TestABI < Test::Unit::TestCase
|
|
def test_require_lib_with_incorrect_abi_on_dev_ruby
|
|
omit "ABI is not checked" unless abi_checking_supported?
|
|
|
|
assert_separately [], <<~RUBY
|
|
err = assert_raise(LoadError) { require "-test-/abi" }
|
|
assert_match(/ABI version of binary is incompatible with this Ruby/, err.message)
|
|
RUBY
|
|
end
|
|
|
|
def test_disable_abi_check_using_environment_variable
|
|
omit "ABI is not checked" unless abi_checking_supported?
|
|
|
|
assert_separately [{ "RUBY_ABI_CHECK" => "0" }], <<~RUBY
|
|
assert_nothing_raised { require "-test-/abi" }
|
|
RUBY
|
|
end
|
|
|
|
def test_enable_abi_check_using_environment_variable
|
|
omit "ABI is not checked" unless abi_checking_supported?
|
|
|
|
assert_separately [{ "RUBY_ABI_CHECK" => "1" }], <<~RUBY
|
|
err = assert_raise(LoadError) { require "-test-/abi" }
|
|
assert_match(/ABI version of binary is incompatible with this Ruby/, err.message)
|
|
RUBY
|
|
end
|
|
|
|
def test_require_lib_with_incorrect_abi_on_release_ruby
|
|
omit "ABI is enforced" if abi_checking_supported?
|
|
|
|
assert_separately [], <<~RUBY
|
|
assert_nothing_raised { require "-test-/abi" }
|
|
RUBY
|
|
end
|
|
|
|
private
|
|
|
|
def abi_checking_supported?
|
|
!(RUBY_PLATFORM =~ /mswin|mingw/)
|
|
end
|
|
end
|