deepl-rb 3.6.0 → 3.6.1

data/spec/fixtures/vcr_cassettes/usage.yml

@@ -0,0 +1,171 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api-free.deepl.com/v2/usage
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - deepl-ruby/3.0.2 (darwin23) ruby/3.3.3
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Mon, 17 May 2021 14:18:32 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '48'
+      Connection:
+      - keep-alive
+      Access-Control-Allow-Origin:
+      - "*"
+    body:
+      encoding: UTF-8
+      string: '{"character_count":353,"character_limit":500000}'
+  recorded_at: Mon, 17 May 2021 14:18:32 GMT
+- request:
+    method: get
+    uri: https://api-free.deepl.com/v2/usage
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
+      User-Agent:
+      - deepl-ruby/3.0.2 (darwin23) ruby/3.3.3
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 403
+      message: Forbidden
+    headers:
+      Date:
+      - Tue, 02 Jul 2024 13:54:07 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+      Strict-Transport-Security:
+      - max-age=63072000; includeSubDomains; preload
+      Server-Timing:
+      - l7_lb_tls;dur=101, l7_lb_idle;dur=0, l7_lb_receive;dur=0, l7_lb_total;dur=103
+      Access-Control-Expose-Headers:
+      - Server-Timing, X-Trace-ID
+      X-Trace-Id:
+      - 4dcf2a36b3f14ba89f107449f4b14919
+    body:
+      encoding: ASCII-8BIT
+      string: '{"message":"Wrong endpoint. Use https://api.deepl.com"}'
+  recorded_at: Tue, 02 Jul 2024 13:54:07 GMT
+- request:
+    method: get
+    uri: https://api.deepl.com/v2/usage
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
+      User-Agent:
+      - deepl-ruby/3.0.2 (darwin23) ruby/3.3.3
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 02 Jul 2024 14:52:05 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+      X-Cache-Status:
+      - MISS
+      Strict-Transport-Security:
+      - max-age=63072000; includeSubDomains; preload
+      Server-Timing:
+      - l7_lb_tls;dur=112, l7_lb_idle;dur=1, l7_lb_receive;dur=0, l7_lb_total;dur=115
+      Access-Control-Expose-Headers:
+      - Server-Timing, X-Trace-ID
+      X-Trace-Id:
+      - de53f558d38c43748bf83b27f4f0edc9
+    body:
+      encoding: ASCII-8BIT
+      string: '{"character_count":18593,"character_limit":1000000000000}'
+  recorded_at: Tue, 02 Jul 2024 14:52:05 GMT
+- request:
+    method: get
+    uri: https://api.deepl.com/v2/usage
+    body:
+      encoding: UTF-8
+      string: "{}"
+    headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
+      User-Agent:
+      - deepl-ruby/3.0.2 (darwin23) ruby/3.3.3
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 09 Jul 2024 01:35:37 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+      X-Cache-Status:
+      - MISS
+      Strict-Transport-Security:
+      - max-age=63072000; includeSubDomains; preload
+      Server-Timing:
+      - l7_lb_tls;dur=137, l7_lb_idle;dur=1, l7_lb_receive;dur=0, l7_lb_total;dur=140
+      Access-Control-Expose-Headers:
+      - Server-Timing, X-Trace-ID
+      X-Trace-Id:
+      - 543309f656244684bb59d30e9dc824b5
+    body:
+      encoding: ASCII-8BIT
+      string: '{"character_count":69328,"character_limit":1000000000000}'
+  recorded_at: Tue, 09 Jul 2024 01:35:37 GMT
+recorded_with: VCR 6.2.0

data/spec/integration_tests/document_api_spec.rb

