haveapi-client 0.28.4 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f5dc4eff2452e31341f2a99d63e6a2d36f7c92ed4acbbb2a5ae7e03d69090b4
-  data.tar.gz: b2ce49aca22bf9c602607b802784a1b599b80929b3aabd60084f91ff7d43b54c
+  metadata.gz: 64e208c9297b87f784abefa3ad21ec1ee176265c7c1b0c84323f5ea93cf54dab
+  data.tar.gz: c8d7fd4e762307fa85751ca16ab79836009d102250a7e1d57a01c61ab06e373f
 SHA512:
-  metadata.gz: 27ef732cc9493e701b47ee931bc876fa31dbef0ed3539e070f353968b76a9f24c37bdad9c2053fac33d40ba9f7b9390deeda91c811cc7dd61485cbd0e86efca2
-  data.tar.gz: 8307517fc9646f7ea38fd5e94732ec74f2d3542b0cdc07a776e39ac293a48bc6902a5716eaa61293ee90b6638e50c0ed7d5dbbee9a2153daaa3ef175cd810e90
+  metadata.gz: f4fbf3e4c7ebb8a719291c0e676e7d88cbc04e16c700c8aa4fd6f52b9c6839c1fd6fb380cd90fe714575d642e63697da65f625993654fb3340d9b44848d267f6
+  data.tar.gz: cf35c27d7e8ac429349847ad8ba084c0f09e82c38857d94c0b08cf18649a9b99b6e684acdb726d30517d0caf8b5e8c32d8470f541bfb0d4cc59986f576b73221

data/README.md

