deepl-rb 2.3.1 → 2.5.1

data/spec/fixtures/vcr_cassettes/languages.yml

@@ -2,11 +2,13 @@
 http_interactions:
 - request:
     method: get
-    uri: https://api-free.deepl.com/v2/languages?auth_key=VALID_TOKEN
+    uri: https://api-free.deepl.com/v2/languages
     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:
@@ -36,11 +38,13 @@ http_interactions:
   recorded_at: Mon, 17 May 2021 14:49:42 GMT
 - request:
     method: get
-    uri: https://api-free.deepl.com/v2/languages?auth_key=VALID_TOKEN&type=target
+    uri: https://api-free.deepl.com/v2/languages?type=target
     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:
@@ -74,11 +78,13 @@ http_interactions:
   recorded_at: Mon, 17 May 2021 14:55:30 GMT
 - request:
     method: get
-    uri: https://api-free.deepl.com/v2/languages?auth_key=VALID_TOKEN&type=invalid
+    uri: https://api-free.deepl.com/v2/languages?type=invalid
     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:

data/spec/fixtures/vcr_cassettes/translate_texts.yml

@@ -2,11 +2,13 @@
 http_interactions:
 - request:
     method: post
-    uri: https://api-free.deepl.com/v2/translate?auth_key=VALID_TOKEN
+    uri: https://api-free.deepl.com/v2/translate
     body:
       encoding: US-ASCII
       string: text=Sample+text&source_lang=EN&target_lang=ES
     headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -39,11 +41,13 @@ http_interactions:
   recorded_at: Mon, 17 May 2021 14:20:14 GMT
 - request:
     method: post
-    uri: https://api-free.deepl.com/v2/translate?auth_key=VALID_TOKEN
+    uri: https://api-free.deepl.com/v2/translate
     body:
       encoding: US-ASCII
       string: text=Sample&text=Word&source_lang=EN&target_lang=ES
     headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -75,11 +79,13 @@ http_interactions:
   recorded_at: Mon, 17 May 2021 14:20:14 GMT
 - request:
     method: post
-    uri: https://api-free.deepl.com/v2/translate?auth_key=VALID_TOKEN&tag_handling=xml
+    uri: https://api-free.deepl.com/v2/translate?tag_handling=xml
     body:
       encoding: US-ASCII
       string: text=%3Cp%3ESample+text%3C%2Fp%3E&source_lang=EN&target_lang=ES
     headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -112,48 +118,13 @@ http_interactions:
   recorded_at: Mon, 17 May 2021 14:20:15 GMT
 - request:
     method: post
-    uri: https://api-free.deepl.com/v2/translate?auth_key=VALID_TOKEN&ignore_tags=code,span
-    body:
-      encoding: US-ASCII
-      string: text=Welcome+and+%3Ccode%3EHello+great+World%3C%2Fcode%3E+Good+Morning%21&source_lang=EN&target_lang=ES
-    headers:
-      Accept-Encoding:
-      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
-      Accept:
-      - "*/*"
-      User-Agent:
-      - Ruby
-      Content-Type:
-      - application/x-www-form-urlencoded
-  response:
-    status:
-      code: 200
-      message: OK
-    headers:
-      Server:
-      - nginx
-      Date:
-      - Mon, 17 May 2021 14:20:16 GMT
-      Content-Type:
-      - application/json
-      Content-Length:
-      - '119'
-      Connection:
-      - keep-alive
-      Access-Control-Allow-Origin:
-      - "*"
-    body:
-      encoding: ASCII-8BIT
-      string: !binary |-
-        eyJ0cmFuc2xhdGlvbnMiOlt7ImRldGVjdGVkX3NvdXJjZV9sYW5ndWFnZSI6IkVOIiwidGV4dCI6IkJpZW52ZW5pZG8geSA8Y29kZT5Ib2xhIGdyYW4gbXVuZG88L2NvZGU+IMKhQnVlbm9zIGTDrWFzISJ9XX0=
-  recorded_at: Mon, 17 May 2021 14:20:16 GMT
-- request:
-    method: post
-    uri: https://api-free.deepl.com/v2/translate?auth_key=invalid
+    uri: https://api-free.deepl.com/v2/translate
     body:
       encoding: US-ASCII
       string: text=Sample+text&source_lang=EN&target_lang=ES
     headers:
