crowdin-api 0.4.0 → 1.0.0

data/lib/crowdin-api/api-resources/translations.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+module Crowdin
+  module ApiResources
+    module Translations
+      def pre_translation_status(pre_translation_id = nil, project_id = config.project_id)
+        pre_translation_id || raise(ArgumentError, ':pre_translation_id is required')
+        project_id         || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/projects/#{project_id}/pre-translations/#{pre_translation_id}"
+        )
+
+        request.perform
+      end
+
+      def apply_pre_translation(query = {}, project_id = config.project_id)
+        project_id || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/projects/#{project_id}/pre-translations",
+          query
+        )
+
+        request.perform
+      end
+
+      def build_project_directory_translation(directory_id = nil, query = {})
+        project_id = query[:project_id] || config.project_id
+
+        directory_id || raise(ArgumentError, ':directory_id is required')
+        project_id   || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/projects/#{project_id}/translations/builds/directories/#{directory_id}",
+          query
+        )
+
+        request.perform
+      end
+
+      def build_project_file_translation(file_id = nil, query = {})
+        project_id = query[:project_id] || config.project_id
+
+        file_id    || raise(ArgumentError, ':file_id is required')
+        project_id || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        headers = query[:eTag] ? { 'If-None-Match' => query[:eTag] } : {}
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/projects/#{project_id}/translations/builds/files/#{file_id}",
+          query,
+          headers
+        )
+
+        request.perform
+      end
+
+      def list_project_builds(query = {}, project_id = config.project_id)
+        project_id || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/projects/#{project_id}/translations/builds",
+          query
+        )
+
+        request.perform
+      end
+
+      def build_project_translation(query = {}, project_id = config.project_id)
+        project_id || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/projects/#{project_id}/translations/builds",
+          query
+        )
+
+        request.perform
+      end
+
+      def upload_translations(language_id = nil, query = {})
+        project_id = query[:project_id] || config.project_id
+
+        language_id || raise(ArgumentError, ':language_id is required')
+        project_id  || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/projects/#{project_id}/translations/#{language_id}",
+          query
+        )
+
+        request.perform
+      end
+
+      def download_project_translations(destinaton = nil, build_id = nil, project_id = config.project_id)
+        destinaton || raise(ArgumentError, ':destination is required for downlaods')
+        build_id   || raise(ArgumentError, ':build_id is required')
+        project_id || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/projects/#{project_id}/translations/builds/#{build_id}/download",
+          {},
+          {},
+          destinaton
+        )
+
+        request.perform
+      end
+
+      def check_project_build_status(build_id = nil, project_id = config.project_id)
+        build_id   || raise(ArgumentError, ':build_id is required')
+        project_id || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :get,
+          "/projects/#{project_id}/translations/builds/#{build_id}"
+        )
+
+        request.perform
+      end
+
+      def cancel_build(build_id = nil, project_id = config.project_id)
+        build_id   || raise(ArgumentError, ':build_id is required')
+        project_id || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :delete,
+          "/projects/#{project_id}/translations/builds/#{build_id}"
+        )
+
+        request.perform
+      end
+
+      def export_project_translation(query = {}, project_id = config.project_id)
+        project_id || raise(ArgumentError, ':project_id is required in parameters or when initialize Client')
+
+        request = Web::Request.new(
+          self,
+          :post,
+          "/projects/#{project_id}/translations/exports",
+          query
+        )
+
+        request.perform
+      end
+    end
+  end
+end

data/lib/crowdin-api/client/client.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+# The Crowdin::Client library is used for interactions with a crowdin.com website.
+#
+# == Example
+#
+#   require 'crowdin-api'
+#
+#   crowdin = Crowdin::Client.new do |config|
+#     config.api_token = 'YOUR_API_TOKEN'
+#   end
+#
+module Crowdin
+  class Client
+    # A wrapper and interface to the Crowdin api. Please visit the Crowdin developers
+    # site for a full explanation of what each of the Crowdin api methods
+    # expect and perform.
+    #
+    # https://support.crowdin.com/api/v2/
+    #
+    include ApiResources::Languages
+    include ApiResources::Projects
+    include ApiResources::SourceFiles
+    include ApiResources::Storages
+    include ApiResources::TranslationStatus
+    include ApiResources::Translations
+
+    attr_reader :config
+    attr_reader :options
+    attr_reader :connection
+
+    def initialize
+      raise ArgumentError, 'block with configurations not given' unless block_given?
+
+      @config = Crowdin::Configuration.new
+      yield config
+
+      check_logger
+
+      set_rest_client_proxy!
+
+      build_options
+      build_connection
+    end
+
+    def log!(message)
+      return true unless config.logger_enabled?
+
+      logger.debug(message)
+    end
+
+    def logger=(logger)
+      @logger = logger
+      config.enable_logger = true
+    end
+
+    protected
+
+    def build_options
+      @options = config.options
+      options[:headers] = config.headers
+    end
+
+    def build_connection
+      @connection = ::RestClient::Resource.new(config.base_url, options)
+    end
+
+    private
+
+    def set_rest_client_proxy!
+      ENV['http_proxy'] ? ::RestClient.proxy = ENV['http_proxy'] : false
+    end
+
+    def check_logger
+      config.enable_logger ||= false
+    end
+
+    def logger
+      @logger ||= Logger.new($stderr)
+    end
+  end
+end

