bootstrap-vendor 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: daa78a564f02b991f124b684302f7ff84ecca051e8948f6b7073d3b9f184f635
+  data.tar.gz: 48776d4c1ab31eedf4c05bcfee16ef540a783c4cf4d95391a7ff7e7b89c1d1b0
+SHA512:
+  metadata.gz: 5a248e243d6597587e748e276d50e33c4a745ae25a5996ff5c0e74cf61d779b061aa8beb85255b92f804fc662a3155a2ba7c7768404c9a0c6400d0bde3925c2a
+  data.tar.gz: 34301886d1cb24a56b89d95b487a4c855b5bc933587944e964e3b28e30ffc15e11a0153f2b268432b25c7272a5a76ac6d7a58a8d1348a6307767e93da4c64be6

data/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## [Unreleased]
+
+## [0.1.0] - 2026-03-26
+
+- Add rake tasks: vendor, version, latest, status, init, install, update, uninstall
+- Add Railtie to load rake tasks in Rails apps
+- Add Registry with all stable Bootstrap versions and constraint matching via Gem::Requirement
+- Add VersionFile to read/write .bootstrap-version files
+- Add Config for ENV-based settings with opinionated defaults
+- Add FileList to compute expected/installed files and download with source fallback
+- Add download source fallback chain (JSDelivrNPM, JSDelivrGitHub, GitHubRaw, GitHubAPI)
+- Support BOOTSTRAP_VENDOR_SOURCE ENV var to pin a specific download source
+- Extract version list to flat VERSIONS.txt file, read by Registry at runtime
+- Add `rake versions` maintainer task to update VERSIONS.txt from GitHub releases

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"bootstrap-vendor" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["veganstraightedge@gmail.com"](mailto:"veganstraightedge@gmail.com").

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Shane Becker
+
+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.

data/README.md