+      Authorization:
+      - DeepL-Auth-Key invalid
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -183,11 +154,13 @@ http_interactions:
   recorded_at: Mon, 17 May 2021 14:20:16 GMT
 - request:
     method: post
-    uri: https://api-free.deepl.com/v2/translate?auth_key=VALID_TOKEN
+    uri: https://api-free.deepl.com/v2/translate
     body:
       encoding: US-ASCII
       string: source_lang=EN&target_lang=ES
     headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -217,11 +190,13 @@ http_interactions:
   recorded_at: Mon, 17 May 2021 14:20:16 GMT
 - request:
     method: post
-    uri: https://api-free.deepl.com/v2/translate?auth_key=VALID_TOKEN
+    uri: https://api-free.deepl.com/v2/translate
     body:
       encoding: US-ASCII
       string: text=Sample+text&source_lang=EN
     headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
       Accept-Encoding:
       - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
       Accept:
@@ -322,4 +297,86 @@ http_interactions:
       encoding: UTF-8
       string: '{"message":"Value for ''termbaseId'' not supported."}'
   recorded_at: Tue, 28 Sep 2021 17:20:52 GMT
-recorded_with: VCR 6.0.0
+- request:
+    method: post
+    uri: https://api-free.deepl.com/v2/translate?ignore_tags=code,span&tag_handling=xml
+    body:
+      encoding: US-ASCII
+      string: text=Welcome+and+%3Ccode%3EHello+great+World%3C%2Fcode%3E+Good+Morning%21&source_lang=EN&target_lang=ES
+    headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Thu, 17 Mar 2022 09:55:34 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        eyJ0cmFuc2xhdGlvbnMiOlt7ImRldGVjdGVkX3NvdXJjZV9sYW5ndWFnZSI6IkVOIiwidGV4dCI6IkJpZW52ZW5pZG8geSA8Y29kZT5IZWxsbyBncmVhdCBXb3JsZDwvY29kZT4gwqFCdWVub3MgZMOtYXMhIn1dfQ==
+  recorded_at: Thu, 17 Mar 2022 09:55:32 GMT
+- request:
+    method: post
+    uri: https://api-free.deepl.com/v2/translate?outline_detection=0&split_sentences=nonewlines&splitting_tags=title,par&tag_handling=xml
+    body:
+      encoding: US-ASCII
+      string: text=%3Cdocument%3E%0A++%3Cmeta%3E%0A++++%3Ctitle%3EA+document%27s+title%3C%2Ftitle%3E%0A++%3C%2Fmeta%3E%0A++%3Ccontent%3E%0A++++%3Cpar%3EThis+is+the+first+sentence.+Followed+by+a+second+one.%3C%2Fpar%3E%0A++++%3Cpar%3EThis+is+the+third+sentence.%3C%2Fpar%3E%0A++%3C%2Fcontent%3E%0A%3C%2Fdocument%3E%0A&source_lang=EN&target_lang=ES
+    headers:
+      Authorization:
+      - DeepL-Auth-Key VALID_TOKEN
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Wed, 22 Jun 2022 18:04:58 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        eyJ0cmFuc2xhdGlvbnMiOlt7ImRldGVjdGVkX3NvdXJjZV9sYW5ndWFnZSI6IkVOIiwidGV4dCI6Ijxkb2N1bWVudD5cbiAgPG1ldGE+XG4gICAgPHRpdGxlPkVsIHTDrXR1bG8gZGUgdW4gZG9jdW1lbnRvPC90aXRsZT5cbiAgPC9tZXRhPlxuICA8Y29udGVudD5cbiAgICA8cGFyPkVzIGxhIHByaW1lcmEgZnJhc2UuIFNlZ3VpZG8gZGUgdW5hIHNlZ3VuZGEuPC9wYXI+XG4gICAgPHBhcj5Fc3RhIGVzIGxhIHRlcmNlcmEgZnJhc2UuPC9wYXI+XG4gIDwvY29udGVudD5cbjwvZG9jdW1lbnQ+XG4ifV19
+  recorded_at: Wed, 22 Jun 2022 18:04:56 GMT
+recorded_with: VCR 6.1.0

data/spec/fixtures/vcr_cassettes/usage.yml

@@ -2,11 +2,13 @@
 http_interactions:
 - request:
     method: get
-    uri: https://api-free.deepl.com/v2/usage?auth_key=VALID_TOKEN
+    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:

