thermite-ruby3-fork-dont-use 0.14.0

data/lib/thermite/tasks.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2016 Mark Lee and contributors
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+# associated documentation files (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge, publish, distribute,
+# sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or
+# substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+# NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+# DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+# OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'fileutils'
+require 'rake/tasklib'
+require 'thermite/cargo'
+require 'thermite/config'
+require 'thermite/custom_binary'
+require 'thermite/github_release_binary'
+require 'thermite/package'
+require 'thermite/util'
+
+#
+# Helpers for Rust-based Ruby extensions.
+#
+module Thermite
+  #
+  # Create the following rake tasks:
+  #
+  # * `thermite:build`
+  # * `thermite:clean`
+  # * `thermite:test`
+  # * `thermite:tarball`
+  #
+  class Tasks < Rake::TaskLib
+    include Thermite::Cargo
+    include Thermite::CustomBinary
+    include Thermite::GithubReleaseBinary
+    include Thermite::Package
+    include Thermite::Util
+
+    #
+    # The configuration used for the Rake tasks. See: {Thermite::Config}
+    #
+    attr_reader :config
+
+    #
+    # Possible configuration options for Thermite tasks:
+    #
+    # * `binary_uri_format` - if set, the interpolation-formatted string used to construct the
+    #   download URI for the pre-built native extension. If the environment variable
+    #   `THERMITE_BINARY_URI_FORMAT` is set, it takes precedence over this option. Either method of
+    #   setting this option overrides the `github_releases` option.
+    #   Example: `https://example.com/download/%{version}/%{filename}`. Replacement variables:
+    #     - `filename` - The value of {Config#tarball_filename}
+    #     - `version` - the crate version from the `Cargo.toml` file
+    # * `cargo_project_path` - the path to the Cargo project. Defaults to the current
+    #   working directory.
+    # * `cargo_workspace_member` - if set, the relative path to the Cargo workspace member. Usually
+    #   used when it is part of a repository containing multiple crates.
+    # * `github_releases` - whether to look for rust binaries via GitHub releases when installing
+    #   the gem, and `cargo` is not found. Defaults to `false`.
+    # * `github_release_type` - when `github_releases` is `true`, the mode to use to download the
+    #   Rust binary from GitHub releases. `'cargo'` (the default) uses the version in `Cargo.toml`,
+    #   along with the `git_tag_format` option (described below) to determine the download URI.
+    #   `'latest'` takes the latest release matching the `git_tag_regex` option (described below) to
+    #   determine the download URI.
+    # * `git_tag_format` - when `github_release_type` is `'cargo'` (the default), the
+    #   [format string](http://ruby-doc.org/core/String.html#method-i-25) used to determine the
+    #   tag used in the GitHub download URI. Defaults to `v%s`, where `%s` is the version in
+    #   `Cargo.toml`.
+    # * `git_tag_regex` - when `github_releases` is enabled and `github_release_type` is
+    #   `'latest'`, a regular expression (expressed as a `String`) that determines which tagged
+    #   releases to look for precompiled Rust tarballs. One group must be specified that indicates
+    #   the version number to be used in the tarball filename. Defaults to the [semantic versioning
+    #   2.0.0 format](https://semver.org/spec/v2.0.0.html). In this case, the group is around the
+    #   entire expression.
+    # * `optional_rust_extension` - prints a warning to STDERR instead of raising an exception, if
+    #   Cargo is unavailable and `github_releases` is either disabled or unavailable. Useful for
+    #   projects where either fallback code exists, or a native extension is desirable but not
+    #   required. Defaults to `false`.
+    # * `ruby_project_path` - the toplevel directory of the Ruby gem's project. Defaults to the
+    #   current working directory.
+    # * `ruby_extension_dir` - the directory relative to `ruby_project_path` where the extension is
+    #   located. Defaults to `lib`.
+    #
+    # These values can be overridden by values with the same key name in the
+    # `package.metadata.thermite` section of `Cargo.toml`, if that section exists. The exceptions
+    # to this are `cargo_project_path` and `cargo_workspace_member`, since they are both used to
+    # find the `Cargo.toml` file.
+    #
+    attr_reader :options
+
+    #
+    # Define the Thermite tasks with the given configuration parameters (see {#options}).
+    #
+    # Example:
+    #
+    # ```ruby
+    # Thermite::Tasks.new(cargo_project_path: 'rust')
+    # ```
+    #
+    def initialize(options = {})
+      @options = options
+      @config = Config.new(options)
+      @options.merge!(@config.toml_config)
+      define_build_task
+      define_clean_task
+      define_test_task
+      define_package_task
+    end
+
+    private
+
+    def define_build_task
+      desc 'Build or download the Rust shared library: CARGO_PROFILE controls Cargo profile'
+      task 'thermite:build' do
+        # if cargo found, build. Otherwise, grab binary (when github_releases is enabled).
+        if cargo
+          profile = ENV.fetch('CARGO_PROFILE', 'release')
+          run_cargo_rustc(profile)
+          FileUtils.cp(config.cargo_target_path(profile, config.cargo_shared_library),
+                       config.ruby_extension_path)
+        elsif !download_binary_from_custom_uri && !download_binary_from_github_release
+          inform_user_about_cargo
+        end
+      end
+    end
+
+    def define_clean_task
+      desc 'Clean up after thermite:build task'
+      task 'thermite:clean' do
+        FileUtils.rm(config.ruby_extension_path, force: true)
+        run_cargo_if_exists 'clean', *cargo_manifest_path_args
+      end
+    end
+
+    def define_test_task
+      desc 'Run Rust testsuite'
+      task 'thermite:test' do
+        run_cargo_if_exists 'test', *cargo_manifest_path_args
+      end
+    end
+
+    def define_package_task
+      namespace :thermite do
+        desc 'Package rust library in a tarball'
+        task tarball: %w[thermite:build] do
+          build_package
+        end
+      end
+    end
+  end
+end