@@ -0,0 +1,178 @@
+# Copyright 2024 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE file.
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeepL::DocumentApi do
+  before do
+    VCR.turn_off!
+    WebMock.allow_net_connect!
+  end
+
+  after do
+    VCR.turn_on!
+    WebMock.disable_net_connect!
+  end
+
+  include_context 'with temp dir'
+
+  let(:default_lang_args) { { source_lang: 'EN', target_lang: 'DE' } }
+
+  describe '#translate_document' do
+    it 'Translates a document from a filepath' do
+      File.unlink(output_document_path)
+      source_lang = default_lang_args[:source_lang]
+      target_lang = default_lang_args[:target_lang]
+      example_doc_path = example_document_path(source_lang)
+      DeepL.document.translate_document(example_doc_path, output_document_path,
+                                        source_lang, target_lang, File.basename(example_doc_path),
+                                        {})
+      output_file_contents = File.read(output_document_path)
+
+      expect(example_document_translation(target_lang)).to eq(output_file_contents)
+    end
+
+    it 'Translates a document from a filepath without a filename' do
+      File.unlink(output_document_path)
+      source_lang = default_lang_args[:source_lang]
+      target_lang = default_lang_args[:target_lang]
+      example_doc_path = example_document_path(source_lang)
+      DeepL.document.translate_document(example_doc_path, output_document_path,
+                                        source_lang, target_lang)
+      output_file_contents = File.read(output_document_path)
+
+      expect(example_document_translation(target_lang)).to eq(output_file_contents)
+    end
+
+    it 'Translates a document using the lower-level methods and returns the correct status' do # rubocop:disable RSpec/ExampleLength
+      File.unlink(output_document_path)
+      source_lang = default_lang_args[:source_lang]
+      target_lang = default_lang_args[:target_lang]
+      example_doc_path = example_document_path(source_lang)
+
+      handle = DeepL.document.upload(example_doc_path, source_lang, target_lang,
+                                     File.basename(example_doc_path), {})
+      doc_status = handle.wait_until_document_translation_finished
+      DeepL.document.download(handle, output_document_path) if doc_status.status != 'error'
+      output_file_contents = File.read(output_document_path)
+
+      expect(example_document_translation(target_lang)).to eq(output_file_contents)
+      expect(doc_status.billed_characters).to eq(example_document_translation(source_lang).length)
+      expect(doc_status.status).to eq('done')
+    end
+
+    it 'Translates a document after retrying the upload once' do # rubocop:disable RSpec/ExampleLength
+      skip 'Only runs on mock server' if real_server?
+      File.unlink(output_document_path)
+      source_lang = default_lang_args[:source_lang]
+      target_lang = default_lang_args[:target_lang]
+      example_doc_path = example_document_path(source_lang)
+      doc_status = nil
+      DeepL.with_session(DeepL::HTTPClientOptions.new({}, nil, enable_ssl_verification: false,
+                                                               read_timeout: 1.0)) do |_session|
+        handle = DeepL.document.upload(example_doc_path, source_lang, target_lang,
+                                       File.basename(example_doc_path), {}, no_response_header(1))
+        doc_status = handle.wait_until_document_translation_finished
+        DeepL.document.download(handle, output_document_path) if doc_status.status != 'error'
+      end
+      output_file_contents = File.read(output_document_path)
+
+      expect(output_file_contents).to eq(example_document_translation(target_lang))
+      expect(doc_status.billed_characters).to eq(example_document_translation(source_lang).length)
+      expect(doc_status.status).to eq('done')
+    end
+  end
+
+  it 'Translates a document after waiting' do # rubocop:disable RSpec/ExampleLength
+    skip 'Only runs on mock server' if real_server?
+    File.unlink(output_document_path)
+    source_lang = default_lang_args[:source_lang]
+    target_lang = default_lang_args[:target_lang]
+    example_doc_path = example_document_path(source_lang)
+    doc_status = nil
+    DeepL.with_session(DeepL::HTTPClientOptions.new({}, nil,
+                                                    enable_ssl_verification: false)) do |_session|
+      handle = DeepL.document.upload(example_doc_path, source_lang, target_lang,
+                                     File.basename(example_doc_path), {},
+                                     doc_translation_queue_time_header(2000).merge(doc_translation_translation_time_header(2000))) # rubocop:disable Layout/LineLength
+      doc_status = handle.wait_until_document_translation_finished
+      DeepL.document.download(handle, output_document_path) if doc_status.status != 'error'
+    end
+    output_file_contents = File.read(output_document_path)
+
+    expect(output_file_contents).to eq(example_document_translation(target_lang))
+    expect(doc_status.billed_characters).to eq(example_document_translation(source_lang).length)
+    expect(doc_status.status).to eq('done')
+  end
+
+  it 'Translates a large document' do # rubocop:disable RSpec/ExampleLength
+    skip 'Only runs on mock server' if real_server?
+    File.unlink(output_document_path)
+    source_lang = default_lang_args[:source_lang]
+    target_lang = default_lang_args[:target_lang]
+    example_doc_path = example_large_document_path(source_lang)
+    doc_status = nil
+    DeepL.with_session(DeepL::HTTPClientOptions.new({}, nil,
+                                                    enable_ssl_verification: false)) do |_session|
+      handle = DeepL.document.upload(example_doc_path, source_lang, target_lang,
+                                     File.basename(example_doc_path), {})
+      doc_status = handle.wait_until_document_translation_finished
+      DeepL.document.download(handle, output_document_path) if doc_status.status != 'error'
+    end
+    output_file_contents = File.read(output_document_path)
+
+    expect(output_file_contents).to eq(example_large_document_translation(target_lang))
+    expect(doc_status.billed_characters).to eq(
+      example_large_document_translation(source_lang).length
+    )
+    expect(doc_status.status).to eq('done')
+  end
+
+  it 'Translates a document with formality set' do # rubocop:disable RSpec/ExampleLength
+    skip 'Only runs on mock server' if real_server?
+    File.unlink(output_document_path)
+    source_lang = default_lang_args[:source_lang]
+    target_lang = default_lang_args[:target_lang]
+    example_doc_path = example_large_document_path(source_lang)
+    doc_status = nil
+    DeepL.with_session(DeepL::HTTPClientOptions.new({}, nil,
+                                                    enable_ssl_verification: false)) do |_session|
+      handle = DeepL.document.upload(example_doc_path, source_lang, target_lang,
+                                     File.basename(example_doc_path),
+                                     { 'formality' => 'prefer_more' })
+      doc_status = handle.wait_until_document_translation_finished
+      DeepL.document.download(handle, output_document_path) if doc_status.status != 'error'
+    end
+    output_file_contents = File.read(output_document_path)
+
+    expect(output_file_contents).to eq(example_large_document_translation(target_lang))
+    expect(doc_status.billed_characters).to eq(
+      example_large_document_translation(source_lang).length
+    )
+    expect(doc_status.status).to eq('done')
+  end
+
+  it 'Translates a document with extra_body_parameters' do # rubocop:disable RSpec/ExampleLength
+    File.unlink(output_document_path)
+    source_lang = default_lang_args[:source_lang]
+    target_lang = default_lang_args[:target_lang]
+    example_doc_path = example_document_path(source_lang)
+
+    handle = DeepL.document.upload(example_doc_path, source_lang, target_lang,
+                                   File.basename(example_doc_path),
+                                   {
+                                     extra_body_parameters: {
+                                       target_lang: 'FR',
+                                       debug: '1'
+                                     }
+                                   })
+    doc_status = handle.wait_until_document_translation_finished
+    DeepL.document.download(handle, output_document_path) if doc_status.status != 'error'
+    output_file_contents = File.read(output_document_path)
+
+    expect(example_document_translation('FR')).to eq(output_file_contents)
+    expect(doc_status.status).to eq('done')
+  end
+end