@@ -110,3 +110,19 @@ user.role = 'user'
 user.save
 p user.id
 ```
+
+## Localization
+
+Pass `language` to request translated API messages and to translate local
+client-side validation errors:
+
+```ruby
+api = HaveAPI::Client::Client.new('https://your.api.tld', language: 'cs')
+```
+
+The value is sent in `Accept-Language` by default. Use `language_header` when
+the API is configured with a custom language header. Set the language before
+the client fetches the API description so translated validator descriptions
+are loaded from the server.
+
+The CLI accepts the same request language with `--language cs`.

data/lib/haveapi/cli/cli.rb

@@ -114,7 +114,7 @@ module HaveAPI::CLI
       begin
         ret = action.execute(@input_params)
       rescue HaveAPI::Client::ValidationError => e
-        format_errors(action, 'input parameters not valid', e.errors)
+        format_errors(action, @api.client_message('errors.input_parameters_not_valid'), e.errors)
         exit(false)
       end
 
@@ -164,6 +164,7 @@ module HaveAPI::CLI
           block: true,
           verbose: false
       }
+      @opts = options
 
       @global_opt = OptionParser.new do |opts|
         opts.banner = "Usage: #{$0} [options] <resource> <action> [objects ids] [-- [parameters]]"
@@ -206,6 +207,11 @@ module HaveAPI::CLI
           options[:version] = v
         end
 
+        opts.on('--language LANGUAGE', 'Language to request from API') do |v|
+          options[:language] = v
+          @api.language = v if @api
+        end
+
         opts.on('-c', '--columns', 'Print output in columns') do
           options[:layout] = :columns
         end
@@ -683,7 +689,8 @@ module HaveAPI::CLI
       @api = HaveAPI::Client::Communicator.new(
         url || api_url,
         version || (@opts && @opts[:version]),
-        verify_ssl: verify_ssl
+        verify_ssl: verify_ssl,
+        language: @opts && @opts[:language]
       )
       @api.identity = $0.split('/').last
     end

data/lib/haveapi/client/action.rb

@@ -18,6 +18,16 @@ module HaveAPI::Client
       "#<#{self.class.name} @name=#{@name}>"
     end
 
+    def client_message(key, **values)
+      if @client.respond_to?(:client_message)
+        @client.client_message(key, **values)
+      elsif @api.respond_to?(:client_message)
+        @api.client_message(key, **values)
+      else
+        I18n.t(nil, key, values)
+      end
+    end
+
     def execute(data)
       params_arg = {}
 

data/lib/haveapi/client/action_state.rb

@@ -15,6 +15,7 @@ module HaveAPI::Client
 
     def initialize(response)
       @data = response.response
+      @client = response.action.client
 
       @progress = Progress.new(@data[:current], @data[:total], @data[:unit])
     end
@@ -40,7 +41,7 @@ module HaveAPI::Client
     # is used only if the cancel operation is blocking.
     def cancel(&block)
       unless can_cancel?
-        raise "action ##{@data[:id]} (#{label}) cannot be cancelled"
+        raise @client.client_message('errors.uncancelable_action', id: @data[:id])
       end
 
       @cancel = true

data/lib/haveapi/client/authentication/token.rb

@@ -82,7 +82,7 @@ module HaveAPI::Client::Authentication
       return if cont == :done
 
       if @block.nil?
-        raise AuthenticationFailed, 'implement multi-factor authentication'
+        raise AuthenticationFailed, @communicator.client_message('authentication.mfa_required')
       end
 
       loop do
@@ -106,7 +106,7 @@ module HaveAPI::Client::Authentication
       resp = HaveAPI::Client::Response.new(a, a.execute(input))
 
       if resp.failed?
-        raise AuthenticationFailed, resp.message || 'invalid credentials'
+        raise AuthenticationFailed, resp.message || @communicator.client_message('authentication.invalid_credentials')
       end
 
       if resp[:complete]

data/lib/haveapi/client/client.rb

@@ -15,6 +15,8 @@ class HaveAPI::Client::Client
   # @option opts [Integer] block_interval
   # @option opts [Integer] block_timeout
   # @option opts [Boolean] verify_ssl
+  # @option opts [String] language value sent in Accept-Language
+  # @option opts [String] language_header HTTP header used for language
   def initialize(url, opts = {})
     @setup = false
     @opts = opts
@@ -29,10 +31,17 @@ class HaveAPI::Client::Client
       @api = HaveAPI::Client::Communicator.new(
         url,
         @version,
-        **{ verify_ssl: opts[:verify_ssl] }.compact
+        **{
+          verify_ssl: opts[:verify_ssl],
+          language: opts[:language],
+          language_header: opts[:language_header]
+        }.compact
       )
       @api.identity = @opts[:identity]
     end
+
+    @api.language = @opts[:language] if @opts.has_key?(:language)
+    @api.language_header = @opts[:language_header] if @opts.has_key?(:language_header)
   end
 
   def inspect
@@ -81,6 +90,33 @@ class HaveAPI::Client::Client
   # @param opts [Hash] options
   def set_opts(opts)
     @opts.update(opts)
+    self.language = opts[:language] if opts.has_key?(:language)
+    self.language_header = opts[:language_header] if opts.has_key?(:language_header)
+  end
+
+  def language
+    @api.language
+  end
+
+  def language=(value)
+    @api.language = value
+  end
+
+  def language_header
+    @api.language_header
+  end
+
+  def language_header=(value)
+    @api.language_header = value
+  end
+
+  def client_message(key, **values)
+    if @api.respond_to?(:client_message)
+      @api.client_message(key, **values)
+    else
+      lang = @api.language if @api.respond_to?(:language)
+      HaveAPI::Client::I18n.t(lang || @opts[:language], key, values)
+    end
   end
 
   # @return [Hash] client options

data/lib/haveapi/client/communicator.rb

@@ -15,16 +15,36 @@ module HaveAPI::Client
       end
     end
 
-    attr_reader :url, :auth, :verify_ssl
+    attr_reader :url, :auth, :verify_ssl, :language, :language_header
     attr_accessor :identity
 
-    def initialize(url, v = nil, verify_ssl: true)
+    def initialize(url, v = nil, verify_ssl: true, language: nil, language_header: nil)
       @url = url
       @auth = Authentication::NoAuth.new(self, {}, {})
       @rest = RestClient::Resource.new(@url, verify_ssl: verify_ssl)
       @version = v
       @verify_ssl = verify_ssl
       @identity = 'haveapi-client-ruby'
+      @language = language
+      @language_header = language_header || I18n::DEFAULT_LANGUAGE_HEADER
+    end
+
+    def language=(value)
+      I18n.assert_header_value!(value.to_s) unless value.nil? || value.to_s.empty?
+      @language = value
+    end
+
+    def language_header=(value)
+      I18n.assert_header_name!(value)
+      @language_header = value
+    end
+
+    def language_headers
+      I18n.request_headers(@language, @language_header)
+    end
+
+    def client_message(key, **values)
+      I18n.t(@language, key, values)
     end
 
     def inspect
@@ -134,7 +154,7 @@ module HaveAPI::Client
         ns.update(@auth.request_payload)
 
         args << ns.to_json
-        args << { content_type: :json, accept: :json, user_agent: @identity }.update(@auth.request_headers)
+        args << base_headers(content_type: :json).update(@auth.request_headers)
 
       elsif %w[GET DELETE].include?(action.http_method)
         get_params = {}
@@ -150,18 +170,20 @@ module HaveAPI::Client
           end
         end
 
-        args << { params: get_params.update(@auth.request_query_params), accept: :json, user_agent: @identity }.update(@auth.request_headers)
+        args << base_headers(
+          params: get_params.update(@auth.request_query_params)
+        ).update(@auth.request_headers)
       end
 
       begin
         response = parse(@rest[action.prepared_path].method(action.http_method.downcase.to_sym).call(*args))
       rescue RestClient::Forbidden
-        return error('Access forbidden. Bad user name or password? Not authorized?')
+        return error(client_message('errors.access_forbidden'))
       rescue RestClient::ResourceNotFound,
              RestClient::BadRequest => e
         response = parse(e.http_body)
       rescue StandardError => e
-        return error("Fatal API error: #{e.inspect}")
+        return error(client_message('errors.fatal_api_error', error: e.inspect))
       end
 
       if response[:status]
@@ -193,9 +215,8 @@ module HaveAPI::Client
 
     def description_for(path, query_params = {})
       ret = parse(@rest[path].get_options({
-          params: @auth.request_payload.update(@auth.request_query_params).update(query_params),
-          user_agent: @identity
-      }.update(@auth.request_headers)))
+          params: @auth.request_payload.update(@auth.request_query_params).update(query_params)
+      }.update(base_headers).update(@auth.request_headers)))
 
       @proto_version = ret[:version]
       p_v = HaveAPI::Client::PROTOCOL_VERSION
@@ -222,5 +243,9 @@ module HaveAPI::Client
     def parse(str)
       JSON.parse(str, symbolize_names: true)
     end
+
+    def base_headers(headers = {})
+      { accept: :json, user_agent: @identity }.update(language_headers).update(headers)
+    end
   end
 end

data/lib/haveapi/client/exceptions.rb

@@ -6,7 +6,12 @@ module HaveAPI::Client
 
     def initialize(response)
       if response.respond_to?(:action)
-        super("#{response.action.name} failed: #{response.message}")
+        msg = response.action.client_message(
+          'errors.action_failed',
+          action: response.action.name,
+          message: response.message
+        )
+        super(msg)
       else
         super(response.to_s)
       end
@@ -19,7 +24,8 @@ module HaveAPI::Client
     attr_reader :errors
 
     def initialize(action, errors)
-      super("#{action.name} failed: input parameters not valid")
+      message = action.client_message('errors.input_parameters_not_valid')
+      super(action.client_message('errors.action_failed', action: action.name, message: message))
 
       @action = action
       @errors = errors

data/lib/haveapi/client/i18n.rb

@@ -0,0 +1,103 @@
+require 'yaml'
+
+module HaveAPI::Client
+  module I18n
+    DEFAULT_LOCALE = :en
+    DEFAULT_LANGUAGE_HEADER = 'Accept-Language'.freeze
+    HEADER_NAME = /\A[A-Za-z0-9!#$%&'*+\-.^_`|~]+\z/
+    HEADER_VALUE_UNSAFE = /[\x00\r\n]/
+
+    class << self
+      def t(language, key, values = {})
+        message = lookup(locale_for(language), key) || lookup(DEFAULT_LOCALE, key) || key.to_s
+
+        interpolate(message, values)
+      end
+
+      def request_headers(language, language_header = DEFAULT_LANGUAGE_HEADER)
+        return {} if language.nil? || language.to_s.empty?
+
+        assert_header_name!(language_header)
+        assert_header_value!(language)
+
+        { language_header => language.to_s }
+      end
+
+      def locale_for(language)
+        return DEFAULT_LOCALE if language.nil? || language.to_s.empty?
+
+        parse_accept_language(language).each do |tag|
+          normalized = normalize_locale(tag)
+          return normalized if normalized && messages.has_key?(normalized)
+        end
+
+        DEFAULT_LOCALE
+      end
+
+      def assert_header_name!(header)
+        return if header.is_a?(String) && header.match?(HEADER_NAME)
+
+        raise ArgumentError, "invalid language HTTP header name: #{header.inspect}"
+      end
+
+      def assert_header_value!(value)
+        return if value.is_a?(String) && !value.match?(HEADER_VALUE_UNSAFE)
+
+        raise ArgumentError, "invalid language HTTP header value: #{value.inspect}"
+      end
+
+      private
+
+      def lookup(locale, key)
+        key.to_s.sub(/\Ahaveapi_client\./, '').split('.').reduce(messages[locale]) do |data, part|
+          break unless data.is_a?(Hash)
+
+          data[part]
+        end
+      end
+
+      def interpolate(message, values)
+        values.reduce(message.dup) do |ret, (key, value)|
+          ret.gsub("%{#{key}}", value.to_s)
+        end
+      end
+
+      def parse_accept_language(header)
+        header.to_s.split(',').filter_map do |part|
+          tag, *params = part.split(';')
+          q = 1.0
+
+          params.each do |param|
+            name, value = param.split('=', 2).map(&:strip)
+            q = value.to_f if name == 'q'
+          end
+
+          next if tag.strip.empty? || q <= 0
+
+          [tag.strip, q]
+        end.sort_by { |(_tag, q)| -q }.map(&:first)
+      end
+
+      def normalize_locale(tag)
+        normalized = tag.to_s.strip.tr('_', '-').sub(/\..*\z/, '').downcase
+        return if normalized.empty?
+
+        primary = normalized.split('-', 2).first.to_sym
+        primary if messages.has_key?(primary)
+      end
+
+      def messages
+        @messages ||= begin
+          dir = File.expand_path('locales', __dir__)
+
+          Dir[File.join(dir, '*.yml')].to_h do |file|
+            locale = File.basename(file, '.yml').to_sym
+            data = YAML.safe_load_file(file, aliases: true) || {}
+
+            [locale, data.fetch(locale.to_s).fetch('haveapi_client')]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/haveapi/client/locales/cs.yml