data/lib/crowdin-api/client/configuration.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Crowdin
+  class Configuration
+    attr_accessor :api_token
+    attr_accessor :project_id
+    attr_accessor :organization_domain
+    attr_accessor :enable_logger
+
+    attr_reader :target_api_url
+
+    def initialize
+      @target_api_url = '/api/v2'
+    end
+
+    def options
+      {
+        headers: {},
+        timeout: nil,
+        json: true
+      }
+    end
+
+    def headers
+      {
+        'Accept' => 'application/json',
+        'Authorization' => "Bearer #{api_token}",
+        'Content-Type' => 'application/json',
+        'User-Agent' => "crowdin-rb/#{Crowdin::Client::VERSION}/#{RUBY_VERSION}/#{RUBY_PLATFORM}"
+      }
+    end
+
+    def base_url
+      organization_domain ? "https://#{organization_domain}.api.crowdin.com" : 'https://api.crowdin.com'
+    end
+
+    def logger_enabled?
+      enable_logger
+    end
+  end
+end

data/lib/crowdin-api/client/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Crowdin
+  class Client
+    VERSION = '1.0.0'
+  end
+end

data/lib/crowdin-api/core/errors.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Crowdin
+  module Errors
+    class Error < StandardError
+      attr_reader :key, :error_code, :error_message
+
+      def initialize(key, error_code, error_message)
+        @key           = key
+        @error_code    = error_code.to_i
+        @error_message = error_message
+        @message       = "#{key} => #{error_code}: #{error_message}"
+      end
+
+      def to_s
+        @message
+      end
+    end
+  end
+end

data/lib/crowdin-api/core/payload.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Crowdin
+  module Web
+    class Payload
+      attr_reader :method, :query
+
+      def initialize(method, query)
+        @method = method
+        @query  = query
+      end
+
+      def perform
+        return @query if @query.is_a?(File)
+
+        @method.eql?(:get) ? { params: fetch_cleared_query } : fetch_cleared_query.to_json
+      end
+
+      private
+
+      def fetch_cleared_query
+        @query.reject { |_, value| value.nil? }
+      end
+    end
+  end
+end

data/lib/crowdin-api/core/request.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Crowdin
+  module Web
+    class Request
+      attr_reader :client
+
+      def initialize(client, method, path, query = {}, headers = {}, destination = nil)
+        @client      = client
+        @method      = method
+        @full_path   = client.config.target_api_url + path
+        @payload     = Payload.new(method, query).perform
+        @headers     = headers
+        @destination = destination
+        @errors      = []
+      end
+
+      def perform
+        process_request!
+        process_response!
+      end
+
+      def process_request!
+        return @response = client.connection[@full_path].delete        if delete_request?
+        return @response = client.connection[@full_path].get(@payload) if get_request?
+
+        client.connection[@full_path].send(@method, @payload, @headers) { |response, _, _| @response = response }
+      rescue StandardError => error
+        client.log! error.class
+
+        @errors << "Something went wrong while proccessing request. Details - #{error.class}"
+      end
+
+      def process_response!
+        return fetch_errors if @errors.any?
+
+        begin
+          if @response
+            doc = JSON.parse(@response.body)
+
+            client.log! "args: #{@response.request.args}"
+            client.log! "body: #{doc}"
+
+            data = fetch_response_data(doc)
+
+            @errors.any? ? fetch_errors : data
+          end
+        rescue StandardError => error
+          client.log! error
+
+          @errors << "Something went wrong while proccessing response. Details - #{error.class}"
+
+          fetch_errors
+        end
+      end
+
+      private
+
+      def fetch_errors
+        @errors.join(';')
+      end
+
+      def download_file(url)
+        download = URI.parse(url).open
+        IO.copy_stream(download, @destination)
+
+        @destination
+      rescue StandardError => error
+        client.log! error
+
+        @errors << "Something went wrong while downloading file. Details - #{error.class}"
+      end
+
+      def fetch_response_data(doc)
+        if doc['data'].is_a?(Hash) && doc['data']['url'] && doc['data']['url'].scan(/response-content-disposition/)
+          download_file(doc['data']['url'])
+        else
+          doc
+        end
+      end
+
+      def get_request?
+        @method.eql?(:get)
+      end
+
+      def delete_request?
+        @method.eql?(:delete)
+      end
+    end
+  end
+end

data/lib/crowdin-api.rb

@@ -1,128 +1,25 @@
+# frozen_string_literal: true
+
+# Libs
 require 'json'
+require 'logger'
+require 'open-uri'
 require 'rest-client'
 
