# frozen_string_literal: true
require "licensee"

module Licensed
  class Dependency < Licensee::Projects::FSProject
    LEGAL_FILES_PATTERN = /(AUTHORS|NOTICE|LEGAL)(?:\..*)?\z/i

    attr_reader :name
    attr_reader :version
    attr_reader :errors
    attr_reader :path

    # Create a new project dependency
    #
    # name        - unique dependency name
    # version     - dependency version
    # path        - absolute file path to the dependency, to find license contents
    # search_root - (optional) the root location to search for dependency license contents
    # metadata    - (optional) additional dependency data to cache
    # errors      - (optional) errors encountered when evaluating dependency
    #
    # Returns a new dependency object.  Dependency metadata and license contents
    # are available if no errors are set on the dependency.
    def initialize(name:, version:, path:, search_root: nil, metadata: {}, errors: [])
      @name = name
      @version = version
      @metadata = metadata
      @errors = errors
      path = path.to_s
      @path = path

      # enforcing absolute paths makes life much easier when determining
      # an absolute file path in #notices
      if File.exist?(path) && !Pathname.new(path).absolute?
        # this is an internal error related to source implementation and
        # should be raised, not stored to be handled by reporters
        raise ArgumentError, "dependency path #{path} must be absolute"
      end

      super(path, search_root: search_root, detect_readme: true, detect_packages: true)
    end

    # Returns whether the dependency exists locally
    def exist?
      # some types of dependencies won't necessarily have a path that exists,
      # but they can still find license contents between the given path and
      # the search root
      # @root is defined
      File.exist?(path) || File.exist?(@root)
    end

    # Returns true if the dependency has any errors, false otherwise
    def errors?
      errors.any?
    end

    # Returns a record for this dependency including metadata and legal contents
    def record
      @record ||= DependencyRecord.new(
        metadata: license_metadata,
        licenses: license_contents,
        notices: notice_contents
      )
    end

    # Returns a string representing the dependencys license
    def license_key
      return "none" unless license
      license.key
    end

    # Returns the license text content from all matched sources
    # except the package file, which doesn't contain license text.
    def license_contents
      matched_files.reject { |f| f == package_file }
                   .group_by(&:content)
                   .map { |content, files| { "sources" => license_content_sources(files), "text" => content } }
    end

    # Returns legal notices found at the dependency path
    def notice_contents
      Dir.glob(dir_path.join("*"))
         .grep(LEGAL_FILES_PATTERN)
         .select { |path| File.file?(path) }
         .sort # sorted by the path
         .map { |path| { "sources" => normalize_source_path(path), "text" => read_file_with_encoding_check(path) } }
         .select { |notice| notice["text"].length > 0 } # files with content only
    end

    private

    def read_file_with_encoding_check(file_path)
      File.read(file_path).encode("UTF-16", invalid: :replace, replace: "?").encode("UTF-8").rstrip
    end

    # Returns the sources for a group of license file contents
    #
    # Sources are returned as a single string with sources separated by ", "
    def license_content_sources(files)
      paths = Array(files).map do |file|
        next file[:uri] if file[:uri]

        path = dir_path.join(file[:dir], file[:name])
        normalize_source_path(path)
      end

      paths.join(", ")
    end

    def normalize_source_path(path)
      path = Pathname.new(path) unless path.is_a?(Pathname)
      if path.fnmatch?(dir_path.join("**").to_path)
        # files under the dependency path return the relative path to the file
        path.relative_path_from(dir_path).to_path
      else
        # otherwise return the source_path as the immediate parent folder name
        # joined with the file name
        path.dirname.basename.join(path.basename).to_path
      end
    end

    # Returns the metadata that represents this dependency.  This metadata
    # is written to YAML in the dependencys cached text file
    def license_metadata
      {
        # can be overriden by values in @metadata
        "name" => name,
        "version" => version
      }.merge(
        @metadata
      ).merge({
        # overrides all other values
        "license" => license_key
      })
    end
  end
end