@@ -0,0 +1,45 @@
+# This file is generated from i18n/haveapi.yml.
+# Do not edit it manually; manual changes will be overwritten.
+# Update i18n/haveapi.yml and run bundle exec rake i18n:update.
+---
+cs:
+  haveapi_client:
+    authentication:
+      callback_failed: "%{callback} selhal: %{error}"
+      callback_invalid_return: callback musí vrátit pole nebo 'stop'
+      callback_required: Implementujte callback %{callback}
+      invalid_credentials: neplatné přihlašovací údaje
+      invalid_oauth2_pkce_verifier: Neplatný OAuth2 PKCE verifier
+      invalid_oauth2_state: Neplatný OAuth2 state
+      mfa_required: implementujte vícefaktorové ověření
+      multistep_callback_required: přidejte callback pro zpracování vícefázového ověření
+      oauth2_access_token_required: Volba access_token musí být zadána
+      oauth2_not_configured: OAuth2 ověření není nastaveno
+      oauth2_revoke_failed: Přístupový token nelze zrušit, HTTP %{status}
+      token_request_failed: 'Token nelze vyžádat: %{message}'
+      token_revoke_failed: 'Token nelze zrušit: %{message}'
+      token_step_failed: 'Krok ověření ''%{action}'' selhal: %{message}'
+      unsupported_auth_action: Nepodporovaná ověřovací akce '%{action}'
+    errors:
+      access_forbidden: Přístup odepřen. Chybné uživatelské jméno nebo heslo? Nejste
+        oprávněni?
+      action_failed: "%{action} selhala: %{message}"
+      fatal_api_error: 'Fatální chyba API: %{error}'
+      input_parameters_not_valid: vstupní parametry nejsou platné
+      input_parameters_not_valid_for_action: Vstupní parametry pro akci '%{action}'
+        nejsou platné
+      invalid_input_parameters: neplatné vstupní parametry
+      uncancelable_action: 'Stav akce #%{id} nelze zrušit'
+      unresolved_arguments: 'Akci ''%{action}'' nelze spustit: chybí argumenty'
+    validation:
+      cannot_be_null: nesmí být null
+      invalid_boolean: neplatná pravdivostní hodnota
+      invalid_datetime: není ve formátu ISO 8601
+      invalid_float: neplatné desetinné číslo
+      invalid_input_layout: neplatná struktura vstupu
+      invalid_integer: neplatné celé číslo
+      invalid_resource_id: neplatné ID prostředku
+      invalid_string: neplatný řetězec
+      required_parameter_missing: povinný parametr chybí
+      validation_failed: validace selhala
+      validation_failed_with_errors: 'validace selhala: %{errors}'

