Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
cli	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
compact_index_client	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
fetcher	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
installer	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
man	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
plugin	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
resolver	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
settings	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
source	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
templates	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
ui	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
vendor	[ DIR ]	drwxr-xr-x	2025-06-05 11:22
build_metadata.rb	1.22 KB	-rw-r--r--	2022-04-12 11:11
capistrano.rb	883 B	-rw-r--r--	2022-04-12 11:11
cli.rb	38.73 KB	-rw-r--r--	2022-04-12 11:11
compact_index_client.rb	3.36 KB	-rw-r--r--	2022-04-12 11:11
constants.rb	212 B	-rw-r--r--	2022-04-12 11:11
current_ruby.rb	2.14 KB	-rw-r--r--	2022-04-12 11:11
definition.rb	28.7 KB	-rw-r--r--	2022-04-12 11:11
dep_proxy.rb	961 B	-rw-r--r--	2022-04-12 11:11
dependency.rb	4.69 KB	-rw-r--r--	2022-04-12 11:11
deployment.rb	3.19 KB	-rw-r--r--	2022-04-12 11:11
deprecate.rb	876 B	-rw-r--r--	2022-04-12 11:11
digest.rb	2.17 KB	-rw-r--r--	2022-04-12 11:11
dsl.rb	20.03 KB	-rw-r--r--	2022-04-12 11:11
endpoint_specification.rb	3.86 KB	-rw-r--r--	2022-04-12 11:11
env.rb	5.02 KB	-rw-r--r--	2022-04-12 11:11
environment_preserver.rb	1.94 KB	-rw-r--r--	2022-04-12 11:11
errors.rb	5.21 KB	-rw-r--r--	2022-04-12 11:11
feature_flag.rb	1.94 KB	-rw-r--r--	2022-04-12 11:11
fetcher.rb	10.94 KB	-rw-r--r--	2022-04-12 11:11
friendly_errors.rb	3.63 KB	-rw-r--r--	2022-04-12 11:11
gem_helper.rb	6.93 KB	-rw-r--r--	2022-04-12 11:11
gem_helpers.rb	3.85 KB	-rw-r--r--	2022-04-12 11:11
gem_tasks.rb	138 B	-rw-r--r--	2022-04-12 11:11
gem_version_promoter.rb	6.54 KB	-rw-r--r--	2022-04-12 11:11
graph.rb	4.99 KB	-rw-r--r--	2022-04-12 11:11
index.rb	5.21 KB	-rw-r--r--	2022-04-12 11:11
injector.rb	9.87 KB	-rw-r--r--	2022-04-12 11:11
inline.rb	2.79 KB	-rw-r--r--	2022-04-12 11:11
installer.rb	11.2 KB	-rw-r--r--	2022-04-12 11:11
lazy_specification.rb	4.94 KB	-rw-r--r--	2022-04-12 11:11
lockfile_generator.rb	2.16 KB	-rw-r--r--	2022-04-12 11:11
lockfile_parser.rb	6.89 KB	-rw-r--r--	2022-04-12 11:11
match_platform.rb	660 B	-rw-r--r--	2022-04-12 11:11
mirror.rb	5.82 KB	-rw-r--r--	2022-04-12 11:11
plugin.rb	11.13 KB	-rw-r--r--	2022-04-12 11:11
process_lock.rb	658 B	-rw-r--r--	2022-04-12 11:11
remote_specification.rb	3.97 KB	-rw-r--r--	2022-04-12 11:11
resolver.rb	14.58 KB	-rw-r--r--	2022-04-12 11:11
retry.rb	1.61 KB	-rw-r--r--	2022-04-12 11:11
ruby_dsl.rb	761 B	-rw-r--r--	2022-04-12 11:11
ruby_version.rb	4.41 KB	-rw-r--r--	2022-04-12 11:11
rubygems_ext.rb	6.56 KB	-rw-r--r--	2022-04-12 11:11
rubygems_gem_installer.rb	5.2 KB	-rw-r--r--	2022-04-12 11:11
rubygems_integration.rb	16.66 KB	-rw-r--r--	2022-04-12 11:11
runtime.rb	10.43 KB	-rw-r--r--	2022-04-12 11:11
self_manager.rb	4.76 KB	-rw-r--r--	2022-04-12 11:11
settings.rb	13.42 KB	-rw-r--r--	2022-04-12 11:11
setup.rb	776 B	-rw-r--r--	2022-04-12 11:11
shared_helpers.rb	10.84 KB	-rw-r--r--	2022-04-12 11:11
similarity_detector.rb	1.84 KB	-rw-r--r--	2022-04-12 11:11
source.rb	3.12 KB	-rw-r--r--	2022-04-12 11:11
source_list.rb	5.96 KB	-rw-r--r--	2022-04-12 11:11
source_map.rb	1.78 KB	-rw-r--r--	2022-04-12 11:11
spec_set.rb	4.57 KB	-rw-r--r--	2022-04-12 11:11
stub_specification.rb	2.87 KB	-rw-r--r--	2022-04-12 11:11
ui.rb	255 B	-rw-r--r--	2022-04-12 11:11
uri_credentials_filter.rb	1.28 KB	-rw-r--r--	2022-04-12 11:11
vendored_fileutils.rb	101 B	-rw-r--r--	2022-04-12 11:11
vendored_molinillo.rb	101 B	-rw-r--r--	2022-04-12 11:11
vendored_persistent.rb	1.44 KB	-rw-r--r--	2022-04-12 11:11
vendored_thor.rb	180 B	-rw-r--r--	2022-04-12 11:11
vendored_tmpdir.rb	95 B	-rw-r--r--	2022-04-12 11:11
vendored_tsort.rb	93 B	-rw-r--r--	2022-04-12 11:11
vendored_uri.rb	89 B	-rw-r--r--	2022-04-12 11:11
version.rb	179 B	-rw-r--r--	2022-04-12 11:11
version_ranges.rb	3.8 KB	-rw-r--r--	2022-04-12 11:11
vlad.rb	468 B	-rw-r--r--	2022-04-12 11:11
worker.rb	2.89 KB	-rw-r--r--	2022-04-12 11:11
yaml_serializer.rb	2.36 KB	-rw-r--r--	2022-04-12 11:11

