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.net/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 http://api.crowdin.net/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.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 http://api.crowdin.net/api/project/{project-identifier}/update-file?key={project-key}
    #
    def update_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.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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/api/supported-languages
    #
    def supported_languages
      request(
        :method => :get,
        :path   => "/api/supported-languages",
      )
    end

    # Track your Crowdin project translation progress by language.
    #
    # == Request
    #
    # POST http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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 http://api.crowdin.net/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