data/lib/thermite/util.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2016 Mark Lee and contributors
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+# associated documentation files (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge, publish, distribute,
+# sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or
+# substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+# NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+# DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+# OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'net/http'
+
+module Thermite
+  #
+  # Utility methods
+  #
+  module Util
+    #
+    # Logs a debug message to the specified `config.debug_filename`, if set.
+    #
+    def debug(msg)
+      # Should probably replace with a Logger
+      return unless config.debug_filename
+
+      @debug ||= File.open(config.debug_filename, 'w')
+      @debug.write("#{msg}\n")
+      @debug.flush
+    end
+
+    #
+    # Wrapper for a Net::HTTP GET request that handles redirects.
+    #
+    # :nocov:
+    def http_get(uri, retries_left = 10)
+      raise RedirectError, 'Too many redirects' if retries_left.zero?
+
+      case (response = Net::HTTP.get_response(URI(uri)))
+      when Net::HTTPClientError
+        nil
+      when Net::HTTPServerError
+        raise Net::HTTPServerException.new(response.message, response)
+      when Net::HTTPFound, Net::HTTPPermanentRedirect
+        http_get(response['location'], retries_left - 1)
+      else
+        StringIO.new(response.body)
+      end
+    end
+    # :nocov:
+  end
+end

data/test/fixtures/config/Cargo.toml

@@ -0,0 +1,5 @@
+[package]
+name = "fixture"
+
+[package.metadata.thermite]
+github_releases = true

data/test/fixtures/github/releases.atom

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/" xml:lang="en-US">
+  <id>tag:github.com,2008:https://github.com/ghost/project/releases</id>
+  <link type="text/html" rel="alternate" href="https://github.com/ghost/project/releases"/>
+  <link type="application/atom+xml" rel="self" href="https://github.com/ghost/project/releases.atom"/>
+  <title>Release notes from project</title>
+  <updated>2016-07-10T01:57:28Z</updated>
+  <entry>
+    <id>tag:github.com,2008:Repository/12345678/v0.1.12_rust</id>
+    <updated>2016-07-10T01:59:24Z</updated>
+    <link rel="alternate" type="text/html" href="/ghost/project/releases/tag/v0.1.12_rust"/>
+    <title>v0.1.12_rust</title>
+    <content>No content.</content>
+    <author>
+      <name>ghost</name>
+    </author>
+    <media:thumbnail height="30" width="30" url="about:blank"/>
+  </entry>
+  <entry>
+    <id>tag:github.com,2008:Repository/12345678/v0.1.11_rust</id>
+    <updated>2016-07-09T22:47:09Z</updated>
+    <link rel="alternate" type="text/html" href="/ghost/project/releases/tag/v0.1.11_rust"/>
+    <title>v0.1.11_rust</title>
+    <content>No content.</content>
+    <author>
+      <name>ghost</name>
+    </author>
+    <media:thumbnail height="30" width="30" url="about:blank"/>
+  </entry>
+</feed>