Rename

# frozen_string_literal: true

module Bundler
  # This class contains all of the logic for determining the next version of a
  # Gem to update to based on the requested level (patch, minor, major).
  # Primarily designed to work with Resolver which will provide it the list of
  # available dependency versions as found in its index, before returning it to
  # to the resolution engine to select the best version.
  class GemVersionPromoter
    DEBUG = ENV["BUNDLER_DEBUG_RESOLVER"] || ENV["DEBUG_RESOLVER"]

attr_reader :level, :locked_specs, :unlock_gems

# By default, strict is false, meaning every available version of a gem
    # is returned from sort_versions. The order gives preference to the
    # requested level (:patch, :minor, :major) but in complicated requirement
    # cases some gems will by necessity by promoted past the requested level,
    # or even reverted to older versions.
    #
    # If strict is set to true, the results from sort_versions will be
    # truncated, eliminating any version outside the current level scope.
    # This can lead to unexpected outcomes or even VersionConflict exceptions
    # that report a version of a gem not existing for versions that indeed do
    # existing in the referenced source.
    attr_accessor :strict

attr_accessor :prerelease_specified

# Given a list of locked_specs and a list of gems to unlock creates a
    # GemVersionPromoter instance.
    #
    # @param locked_specs [SpecSet] All current locked specs. Unlike Definition
    #   where this list is empty if all gems are being updated, this should
    #   always be populated for all gems so this class can properly function.
    # @param unlock_gems [String] List of gem names being unlocked. If empty,
    #   all gems will be considered unlocked.
    # @return [GemVersionPromoter]
    def initialize(locked_specs = SpecSet.new([]), unlock_gems = [])
      @level = :major
      @strict = false
      @locked_specs = locked_specs
      @unlock_gems = unlock_gems
      @sort_versions = {}
      @prerelease_specified = {}
    end

# @param value [Symbol] One of three Symbols: :major, :minor or :patch.
    def level=(value)
      v = case value
          when String, Symbol
            value.to_sym
      end