data/lib/haveapi/client/locales/en.yml

@@ -0,0 +1,44 @@
+# This file is generated from i18n/haveapi.yml.
+# Do not edit it manually; manual changes will be overwritten.
+# Update i18n/haveapi.yml and run bundle exec rake i18n:update.
+---
+en:
+  haveapi_client:
+    authentication:
+      callback_failed: "%{callback} failed: %{error}"
+      callback_invalid_return: callback has to return an array or 'stop'
+      callback_required: Implement callback %{callback}
+      invalid_credentials: invalid credentials
+      invalid_oauth2_pkce_verifier: Invalid OAuth2 PKCE verifier
+      invalid_oauth2_state: Invalid OAuth2 state
+      mfa_required: implement multi-factor authentication
+      multistep_callback_required: add callback to handle multi-step authentication
+      oauth2_access_token_required: Option access_token must be provided
+      oauth2_not_configured: OAuth2 authentication is not configured
+      oauth2_revoke_failed: Unable to revoke access token, HTTP %{status}
+      token_request_failed: 'Unable to request token: %{message}'
+      token_revoke_failed: 'Unable to revoke token: %{message}'
+      token_step_failed: 'Failed at authentication step ''%{action}'': %{message}'
+      unsupported_auth_action: Unsupported authentication action '%{action}'
+    errors:
+      access_forbidden: Access forbidden. Bad user name or password? Not authorized?
+      action_failed: "%{action} failed: %{message}"
+      fatal_api_error: 'Fatal API error: %{error}'
+      input_parameters_not_valid: input parameters not valid
+      input_parameters_not_valid_for_action: Input parameters not valid for action
+        '%{action}'
+      invalid_input_parameters: invalid input parameters
+      uncancelable_action: 'Action state #%{id} cannot be cancelled'
+      unresolved_arguments: 'Unable to execute action ''%{action}'': unresolved arguments'
+    validation:
+      cannot_be_null: cannot be null
+      invalid_boolean: not a valid boolean
+      invalid_datetime: not in ISO 8601 format
+      invalid_float: not a valid float
+      invalid_input_layout: invalid input layout
+      invalid_integer: not a valid integer
+      invalid_resource_id: not a valid resource id
+      invalid_string: not a valid string
+      required_parameter_missing: required parameter missing
+      validation_failed: validation failed
+      validation_failed_with_errors: 'validation failed: %{errors}'