data/spec/requests/glossary/create_spec.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeepL::Requests::Glossary::Create do
+  let(:api) { build_deepl_api }
+  let(:name) { 'Mi Glosario' }
+  let(:source_lang) { 'EN' }
+  let(:target_lang) { 'ES' }
+  let(:entries) do
+    [
+      %w[Hello Hola],
+      %w[World Mundo]
+    ]
+  end
+  let(:entries_format) { 'tsv' }
+  let(:options) { {} }
+  subject do
+    DeepL::Requests::Glossary::Create.new(api, name, source_lang, target_lang, entries, options)
+  end
+
+  describe '#initialize' do
+    context 'When building a request' do
+      it 'should create a request object' do
+        expect(subject).to be_a(described_class)
+      end
+
+      it 'should set the default value for the entries format if not specified' do
+        request = DeepL::Requests::Glossary::Create.new(api, name, source_lang, target_lang,
+                                                        entries, options)
+        expect(request.entries_format).to eq('tsv')
+      end
+    end
+  end
+
+  describe '#request' do
+    around do |example|
+      VCR.use_cassette('glossaries') { example.call }
+    end
+
+    context 'When performing a valid request with two glossary entries' do
+      it 'should return a glossaries object' do
+        glossary = subject.request
+        expect(glossary).to be_a(DeepL::Resources::Glossary)
+        expect(glossary.id).to be_kind_of(String)
+        expect(glossary.name).to eq('Mi Glosario')
+        expect(glossary.ready).to be(true).or be(false)
+        expect(glossary.source_lang).to eq('en')
+        expect(glossary.target_lang).to eq('es')
+        expect { Time.iso8601(glossary.creation_time) }.not_to raise_error
+        expect(glossary.entry_count).to eq(2)
+      end
+    end
+  end
+end

data/spec/requests/glossary/destroy_spec.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeepL::Requests::Glossary::Destroy do
+  let(:api) { build_deepl_api }
+  let(:id) { '367eef44-b533-4d95-be19-74950c7760e9' }
+  subject { DeepL::Requests::Glossary::Destroy.new(api, id) }
+
+  describe '#initialize' do
+    context 'When building a request' do
+      it 'should create a request object' do
+        expect(subject).to be_a(described_class)
+      end
+    end
+  end
+
+  describe '#request' do
+    around do |example|
+      VCR.use_cassette('glossaries') { example.call }
+    end
+
+    context 'When performing a valid request' do
+      let(:new_glossary) do
+        DeepL::Requests::Glossary::Create.new(api, 'fixture', 'EN', 'ES', [%w[Hello Hola]]).request
+      end
+      subject { DeepL::Requests::Glossary::Destroy.new(api, new_glossary.id) }
+      it 'should return an empty object' do
+        response = subject.request
+        expect(response).to eq(new_glossary.id)
+      end
+    end
+
+    context 'When deleting a non existing glossary with a valid id' do
+      let(:id) { '00000000-0000-0000-0000-000000000000' }
+      subject { DeepL::Requests::Glossary::Destroy.new(api, id) }
+      it 'should raise a not found error' do
+        expect { subject.request }.to raise_error(DeepL::Exceptions::NotFound)
+      end
+    end
+
+    context 'When deleting a non existing glossary with an invalid id' do
+      let(:id) { 'invalid-uuid' }
+      subject { DeepL::Requests::Glossary::Destroy.new(api, id) }
+      it 'should raise a bad request error' do
+        expect { subject.request }.to raise_error(DeepL::Exceptions::BadRequest)
+      end
+    end
+  end
+end

