class Object - bundler: Ruby Standard Library Documentation

# class Object

### Public Instance Methods

gemfile(force_latest_compatible = false, options = {}, &gemfile) click to toggle source

Allows for declaring a Gemfile inline in a ruby script, installing any gems that aren’t already installed on the user’s system.

@note Every gem that is specified in this ‘Gemfile’ will be ‘require`d, as if

    the user had manually called `Bundler.require`. To avoid a requested gem
    being automatically required, add the `:require => false` option to the
    `gem` dependency declaration.

@param force_latest_compatible [Boolean] Force installing the latest

    compatible versions of the gems,
    even if compatible versions are
    already installed locally.
    This also logs output if the
    `:quiet` option is not set.
    Defaults to `false`.

@param gemfile [Proc] a block that is evaluated as a ‘Gemfile`.

@example Using an inline Gemfile

    #!/usr/bin/env ruby

    require 'bundler/inline'

    gemfile do
      source 'https://rubygems.org'
      gem 'json', require: false
      gem 'nap', require: 'rest'
      gem 'cocoapods', '~> 0.34.1'
    end

    puts Pod::VERSION # => "0.34.4"

    # File bundler/inline.rb, line 36
    def gemfile(force_latest_compatible = false, options = {}, &gemfile)
      require_relative "../bundler"
      Bundler.reset!

      opts = options.dup
      ui = opts.delete(:ui) { Bundler::UI::Shell.new }
      ui.level = "silent" if opts.delete(:quiet) || !force_latest_compatible
      Bundler.ui = ui
      raise ArgumentError, "Unknown options: #{opts.keys.join(", ")}" unless opts.empty?

      old_gemfile = ENV["BUNDLE_GEMFILE"]

      Bundler.unbundle_env!

      begin
        Bundler.instance_variable_set(:@bundle_path, Pathname.new(Gem.dir))
        Bundler::SharedHelpers.set_env "BUNDLE_GEMFILE", "Gemfile"

        Bundler::Plugin.gemfile_install(&gemfile) if Bundler.feature_flag.plugins?
        builder = Bundler::Dsl.new
        builder.instance_eval(&gemfile)

        Bundler.settings.temporary(deployment: false, frozen: false) do
          definition = builder.to_definition(nil, true)
          definition.validate_runtime!

          if force_latest_compatible || definition.missing_specs?
            Bundler.settings.temporary(inline: true, no_install: false) do
              installer = Bundler::Installer.install(Bundler.root, definition, system: true)
              installer.post_install_messages.each do |name, message|
                Bundler.ui.info "Post-install message from #{name}:\n#{message}"
              end
            end
          end

          begin
            runtime = Bundler::Runtime.new(nil, definition).setup
          rescue Gem::LoadError => e
            name = e.name
            version = e.requirement.requirements.first[1]
            activated_version = Gem.loaded_specs[name].version

            Bundler.ui.info \
              "The #{name} gem was resolved to #{version}, but #{activated_version} was activated by Bundler while installing it, causing a conflict. " \
              "Bundler will now retry resolving with #{activated_version} instead."

            builder.dependencies.delete_if {|d| d.name == name }
            builder.instance_eval { gem name, activated_version }
            definition = builder.to_definition(nil, true)

            retry
          end

          runtime.require
        end
      ensure
        if old_gemfile
          ENV["BUNDLE_GEMFILE"] = old_gemfile
        else
          ENV["BUNDLE_GEMFILE"] = ""
        end
      end
    end

namespace(name) click to toggle source
Calls superclass method

    # File bundler/vendor/thor/lib/thor/rake_compat.rb, line 61
    def namespace(name)
      if klass = Bundler::Thor::RakeCompat.rake_classes.last # rubocop:disable Lint/AssignmentInCondition
        const_name = Bundler::Thor::Util.camel_case(name.to_s).to_sym
        klass.const_set(const_name, Class.new(Bundler::Thor))
        new_klass = klass.const_get(const_name)
        Bundler::Thor::RakeCompat.rake_classes << new_klass
      end

      super
      Bundler::Thor::RakeCompat.rake_classes.pop
    end

Also aliased as: rake_namespace
rake_namespace(name)
Alias for: namespace
task(*) click to toggle source
Calls superclass method

    # File bundler/vendor/thor/lib/thor/rake_compat.rb, line 41
    def task(*)
      task = super

      if klass = Bundler::Thor::RakeCompat.rake_classes.last # rubocop:disable Lint/AssignmentInCondition
        non_namespaced_name = task.name.split(":").last

        description = non_namespaced_name
        description << task.arg_names.map { |n| n.to_s.upcase }.join(" ")
        description.strip!

        klass.desc description, Rake.application.last_description || non_namespaced_name
        Rake.application.last_description = nil
        klass.send :define_method, non_namespaced_name do |*args|
          Rake::Task[task.name.to_sym].invoke(*args)
        end
      end

      task
    end