data/lib/haveapi/client/parameters/resource.rb

@@ -3,6 +3,7 @@ module HaveAPI::Client
     attr_reader :errors
 
     def initialize(params, desc, value)
+      @params = params
       @errors = []
       @desc = desc
       @value = coerce(value)
@@ -22,24 +23,28 @@ module HaveAPI::Client
       if v.nil?
         return nil if @desc[:nullable]
 
-        @errors << 'cannot be null'
+        @errors << message('validation.cannot_be_null')
         return nil
       end
 
       if v.is_a?(::String) && v.strip.empty?
         return nil if @desc[:nullable]
 
-        @errors << 'not a valid resource id'
+        @errors << message('validation.invalid_resource_id')
         return nil
       end
 
       if !v.is_a?(::Integer) && /\A\d+\z/ !~ v
-        @errors << 'not a valid resource id'
+        @errors << message('validation.invalid_resource_id')
         nil
 
       else
         v.to_i
       end
     end
+
+    def message(key, **values)
+      @params.send(:message, key, **values)
+    end
   end
 end

data/lib/haveapi/client/parameters/typed.rb

@@ -35,7 +35,7 @@ module HaveAPI::Client
       if raw.nil?
         return nil if @desc[:nullable]
 
-        @errors << 'cannot be null'
+        @errors << message('validation.cannot_be_null')
         return nil
       end
 