data/spec/integration_tests/integration_test_utils.rb

@@ -0,0 +1,170 @@
+# Copyright 2024 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE file.
+# frozen_string_literal: true
+
+require 'securerandom'
+require 'tempfile'
+
+module IntegrationTestUtils # rubocop:disable Metrics/ModuleLength
+  EXAMPLE_TEXT = {
+    'BG' => 'протонен лъч',
+    'CS' => 'protonový paprsek',
+    'DA' => 'protonstråle',
+    'DE' => 'Protonenstrahl',
+    'EL' => 'δέσμη πρωτονίων',
+    'EN' => 'proton beam',
+    'EN-US' => 'proton beam',
+    'EN-GB' => 'proton beam',
+    'ES' => 'haz de protones',
+    'ET' => 'prootonikiirgus',
+    'FI' => 'protonisäde',
+    'FR' => 'faisceau de protons',
+    'HU' => 'protonnyaláb',
+    'ID' => 'berkas proton',
+    'IT' => 'fascio di protoni',
+    'JA' => '陽子ビーム',
+    'KO' => '양성자 빔',
+    'LT' => 'protonų spindulys',
+    'LV' => 'protonu staru kūlis',
+    'NB' => 'protonstråle',
+    'NL' => 'protonenbundel',
+    'PL' => 'wiązka protonów',
+    'PT' => 'feixe de prótons',
+    'PT-BR' => 'feixe de prótons',
+    'PT-PT' => 'feixe de prótons',
+    'RO' => 'fascicul de protoni',
+    'RU' => 'протонный луч',
+    'SK' => 'protónový lúč',
+    'SL' => 'protonski žarek',
+    'SV' => 'protonstråle',
+    'TR' => 'proton ışını',
+    'UK' => 'протонний пучок',
+    'ZH' => '质子束'
+  }.freeze
+
+  def mock_server?
+    ENV.key?('DEEPL_MOCK_SERVER_PORT')
+  end
+
+  def mock_proxy_server?
+    ENV.key?('DEEPL_MOCK_PROXY_SERVER_PORT')
+  end
+
+  def real_server?
+    !mock_server?
+  end
+
+  def setup
+    @input_file = nil
+    @input_file_extension = nil
+    @output_file = nil
+    DeepL.configure do |config|
+      config.auth_key = 'your-api-token'
+    end
+  end
+
+  def teardown
+    unless @input_file.nil?
+      @input_file.close
+      @input_file.unlink
+    end
+    return if @output_file.nil?
+
+    @output_file.close
+    @output_file.unlink
+  end
+
+  def example_document_path(document_language)
+    setup_example_document(EXAMPLE_TEXT[document_language])
+  end
+
+  def example_large_document_path(document_language)
+    setup_example_document("#{EXAMPLE_TEXT[document_language]}\n" * 1000)
+  end
+
+  def setup_example_document(file_content)
+    @input_file_base_name = 'example_input_document' if @input_file_base_name.nil?
+    @input_file_extension = '.txt' if @input_file_extension.nil?
+    if @input_file.nil?
+      @input_file = Tempfile.new([@input_file_base_name, @input_file_extension])
+      @input_file.write(file_content)
+      @input_file.close
+    end
+    @input_file.path
+  end
+
+  def example_document_translation(document_language)
+    EXAMPLE_TEXT[document_language]
+  end
+
+  def example_large_document_translation(document_language)
+    "#{EXAMPLE_TEXT[document_language]}\n" * 1000
+  end
+
+  def output_document_path
+    @output_file = Tempfile.new('example_output_document') if @output_file.nil?
+    @output_file.path
+  end
+
+  # For detailed explanations of these header, check the deepl-mock README.md
+  def no_response_header(no_response_count)
+    { 'mock-server-session-no-response-count' => no_response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+
+  def respond_with_429_header(response_count)
+    { 'mock-server-session-429-count' => response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+
+  def set_character_limit_header(response_count) # rubocop:disable Naming/AccessorMethodName
+    { 'mock-server-session-init-character-limit' => response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+
+  def set_document_limit_header(response_count) # rubocop:disable Naming/AccessorMethodName
+    { 'mock-server-session-init-document-limit' => response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+
+  def set_team_document_limit_header(response_count) # rubocop:disable Naming/AccessorMethodName
+    { 'mock-server-session-init-team-document-limit' => response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+
+  def fail_docs_header(response_count)
+    { 'mock-server-session-doc-failure' => response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+
+  def doc_translation_queue_time_header(response_count)
+    { 'mock-server-session-doc-queue-time' => response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+
+  def doc_translation_translation_time_header(response_count)
+    { 'mock-server-session-doc-translate-time' => response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+
+  def expect_proxy_header(response_count)
+    { 'mock-server-session-expect-proxy' => response_count.to_s,
+      'mock-server-session' => SecureRandom.uuid }
+  end
+end
+
+shared_context 'with temp dir' do
+  around do |example|
+    Dir.mktmpdir('deepl-rspec-') do |dir|
+      @temp_dir = dir
+      example.run
+    end
+  end
+
+  attr_reader :temp_dir, :input_file_base_name, :input_file_extension
+end
+
+RSpec.configure do |c|
+  c.include IntegrationTestUtils
+end

data/spec/integration_tests/style_rule_api_spec.rb

@@ -0,0 +1,79 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE file.
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeepL::StyleRuleApi do
+  before do
+    VCR.turn_off!
+    WebMock.allow_net_connect!
+  end
+
+  after do
+    VCR.turn_on!
+    WebMock.disable_net_connect!
+  end
+
+  describe '#translate_with_style_rules' do
+    it 'when performing a request with style_id' do
+      skip 'Only runs on mock server' if real_server?
+
+      source_lang = 'DE'
+      target_lang = 'EN-US'
+      text = 'Hallo, Welt!'
+      style_id = 'dca2e053-8ae5-45e6-a0d2-881156e7f4e4'
+
+      result = DeepL.translate(text, source_lang, target_lang, { style_rule: style_id })
+      expect(result).to be_a(DeepL::Resources::Text)
+    end
+
+    it 'when performing a request with style_rule object' do
+      skip 'Only runs on mock server' if real_server?
+
+      source_lang = 'DE'
+      target_lang = 'EN-US'
+      text = 'Hallo, Welt!'
+      style_rule = build_test_style_rule
+
+      result = DeepL.translate(text, source_lang, target_lang, { style_rule: style_rule })
+      expect(result).to be_a(DeepL::Resources::Text)
+    end
+  end
+
+  describe '#list_style_rules' do
+    it 'when requesting a list of all style rules' do
+      skip 'Only runs on mock server' if real_server?
+      style_rules = DeepL.style_rules.list(page: 0, page_size: 10, detailed: true)
+      expect(style_rules).to be_an(Array)
+      expect(style_rules.length).to eq(1)
+      expect(style_rules[0].style_id).to eq('dca2e053-8ae5-45e6-a0d2-881156e7f4e4')
+      expect(style_rules[0].name).to eq('Default Style Rule')
+      expect(style_rules[0].configured_rules).to be_a(DeepL::Resources::ConfiguredRules)
+      expect(style_rules[0].custom_instructions).to be_an(Array)
+    end
+
+    it 'when requesting a list of all style rules without detailed' do
+      skip 'Only runs on mock server' if real_server?
+      style_rules = DeepL.style_rules.list
+      expect(style_rules).to be_an(Array)
+      expect(style_rules.length).to eq(1)
+      expect(style_rules[0].style_id).to eq('dca2e053-8ae5-45e6-a0d2-881156e7f4e4')
+      expect(style_rules[0].configured_rules).to be_nil
+      expect(style_rules[0].custom_instructions).to be_nil
+    end
+  end
+
+  def build_test_style_rule
+    style_rule_data = {
+      'style_id' => 'dca2e053-8ae5-45e6-a0d2-881156e7f4e4',
+      'name' => 'Default Style Rule',
+      'creation_time' => '2025-01-01T00:00:00Z',
+      'updated_time' => '2025-01-01T00:00:00Z',
+      'language' => 'en',
+      'version' => 1
+    }
+    DeepL::Resources::StyleRule.new(style_rule_data, nil, nil)
+  end
+end

data/spec/requests/extra_body_parameters_types_spec.rb

@@ -0,0 +1,82 @@
+# Copyright 2025 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe 'DeepL::Requests::Base extra_body_parameters type preservation' do
+  let(:api) { build_deepl_api }
+
+  around do |tests|
+    tmp_env = replace_env_preserving_deepl_vars_except_mock_server
+    tests.call
+    ENV.replace(tmp_env)
+  end
+
+  describe 'apply_extra_body_parameters_to_json' do
+    it 'preserves boolean true' do
+      request = DeepL::Requests::Translate.new(
+        api, 'test', 'EN', 'ES',
+        extra_body_parameters: { enable_beta_languages: true }
+      )
+
+      payload = {}
+      request.send(:apply_extra_body_parameters_to_json, payload)
+
+      expect(payload[:enable_beta_languages]).to be(true)
+      expect(payload[:enable_beta_languages]).to be_a(TrueClass)
+    end
+
+    it 'preserves boolean false' do
+      request = DeepL::Requests::Translate.new(
+        api, 'test', 'EN', 'ES',
+        extra_body_parameters: { some_flag: false }
+      )
+
+      payload = {}
+      request.send(:apply_extra_body_parameters_to_json, payload)
+
+      expect(payload[:some_flag]).to be(false)
+      expect(payload[:some_flag]).to be_a(FalseClass)
+    end
+
+    it 'preserves integers' do
+      request = DeepL::Requests::Translate.new(
+        api, 'test', 'EN', 'ES',
+        extra_body_parameters: { some_number: 42 }
+      )
+
+      payload = {}
+      request.send(:apply_extra_body_parameters_to_json, payload)
+
+      expect(payload[:some_number]).to eq(42)
+      expect(payload[:some_number]).to be_a(Integer)
+    end
+
+    it 'preserves strings' do
+      request = DeepL::Requests::Translate.new(
+        api, 'test', 'EN', 'ES',
+        extra_body_parameters: { some_string: 'hello' }
+      )
+
+      payload = {}
+      request.send(:apply_extra_body_parameters_to_json, payload)
+
+      expect(payload[:some_string]).to eq('hello')
+      expect(payload[:some_string]).to be_a(String)
+    end
+
+    it 'allows overriding standard parameters' do
+      request = DeepL::Requests::Translate.new(
+        api, 'test', 'EN', 'ES',
+        extra_body_parameters: { target_lang: 'FR' }
+      )
+
+      payload = { target_lang: 'ES' }
+      request.send(:apply_extra_body_parameters_to_json, payload)
+
+      expect(payload[:target_lang]).to eq('FR')
+    end
+  end
+end