bundlebun 0.5.0.1.3.13-aarch64-linux-gnu

data/lib/tasks/install.rake

@@ -0,0 +1,305 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'json'
+
+namespace :bun do
+  desc 'Install bundlebun: install binstub and detect frameworks'
+  task 'install' do
+    puts <<~MESSAGE
+      We are now going to install bundlebun. We'll try to detect the frameworks already in use and install integrations for them.
+
+      Don't forget to run `rake -T bun` to learn more about additional installation tasks for integration with Ruby and JavaScript frameworks, or check the documentation.
+
+      Bun.
+
+    MESSAGE
+
+    Rake::Task['bun:install:bin'].invoke
+
+    if defined?(Cssbundling) || defined?(Jsbundling)
+      puts "Rails' cssbundling/jsbundling detected.\n\n"
+      Rake::Task['bun:install:bundling-rails'].invoke
+    end
+
+    if defined?(ViteRuby)
+      puts "vite-ruby detected.\n\n"
+      Rake::Task['bun:install:vite'].invoke
+    end
+
+    if File.exist?('package.json')
+      puts "package.json detected.\n\n"
+      Rake::Task['bun:install:package'].invoke
+    end
+
+    if Dir.glob('Procfile*').any?
+      puts "Procfile detected.\n\n"
+      Rake::Task['bun:install:procfile'].invoke
+    end
+  end
+
+  desc 'Install bundlebun: create `bin/bun` binstub'
+  task 'install:bin' do
+    puts "Installing bin/bun...\n\n"
+
+    source = File.expand_path('../../exe/bundlebun', __dir__)
+    target_dir = 'bin'
+    target = File.join(target_dir, 'bun')
+    content = File.read(source)
+
+    if File.exist?(target)
+      puts "#{target} already exists."
+    else
+      FileUtils.mkdir_p(target_dir)
+      File.write(target, content, mode: "w")
+      FileUtils.chmod(0o755, target)
+
+      puts "Installed binstub at #{target}."
+    end
+
+    # We're using Bundler technique to generate the .cmd wrappers on
+    # Windows (as Windows cannot run files with shebangs, of course).
+    # There is no public API for generating binstubs (I wish), so that's a copy and paste.
+    # @see https://github.com/rubygems/rubygems/blob/186a4f24789e6e7fd967b290ce93ed5886ef22d8/bundler/lib/bundler/installer.rb#L137
+    if Gem.win_platform?
+      cmd_target = "#{target}.cmd"
+      if File.exist?(cmd_target)
+        puts "#{cmd_target} already exists."
+      else
+        prefix = "@ruby -x \"%~f0\" %*\n@exit /b %ERRORLEVEL%\n\n"
+        File.write(cmd_target, prefix + content, mode: "wb:UTF-8")
+        puts "Installed Windows binstub at #{cmd_target}"
+      end
+    end
+
+    puts <<~MESSAGE
+      Try running it directly. Or, replace existing mentions of `bun` with `bin/bun` in your `package.json`, `Procfile` or binstubs and other files.
+
+      Bun.
+
+    MESSAGE
+  end
+
+  desc 'Install bundlebun: cssbundling-rails, jsbundling-rails integration'
+  task 'install:bundling-rails' => :install do
+    puts "Installing cssbundling/jsbundling Rails integration...\n\n"
+
+    assets_rake = File.expand_path('../templates/bundling-rails/bundlebun.rake', __dir__)
+    target_dir = 'lib/tasks'
+    target = File.join(target_dir, 'bundlebun.rake')
+
+    if File.exist?(target)
+      puts "#{target} already exists."
+    else
+      FileUtils.mkdir_p(target_dir)
+      FileUtils.cp(assets_rake, target)
+      puts "Installed an initializer with overrides for cssbundling-rails and jsbundling-rails at #{target}"
+    end
+
+    puts <<~MESSAGE
+      Install cssbundling-rails [https://github.com/rails/cssbundling-rails] and jsbundling-rails [https://github.com/rails/jsbundling-rails] to get a simple assets pipeline with Rails, powered by Bun.
+
+      Example:
+
+        bundle add cssbundling-rails
+        bin/rails css:install:[tailwind|bootstrap|bulma|postcss|sass]
+        bin/rails css:build
+
+        bundle add jsbundling-rails
+        bin/rails javascript:install:bun
+
+      Those gems enable you to create new Rails templates using Bun, as well as to create a simple build configuration with Bun. Check their READMEs and documentation.
+
+      Be sure to replace `bun` with `bin/bun` in any existing and generated build-related files such as `Procfile` or `Procfile.dev`, `package.json` and others.
+
+      Bun.
+
+    MESSAGE
+  end
+
+  desc 'Install bundlebun: vite-ruby integration'
+  task 'install:vite' => :install do
+    puts "Installing vite-ruby integration...\n\n"
+
+    binstub = File.expand_path('../templates/vite-ruby/bun-vite', __dir__)
+    target_dir = 'bin'
+    target = File.join(target_dir, 'bun-vite')
+    content = File.read(binstub)
+
+    config = File.expand_path('../templates/vite-ruby/vite.json', __dir__)
+    config_target_dir = 'config'
+    config_target = File.join(config_target_dir, 'vite.json')
+
+    if File.exist?(target)
+      puts "#{target} already exists."
+    else
+      FileUtils.mkdir_p(target_dir)
+      File.write(target, content, mode: "w")
+      FileUtils.chmod(0o755, target)
+      puts "Installed a vite-ruby + bundlebun binstub at #{target}"
+    end
+
+    # See above for notes on `.cmd`-file generation.
+    if Gem.win_platform?
+      cmd_target = "#{target}.cmd"
+      if File.exist?(cmd_target)
+        puts "#{cmd_target} already exists."
+      else
+        prefix = "@ruby -x \"%~f0\" %*\n@exit /b %ERRORLEVEL%\n\n"
+        File.write(cmd_target, prefix + content, mode: "wb:UTF-8")
+        puts "Installed Windows binstub at #{cmd_target}"
+      end
+    end
+
+    if File.exist?(config_target)
+      puts "#{config_target} already exists."
+
+      begin
+        json = JSON.parse(File.read(config_target))
+        # Injecting our binstub
+        json['all'] ||= {}
+        json['all']['viteBinPath'] = 'bin/bun-vite'
+
+        File.write(config_target, JSON.pretty_generate(json))
+      rescue
+        puts "Failed to parse #{config_target}, no changes made."
+      end
+    else
+      FileUtils.mkdir_p(config_target_dir)
+      FileUtils.cp(config, config_target)
+      puts "Installed sample vite-ruby + bundlebun config at #{config_target}"
+    end
+
+    puts <<~MESSAGE
+      We've installed a binstub for running vite-ruby with bundlebun enabled at #{target}.
+      Use this binstub to force bundlebun with Vite as a JavaScript runtime. Additionally, we've installed (or updated!) a vite-ruby configuration file at #{config_target} to use that binstub.
+
+      Be sure to replace `bun` with `bin/bun` in any existing build-related files such as `Procfile` or `Procfile.dev`, `package.json` and others.
+
+      Bun.
+
+    MESSAGE
+  end
+
+  desc 'Migrate package.json scripts to use bin/bun'
+  task 'install:package' do
+    package_json_path = 'package.json'
+
+    unless File.exist?(package_json_path)
+      puts "No package.json found in the current directory."
+      next
+    end
+
+    begin
+      package = JSON.parse(File.read(package_json_path))
+    rescue JSON::ParserError
+      puts "Failed to parse package.json."
+      next
+    end
+
+    scripts = package['scripts']
+    if scripts.nil? || scripts.empty?
+      puts "No scripts found in package.json."
+      next
+    end
+
+    # Order in alternation matters: more specific patterns first
+    pattern = /\b(bunx|npx|pnpm exec|yarn exec|npm run|yarn run|pnpm run|bun)\b/
+    binstub = Bundlebun::Runner.binstub_path
+    replacements = {
+      'bunx' => "#{binstub} x",
+      'npx' => "#{binstub} x",
+      'pnpm exec' => "#{binstub} x",
+      'yarn exec' => "#{binstub} x",
+      'npm run' => "#{binstub} run",
+      'yarn run' => "#{binstub} run",
+      'pnpm run' => "#{binstub} run",
+      'bun' => binstub
+    }
+
+    changes = []
+    scripts.each do |name, value|
+      next unless value.is_a?(String)
+      next if value.include?(Bundlebun::Runner::BINSTUB_PATH)
+
+      new_value = value.gsub(pattern) { |match| replacements[match] }
+      changes << {name: name, old: value, new: new_value} if new_value != value
+    end
+
+    if changes.empty?
+      puts "All scripts in package.json already use bin/bun. No changes needed."
+      next
+    end
+
+    puts "The following changes will be made to package.json scripts:\n\n"
+    changes.each do |change|
+      puts "  #{change[:name]}:"
+      puts "    - #{change[:old]}"
+      puts "    + #{change[:new]}"
+      puts
+    end
+
+    print "Apply these changes? [Y/n] "
+    answer = $stdin.gets&.strip&.downcase
+
+    if answer.nil? || answer.empty? || answer == 'y' || answer == 'yes'
+      changes.each do |change|
+        package['scripts'][change[:name]] = change[:new]
+      end
+
+      File.write(package_json_path, JSON.pretty_generate(package) + "\n")
+      puts "\nUpdated package.json successfully."
+    else
+      puts "\nNo changes made."
+    end
+  end
+
+  desc 'Migrate Procfile commands to use bin/bun'
+  task 'install:procfile' do
+    procfiles = Dir.glob('Procfile*')
+
+    if procfiles.empty?
+      puts "No Procfile found in the current directory."
+      next
+    end
+
+    pattern = /\b(bunx|npx|pnpm exec|yarn exec|npm run|yarn run|pnpm run|bun)\b/
+    binstub = Bundlebun::Runner.binstub_path
+    replacements = {
+      'bunx' => "#{binstub} x",
+      'npx' => "#{binstub} x",
+      'pnpm exec' => "#{binstub} x",
+      'yarn exec' => "#{binstub} x",
+      'npm run' => "#{binstub} run",
+      'yarn run' => "#{binstub} run",
+      'pnpm run' => "#{binstub} run",
+      'bun' => binstub
+    }
+
+    procfiles.each do |procfile|
+      content = File.read(procfile)
+      next if content.include?(Bundlebun::Runner::BINSTUB_PATH)
+
+      new_content = content.gsub(pattern) { |match| replacements[match] }
+      next if new_content == content
+
+      puts "Changes for #{procfile}:\n\n"
+      content.lines.zip(new_content.lines).each do |old_line, new_line|
+        if old_line != new_line
+          puts "  - #{old_line}"
+          puts "  + #{new_line}"
+        end
+      end
+
+      print "Apply these changes? [Y/n] "
+      answer = $stdin.gets&.strip&.downcase
+
+      if answer.nil? || answer.empty? || answer == 'y' || answer == 'yes'
+        File.write(procfile, new_content)
+        puts "Updated #{procfile} successfully.\n\n"
+      else
+        puts "No changes made to #{procfile}.\n\n"
+      end
+    end
+  end
+end

data/lib/templates/bundling-rails/bundlebun.rake

@@ -0,0 +1,10 @@
+# An initializer of sorts for bundlebun's integration.
+# Can't go to `initializers`, does not trigger that way.
+#
+# This forces cssbundling and jsbundling to use a bundlebun'ed
+# version of Bun for building assets.
+#
+# Safe to delete if you no longer use bundlebun or
+# not interested in running Bun anymore.
+Bundlebun::Integrations::Cssbundling.bun!
+Bundlebun::Integrations::Jsbundling.bun!

data/lib/templates/vite-ruby/bun-vite

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+# This file runs the Vite executable under Bun.
+
+ENV['RAILS_ENV'] ||= ENV['RACK_ENV']
+
+require 'bundler/setup'
+require 'vite_ruby'
+require 'bundlebun'
+
+Bundlebun::Integrations::ViteRuby.bun!
+
+Bundlebun.call(['x', '--bun', 'vite', *ARGV])

data/lib/templates/vite-ruby/vite.json

@@ -0,0 +1,16 @@
+{
+  "all": {
+    "watchAdditionalPaths": [],
+    "viteBinPath": "bin/bun-vite"
+},
+  "development": {
+    "autoBuild": true,
+    "publicOutputDir": "vite-dev",
+    "port": 3036
+  },
+  "test": {
+    "autoBuild": true,
+    "publicOutputDir": "vite-test",
+    "port": 3037
+  }
+}

data/sig/bundlebun/env_path.rbs

@@ -0,0 +1,8 @@
+module Bundlebun
+  class EnvPath
+    def self.path: () -> String?
+    def self.path=: (String new_path) -> String
+    def self.prepend: (String new_path) -> String?
+    def self.separator: () -> String
+  end
+end

data/sig/bundlebun/integrations/cssbundling.rbs

@@ -0,0 +1,12 @@
+module Bundlebun
+  module Integrations
+    module Cssbundling
+      def self.bun!: () -> void
+
+      module Tasks
+        def install_command: () -> String
+        def build_command: () -> String
+      end
+    end
+  end
+end

data/sig/bundlebun/integrations/execjs.rbs

@@ -0,0 +1,7 @@
+module Bundlebun
+  module Integrations
+    module ExecJS
+      def self.bun!: () -> void
+    end
+  end
+end

data/sig/bundlebun/integrations/jsbundling.rbs

@@ -0,0 +1,12 @@
+module Bundlebun
+  module Integrations
+    module Jsbundling
+      def self.bun!: () -> void
+
+      module Tasks
+        def install_command: () -> String
+        def build_command: () -> String
+      end
+    end
+  end
+end

data/sig/bundlebun/integrations/vite_ruby.rbs

@@ -0,0 +1,12 @@
+module Bundlebun
+  module Integrations
+    module ViteRuby
+      def self.bun!: () -> void
+
+      module RunnerExtensions
+        def vite_executable: (*untyped exec_args) -> Array[String]
+        def bun_binstub_path: () -> String
+      end
+    end
+  end
+end

data/sig/bundlebun/integrations.rbs

@@ -0,0 +1,5 @@
+module Bundlebun
+  module Integrations
+    def self.bun!: () -> Array[Module]
+  end
+end

data/sig/bundlebun/platform.rbs

@@ -0,0 +1,5 @@
+module Bundlebun
+  class Platform
+    def self.windows?: () -> bool
+  end
+end

data/sig/bundlebun/runner.rbs

@@ -0,0 +1,35 @@
+module Bundlebun
+  class Runner
+    BINSTUB_PATH: String
+    RELATIVE_DIRECTORY: String
+
+    # Replaces the current Ruby process with Bun. Never returns.
+    def self.exec: (String | Array[String] arguments) -> bot
+
+    # Replaces the current Ruby process with Bun. Alias for .exec. Never returns.
+    def self.call: (String | Array[String] arguments) -> bot
+
+    # Runs Bun as a subprocess and returns control to Ruby.
+    def self.system: (String | Array[String] arguments) -> bool?
+
+    def self.binstub_path: () -> String
+    def self.full_binstub_path: () -> String
+    def self.relative_directory: () -> String
+    def self.full_directory: () -> String
+    def self.binary_path: () -> String
+    def self.binary_path_exist?: () -> bool
+    def self.binstub_or_binary_path: () -> String
+    def self.binstub_exist?: () -> bool
+
+    def initialize: (String | Array[String] arguments) -> void
+
+    # Replaces the current Ruby process with Bun. Never returns.
+    def exec: () -> bot
+
+    # Replaces the current Ruby process with Bun. Alias for #exec. Never returns.
+    def call: () -> bot
+
+    # Runs Bun as a subprocess and returns control to Ruby.
+    def system: () -> bool?
+  end
+end

data/sig/bundlebun/version.rbs

@@ -0,0 +1,3 @@
+module Bundlebun
+  VERSION: String
+end

data/sig/bundlebun.rbs

@@ -0,0 +1,18 @@
+module Bundlebun
+  VERSION: String
+
+  # Replaces the current Ruby process with Bun.
+  # This is the default way to run Bun. Never returns.
+  def self.call: (String | Array[String] arguments) -> bot
+
+  # Replaces the current Ruby process with Bun. Same as .call.
+  def self.exec: (String | Array[String] arguments) -> bot
+
+  # Runs Bun as a subprocess and returns control to Ruby.
+  # Returns true if Bun exited successfully, false if it failed, nil if execution failed.
+  def self.system: (String | Array[String] arguments) -> bool?
+
+  def self.prepend_to_path: () -> String?
+  def self.load_tasks: () -> void
+  def self.load_integrations: () -> Array[Module]
+end

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: bundlebun
+version: !ruby/object:Gem::Version
+  version: 0.5.0.1.3.13
+platform: aarch64-linux-gnu
+authors:
+- Yaroslav Markin
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: json
+  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: 'bundlebun bundles Bun, a fast JavaScript runtime, package manager, and
+  builder, with your Ruby and Rails applications. No need to use Docker, devcontainers,
+  `curl | sh`, or `brew`.
+
+  '
+email:
+- yaroslav@markin.net
+executables:
+- bundlebun
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- exe/bundlebun
+- lib/bundlebun.rb
+- lib/bundlebun/env_path.rb
+- lib/bundlebun/integrations.rb
+- lib/bundlebun/integrations/cssbundling.rb
+- lib/bundlebun/integrations/execjs.rb
+- lib/bundlebun/integrations/jsbundling.rb
+- lib/bundlebun/integrations/vite_ruby.rb
+- lib/bundlebun/platform.rb
+- lib/bundlebun/runner.rb
+- lib/bundlebun/vendor/bun/LICENSE.md
+- lib/bundlebun/vendor/bun/bun
+- lib/bundlebun/version.rb
+- lib/tasks/bun.rake
+- lib/tasks/install.rake
+- lib/templates/bundling-rails/bundlebun.rake
+- lib/templates/vite-ruby/bun-vite
+- lib/templates/vite-ruby/vite.json
+- sig/bundlebun.rbs
+- sig/bundlebun/env_path.rbs
+- sig/bundlebun/integrations.rbs
+- sig/bundlebun/integrations/cssbundling.rbs
+- sig/bundlebun/integrations/execjs.rbs
+- sig/bundlebun/integrations/jsbundling.rbs
+- sig/bundlebun/integrations/vite_ruby.rbs
+- sig/bundlebun/platform.rbs
+- sig/bundlebun/runner.rbs
+- sig/bundlebun/version.rbs
+homepage: https://github.com/yaroslav/bundlebun
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/yaroslav/bundlebun
+  source_code_uri: https://github.com/yaroslav/bundlebun
+  changelog_uri: https://github.com/yaroslav/bundlebun/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/yaroslav/bundlebun/issues
+  documentation_uri: https://rubydoc.info/gems/bundlebun
+  rbs_source: sig
+post_install_message: Bun.
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: bundlebun bundles the Bun JavaScript runtime, package manager and build tool,
+  for use with Ruby and Rails
+test_files: []