@@ -92,7 +92,7 @@ module HaveAPI::Client
         value = raw.to_f
         return value if value.finite?
 
-        @errors << 'not a valid float'
+        @errors << message('validation.invalid_float')
         nil
 
       elsif raw.is_a?(::String)
@@ -159,28 +159,32 @@ module HaveAPI::Client
     end
 
     def invalid_integer
-      @errors << 'not a valid integer'
+      @errors << message('validation.invalid_integer')
       nil
     end
 
     def invalid_float
-      @errors << 'not a valid float'
+      @errors << message('validation.invalid_float')
       nil
     end
 
     def invalid_boolean
-      @errors << 'not a valid boolean'
+      @errors << message('validation.invalid_boolean')
       nil
     end
 
     def invalid_datetime
-      @errors << 'not in ISO 8601 format'
+      @errors << message('validation.invalid_datetime')
       nil
     end
 
     def invalid_string
-      @errors << 'not a valid string'
+      @errors << message('validation.invalid_string')
       nil
     end
+
+    def message(key, **values)
+      @params.send(:message, key, **values)
+    end
   end
 end

data/lib/haveapi/client/params.rb

@@ -33,7 +33,7 @@ module HaveAPI::Client
           p[:validators][:presence] || p[:validators][:present] || p[:validators][:required]
 
         if presence_validator && @params[name].nil?
-          error(name, 'required parameter missing')
+          error(name, message('validation.required_parameter_missing'))
           next
         elsif @params[name].nil?
           next
@@ -61,6 +61,10 @@ module HaveAPI::Client
 
     protected
 
+    def message(key, **values)
+      @action.client_message(key, **values)
+    end
+
     def error(param, msg)
       @errors[param] ||= []
 

data/lib/haveapi/client/version.rb

@@ -1,6 +1,6 @@
 module HaveAPI
   module Client
     PROTOCOL_VERSION = '2.0'.freeze
-    VERSION = '0.28.4'.freeze
+    VERSION = '0.29.0'.freeze
   end
 end

data/lib/haveapi/client.rb

@@ -1,6 +1,8 @@
 require 'require_all'
 require 'date'
 
+require_relative 'client/i18n'
+
 module HaveAPI
   module Client
     # Shortcut to HaveAPI::Client::Client.new