-require "crowdin-api/errors"
-require "crowdin-api/methods"
-require "crowdin-api/version"
-
-# The Crowdin::API library is used for interactions with a crowdin.com website.
-#
-# == Example
-#
-#   require 'crowdin-api'
-#   require 'logger'
-#
-#   crowdin = Crowdin::API.new(:api_key => API_KEY, :project_id => PROJECT_ID)
-#   crowdin.log = Logger.new($stderr)
-#
-module Crowdin
-  class API
-
-    class << self
-      # Default logger for all Crowdin::API instances
-      #
-      #   Crowdin::API.log = Logger.new($stderr)
-      #
-      attr_accessor :log
-    end
-
-    # Create a new API object using the given parameters.
-    #
-    # @param [String] api_key the authentication API key can be found on the project settings page
-    # @param [String] project_id the project identifier.
-    # @param [String] account_key the account API Key
-    # @param [String] base_url the url of the Crowdin API
-    #
-    def initialize(options = {})
-      @api_key     = options.delete(:api_key)
-      @project_id  = options.delete(:project_id)
-      @account_key = options.delete(:account_key)
-      @base_url    = options.delete(:base_url) || 'https://api.crowdin.com'
-
-      @log = nil
-
-      options = {
-        :headers                => {},
-        :params                 => {},
-        :timeout                => nil,
-        :open_timeout           => nil,
-        :key                    => @api_key,
-        :'account-key'          => @account_key,
-        :json                   => true
-      }.merge(options)
-
-      options[:headers] = {
-        'Accept'                => 'application/json',
-        'User-Agent'            => "crowdin-rb/#{Crowdin::API::VERSION}",
-        'X-Ruby-Version'        => RUBY_VERSION,
-        'X-Ruby-Platform'       => RUBY_PLATFORM
-      }.merge(options[:headers])
-
-      options[:params] = {
-        :key                    => @api_key,
-        :'account-key'          => @account_key,
-        :json                   => true
-      }.merge(options[:params])
-
-      RestClient.proxy = ENV['http_proxy'] if ENV['http_proxy']
-      @connection = RestClient::Resource.new(@base_url, options)
-    end
-
-    def request(params, &block)
-      # Returns a query hash with non nil values.
-      params[:query].reject! { |_, value| value.nil? } if params[:query]
-
-      case params[:method]
-      when :post
-        query = @connection.options.merge(params[:query] || {})
-        @connection[params[:path]].post(query) { |response, _, _|
-          @response = response
-        }
-      when :get
-        query = @connection.options[:params].merge(params[:query] || {})
-        @connection[params[:path]].get(:params => query) { |response, _, _|
-          @response = response
-        }
-      end
-
-      log.debug("args: #{@response.args}") if log
-
-      if @response.headers[:content_disposition]
-        filename = params[:output] || @response.headers[:content_disposition][/attachment; filename="(.+?)"/, 1]
-        body = @response.body
-        file = open(filename, 'wb')
-        file.write(body)
-        file.close
-        return true
-      else
-        doc = JSON.load(@response.body)
-        log.debug("body: #{doc}") if log
-
-        if doc.kind_of?(Hash) && doc['success'] == false
-          code    = doc['error']['code']
-          message = doc['error']['message']
-          error   = Crowdin::API::Errors::Error.new(code, message)
-          raise(error)
-        else
-          return doc
-        end
-      end
-
-    end
-
-    # The current logger. If no logger has been set Crowdin::API.log is used.
-    #
-    def log
-      @log || Crowdin::API.log
-    end
-
-    # Sets the +logger+ used by this instance of Crowdin::API
-    #
-    def log= logger
-      @log = logger
-    end
-
-    private
-
-  end
-end
+# Core modules
+require 'crowdin-api/core/payload'
+require 'crowdin-api/core/request'
+require 'crowdin-api/core/errors'
+
+# Api modules
+require 'crowdin-api/api-resources/languages'
+require 'crowdin-api/api-resources/projects'
+require 'crowdin-api/api-resources/source_files'
+require 'crowdin-api/api-resources/storages'
+require 'crowdin-api/api-resources/translation_status'
+require 'crowdin-api/api-resources/translations'
+
+# Client
+require 'crowdin-api/client/version'
+require 'crowdin-api/client/configuration'
+require 'crowdin-api/client/client'

data/spec/core/config-instance_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+describe 'Config instance' do
+  it 'should have a project_id' do
+    @crowdin = Crowdin::Client.new do |config|
+      config.project_id = 1
+    end
+
+    expect(@crowdin.config.project_id).to_not be_nil
+  end
+
+  it 'should have a api_token' do
+    @crowdin = Crowdin::Client.new do |config|
+      config.api_token = 'api_token'
+    end
+
+    expect(@crowdin.config.api_token).to_not be_nil
+  end
+
+  it 'should have a base_url' do
+    @crowdin = Crowdin::Client.new do |config|
+      config.api_token = 'api_token'
+    end
+
+    expect(@crowdin.config.base_url).to_not be_nil
+  end
+
+  it 'should have a enable_logger set to false by default' do
+    @crowdin = Crowdin::Client.new do |config|
+      config.api_token = 'api_token'
+    end
+
+    expect(@crowdin.config.enable_logger).eql? false
+  end
+end

data/spec/crowdin-api_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+describe Crowdin::Client do
+  it 'should have a version' do
+    expect(Crowdin::Client::VERSION).to_not be_nil
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'crowdin-api'