raise ArgumentError, "Unexpected level #{v}. Must be :major, :minor or :patch" unless [:major, :minor, :patch].include?(v)
      @level = v
    end

# Given a Dependency and an Array of SpecGroups of available versions for a
    # gem, this method will return the Array of SpecGroups sorted (and possibly
    # truncated if strict is true) in an order to give preference to the current
    # level (:major, :minor or :patch) when resolution is deciding what versions
    # best resolve all dependencies in the bundle.
    # @param dep [Dependency] The Dependency of the gem.
    # @param spec_groups [SpecGroup] An array of SpecGroups for the same gem
    #    named in the @dep param.
    # @return [SpecGroup] A new instance of the SpecGroup Array sorted and
    #    possibly filtered.
    def sort_versions(dep, spec_groups)
      before_result = "before sort_versions: #{debug_format_result(dep, spec_groups).inspect}" if DEBUG

@sort_versions[dep] ||= begin
        gem_name = dep.name

# An Array per version returned, different entries for different platforms.
        # We only need the version here so it's ok to hard code this to the first instance.
        locked_spec = locked_specs[gem_name].first

if strict
          filter_dep_specs(spec_groups, locked_spec)
        else
          sort_dep_specs(spec_groups, locked_spec)
        end.tap do |specs|
          if DEBUG
            puts before_result
            puts " after sort_versions: #{debug_format_result(dep, specs).inspect}"
          end
        end
      end
    end

# @return [bool] Convenience method for testing value of level variable.
    def major?
      level == :major
    end

# @return [bool] Convenience method for testing value of level variable.
    def minor?
      level == :minor
    end

private

def filter_dep_specs(spec_groups, locked_spec)
      res = spec_groups.select do |spec_group|
        if locked_spec && !major?
          gsv = spec_group.version
          lsv = locked_spec.version

must_match = minor? ? [0] : [0, 1]

matches = must_match.map {|idx| gsv.segments[idx] == lsv.segments[idx] }
          matches.uniq == [true] ? (gsv >= lsv) : false
        else
          true
        end
      end

sort_dep_specs(res, locked_spec)
    end

def sort_dep_specs(spec_groups, locked_spec)
      return spec_groups unless locked_spec
      @gem_name = locked_spec.name
      @locked_version = locked_spec.version

result = spec_groups.sort do |a, b|
        @a_ver = a.version
        @b_ver = b.version

unless @prerelease_specified[@gem_name]
          a_pre = @a_ver.prerelease?
          b_pre = @b_ver.prerelease?

next -1 if a_pre && !b_pre
          next  1 if b_pre && !a_pre
        end

if major?
          @a_ver <=> @b_ver
        elsif either_version_older_than_locked
          @a_ver <=> @b_ver
        elsif segments_do_not_match(:major)
          @b_ver <=> @a_ver
        elsif !minor? && segments_do_not_match(:minor)
          @b_ver <=> @a_ver
        else
          @a_ver <=> @b_ver
        end
      end
      post_sort(result)
    end

def either_version_older_than_locked
      @a_ver < @locked_version || @b_ver < @locked_version
    end

def segments_do_not_match(level)
      index = [:major, :minor].index(level)
      @a_ver.segments[index] != @b_ver.segments[index]
    end

def unlocking_gem?
      unlock_gems.empty? || unlock_gems.include?(@gem_name)
    end

# Specific version moves can't always reliably be done during sorting
    # as not all elements are compared against each other.
    def post_sort(result)
      # default :major behavior in Bundler does not do this
      return result if major?
      if unlocking_gem?
        result
      else
        move_version_to_end(result, @locked_version)
      end
    end

def move_version_to_end(result, version)
      move, keep = result.partition {|s| s.version.to_s == version.to_s }
      keep.concat(move)
    end

def debug_format_result(dep, spec_groups)
      a = [dep.to_s,
           spec_groups.map {|sg| [sg.version, sg.dependencies_for_activated_platforms.map {|dp| [dp.name, dp.requirement.to_s] }] }]
      last_map = a.last.map {|sg_data| [sg_data.first.version, sg_data.last.map {|aa| aa.join(" ") }] }
      [a.first, last_map, level, strict ? :strict : :not_strict]
    end
  end
end