data/spec/cli_i18n_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'haveapi/cli'
+
+RSpec.describe HaveAPI::CLI::Cli do
+  def with_argv(*argv)
+    old_argv = ARGV.dup
+    ARGV.replace(argv)
+    yield
+  ensure
+    ARGV.replace(old_argv)
+  end
+
+  def fake_cli_api(language)
+    Class.new do
+      attr_accessor :language
+
+      def initialize(language)
+        @language = language
+      end
+
+      def describe_api(_version = nil)
+        { authentication: { fake: {} } }
+      end
+    end.new(language)
+  end
+
+  def parsed_cli_api(*argv)
+    cli = described_class.allocate
+    cli.instance_variable_set(:@config, {})
+
+    allow(cli).to receive(:connect_api) do
+      cli.instance_variable_set(
+        :@api,
+        fake_cli_api(cli.instance_variable_get(:@opts)&.[](:language))
+      )
+    end
+
+    with_argv(*argv) { cli.send(:options) }
+    cli.instance_variable_get(:@api)
+  end
+
+  it 'applies --language to no-auth CLI connections' do
+    expect(parsed_cli_api('--language', 'cs', 'test', 'fail').language).to eq('cs')
+  end
+
+  it 'keeps --language when auth is parsed before language' do
+    old_auth_methods = (described_class.auth_methods || {}).dup
+    fake_auth = Class.new do
+      def initialize(*); end
+      def options(_opts); end
+    end
+
+    described_class.auth_methods = old_auth_methods.merge(fake: fake_auth)
+
+    expect(
+      parsed_cli_api('--auth', 'fake', '--language', 'cs', 'test', 'fail').language
+    ).to eq('cs')
+  ensure
+    described_class.auth_methods = old_auth_methods
+  end
+end

data/spec/i18n_spec.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe HaveAPI::Client::Client do
+  let(:valid_params) do
+    {
+      i: 1,
+      f: 1.0,
+      b: true,
+      dt: '2020-01-01T00:00:00Z',
+      s: 'x',
+      t: 'y'
+    }
+  end
+
+  it 'sends the configured language header' do
+    client = described_class.new(
+      TEST_SERVER.base_url,
+      language: 'cs-CZ',
+      language_header: 'X-Language'
+    )
+
+    expect(client.communicator.language_headers).to eq('X-Language' => 'cs-CZ')
+  end
+
+  it 'localizes local validation errors' do
+    client = described_class.new(TEST_SERVER.base_url, language: 'cs')
+
+    expect { client.test.echo(valid_params.merge(i: 'abc')) }
+      .to raise_error(HaveAPI::Client::ValidationError) do |err|
+        expect(err.message).to include('vstupní parametry nejsou platné')
+        expect(err.errors[:i]).to include('neplatné celé číslo')
+      end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: haveapi-client
 version: !ruby/object:Gem::Version
-  version: 0.28.4
+  version: 0.29.0
 platform: ruby
 authors:
 - Jakub Skokan
@@ -130,7 +130,10 @@ files:
 - lib/haveapi/client/client.rb
 - lib/haveapi/client/communicator.rb
 - lib/haveapi/client/exceptions.rb
+- lib/haveapi/client/i18n.rb
 - lib/haveapi/client/inflections.rb
+- lib/haveapi/client/locales/cs.yml
+- lib/haveapi/client/locales/en.yml
 - lib/haveapi/client/parameters/resource.rb
 - lib/haveapi/client/parameters/typed.rb
 - lib/haveapi/client/params.rb
@@ -152,8 +155,10 @@ files:
 - lib/restclient_ext/resource.rb
 - spec/action_security_spec.rb
 - spec/authentication_token_security_spec.rb
+- spec/cli_i18n_spec.rb
 - spec/cli_security_spec.rb
 - spec/description_method_security_spec.rb
+- spec/i18n_spec.rb
 - spec/integration/client_spec.rb
 - spec/integration/typed_input_spec.rb
 - spec/spec_helper.rb