module Crowdin
  # A wrapper and interface to the Crowdin api. Please visit the Crowdin developers
  # site for a full explaination of what each of the Crowdin api methods
  # expect and perform.
  #
  # http://crowdin.com/page/api

  class API

    # Add new file to Crowdin project.
    #
    # == Parameters
    #
    # files - Array of files that should be added to Crowdin project.
    # file is a Hash {:dest, :source, :title, :export_pattern}
    # * :dest - file name with path in Crowdin project (required)
    # * :source - path for uploaded file (required)
    # * :title - title in Crowdin UI (optional)
    # * :export_pattern - Resulted file name (optional)
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/add-file?key={project-key}
    #
    def add_file(files, params = {})
      params[:files] = Hash[files.map{ |f| [
        f[:dest]               || raise(ArgumentError, "'`:dest`' is required"),
        ::File.open(f[:source] || raise(ArgumentError, "'`:source` is required'"))
      ] }]

      params[:titles] = Hash[files.map{ |f| [f[:dest], f[:title]] }]
      params[:titles].delete_if{ |k, v| v.nil? }

      params[:export_patterns] = Hash[files.map{ |f| [f[:dest], f[:export_pattern]] }]
      params[:export_patterns].delete_if{ |k, v| v.nil? }

      params.delete_if{ |k, v| v.to_s.empty? }

      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/add-file",
        :query  => params,
      )
    end

    # Upload fresh version of your localization file to Crowdin.
    #
    # == Parameters
    #
    # files - Array of files that should be updated in Crowdin project.
    # file is a Hash {:dest, :source}
    # * :dest - file name with path in Crowdin project (required)
    # * :source - path for uploaded file (required)
    # * :title - title in Crowdin UI (optional)
    # * :export_pattern - Resulted file name (optional)
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/update-file?key={project-key}
    #
    def update_file(files, params = {})
      params[:files] = Hash[files.map{ |f|
        dest = f[:dest] || raise(ArgumentError, "'`:dest` is required'")
        source = ::File.open(f[:source] || raise(ArgumentError, "'`:source` is required'"))
        source.define_singleton_method(:original_filename) do
          dest
        end
        [dest, source]
      }]

      params[:titles] = Hash[files.map{ |f| [f[:dest], f[:title]] }]
      params[:titles].delete_if{ |k, v| v.nil? }

      params[:export_patterns] = Hash[files.map{ |f| [f[:dest], f[:export_pattern]] }]
      params[:export_patterns].delete_if{ |k, v| v.nil? }

      params.delete_if{ |k, v| v.to_s.empty? }

      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/update-file",
        :query  => params,
      )
    end

    # Upload existing translations to your Crowdin project.
    #
    # == Parameters
    #
    # files - Array of files that should be added to Crowdin project.
    # file is a Hash {:dest, :source}
    # * :dest - file name with path in Crowdin project (required)
    # * :source - path for uploaded file (required)
    #
    # Optional:
    # * :import_duplicates (default: false)
    # * :import_eq_suggestions (default: false)
    # * :auto_approve_imported (default: false)
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/upload-translation?key={project-key}
    #
    def upload_translation(files, language, params = {})
      params[:files] = Hash[files.map{ |f| [
        f[:dest]               || raise(ArgumentError, "`:dest` is required"),
        ::File.open(f[:source] || raise(ArgumentError, "`:source` is required"))
      ] }]

      params[:language] = language

      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/upload-translation",
        :query  => params,
      )
    end

    # Download ZIP file with translations. You can choose the language of translation you need or download all of them at once.
    # Note: If you would like to download the most recent translations you may want to use export API method before downloading.
    #
    # == Request
    #
    # GET https://api.crowdin.com/api/project/{project-identifier}/download/{package}.zip?key={project-key}
    #
    def download_translation(language = 'all', params = {})
      request(
        :method  => :get,
        :path    => "/api/project/#{@project_id}/download/#{language}.zip",
        :output  => params[:output],
      )
    end

    # Upload your glossarries for Crowdin Project in TBX file format.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/upload-glossary?key={project-key}
    #
    def upload_glossary(file)
      # raise "#{path} file does not exist" unless ::File.exist?(path)
      file = ::File.open(file, 'rb')

      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/upload-glossary",
        :query  => { :file => file },
      )
    end

    # Upload your Translation Memory for Crowdin Project in TMX file format.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/upload-tm?key={project-key}
    #
    def upload_tm(file)
      file = ::File.open(file, 'rb')

      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/upload-tm",
        :query  => { :file => file },
      )
    end

    # Add directory to Crowdin project.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/add-directory?key={project-key}
    #
    def add_directory(name)
      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/add-directory",
        :query  => { :name => name },
      )
    end

    # Delete Crowdin project directory. All nested files and directories will be deleted too.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/delete-directory?key={project-key}
    #
    def delete_directory(name)
      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/delete-directory",
        :query  => { :name => name },
      )
    end


    # Delete file from Crowdin project. All the translations will be lost without ability to restore them.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/delete-file?key={project-key}
    #
    def delete_file(file)
      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/delete-file",
        :query  => { :file => file },
      )
    end

    # Download Crowdin project glossaries as TBX file.
    #
    # == Request
    #
    # GET https://api.crowdin.com/api/project/{project-identifier}/download-glossary?key={project-key}
    #
    def download_glossary(params = {})
      request(
        :method => :get,
        :path   => "/api/project/#{@project_id}/download-glossary",
        :output => params[:output],
      )
    end

    # Download Crowdin project Translation Memory as TMX file.
    #
    # == Request
    #
    # GET https://api.crowdin.com/api/project/{project-identifier}/download-tm?key={project-key}
    #
    def download_tm(params = {})
      request(
        :method => :get,
        :path   => "/api/project/#{@project_id}/download-tm",
        :output => params[:output],
      )
    end

    # Build ZIP archive with the latest translations. Please note that this method can be invoked only every 30 minutes. Also API call will be ignored if there were no any changes in project since last export.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/export?key={project-key}
    #
    def export_translations
      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/export",
      )
    end


    # Get supported languages list with Crowdin codes mapped to locale name and standarded codes.
    #
    # == Request
    #
    # GET https://api.crowdin.com/api/supported-languages
    #
    def supported_languages
      request(
        :method => :get,
        :path   => "/api/supported-languages",
      )
    end

    # Track your Crowdin project translation progress by language.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/status?key={project-key}
    #
    def translations_status
      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/status",
      )
    end

    # Get Crowdin Project details.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/info?key={project-key}
    #
    def project_info
      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/info",
      )
    end

    # Create new Crowdin project.
    # Important: The API method requires Account API Key. This key can not be found on your profile pages, please contact us to obtain API key for your account.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/account/create-project?account-key={account-key}
    #
    def create_project(params = {})
      request(
        :method => :post,
        :path   => "/api/account/create-project",
        :query  => params,
      )
    end

    # Edit Crowdin project.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/edit-project?key={key}
    #
    def edit_project(params = {})
      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/edit-project",
        :query  => params,
      )
    end

    # Delete Crowdin project with all translations.
    #
    # == Request
    #
    # POST https://api.crowdin.com/api/project/{project-identifier}/delete-project?key={project-key}
    #
    def delete_project
      request(
        :method => :post,
        :path   => "/api/project/#{@project_id}/delete-project",
      )
    end

    # Get Crowdin Project details.
    #
    # == Request
    #
    # GET https://api.crowdin.com/api/account/get-projects?key={account-key}
    #
    def get_projects(login)
      request(
        :method => :get,
        :path   => "/api/account/get-projects",
        :query  => { :login => login },
      )
    end

  end
end