module Berkshelf
  # @author Jamie Winsor <jamie@vialstudios.com>
  class Resolver
    extend Forwardable

    attr_reader :graph

    # @param [Downloader] downloader
    # @param [Hash] options
    #
    # @option options [Array<CookbookSource>, CookbookSource] sources
    def initialize(downloader, options = {})
      @downloader = downloader
      @graph = Solve::Graph.new
      @sources = Hash.new

      # Dependencies need to be added AFTER the sources. If they are
      # not, then one of the dependencies of a source that is added
      # may take precedence over an explicitly set source that appears
      # later in the iterator.
      Array(options[:sources]).each do |source|
        add_source(source, false)
      end

      Array(options[:sources]).each do |source|
        add_source_dependencies(source)
      end
    end

    # Add the given source to the collection of sources for this instance
    # of Resolver. By default the dependencies of the given source will also
    # be added as sources to the collection.
    #
    # @param [Berkshelf::CookbookSource] source
    #   source to add
    # @param [Boolean] include_dependencies
    #   adds the dependencies of the given source as sources to the collection of
    #   if true. Dependencies will be ignored if false.
    #
    # @return [Array<CookbookSource>]
    def add_source(source, include_dependencies = true)
      if has_source?(source)
        raise DuplicateSourceDefined, "A source named '#{source.name}' is already present."
      end

      @sources[source.name] = source
      use_source(source) || install_source(source)

      graph.artifacts(source.name, source.cached_cookbook.version)

      if include_dependencies
        add_source_dependencies(source)
      end

      sources
    end

    # Add the dependencies of the given source as sources in the collection of sources
    # on this instance of Resolver. Any dependencies which already have a source in the
    # collection of sources of the same name will not be added to the collection a second
    # time.
    #
    # @param [CookbookSource] source
    #   source to convert dependencies into sources
    #
    # @return [Array<CookbookSource>]
    def add_source_dependencies(source)
      source.cached_cookbook.dependencies.each do |name, constraint|
        next if has_source?(name)

        add_source(CookbookSource.new(name, constraint: constraint))
      end
    end

    # @return [Array<Berkshelf::CookbookSource>]
    #   an array of CookbookSources that are currently added to this resolver
    def sources
      @sources.collect { |name, source| source }
    end

    # Finds a solution for the currently added sources and their dependencies and
    # returns an array of CachedCookbooks.
    #
    # @return [Array<Berkshelf::CachedCookbook>]
    def resolve
      demands = [].tap do |l_demands|
        graph.artifacts.each do |artifact|
          l_demands << [ artifact.name, artifact.version ]
        end
      end

      solution = Solve.it!(graph, demands)

      [].tap do |cached_cookbooks|
        solution.each do |name, version|
          cached_cookbooks << get_source(name).cached_cookbook
        end
      end
    end

    # @param [CookbookSource, #to_s] source
    #   name of the source to return
    #
    # @return [Berkshelf::CookbookSource]
    def [](source)
      if source.is_a?(CookbookSource)
        source = source.name
      end
      @sources[source.to_s]
    end
    alias_method :get_source, :[]

    # @param [CoobookSource, #to_s] source
    #   the source to test if the resolver has added
    def has_source?(source)
      !get_source(source).nil?
    end

    private

      attr_reader :downloader

      # @param [Berkshelf::CookbookSource] source
      #
      # @return [Boolean]
      def install_source(source)
        cached_cookbook, location = downloader.download(source)
        Berkshelf.formatter.install source.name, cached_cookbook.version, location
      end

      # Use the given source to create a constraint solution if the source has been downloaded or can
      # be satisfied by a cached cookbook that is already present in the cookbook store.
      #
      # @note Git location sources which have not yet been downloaded will not be satisfied by a
      #   cached cookbook from the cookbook store.
      #
      # @param [Berkshelf::CookbookSource] source
      #
      # @raise [ConstraintNotSatisfied] if the CachedCookbook does not satisfy the version constraint of
      #   this instance of Location.
      #   contain a cookbook that satisfies the given version constraint of this instance of
      #   CookbookSource.
      #
      # @return [Boolean]
      def use_source(source)
        if source.downloaded?
          cached = source.cached_cookbook
          source.location.validate_cached(cached)
        else
          if source.location.is_a?(GitLocation)
            return false
          end

          cached = downloader.cookbook_store.satisfy(source.name, source.version_constraint)
          return false if cached.nil?

          get_source(source).cached_cookbook = cached
        end

        path = source.location.is_a?(PathLocation) ? "#{source.location}" : nil
        Berkshelf.formatter.use cached.cookbook_name, cached.version, path

        true
      end
  end
end