data/spec/requests/glossary/entries_spec.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeepL::Requests::Glossary::Entries do
+  let(:api) { build_deepl_api }
+  let(:id) { '012a5576-b551-4d4c-b917-ce01bc8debb6' }
+  subject { DeepL::Requests::Glossary::Entries.new(api, id) }
+
+  describe '#initialize' do
+    context 'When building a request' do
+      it 'should create a request object' do
+        expect(subject).to be_a(described_class)
+      end
+    end
+  end
+
+  describe '#request' do
+    around do |example|
+      VCR.use_cassette('glossaries') { example.call }
+    end
+
+    context 'When performing a valid request' do
+      it 'should return a list of entries in TSV format' do
+        entries = subject.request
+        expect(entries).to be_kind_of(Array)
+        expect(entries).to all(be_a(Array))
+        expect(entries.size).to eq(2)
+      end
+    end
+
+    context 'When requesting entries with a valid but non existing glossary id' do
+      let(:id) { '00000000-0000-0000-0000-000000000000' }
+      subject { DeepL::Requests::Glossary::Entries.new(api, id) }
+      it 'should raise a not found error' do
+        expect { subject.request }.to raise_error(DeepL::Exceptions::NotFound)
+      end
+    end
+
+    context 'When requesting entries with an invalid glossary id' do
+      let(:id) { 'invalid-uuid' }
+      subject { DeepL::Requests::Glossary::Entries.new(api, id) }
+      it 'should raise a bad request error' do
+        expect { subject.request }.to raise_error(DeepL::Exceptions::BadRequest)
+      end
+    end
+  end
+end

data/spec/requests/glossary/find_spec.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeepL::Requests::Glossary::Find do
+  let(:api) { build_deepl_api }
+  let(:id) { 'd9ad833f-c818-430c-a3c9-47071384fa3e' }
+  let(:options) { {} }
+  subject { DeepL::Requests::Glossary::Find.new(api, id, options) }
+
+  describe '#initialize' do
+    context 'When building a request' do
+      it 'should create a request object' do
+        expect(subject).to be_a(described_class)
+      end
+    end
+  end
+
+  describe '#request' do
+    around do |example|
+      VCR.use_cassette('glossaries') { example.call }
+    end
+
+    context 'When performing a valid request' do
+      it 'should return a glossary object' do
+        glossary = subject.request
+        expect(glossary).to be_a(DeepL::Resources::Glossary)
+        expect(glossary.id).to eq('d9ad833f-c818-430c-a3c9-47071384fa3e')
+        expect(glossary.name).to eq('Mi Glosario')
+        expect(glossary.ready).to be(true).or be(false)
+        expect(glossary.source_lang).to eq('en')
+        expect(glossary.target_lang).to eq('es')
+        expect { Time.iso8601(glossary.creation_time) }.not_to raise_error
+        expect(glossary.entry_count).to eq(2)
+      end
+    end
+
+    context 'When requesting a non existing glossary with a valid id' do
+      let(:id) { 'a0af40e1-d81b-4aab-a95c-7cafbcfd1eb1' }
+      subject { DeepL::Requests::Glossary::Find.new(api, id, options) }
+      it 'should raise a not found error' do
+        expect { subject.request }.to raise_error(DeepL::Exceptions::NotFound)
+      end
+    end
+
+    context 'When requesting a non existing glossary with an invalid id' do
+      let(:id) { 'invalid-uuid' }
+      subject { DeepL::Requests::Glossary::Find.new(api, id, options) }
+      it 'should raise a bad request error' do
+        expect { subject.request }.to raise_error(DeepL::Exceptions::BadRequest)
+      end
+    end
+  end
+end

data/spec/requests/glossary/language_pairs_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeepL::Requests::Glossary::LanguagePairs do
+  let(:api) { build_deepl_api }
+  let(:options) { {} }
+  subject { DeepL::Requests::Glossary::LanguagePairs.new(api, options) }
+
+  describe '#initialize' do
+    context 'When building a request' do
+      it 'should create a request object' do
+        expect(subject).to be_a(described_class)
+      end
+    end
+  end
+
+  describe '#request' do
+    around do |example|
+      VCR.use_cassette('glossaries') { example.call }
+    end
+
+    context 'When requesting a list of all language pairs supported by glossaries' do
+      it 'should return a language pairs object' do
+        language_pairs = subject.request
+        expect(language_pairs).to be_an(Array)
+      end
+    end
+  end
+end

data/spec/requests/glossary/list_spec.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeepL::Requests::Glossary::List do
+  let(:api) { build_deepl_api }
+  let(:options) { {} }
+  subject { DeepL::Requests::Glossary::List.new(api, options) }
+
+  describe '#initialize' do
+    context 'When building a request' do
+      it 'should create a request object' do
+        expect(subject).to be_a(described_class)
+      end
+    end
+  end
+
+  describe '#request' do
+    around do |example|
+      VCR.use_cassette('glossaries') { example.call }
+    end
+
+    context 'When requesting a list of all glossaries' do
+      it 'should return a glossaries object' do
+        glossaries = subject.request
+        expect(glossaries).to be_an(Array)
+      end
+    end
+
+    context 'When performing a bad request' do
+      context 'When using an invalid token' do
+        let(:api) do
+          api = build_deepl_api
+          api.configuration.auth_key = 'invalid'
+          api
+        end
+
+        it 'should raise an unauthorized error' do
+          expect { subject.request }.to raise_error(DeepL::Exceptions::AuthorizationFailed)
+        end
+      end
+    end
+  end
+end

