gemvault 0.1.1

data/lib/rubygems/source/vault.rb

@@ -0,0 +1,124 @@
+require "gemvault/vault"
+
+##
+# A source backed by a .gemv vault file (SQLite archive of .gem blobs).
+#
+# Used by the gemvault RubyGems plugin to support:
+#
+#   gem install --source myvault.gemv activesupport
+
+class Gem::Source::Vault < Gem::Source
+  include Gem::UserInteraction
+
+  attr_reader :path
+
+  def initialize(path)
+    path = path.to_s
+    path = path.sub(%r{^file://}, "") if path.start_with?("file://")
+    @path = File.expand_path(path)
+    @uri  = @path
+    @specs = nil
+  end
+
+  def load_specs(type)
+    verbose "Loading #{type} specs from vault at #{@path}"
+    ensure_specs_loaded
+
+    case type
+    when :released
+      @specs.keys.reject { |t| t.version.prerelease? }
+    when :prerelease
+      @specs.keys.select { |t| t.version.prerelease? }
+    when :latest
+      @specs.keys
+            .group_by { |tuple| [tuple.name, tuple.platform] }
+            .values
+            .map { |tuples| tuples.max_by(&:version) }
+    else
+      @specs.keys
+    end
+  end
+
+  def fetch_spec(name_tuple)
+    ensure_specs_loaded
+
+    spec = @specs[name_tuple]
+    raise Gem::Exception, "Unable to find '#{name_tuple}'" unless spec
+
+    spec
+  end
+
+  def download(spec, dir = Dir.pwd)
+    verbose "Extracting #{spec.file_name} from vault at #{@path}"
+    cache_dir = File.join(dir, "cache")
+    FileUtils.mkdir_p(cache_dir)
+
+    dest = File.join(cache_dir, spec.file_name)
+
+    Gemvault::Vault.open(@path) do |vault|
+      data = vault.gem_data(spec.name, spec.version.to_s, platform: spec.platform.to_s)
+      File.binwrite(dest, data)
+    end
+
+    dest
+  end
+
+  def dependency_resolver_set(prerelease = false)
+    require_relative "../resolver/vault_set"
+    set = Gem::Resolver::VaultSet.new(self)
+    set.prerelease = prerelease
+    set
+  end
+
+  def <=>(other)
+    case other
+    when Gem::Source::Installed,
+         Gem::Source::Lock then
+      -1
+    when Gem::Source::Vault
+      0
+    when Gem::Source::Local
+      -1
+    when Gem::Source
+      1
+    end
+  end
+
+  def ==(other)
+    other.is_a?(self.class) && @path == other.path
+  end
+
+  alias eql? ==
+
+  def hash
+    @path.hash
+  end
+
+  def to_s
+    "vault at #{@path}"
+  end
+
+  def pretty_print(q)
+    q.object_group(self) do
+      q.group 2, "[Vault:", "]" do
+        q.breakable
+        q.text @path
+      end
+    end
+  end
+
+  private
+
+  def ensure_specs_loaded
+    return if @specs
+
+    @specs = {}
+    Gemvault::Vault.open(@path) do |vault|
+      vault.gem_entries.each do |entry|
+        spec = vault.spec_from_blob(entry.name, entry.version, entry.platform)
+        tuple = spec.name_tuple
+        @specs[tuple] = spec
+      end
+    end
+  end
+end

data/lib/rubygems_plugin.rb

@@ -0,0 +1,72 @@
+require_relative "rubygems/source/vault"
+require "rubygems/source_list"
+
+##
+# RubyGems plugin for .gemv vault sources.
+#
+# Enables: gem install --source myvault.gemv activesupport
+#
+# Three monkey-patches (via prepend) are needed because RubyGems has no
+# source registration API:
+#
+# 1. accept_uri_http -- let .gemv paths bypass URI scheme validation
+# 2. add_source_option -- skip trailing "/" append for .gemv paths
+# 3. SourceList#<< -- route .gemv strings to Gem::Source::Vault
+
+module Gemvault
+  module AcceptVaultURI
+    def accept_uri_http
+      Gem::OptionParser.accept Gem::URI::HTTP do |value|
+        next value if value.to_s.end_with?(".gemv")
+
+        begin
+          uri = Gem::URI.parse value
+        rescue Gem::URI::InvalidURIError
+          raise Gem::OptionParser::InvalidArgument, value
+        end
+
+        valid_uri_schemes = ["http", "https", "file", "s3"]
+        unless valid_uri_schemes.include?(uri.scheme)
+          msg = "Invalid uri scheme for #{value}\nPreface URLs with one of #{valid_uri_schemes.map { |s| "#{s}://" }}"
+          raise ArgumentError, msg
+        end
+
+        value
+      end
+    end
+  end
+
+  module AddVaultSourceOption
+    def add_source_option
+      accept_uri_http
+
+      add_option(:"Local/Remote", "-s", "--source URL", Gem::URI::HTTP,
+                 "Append URL to list of remote gem sources") do |source, options|
+        source << "/" unless source.end_with?("/", ".gemv")
+
+        if options.delete :sources_cleared
+          Gem.sources = [source]
+        else
+          Gem.sources << source unless Gem.sources.include?(source)
+        end
+      end
+    end
+  end
+
+  module VaultSourceList
+    def <<(obj)
+      if obj.is_a?(String) && obj.end_with?(".gemv")
+        src = Gem::Source::Vault.new(obj)
+        @sources << src unless @sources.include?(src)
+        return src
+      end
+      super
+    end
+  end
+end
+
+Gem::SourceList.prepend Gemvault::VaultSourceList
+
+require "rubygems/local_remote_options"
+Gem::LocalRemoteOptions.prepend Gemvault::AcceptVaultURI
+Gem::LocalRemoteOptions.prepend Gemvault::AddVaultSourceOption

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: gemvault
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- David Gillis
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: command_kit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: SQLite-backed .gemv archives for bundling and distributing multiple gems
+  as a single file
+email:
+- david@flipmine.com
+executables:
+- gemvault
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ASSESSMENT.md
+- CLAUDE.md
+- Dockerfile.test
+- LICENSE
+- LICENSE.txt
+- MACROPLAN.md
+- README.md
+- Rakefile
+- docs/superpowers/plans/2026-04-16-container-integration-tests.md
+- exe/gemvault
+- lib/bundler/plugin/vault_source.rb
+- lib/gemvault.rb
+- lib/gemvault/cli.rb
+- lib/gemvault/cli/command.rb
+- lib/gemvault/cli/commands/add.rb
+- lib/gemvault/cli/commands/extract.rb
+- lib/gemvault/cli/commands/list.rb
+- lib/gemvault/cli/commands/new.rb
+- lib/gemvault/cli/commands/remove.rb
+- lib/gemvault/gem_entry.rb
+- lib/gemvault/vault.rb
+- lib/gemvault/version.rb
+- lib/rubygems/resolver/vault_set.rb
+- lib/rubygems/source/vault.rb
+- lib/rubygems_plugin.rb
+homepage: https://github.com/gillisd/gemvault
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/gillisd/gemvault
+  bug_tracker_uri: https://github.com/gillisd/gemvault/issues
+  changelog_uri: https://github.com/gillisd/gemvault/blob/master/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.9
+specification_version: 4
+summary: Multi-gem portable archives backed by SQLite
+test_files: []