data/test/lib/thermite/cargo_test.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2016, 2017 Mark Lee and contributors
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+# associated documentation files (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge, publish, distribute,
+# sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or
+# substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+# NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+# DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+# OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'test_helper'
+require 'thermite/cargo'
+
+module Thermite
+  class CargoTest < Minitest::Test
+    include Thermite::ModuleTester
+
+    class Tester
+      include Thermite::Cargo
+      include Thermite::TestHelper
+    end
+
+    def test_run_cargo_if_exists
+      mock_module.stubs(:find_executable).returns('/opt/cargo-test/bin/cargo')
+      mock_module.expects(:sh).with('/opt/cargo-test/bin/cargo', 'foo', 'bar').once
+      mock_module.run_cargo_if_exists('foo', 'bar')
+    end
+
+    def test_run_cargo_if_exists_sans_cargo
+      mock_module.stubs(:find_executable).returns(nil)
+      mock_module.expects(:sh).never
+      mock_module.run_cargo_if_exists('foo', 'bar')
+    end
+
+    def test_run_cargo_debug_rustc
+      mock_module.config.stubs(:dynamic_linker_flags).returns('')
+      mock_module.expects(:run_cargo).with('rustc').once
+      mock_module.run_cargo_rustc('debug')
+    end
+
+    def test_run_cargo_release_rustc
+      mock_module.config.stubs(:dynamic_linker_flags).returns('')
+      mock_module.expects(:run_cargo).with('rustc', '--release').once
+      mock_module.run_cargo_rustc('release')
+    end
+
+    def test_run_cargo_rustc_with_workspace_member
+      mock_module.config.stubs(:dynamic_linker_flags).returns('')
+      mock_module.config.stubs(:cargo_workspace_member).returns('foo/bar')
+      mock_module.expects(:run_cargo).with('rustc', '--manifest-path', 'foo/bar/Cargo.toml').once
+      mock_module.run_cargo_rustc('debug')
+    end
+
+    def test_run_cargo_rustc_with_dynamic_linker_flags
+      mock_module.config.stubs(:dynamic_linker_flags).returns('foo bar')
+      if RbConfig::CONFIG['target_os'] == 'mingw32'
+        mock_module.expects(:run_cargo).with('rustc').once
+      else
+        mock_module.expects(:run_cargo).with('rustc', '--lib', '--', '-C', 'link-args=foo bar').once
+      end
+      mock_module.run_cargo_rustc('debug')
+    end
+
+    def test_inform_user_about_cargo_exception
+      _, err = capture_io do
+        assert_raises RuntimeError do
+          mock_module(optional_rust_extension: false).inform_user_about_cargo
+        end
+      end
+
+      assert_equal '', err
+    end
+
+    def test_inform_user_about_cargo_warning
+      _, err = capture_io do
+        mock_module(optional_rust_extension: true).inform_user_about_cargo
+      end
+
+      assert_equal mock_module.cargo_recommended_msg, err
+    end
+
+    def described_class
+      Tester
+    end
+  end
+end

data/test/lib/thermite/config_test.rb