data/spec/requests/translate_spec.rb

@@ -3,7 +3,7 @@
 require 'spec_helper'
 
 describe DeepL::Requests::Translate do
-  let(:tags_str) { 'p, strong, span' }
+  let(:tags_str) { 'p,strong,span' }
   let(:tags_array) { %w[p strong span] }
 
   let(:api) { build_deepl_api }
@@ -11,6 +11,7 @@ describe DeepL::Requests::Translate do
   let(:source_lang) { 'EN' }
   let(:target_lang) { 'ES' }
   let(:options) { {} }
+
   subject { DeepL::Requests::Translate.new(api, text, source_lang, target_lang, options) }
 
   describe '#initialize' do
@@ -20,6 +21,33 @@ describe DeepL::Requests::Translate do
       end
     end
 
+    context 'when using `splitting_tags` options' do
+      it 'should work with a nil values' do
+        request = DeepL::Requests::Translate.new(api, nil, nil, nil, splitting_tags: nil)
+        expect(request.options[:splitting_tags]).to eq(nil)
+      end
+
+      it 'should work with a blank list' do
+        request = DeepL::Requests::Translate.new(api, nil, nil, nil, splitting_tags: '')
+        expect(request.options[:splitting_tags]).to eq('')
+      end
+
+      it 'should work with a comma-separated list' do
+        request = DeepL::Requests::Translate.new(api, nil, nil, nil, splitting_tags: tags_str)
+        expect(request.options[:splitting_tags]).to eq(tags_str)
+      end
+
+      it 'should convert arrays to strings' do
+        request = DeepL::Requests::Translate.new(api, nil, nil, nil, splitting_tags: tags_array)
+        expect(request.options[:splitting_tags]).to eq(tags_str)
+      end
+
+      it 'should leave strings as they are' do
+        request = DeepL::Requests::Translate.new(api, nil, nil, nil, splitting_tags: tags_str)
+        expect(request.options[:splitting_tags]).to eq(tags_str)
+      end
+    end
+
     context 'when using `non_splitting_tags` options' do
       it 'should work with a nil values' do
         request = DeepL::Requests::Translate.new(api, nil, nil, nil, non_splitting_tags: nil)
@@ -215,7 +243,7 @@ describe DeepL::Requests::Translate do
 
     context 'When performing a valid request and passing a variable' do
       let(:text) { 'Welcome and <code>Hello great World</code> Good Morning!' }
-      let(:options) { { tag_handling: 'xml', ignore_tags: 'code,span' } }
+      let(:options) { { tag_handling: 'xml', ignore_tags: %w[code span] } }
 
       it 'should return a text object' do
         text = subject.request
@@ -226,6 +254,50 @@ describe DeepL::Requests::Translate do
       end
     end
 
+    context 'When performing a valid request with an HTML document' do
+      let(:text) do
+        <<~XML
+          <document>
+            <meta>
+              <title>A document's title</title>
+            </meta>
+            <content>
+              <par>This is the first sentence. Followed by a second one.</par>
+              <par>This is the third sentence.</par>
+            </content>
+          </document>
+        XML
+      end
+      let(:options) do
+        {
+          tag_handling: 'xml',
+          split_sentences: 'nonewlines',
+          outline_detection: false,
+          splitting_tags: %w[title par]
+        }
+      end
+
+      it 'should return a text object' do
+        text = subject.request
+
+        expect(text).to be_a(DeepL::Resources::Text)
+        expect(text.text).to eq(
+          <<~XML
+            <document>
+              <meta>
+                <title>El título de un documento</title>
+              </meta>
+              <content>
+                <par>Es la primera frase. Seguido de una segunda.</par>
+                <par>Esta es la tercera frase.</par>
+              </content>
+            </document>
+          XML
+        )
+        expect(text.detected_source_language).to eq('EN')
+      end
+    end
+
     context 'When performing a bad request' do
       context 'When using an invalid token' do
         let(:api) do