bundler-source-pathext 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fe992635560597c121fa90491f6501471dedddf344d497cfa87f4c512e51deb8
+  data.tar.gz: afd9e49a4916dbf8b9ec52505ef19fee11de8052716d94411a15e3961f93e628
+SHA512:
+  metadata.gz: eafc5e0d6fd8e7ff002ed82cc766332ec1b9e371fa596bc20f9877625a8feb5afc28160f5a698eedc85d8c9c6281e9c52e7fbb78cf18d0727c5791fc7788265d
+  data.tar.gz: c89d33b02882c2bb025e16a097cf48940ed86c7f0ce653bf4422e3bdf08d49db6dea1e885dc7c2062d261b8fab8932c0c0972d7d239f1712d58254a969c8b3ed

data/.gitignore

@@ -0,0 +1,7 @@
+pkg
+tmp
+.DS_Store
+
+*.bundle
+*.o
+*.so

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "rake", "~> 12.0"

data/Gemfile.lock

@@ -0,0 +1,20 @@
+PATH
+  remote: .
+  specs:
+    bundler-source-pathext (0.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    rake (12.3.3)
+
+PLATFORMS
+  arm64-darwin-24
+  x86_64-darwin-17
+
+DEPENDENCIES
+  bundler-source-pathext!
+  rake (~> 12.0)
+
+BUNDLED WITH
+   2.2.3

data/LICENSE

@@ -0,0 +1,28 @@
+Copyright (c) 2026, pganalyze Team <team@pganalyze.com>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+* Neither the name of pganalyze nor the names of its contributors may be used
+to endorse or promote products derived from this software without specific
+prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,24 @@
+# bundle-source-pathext [ ![](https://img.shields.io/gem/v/bundle-source-pathext.svg)](https://rubygems.org/gems/bundle-source-pathext) [ ![](https://img.shields.io/gem/dt/bundle-source-pathext.svg)](https://rubygems.org/gems/bundle-source-pathext)
+
+This bundler plugin allows building local Ruby extensions that are referred to by a local path, similar to how gems are built when they are fetched from a remote path.
+
+Rubygems/Bundler itself unfortunately does not build local extensions automatically, making workflows complicated that utilize gems with an extension build, as part of an application.
+
+## Usage
+
+In your Gemfile, replace something like `gem 'mygem', path: './folder` with:
+
+```ruby
+source './folder', type: 'pathext' do
+  gem 'mygem'
+end
+```
+
+Different from Rubygems, this plugin will prefer `rake compile` when an extension has a Rakefile, only falling back to the [Gem::Ext::Builder](https://github.com/ruby/rubygems/blob/master/lib/rubygems/ext/builder.rb) (or [other builders](https://github.com/ruby/rubygems/blob/master/lib/rubygems/ext/builder.rb#L173)) if needed. This is aimed at making debugging easier.
+
+## LICENSE
+
+Licensed under the 3-clause BSD license, see LICENSE file for details.
+
+Copyright (c) 2026, pganalyze Team <team@pganalyze.com>
+All rights reserved.

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bundler-source-pathext.gemspec

@@ -0,0 +1,21 @@
+require_relative 'lib/bundler-source-pathext/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "bundler-source-pathext"
+  spec.version       = BundlerSourcePathext::VERSION
+  spec.authors       = ["pganalyze Team"]
+  spec.email         = ["team@pganalyze.com"]
+
+  spec.summary = ''
+  spec.description = ''
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

data/lib/bundler-source-pathext/version.rb

@@ -0,0 +1,3 @@
+class BundlerSourcePathext < Bundler::Plugin::API
+  VERSION = "0.2.0"
+end

data/lib/bundler-source-pathext.rb

@@ -0,0 +1,166 @@
+require "bundler-source-pathext/version"
+
+class BundlerSourcePathext < Bundler::Plugin::API
+  class PathExtSource < Bundler::Source#Bundler::Source::Path
+    def install(spec, opts)
+      print_using_message "Using #{spec.name} #{spec.version} from #{self}"
+
+      using_message = "Using #{version_message(spec, options[:previous_spec])} from #{self}"
+      using_message += " and installing its executables" unless spec.executables.empty?
+      print_using_message using_message
+      generate_bin(spec, disable_extensions: true) # Turned off!
+
+      build_local_extensions(spec)
+
+      nil # no post-install message
+    end
+
+    # Bundler plugin api, we need to return a Bundler::Index
+    def specs
+      files = Dir.glob(File.join(File.expand_path(uri), '*.gemspec'))
+
+      Bundler::Index.build do |index|
+        files.each do |file|
+          next unless spec = Bundler.load_gemspec(file)
+          spec.installed_by_version = Gem::VERSION
+          spec.source = self
+          spec.extension_dir = File.join(File.dirname(file), 'tmp', RUBY_PLATFORM, spec.name, RUBY_VERSION)
+          Bundler.rubygems.validate(spec)
+
+          index << spec
+        end
+      end
+    end
+
+    # Set internal representation to fetch the gems/specs locally.
+    #
+    # When this is called, the source should try to fetch the specs and
+    # install from the local system.
+    def local!
+      # not applicable
+    end
+
+    # Set internal representation to fetch the gems/specs from remote.
+    #
+    # When this is called, the source should try to fetch the specs and
+    # install from remote path.
+    def remote!
+      # not applicable
+    end
+
+    # Set internal representation to fetch the gems/specs from app cache.
+    #
+    # When this is called, the source should try to fetch the specs and
+    # install from the path provided by `app_cache_path`.
+    def cached!
+      # not applicable
+    end
+
+    # This is called to update the spec and installation.
+    #
+    # If the source plugin is loaded from lockfile or otherwise, it shall
+    # refresh the cache/specs (e.g. git sources can make a fresh clone).
+    def unlock!
+      # not applicable
+    end
+
+    private
+
+    def build_local_extensions(spec)
+      build_args = options[:build_args] || Bundler.rubygems.build_args || begin
+        require_relative "command"
+        Gem::Command.build_args
+      end
+
+      builder = Gem::Ext::Builder.new spec, build_args
+
+      build_extensions(spec, build_args, builder)
+    end
+
+    def build_extensions(spec, build_args, builder)
+      return if spec.extensions.empty?
+
+      if build_args.empty?
+        puts "Building native extensions for #{spec.name}. This could take a while..."
+      else
+        puts "Building native extensions for #{spec.name} with: '#{@build_args.join " "}'"
+        puts "This could take a while..."
+      end
+
+      dest_path = spec.extension_dir
+      start = Time.now
+      load_dir = File.dirname(spec.loaded_from)
+
+      success = true
+      spec.extensions.each do |extension|
+        if extension[/extconf/] && File.exist?(File.join(load_dir, 'Rakefile'))
+          rake_args = ['compile']
+          builder.class.run(rake + rake_args, [], 'rake compile (via ' + self.class.to_s + ')', load_dir) do |status, results|
+            unless status.success?
+              success = false
+              puts results
+            end
+          end
+        else
+          builder.build_extension extension, dest_path
+        end
+      end
+      puts format('  Finished after %0.2f seconds', Time.now - start)
+      FileUtils.touch(spec.gem_build_complete_path) if success
+    end
+
+    def rake
+      rake = ENV["rake"]
+
+      if rake
+        rake = Shellwords.split(rake)
+      else
+        begin
+          rake = Gem::Ext::Builder.ruby << "-rrubygems" << Gem.bin_path("rake", "rake")
+        rescue Gem::Exception
+          rake = [Gem.default_exec_format % "rake"]
+        end
+      end
+      rake
+    end
+
+    def generate_bin(spec, options = {})
+      gem_dir = Pathname.new(spec.full_gem_path)
+
+      # Some gem authors put absolute paths in their gemspec
+      # and we have to save them from themselves
+      spec.files = spec.files.filter_map do |path|
+        next path unless /\A#{Pathname::SEPARATOR_PAT}/o.match?(path)
+        next if File.directory?(path)
+        begin
+          Pathname.new(path).relative_path_from(gem_dir).to_s
+        rescue ArgumentError
+          path
+        end
+      end
+
+      installer = Path::Installer.new(
+        spec,
+        env_shebang: false,
+        disable_extensions: options[:disable_extensions],
+        build_args: options[:build_args],
+        bundler_extension_cache_path: extension_cache_path(spec)
+      )
+      installer.post_install
+    rescue Gem::InvalidSpecificationException => e
+      Bundler.ui.warn "\n#{spec.name} at #{spec.full_gem_path} did not have a valid gemspec.\n" \
+                      "This prevents bundler from installing bins or native extensions, but " \
+                      "that may not affect its functionality."
+
+      if !spec.extensions.empty? && !spec.email.empty?
+        Bundler.ui.warn "If you need to use this package without installing it from a gem " \
+                        "repository, please contact #{spec.email} and ask them " \
+                        "to modify their .gemspec so it can work with `gem build`."
+      end
+
+      Bundler.ui.warn "The validation message from RubyGems was:\n  #{e.message}"
+    end
+  end
+
+  source 'pathext', PathExtSource
+end

data/plugins.rb

@@ -0,0 +1,2 @@
+require 'bundler-source-pathext'
+

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: bundler-source-pathext
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- pganalyze Team
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-01-17 00:00:00.000000000 Z
+dependencies: []
+description: ''
+email:
+- team@pganalyze.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bundler-source-pathext.gemspec
+- lib/bundler-source-pathext.rb
+- lib/bundler-source-pathext/version.rb
+- plugins.rb
+homepage:
+licenses: []
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: ''
+test_files: []