@@ -0,0 +1,239 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2016, 2017 Mark Lee and contributors
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+# associated documentation files (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge, publish, distribute,
+# sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or
+# substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+# NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+# DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+# OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'test_helper'
+
+module Thermite
+  class ConfigTest < Minitest::Test
+    def test_debug_filename
+      assert_nil described_class.new.debug_filename
+      ENV['THERMITE_DEBUG_FILENAME'] = 'foo'
+      assert_equal 'foo', described_class.new.debug_filename
+      ENV['THERMITE_DEBUG_FILENAME'] = nil
+    end
+
+    def test_shared_ext_osx
+      config.stubs(:dlext).returns('bundle')
+      assert_equal 'dylib', config.shared_ext
+    end
+
+    def test_shared_ext_windows
+      config.stubs(:dlext).returns('so')
+      Gem.stubs(:win_platform?).returns(true)
+      assert_equal 'dll', config.shared_ext
+    end
+
+    def test_shared_ext_unix
+      config.stubs(:dlext).returns('foobar')
+      Gem.stubs(:win_platform?).returns(false)
+      assert_equal 'foobar', config.shared_ext
+    end
+
+    def test_ruby_version
+      config.stubs(:rbconfig_ruby_version).returns('3.2.0')
+      assert_equal 'ruby32', config.ruby_version
+    end
+
+    def test_library_name_from_cargo_lib
+      config.stubs(:toml).returns(lib: { name: 'foobar' }, package: { name: 'barbaz' })
+      assert_equal 'foobar', config.library_name
+    end
+
+    def test_library_name_from_cargo_package
+      config.stubs(:toml).returns(lib: {}, package: { name: 'barbaz' })
+      assert_equal 'barbaz', config.library_name
+    end
+
+    def test_library_name_from_cargo_lib_has_no_hyphens
+      config.stubs(:toml).returns(lib: { name: 'foo-bar' }, package: { name: 'bar-baz' })
+      assert_equal 'foo_bar', config.library_name
+    end
+
+    def test_library_name_from_cargo_package_has_no_hyphens
+      config.stubs(:toml).returns(lib: {}, package: { name: 'bar-baz' })
+      assert_equal 'bar_baz', config.library_name
+    end
+
+    def test_shared_library
+      config.stubs(:library_name).returns('foobar')
+      config.stubs(:shared_ext).returns('ext')
+      Gem.stubs(:win_platform?).returns(false)
+      assert_equal 'foobar.so', config.shared_library
+    end
+
+    def test_shared_library_windows
+      config.stubs(:library_name).returns('foobar')
+      config.stubs(:shared_ext).returns('ext')
+      Gem.stubs(:win_platform?).returns(true)
+      assert_equal 'foobar.so', config.shared_library
+    end
+
+    def test_cargo_shared_library
+      config.stubs(:library_name).returns('foobar')
+      config.stubs(:shared_ext).returns('ext')
+      Gem.stubs(:win_platform?).returns(false)
+      assert_equal 'libfoobar.ext', config.cargo_shared_library
+    end
+
+    def test_cargo_shared_library_windows
+      config.stubs(:library_name).returns('foobar')
+      config.stubs(:shared_ext).returns('ext')
+      Gem.stubs(:win_platform?).returns(true)
+      assert_equal 'foobar.ext', config.cargo_shared_library
+    end
+
+    def test_tarball_filename
+      stub_tarball_filename_params(false)
+      assert_equal 'foobar-0.1.2-ruby12-c64-z80.tar.gz', config.tarball_filename('0.1.2')
+    end
+
+    def test_tarball_filename_with_static_extension
+      stub_tarball_filename_params(true)
+      assert_equal 'foobar-0.1.2-ruby12-c64-z80-static.tar.gz', config.tarball_filename('0.1.2')
+    end
+
+    def test_default_ruby_toplevel_dir
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      assert_equal '/tmp/foobar', config.ruby_toplevel_dir
+    end
+
+    def test_ruby_toplevel_dir
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      assert_equal '/tmp/barbaz', config(ruby_project_path: '/tmp/barbaz').ruby_toplevel_dir
+    end
+
+    def test_ruby_path
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      assert_equal '/tmp/foobar/baz/quux', config.ruby_path('baz', 'quux')
+    end
+
+    def test_ruby_extension_path
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      config.stubs(:shared_library).returns('libfoo.ext')
+      assert_equal '/tmp/foobar/lib/libfoo.ext', config.ruby_extension_path
+    end
+
+    def test_ruby_extension_path_with_custom_extension_dir
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      config.stubs(:ruby_extension_dir).returns('lib/ext')
+      config.stubs(:shared_library).returns('libfoo.ext')
+      assert_equal '/tmp/foobar/lib/ext/libfoo.ext', config.ruby_extension_path
+    end
+
+    def test_default_rust_toplevel_dir
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      assert_equal '/tmp/foobar', config.rust_toplevel_dir
+    end
+
+    def test_rust_toplevel_dir
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      assert_equal '/tmp/barbaz', config(cargo_project_path: '/tmp/barbaz').rust_toplevel_dir
+    end
+
+    def test_rust_path
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      assert_equal '/tmp/foobar/baz/quux', config.rust_path('baz', 'quux')
+    end
+
+    def test_cargo_target_path_with_env_var
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      ENV['CARGO_TARGET_DIR'] = 'foo'
+      assert_equal File.join('foo', 'debug', 'bar'), config.cargo_target_path('debug', 'bar')
+      ENV['CARGO_TARGET_DIR'] = nil
+    end
+
+    def test_cargo_target_path_without_env_var
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      ENV['CARGO_TARGET_DIR'] = nil
+      assert_equal File.join('/tmp/foobar', 'target', 'debug', 'bar'),
+                   config.cargo_target_path('debug', 'bar')
+    end
+
+    def test_cargo_toml_path_with_workspace_member
+      FileUtils.stubs(:pwd).returns('/tmp/foobar')
+      config(cargo_workspace_member: 'baz')
+      assert_equal '/tmp/foobar/baz/Cargo.toml', config.cargo_toml_path
+    end
+
+    def test_default_git_tag_regex
+      assert_equal described_class::DEFAULT_TAG_REGEX, config.git_tag_regex
+    end
+
+    def test_git_tag_regex
+      assert_equal(/abc(\d)/, config(git_tag_regex: 'abc(\d)').git_tag_regex)
+    end
+
+    def test_toml
+      expected = {
+        package: {
+          name: 'fixture',
+          metadata: {
+            thermite: {
+              github_releases: true
+            }
+          }
+        }
+      }
+      assert_equal expected, config(cargo_project_path: fixtures_path('config')).toml
+    end
+
+    def test_default_toml_config
+      config.stubs(:toml).returns({})
+      assert_equal({}, config.toml_config)
+    end
+
+    def test_toml_config
+      expected = { github_releases: true }
+      assert_equal expected, config(cargo_project_path: fixtures_path('config')).toml_config
+    end
+
+    def test_static_extension_sans_env_var
+      ENV.stubs(:key?).with('RUBY_STATIC').returns(false)
+      RbConfig::CONFIG.stubs(:[]).with('ENABLE_SHARED').returns('yes')
+      refute config.static_extension?
+
+      RbConfig::CONFIG.stubs(:[]).with('ENABLE_SHARED').returns('no')
+      assert config.static_extension?
+    end
+
+    def test_static_extension_with_env_var
+      ENV.stubs(:key?).with('RUBY_STATIC').returns(true)
+      RbConfig::CONFIG.stubs(:[]).with('ENABLE_SHARED').returns('yes')
+      assert config.static_extension?
+    end
+
+    private
+
+    def config(options = {})
+      @config ||= described_class.new(options)
+    end
+
+    def described_class
+      Thermite::Config
+    end
+
+    def stub_tarball_filename_params(static_extension)
+      config.stubs(:library_name).returns('foobar')
+      config.stubs(:ruby_version).returns('ruby12')
+      config.stubs(:target_os).returns('c64')
+      config.stubs(:target_arch).returns('z80')
+      config.stubs(:static_extension?).returns(static_extension)
+    end
+  end
+end