@@ -0,0 +1,273 @@
+# bootstrap-vendor
+
+Rake tasks to vendor [Bootstrap](https://getbootstrap.com) CSS and JS into your Rails app. No asset pipeline, no npm, no build system. Just static files in `vendor/`.
+
+## Install
+
+Add to your Gemfile:
+
+```ruby
+gem 'bootstrap-vendor'
+```
+
+Then:
+
+```sh
+bundle install
+```
+
+In a Rails app, the rake tasks are loaded automatically via Railtie.
+
+## Quick start
+
+```sh
+rake bootstrap:vendor
+```
+
+This creates a `.bootstrap-version` file and downloads the latest Bootstrap CSS and JS into `vendor/stylesheets/` and `vendor/javascript/`.
+
+## Usage
+
+### In Rails
+
+Add Bootstrap to your asset paths. In `config/initializers/assets.rb`:
+
+```ruby
+Rails.application.config.assets.paths << Rails.root.join('vendor/stylesheets')
+Rails.application.config.assets.paths << Rails.root.join('vendor/javascript')
+```
+
+Or with importmaps, pin the JS in `config/importmap.rb`:
+
+```ruby
+pin 'bootstrap', to: 'bootstrap.bundle.js'
+```
+
+And add a stylesheet link in your layout:
+
+```erb
+<%= stylesheet_link_tag 'bootstrap', 'data-turbo-track': 'reload' %>
+```
+
+### In non-Rails
+
+Add the gem:
+
+```sh
+gem install bootstrap-vendor
+```
+
+Create a `Rakefile` (or add to an existing one):
+
+```ruby
+require 'bootstrap/vendor'
+load 'tasks/bootstrap.rake'
+```
+
+Then use the rake tasks as normal:
+
+```sh
+rake bootstrap:vendor
+```
+
+### From zsh (command line shell)
+
+zsh interprets `[]` as glob patterns. Escape the brackets when passing arguments to rake tasks:
+
+```sh
+rake 'bootstrap:init[overwrite]'
+rake bootstrap:init\[overwrite\]
+noglob rake bootstrap:init[overwrite]
+```
+
+## Rake tasks
+
+- [`bootstrap:vendor`](#bootstrapvendor) — do it all shortcut
+- [`bootstrap:version`](#bootstrapversion) — print current version
+- [`bootstrap:latest`](#bootstraplatest) — print latest upstream version
+- [`bootstrap:status`](#bootstrapstatus) — compare current to latest
+- [`bootstrap:init`](#bootstrapinit) — create .bootstrap-version
+- [`bootstrap:install`](#bootstrapinstall) — download files
+- [`bootstrap:update`](#bootstrapupdate) — update files
+- [`bootstrap:uninstall`](#bootstrapuninstall) — remove files
+
+### `bootstrap:vendor`
+
+The opinionated, does-it-all shortcut. Creates `.bootstrap-version`, downloads the latest Bootstrap files, and you're done.
+
+```sh
+rake bootstrap:vendor
+```
+
+### `bootstrap:version`
+
+Prints the current version from `.bootstrap-version`.
+
+```sh
+rake bootstrap:version
+# 5.3.8
+```
+
+### `bootstrap:latest`
+
+Prints the latest known Bootstrap version. Accepts an optional constraint.
+
+```sh
+rake bootstrap:latest
+# 5.3.8
+
+rake bootstrap:latest[5]
+# 5.3.8
+
+rake bootstrap:latest[4]
+# 4.6.2
+
+rake bootstrap:latest[5.2]
+# 5.2.3
+```
+
+### `bootstrap:status`
+
+Compares your current version to the latest upstream.
+
+```sh
+rake bootstrap:status
+# Current version 5.3.8 is up to date
+
+rake bootstrap:status
+# Current version 5.2.3 is behind latest version 5.3.8
+```
+
+### `bootstrap:init`
+
+Creates a `.bootstrap-version` file. Defaults to the latest version.
+
+```sh
+rake bootstrap:init
+# A .bootstrap-version file was created.
+# Version: 5.3.8
+
+rake bootstrap:init[4]
+# A .bootstrap-version file was created.
+# Version: 4.6.2
+
+rake bootstrap:init[overwrite]
+# Overwrites an existing .bootstrap-version
+```
+
+### `bootstrap:install`
+
+Downloads Bootstrap CSS and JS files. Fails if already installed (use `update` instead).
+
+```sh
+rake bootstrap:install
+```
+
+### `bootstrap:update`
+
+Downloads Bootstrap CSS and JS files, overwriting existing ones.
+
+```sh
+rake bootstrap:update
+# Bootstrap updated from 5.3.5 to 5.3.8
+```
+
+### `bootstrap:uninstall`
+
+Removes vendored Bootstrap files and `.bootstrap-version`.
+
+```sh
+rake bootstrap:uninstall
+```
+
+## Default files
+
+By default, these files are downloaded:
+
+```sh
+vendor/stylesheets/bootstrap.css
+vendor/stylesheets/bootstrap.css.map
+vendor/javascript/bootstrap.bundle.js
+vendor/javascript/bootstrap.bundle.js.map
+```
+
+### Configuration
+
+Customize which files are downloaded with environment variables. These are the defaults:
+
+| ENV variable                 | Default | Effect                                     |
+| ---------------------------- | ------- | ------------------------------------------ |
+| `BOOTSTRAP_VENDOR_CSS_LTR`   | `true`  | Download LTR CSS                           |
+| `BOOTSTRAP_VENDOR_CSS_RTL`   | `false` | Download RTL CSS                           |
+| `BOOTSTRAP_VENDOR_CSS_MAP`   | `true`  | Download CSS source maps                   |
+| `BOOTSTRAP_VENDOR_CSS_MIN`   | `false` | Download minified CSS                      |
+| `BOOTSTRAP_VENDOR_JS_BUNDLE` | `true`  | Download bundle (includes Popper) vs plain |
+| `BOOTSTRAP_VENDOR_JS_MAP`    | `true`  | Download JS source maps                    |
+| `BOOTSTRAP_VENDOR_JS_MIN`    | `false` | Download minified JS                       |
+
+At least one of `CSS_LTR` or `CSS_RTL` must be `true`.
+
+Example: download minified files without source maps:
+
+```sh
+BOOTSTRAP_VENDOR_CSS_MIN=true BOOTSTRAP_VENDOR_CSS_MAP=false BOOTSTRAP_VENDOR_JS_MIN=true BOOTSTRAP_VENDOR_JS_MAP=false rake bootstrap:install
+```
+
+## Download sources
+
+Files are downloaded from multiple sources with automatic fallback for resilience:
+
+1. [jsdelivr CDN](https://www.jsdelivr.com) (npm)
+2. [jsdelivr CDN](https://www.jsdelivr.com) (GitHub)
+3. [GitHub raw files](https://raw.githubusercontent.com)
+4. [GitHub releases](https://github.com/twbs/bootstrap/releases) (zip)
+
+Pin a specific source with:
+
+```sh
+BOOTSTRAP_VENDOR_SOURCE=github_raw rake bootstrap:install
+```
+
+Valid source names: `jsdelivr_npm`, `jsdelivr_github`, `github_raw`, `github_api`.
+
+## Optional arguments
+
+### Path, where to install
+
+Most tasks accept an optional `path` argument. By default, tasks operate in the current directory. Pass a path to target a different location:
+
+```sh
+rake 'bootstrap:vendor[public/assets]'
+rake 'bootstrap:version[public/assets]'
+```
+
+The `.bootstrap-version` file and `vendor/` directories are created relative to the given path.
+
+Tasks that accept `path`: `vendor`, `version`, `status`, `init`, `install`, `update`, `uninstall`.
+
+For tasks that accept both `version` and `path` (`status`, `init`, `install`, `update`), `version` is the first positional arg. To pass only a path, leave version empty:
+
+```sh
+rake 'bootstrap:install[5, public/assets]'
+rake 'bootstrap:install[, public/assets]'
+```
+
+### Version constraint, what to install
+
+`latest`, `status`, `init`, `install`, and `update` accept version constraints. The constraint finds the latest version within that major or minor:
+
+| Constraint | Resolves to                |
+| ---------- | -------------------------- |
+| `5`        | Latest 5.x.y (e.g., 5.3.8) |
+| `5.3`      | Latest 5.3.x (e.g., 5.3.8) |
+| `5.3.5`    | Latest 5.3.x (e.g., 5.3.8) |
+| `4`        | Latest 4.x.y (e.g., 4.6.2) |
+
+## Requirements
+
+- Ruby >= 4.0
+- Rails (for automatic Railtie loading) or any Ruby project with Rake
+
+## License
+
+MIT. See [LICENSE.txt](LICENSE.txt).

data/Rakefile

@@ -0,0 +1,50 @@
+require 'http'
+require 'json'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new :spec
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]
+
+desc 'Update VERSIONS file from GitHub releases'
+task :versions do
+  puts 'Fetching releases from GitHub...'
+
+  versions = []
+  page = 1
+
+  loop do
+    response = HTTP.get "https://api.github.com/repos/twbs/bootstrap/releases?per_page=100&page=#{page}"
+    releases = JSON.parse response.body.to_s
+
+    break if releases.empty?
+
+    releases.each do |release|
+      tag     = release['tag_name'].delete_prefix 'v'
+      version = Gem::Version.new tag
+
+      next if version.prerelease?
+
+      versions << tag
+    end
+
+    page += 1
+  end
+
+  versions.sort_by! { Gem::Version.new it }
+
+  versions_path = File.expand_path 'VERSIONS.txt', __dir__
+  current       = File.readlines(versions_path, chomp: true).reject(&:empty?)
+  new_versions  = versions - current
+
+  if new_versions.empty?
+    puts 'VERSIONS is up to date.'
+  else
+    File.write versions_path, "#{versions.join "\n"}\n"
+
+    puts "Added #{new_versions.length} new version(s): #{new_versions.join ', '}"
+  end
+end

data/VERSIONS.txt

@@ -0,0 +1,73 @@
+1.0.0
+1.1.0
+1.1.1
+1.2.0
+1.3.0
+1.4.0
+2.0.0
+2.0.1
+2.0.2
+2.0.3
+2.0.4
+2.1.0
+2.1.1
+2.2.0
+2.2.1
+2.2.2
+2.3.0
+2.3.1
+2.3.2
+3.0.0
+3.0.1
+3.0.2
+3.0.3
+3.1.0
+3.1.1
+3.2.0
+3.3.0
+3.3.1
+3.3.2
+3.3.4
+3.3.5
+3.3.6
+3.3.7
+3.4.0
+3.4.1
+4.0.0
+4.1.0
+4.1.1
+4.1.2
+4.1.3
+4.2.0
+4.2.1
+4.3.0
+4.3.1
+4.4.0
+4.4.1
+4.5.0
+4.5.1
+4.5.2
+4.5.3
+4.6.0
+4.6.1
+4.6.2
+5.0.0
+5.0.1
+5.0.2
+5.1.0
+5.1.1
+5.1.2
+5.1.3
+5.2.0
+5.2.1
+5.2.2
+5.2.3
+5.3.0
+5.3.1
+5.3.2
+5.3.3
+5.3.4
+5.3.5
+5.3.6
+5.3.7
+5.3.8

data/lib/bootstrap/vendor/config.rb

@@ -0,0 +1,46 @@
+module Bootstrap
+  module Vendor
+    class Config
+      attr_reader :source
+
+      def initialize
+        @css_ltr   = env_bool 'BOOTSTRAP_VENDOR_CSS_LTR', default: true
+        @css_map   = env_bool 'BOOTSTRAP_VENDOR_CSS_MAP', default: true
+        @css_min   = env_bool 'BOOTSTRAP_VENDOR_CSS_MIN', default: false
+        @css_rtl   = env_bool 'BOOTSTRAP_VENDOR_CSS_RTL', default: false
+        @js_bundle = env_bool 'BOOTSTRAP_VENDOR_JS_BUNDLE', default: true
+        @js_map    = env_bool 'BOOTSTRAP_VENDOR_JS_MAP', default: true
+        @js_min    = env_bool 'BOOTSTRAP_VENDOR_JS_MIN', default: false
+        @source    = ENV.fetch 'BOOTSTRAP_VENDOR_SOURCE', nil
+
+        validate!
+      end
+
+      def css_map? = @css_map
+      def css_min? = @css_min
+      def css_path = 'vendor/stylesheets'
+      def js_map?  = @js_map
+      def js_min?  = @js_min
+      def js_path  = 'vendor/javascript'
+
+      def css_ltr?   = @css_ltr
+      def css_rtl?   = @css_rtl
+      def js_bundle? = @js_bundle
+
+      private
+
+      def env_bool key, default:
+        value = ENV.fetch key, nil
+        return default if value.nil?
+
+        value.downcase == 'true'
+      end
+
+      def validate!
+        return if css_ltr? || css_rtl?
+
+        raise Error, 'At least one of LTR or RTL must be true'
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor/file_list.rb

@@ -0,0 +1,83 @@
+module Bootstrap
+  module Vendor
+    class FileList
+      def initialize config:, version:, root: '.', sources: nil
+        @config  = config
+        @version = version
+        @root    = root
+        @sources = sources || Source.default_chain
+      end
+
+      def expected
+        css_entries + js_entries
+      end
+
+      def installed
+        expected.map { it[:destination] }.select { File.exist? it }
+      end
+
+      def download
+        dirs = expected.map { File.dirname it[:destination] }.uniq
+        dirs.each { FileUtils.mkdir_p it }
+
+        expected.each { download_with_fallback it }
+      end
+
+      private
+
+      def download_with_fallback entry
+        errors = []
+
+        @sources.each do |source|
+          source.download_file(
+            version:     @version,
+            subdir:      entry[:subdir],
+            filename:    entry[:filename],
+            destination: entry[:destination]
+          )
+          errors.clear
+          break
+        rescue Down::Error, Zip::Error, IOError => e
+          errors << e
+        end
+
+        raise errors.last unless errors.empty?
+      end
+
+      def css_entries
+        filenames = []
+        filenames.concat(css_filenames_for(rtl: false)) if @config.css_ltr?
+        filenames.concat(css_filenames_for(rtl: true)) if @config.css_rtl?
+        filenames.map { build_entry(filename: it, subdir: 'css', local_path: @config.css_path) }
+      end
+
+      def css_filenames_for rtl:
+        base = rtl ? 'bootstrap.rtl' : 'bootstrap'
+        base = "#{base}.min" if @config.css_min?
+        names = ["#{base}.css"]
+        names << "#{base}.css.map" if @config.css_map?
+        names
+      end
+
+      def js_entries
+        js_filenames.map { build_entry(filename: it, subdir: 'js', local_path: @config.js_path) }
+      end
+
+      def js_filenames
+        base = @config.js_bundle? ? 'bootstrap.bundle' : 'bootstrap'
+        base = "#{base}.min" if @config.js_min?
+        names = ["#{base}.js"]
+        names << "#{base}.js.map" if @config.js_map?
+        names
+      end
+
+      def build_entry filename:, subdir:, local_path:
+        {
+          filename:,
+          subdir:,
+          destination: File.join(@root, local_path, filename)
+        }
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor/railtie.rb

@@ -0,0 +1,9 @@
+module Bootstrap
+  module Vendor
+    class Railtie < Rails::Railtie
+      rake_tasks do
+        load File.expand_path('../../tasks/bootstrap.rake', __dir__)
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor/registry.rb

@@ -0,0 +1,33 @@
+module Bootstrap
+  module Vendor
+    module Registry
+      VERSIONS_PATH = File.expand_path('../../../VERSIONS.txt', __dir__).freeze
+
+      def self.all
+        @all ||= File.readlines(VERSIONS_PATH, chomp: true).reject(&:empty?)
+      end
+
+      def self.latest constraint: nil
+        return all.last if constraint.nil?
+
+        requirement = build_requirement(constraint.to_s)
+        matches     = all.select { requirement.satisfied_by? Gem::Version.new it }
+
+        raise Error, "No versions matching '#{constraint}'" if matches.empty?
+
+        matches.last
+      end
+
+      def self.build_requirement constraint
+        segments = Gem::Version.new(constraint).segments
+
+        case segments.length
+        when 1    then Gem::Requirement.new("~> #{segments[0]}.0")
+        when 2, 3 then Gem::Requirement.new("~> #{segments[0]}.#{segments[1]}.0")
+        end
+      end
+
+      private_class_method :build_requirement
+    end
+  end
+end

data/lib/bootstrap/vendor/source/git_hub_api.rb

@@ -0,0 +1,40 @@
+require 'zip'
+
+module Bootstrap
+  module Vendor
+    module Source
+      class GitHubAPI
+        NAME = 'github_api'.freeze
+        BASE_URL = 'https://github.com/twbs/bootstrap/releases/download/v'.freeze
+
+        def name = NAME
+
+        def url_for version:, subdir: nil, filename: nil # rubocop:disable Lint/UnusedMethodArgument
+          [BASE_URL, version, '/bootstrap-', version, '-dist.zip'].join
+        end
+
+        def download_file version:, subdir:, filename:, destination:
+          zip        = cached_zip(version:)
+          entry_path = "bootstrap-#{version}-dist/#{subdir}/#{filename}"
+          entry      = zip.find_entry(entry_path)
+
+          raise Down::NotFound, "#{entry_path} not found in zip" unless entry
+
+          File.binwrite destination, entry.get_input_stream.read
+        end
+
+        private
+
+        def cached_zip version:
+          @cached_zips ||= {}
+          @cached_zips[version] ||= download_zip(version:)
+        end
+
+        def download_zip version:
+          tempfile = Down.download url_for(version:)
+          Zip::File.open tempfile.path
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor/source/git_hub_raw.rb

@@ -0,0 +1,20 @@
+module Bootstrap
+  module Vendor
+    module Source
+      class GitHubRaw
+        NAME = 'github_raw'.freeze
+        BASE_URL = 'https://raw.githubusercontent.com/twbs/bootstrap/refs/tags/v'.freeze
+
+        def name = NAME
+
+        def url_for version:, subdir:, filename:
+          [BASE_URL, version, '/dist/', subdir, '/', filename].join
+        end
+
+        def download_file version:, subdir:, filename:, destination:
+          Down.download url_for(version:, subdir:, filename:), destination:
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor/source/js_delivr_git_hub.rb

@@ -0,0 +1,20 @@
+module Bootstrap
+  module Vendor
+    module Source
+      class JSDelivrGitHub
+        NAME = 'jsdelivr_github'.freeze
+        BASE_URL = 'https://cdn.jsdelivr.net/gh/twbs/bootstrap@v'.freeze
+
+        def name = NAME
+
+        def url_for version:, subdir:, filename:
+          [BASE_URL, version, '/dist/', subdir, '/', filename].join
+        end
+
+        def download_file version:, subdir:, filename:, destination:
+          Down.download url_for(version:, subdir:, filename:), destination:
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor/source/js_delivr_npm.rb

@@ -0,0 +1,20 @@
+module Bootstrap
+  module Vendor
+    module Source
+      class JSDelivrNPM
+        NAME = 'jsdelivr_npm'.freeze
+        BASE_URL = 'https://cdn.jsdelivr.net/npm/bootstrap@'.freeze
+
+        def name = NAME
+
+        def url_for version:, subdir:, filename:
+          [BASE_URL, version, '/dist/', subdir, '/', filename].join
+        end
+
+        def download_file version:, subdir:, filename:, destination:
+          Down.download url_for(version:, subdir:, filename:), destination:
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor/source.rb

@@ -0,0 +1,30 @@
+require_relative 'source/git_hub_api'
+require_relative 'source/git_hub_raw'
+require_relative 'source/js_delivr_git_hub'
+require_relative 'source/js_delivr_npm'
+
+module Bootstrap
+  module Vendor
+    module Source
+      SOURCES = {
+        jsdelivr_npm:    JSDelivrNPM,
+        jsdelivr_github: JSDelivrGitHub,
+        github_raw:      GitHubRaw,
+        github_api:      GitHubAPI
+      }.freeze
+
+      DEFAULT_ORDER = %i[jsdelivr_npm jsdelivr_github github_raw github_api].freeze
+
+      def self.build name
+        klass = SOURCES[name.to_sym]
+        raise Error, "Unknown source: '#{name}'. Valid sources: #{SOURCES.keys.join(', ')}" unless klass
+
+        klass.new
+      end
+
+      def self.default_chain
+        DEFAULT_ORDER.map { SOURCES[it].new }
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor/version.rb

@@ -0,0 +1,5 @@
+module Bootstrap
+  module Vendor
+    VERSION = '0.1.0'.freeze
+  end
+end

data/lib/bootstrap/vendor/version_file.rb

@@ -0,0 +1,42 @@
+module Bootstrap
+  module Vendor
+    class VersionFile
+      FILENAME = '.bootstrap-version'.freeze
+
+      attr_reader :path
+
+      def initialize path:
+        @path = resolve_path path
+      end
+
+      def delete
+        File.delete @path if exists?
+      end
+
+      def exists?
+        File.exist? @path
+      end
+
+      def read
+        return nil unless exists?
+
+        File.read(@path).strip
+      end
+
+      def write version:
+        FileUtils.mkdir_p File.dirname(@path)
+        File.write @path, "#{version}\n"
+      end
+
+      private
+
+      def resolve_path path
+        if File.directory?(path) || !path.end_with?(FILENAME)
+          File.join path, FILENAME
+        else
+          path
+        end
+      end
+    end
+  end
+end

data/lib/bootstrap/vendor.rb

@@ -0,0 +1,18 @@
+require 'down'
+require 'fileutils'
+require 'tmpdir'
+
+require_relative 'vendor/config'
+require_relative 'vendor/file_list'
+require_relative 'vendor/registry'
+require_relative 'vendor/source'
+require_relative 'vendor/version'
+require_relative 'vendor/version_file'
+
+module Bootstrap
+  module Vendor
+    class Error < StandardError; end
+  end
+end
+
+require_relative 'vendor/railtie' if defined? Rails::Railtie

data/lib/tasks/bootstrap.rake

@@ -0,0 +1,200 @@
+require 'bootstrap/vendor'
+
+def bootstrap_sources config
+  if config.source
+    [Bootstrap::Vendor::Source.build(config.source)]
+  else
+    Bootstrap::Vendor::Source.default_chain
+  end
+end
+
+namespace :bootstrap do
+  desc 'Print the current Bootstrap version from .bootstrap-version'
+  task :version, [:path] do |_t, args|
+    path         = args[:path] || '.'
+    version_file = Bootstrap::Vendor::VersionFile.new(path:)
+
+    if version_file.exists?
+      puts version_file.read
+    else
+      puts 'No .bootstrap-version file found. Create one with:'
+      puts 'rake bootstrap:init'
+    end
+  end
+
+  desc 'Print the latest Bootstrap version (optionally within a constraint)'
+  task :latest, [:version] do |_t, args|
+    constraint = args[:version]
+    latest     = Bootstrap::Vendor::Registry.latest(constraint:)
+
+    puts latest
+  end
+
+  desc 'Compare current version to latest upstream version'
+  task :status, [:version, :path] do |_t, args|
+    path = args[:path] || '.'
+    version_file = Bootstrap::Vendor::VersionFile.new(path:)
+
+    unless version_file.exists?
+      puts 'No .bootstrap-version file found. Create one with:'
+      puts 'rake bootstrap:init'
+      next
+    end
+
+    current    = version_file.read
+    constraint = args[:version]
+    latest     = Bootstrap::Vendor::Registry.latest(constraint:)
+
+    if current == latest
+      puts "Current version #{current} is up to date"
+    else
+      constraint_label = constraint ? " #{constraint}.x.y" : ''
+      puts "Current version #{current} is behind latest#{constraint_label} version #{latest}"
+    end
+  end
+
+  desc 'Create a .bootstrap-version file'
+  task :init, [:version, :path, :overwrite] do |_t, args|
+    version   = args[:version]
+    path      = args[:path] || '.'
+    overwrite = args[:overwrite] == 'overwrite' || version == 'overwrite'
+
+    # Handle bootstrap:init['overwrite'] (version arg is actually 'overwrite')
+    version = nil if version == 'overwrite'
+
+    resolved     = Bootstrap::Vendor::Registry.latest constraint: version
+    version_file = Bootstrap::Vendor::VersionFile.new(path:)
+
+    if version_file.exists? && !overwrite
+      puts 'A .bootstrap-version file already exists.'
+      puts "Version: #{version_file.read}"
+      puts "Use 'overwrite' to replace it."
+      puts "rake bootstrap:init['overwrite']"
+      next
+    end
+
+    version_file.write version: resolved
+
+    puts 'A .bootstrap-version file was created.'
+    puts "Version: #{resolved}"
+  end
+
+  desc 'Download Bootstrap CSS and JS files'
+  task :install, [:version, :path] do |_t, args|
+    path         = args[:path] || '.'
+    version_file = Bootstrap::Vendor::VersionFile.new(path:)
+    constraint   = args[:version]
+    resolved     = if version_file.exists? && constraint.nil?
+                     version_file.read
+                   else
+                     Bootstrap::Vendor::Registry.latest(constraint:)
+                   end
+
+    config    = Bootstrap::Vendor::Config.new
+    sources   = bootstrap_sources config
+    file_list = Bootstrap::Vendor::FileList.new(config:, version: resolved, root: path, sources:)
+
+    if file_list.installed.length == file_list.expected.length
+      puts 'Bootstrap is already installed.'
+      puts "Version: #{resolved}"
+      puts "Use 'rake bootstrap:update' to update."
+      next
+    end
+
+    file_list.download
+
+    version_file.write version: resolved
+
+    puts 'CSS:'
+    file_list.expected.select { it[:destination].include?('stylesheets') }.each do |entry|
+      puts "  #{entry[:destination]}"
+    end
+    puts 'JS:'
+    file_list.expected.select { it[:destination].include?('javascript') }.each do |entry|
+      puts "  #{entry[:destination]}"
+    end
+  end
+
+  desc 'Update Bootstrap CSS and JS files to latest version'
+  task :update, [:version, :path] do |_t, args|
+    path         = args[:path] || '.'
+    version_file = Bootstrap::Vendor::VersionFile.new(path:)
+    current      = version_file.read || '0.0.0'
+
+    constraint = args[:version]
+    resolved   = Bootstrap::Vendor::Registry.latest constraint: constraint
+    config     = Bootstrap::Vendor::Config.new
+    sources    = bootstrap_sources config
+    file_list  = Bootstrap::Vendor::FileList.new(config:, version: resolved, root: path, sources:)
+
+    file_list.download
+
+    version_file.write version: resolved
+
+    puts "Bootstrap updated from #{current} to #{resolved}"
+    puts ''
+    puts 'CSS:'
+    file_list.expected.select { it[:destination].include?('stylesheets') }.each do |entry|
+      puts "  #{entry[:destination]}"
+    end
+    puts 'JS:'
+    file_list.expected.select { it[:destination].include?('javascript') }.each do |entry|
+      puts "  #{entry[:destination]}"
+    end
+  end
+
+  desc 'Vendor Bootstrap: init, fetch latest, update'
+  task :vendor, [:path] do |_t, args|
+    path         = args[:path] || '.'
+    version_file = Bootstrap::Vendor::VersionFile.new(path:)
+
+    resolved  = Bootstrap::Vendor::Registry.latest
+    config    = Bootstrap::Vendor::Config.new
+    sources   = bootstrap_sources config
+    file_list = Bootstrap::Vendor::FileList.new(config:, version: resolved, root: path, sources:)
+
+    file_list.download
+
+    version_file.write(version: resolved)
+
+    puts "Bootstrap #{resolved} vendored."
+    puts ''
+    puts 'CSS:'
+    file_list.expected.select { it[:destination].include?('stylesheets') }.each do |entry|
+      puts "  #{entry[:destination]}"
+    end
+    puts 'JS:'
+    file_list.expected.select { it[:destination].include?('javascript') }.each do |entry|
+      puts "  #{entry[:destination]}"
+    end
+  end
+
+  desc 'Remove vendored Bootstrap files'
+  task :uninstall, [:path] do |_t, args|
+    path         = args[:path] || '.'
+    version_file = Bootstrap::Vendor::VersionFile.new(path:)
+    current      = version_file.read
+    config       = Bootstrap::Vendor::Config.new
+    file_list    = Bootstrap::Vendor::FileList.new config:, version: current || '0', root: path
+    deleted      = false
+
+    file_list.installed.each do |destination|
+      File.delete destination
+      puts "Deleted #{destination}"
+      deleted = true
+    end
+
+    if version_file.exists?
+      version_file.delete
+      puts 'Deleted .bootstrap-version'
+      deleted = true
+    end
+
+    if deleted
+      message = current ? "Bootstrap #{current} uninstalled." : 'Bootstrap uninstalled.'
+      puts message
+    else
+      puts 'No Bootstrap installation found.'
+    end
+  end
+end

data/sig/bootstrap/vendor.rbs

@@ -0,0 +1,6 @@
+module Bootstrap
+  module Vendor
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: bootstrap-vendor
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Shane Becker
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: down
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.5'
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+description: 'Manage vendored Bootstrap files with rake tasks: check versions, download,
+  update, and uninstall.'
+email:
+- veganstraightedge@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSIONS.txt
+- lib/bootstrap/vendor.rb
+- lib/bootstrap/vendor/config.rb
+- lib/bootstrap/vendor/file_list.rb
+- lib/bootstrap/vendor/railtie.rb
+- lib/bootstrap/vendor/registry.rb
+- lib/bootstrap/vendor/source.rb
+- lib/bootstrap/vendor/source/git_hub_api.rb
+- lib/bootstrap/vendor/source/git_hub_raw.rb
+- lib/bootstrap/vendor/source/js_delivr_git_hub.rb
+- lib/bootstrap/vendor/source/js_delivr_npm.rb
+- lib/bootstrap/vendor/version.rb
+- lib/bootstrap/vendor/version_file.rb
+- lib/tasks/bootstrap.rake
+- sig/bootstrap/vendor.rbs
+homepage: https://github.com/xoengineering/bootstrap-vendor
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/xoengineering/bootstrap-vendor
+  source_code_uri: https://github.com/xoengineering/bootstrap-vendor
+  changelog_uri: https://github.com/xoengineering/bootstrap-vendor/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.8
+specification_version: 4
+summary: Rake tasks to vendor Bootstrap CSS and JS into your Rails app
+test_files: []