data/test/lib/thermite/custom_binary_test.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2016, 2017 Mark Lee and contributors
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+# associated documentation files (the "Software"), to deal in the Software without restriction,
+# including without limitation the rights to use, copy, modify, merge, publish, distribute,
+# sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or
+# substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+# NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+# DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+# OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'tmpdir'
+require 'test_helper'
+require 'thermite/custom_binary'
+require 'thermite/util'
+
+module Thermite
+  class CustomBinaryTest < Minitest::Test
+    include Thermite::ModuleTester
+
+    class Tester
+      include Thermite::CustomBinary
+      include Thermite::TestHelper
+      include Thermite::Util
+    end
+
+    def test_no_downloading_when_binary_uri_is_falsey
+      mock_module(binary_uri_format: false)
+      mock_module.expects(:http_get).never
+
+      assert !mock_module.download_binary_from_custom_uri
+    end
+
+    def test_download_binary_from_custom_uri
+      mock_module(binary_uri_format: 'http://example.com/download/%<version>s/%<filename>s')
+      mock_module.config.stubs(:toml).returns(package: { version: '4.5.6' })
+      Net::HTTP.stubs(:get_response).returns('location' => 'redirect')
+      mock_module.stubs(:http_get).returns('tarball')
+      mock_module.expects(:unpack_tarball).once
+      mock_module.expects(:prepare_downloaded_library).once
+
+      assert mock_module.download_binary_from_custom_uri
+    end
+
+    private
+
+    def described_class
+      Tester
+    end
+  end
+end