NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #3791 most downloaded on PyPI
Python library for the DeepL API.
Latest stable
1.33.0
Last release 20 days ago
02 Nov 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 48 of 48 stable releases
1 version withdrawn
withdrawn after publishing
9 years old
49 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Translation memories, style rules and multilingual glossaries gained many options and fixes. Read Changed and Deprecated before upgrading; no public A…
TL;DR: new APIs in this release: the Admin API, spoken terms and style profiles. Translation memories, style rules and multilingual glossaries gained many options and fixes. Read Changed and Deprecated before upgrading; no public API is removed in this release.
headers option to the Translator, DeepLClient and
DeepLAdminClient constructors: extra HTTP headers sent with every request
to the DeepL API. A header replaces the library's header of the same name,
including User-Agent and Authorization; Content-Type,
Content-Length, Transfer-Encoding, Host and an Accept the library
sets for a call keep the library's value. Translation memory storage URLs
get only the User-Agent.app_info option, an AppInfo(app_name, app_version), to the
Translator, DeepLClient and DeepLAdminClient constructors, the same as
calling set_app_info().NotFoundException, raised for HTTP 404 on every endpoint.
GlossaryNotFoundException is now its subclass.is_free_account_auth_key(), which replaces auth_key_is_free_account().extra_body_parameters option to create_style_rule(),
update_style_rule_name(), update_style_rule_configured_rules(),
create_style_rule_custom_instruction() and
update_style_rule_custom_instruction().get_style_rule_custom_instruction(),
update_style_rule_custom_instruction() and
delete_style_rule_custom_instruction() accept a CustomInstruction object
as instruction_id, as well as an ID string.max_retries and timeout_s options to the Translator,
DeepLClient and DeepLAdminClient constructors, to set the maximum number
of retries and the minimum per-attempt timeout in seconds for each client.style_profile option to translate_text() and the document
translation functions (translate_document(),
translate_document_from_filepath(), translate_document_upload()) to
translate with a style profile, as a style profile ID or StyleProfile
object. The CLI accepts it as --style-profile-id.DeepLAdminClient class for the Admin API. It must be created with
an admin API key and supports managing developer keys
(create_developer_key(), list_developer_keys(),
deactivate_developer_key(), rename_developer_key(),
set_developer_key_usage_limits()) and retrieving usage analytics
(get_usage_analytics(), get_custom_tag_usage_analytics()) with
the result types DeveloperKey, DeveloperKeyUsageLimits,
AdminUsageReport, AdminUsageBreakdown, KeyUsage, CustomTagUsageReport,
CustomTagUsage and CustomTagUsageBreakdown, and the request options
DeveloperKeyUsageLimitsUpdate, AdminUsageGroupBy and
CustomTagUsageAggregateBy.
The developer key methods that send a request body accept
extra_body_parameters.
create_developer_key() is retried only when the request was not sent:
after HTTP 429, a DNS resolution failure, a refused connection or a connect
timeout. AdminUsageReport.total_usage,
AdminUsageBreakdown.speech_to_speech_minutes and
CustomTagUsageBreakdown.speech_to_speech_minutes are None when the
report does not contain them, and a response without usage_report or
custom_tag_usage_report raises DeepLException.get_languages_for_resource() method to the DeepLClient class to
retrieve the languages supported by a resource, with per-feature support
information, via the /v3/languages endpoint. Resources are given as
LanguageResourceName values or strings; results are LanguageSupport
objects. Malformed responses raise DeepLException.get_language_resources() method to the DeepLClient class to
retrieve the API resources and their features via the
/v3/languages/resources endpoint. Results are returned as
LanguageResource and ResourceFeature objects; needs_source_support
and needs_target_support are False when the API omits them.Language constants for the target variants de-CH, de-DE,
es-ES, fr-CA, and fr-FR.enable_watermark option to translate_document(),
translate_document_upload() and translate_document_from_filepath(). Set
it to True to add a "Translated by DeepL" watermark to docx and pdf
output.Usage: api_key_character,
speech_to_text_minutes and speech_to_speech_minutes (as
Optional[Usage.Detail]), start_time and end_time (the billing period),
and products, a list of Usage.Product objects with per-product usage.
They are None when the response does not contain them; products entries
that are not JSON objects are skipped./v3/spoken-terms) to the DeepLClient class:
create_spoken_terms(), list_spoken_terms(), get_spoken_terms(),
update_spoken_terms(), get_spoken_terms_entries(),
replace_spoken_terms_list(), delete_spoken_terms() and
delete_spoken_terms_list(), with the SpokenTerms, SpokenTermsList and
SpokenTermsEntries types. create_spoken_terms(), update_spoken_terms()
and replace_spoken_terms_list() accept extra_body_parameters. Collection
IDs are URL-encoded in the request path, terms are stripped of leading and
trailing whitespace before they are validated and sent, and a malformed
response raises DeepLException./v3/style_profiles) to the DeepLClient
class: list_style_profiles(), create_style_profile(),
get_style_profile(), update_style_profile() and
delete_style_profile(), with the StyleProfile type. The glossary_ids,
style_rule_ids and translation_memory_ids options of
create_style_profile() and update_style_profile() accept IDs or
GlossaryInfo, MultilingualGlossaryInfo, StyleRuleInfo and
TranslationMemoryInfo objects, and both functions accept
extra_body_parameters. A style profile response that is not a JSON object,
or lacks a valid style_profile_id, name, creation_time or
updated_time, raises DeepLException.TagHandlingMode (HTML, XML) and TagHandlingVersion (V1,
V2) enums. The tag_handling and tag_handling_version options of
translate_text() accept them as well as strings.tag_handling_version to TextResult: the tag handling version the
API used, or None when the response does not contain it.translate_text() accepts source_lang and target_lang positionally after
the text, for example translate_text("Hello", None, "DE"). Keyword use is
unchanged; omitting target_lang still raises TypeError.document_id property to DocumentStatus, read from the status
response of translate_document_get_status() (falling back to the handle's
document ID).translate_document(), translate_document_from_filepath() and
translate_document_upload() now also accept source_lang and
target_lang as positional arguments after the input (and output)
arguments, for example translate_document_upload(file, "EN", "DE").
Keyword use is unchanged.writing_style and extra_body_parameters options to
rephrase_text(), and the extra_body_parameters option to
correct_text(). writing_style and tone accept a WritingStyle or
WritingTone member or a string.update_multilingual_glossary() to the DeepLClient class to rename a
multilingual glossary and/or merge dictionaries into it in one request,
sending only the options that are set.get_multilingual_glossary_dictionary_entries() to the DeepLClient
class, returning the MultilingualGlossaryDictionaryEntries of one dictionary
and raising GlossaryNotFoundException if the glossary has none for the
language pair.extra_body_parameters option to create_multilingual_glossary(),
create_multilingual_glossary_from_csv(),
update_multilingual_glossary_name(),
update_multilingual_glossary_dictionary(),
update_multilingual_glossary_dictionary_from_csv(),
replace_multilingual_glossary_dictionary() and
replace_multilingual_glossary_dictionary_from_csv().get_multilingual_glossary() accepts a MultilingualGlossaryInfo object, as
glossary, besides a glossary ID.dictionaries (create_multilingual_glossary()),
dictionary (update_multilingual_glossary_dictionary(),
replace_multilingual_glossary_dictionary()), csv (the
*_multilingual_glossary*_from_csv() functions) and glossary
(get_multilingual_glossary()).MultilingualGlossaryInfo, MultilingualGlossaryDictionaryInfo and
MultilingualGlossaryDictionaryEntries are exported from the deepl package.MultilingualGlossaryDictionaryInfo.to_json().content_type and extra_body_parameters options to
import_translation_memory_from_filepath(), and the extra_body_parameters
option to create_translation_memory_import(). content_type is declared
when creating the import job and sent with the upload; extra body parameters
are added to the request that creates the import job and replace keys of
the same name.TranslationMemoryJobStatus enum. TranslationMemoryJob.status
and TranslationMemoryJobResult.status now return its members for the
statuses awaiting_input, processing, completed, failed and
expired, and the plain string for any other value. Members are strings
that compare equal to the API value, so existing comparisons with strings
and the TranslationMemoryJobResult.STATUS_* constants keep working.content parameter name to upload_translation_memory_file()
for the file content, replacing input_file. Positional calls are
unaffected.DocumentTranslationException accepts should_retry and
http_status_code. translate_document() and
translate_document_from_filepath() copy both from the underlying
DeepLException; before they were always False and None.timeout_s, wait_until_translation_memory_job_done() now cuts its
last sleep short; previously it could run up to 5 seconds past the timeout.import_translation_memory_from_filepath() now reads the file and
export_translation_memory_to_filepath() now checks the output path before
creating the job, so these OSErrors are raised without creating a job;
previously the job was created first.translate_text() now accepts glossary and glossary_ids without
source_lang, and DeepL uses the glossary dictionary for the detected
language pair; previously it raised ValueError. Document translation with a
glossary still requires source_lang.server_url is now kept; previously the last path segment was
dropped.AuthorizationException; previously
DeepLException.Translator now emits a DeprecationWarning; previously it did
not.NotFoundException instead of DeepLException
(glossary functions keep raising GlossaryNotFoundException, now a
subclass of NotFoundException).User-Agent platform information now ends with python/<version>;
previously it also included the requests version.EN and PT are now sent to the API, which translates them
into EN-US and PT-PT; previously they were rejected client-side.get_source_languages(), get_target_languages(), and
get_glossary_languages() now use the /v3/languages endpoint
internally instead of the deprecated /v2/languages and
/v2/glossary-language-pairs endpoints. Public signatures and return
types are unchanged, but the returned language lists may now include
additional languages.chunk_size of translate_document_download() and
download_translation_memory_export() is now 64 KiB instead of 1 byte, so
downloads into output_file no longer write one byte per call. The written
content is unchanged; an explicit chunk_size still applies.DocumentStatus.status is now typed Union[DocumentStatus.Status, str]: a
status value the API returns that this version does not know is kept as a
string instead of raising ValueError. Type-checked code that reads
status.status.value may need an isinstance(..., DocumentStatus.Status)
guard; str(status) returns the status string in both cases.Translator is deprecated in favour of DeepLClient, which supports all its
functions, and will be removed in the next major version.GlossaryNotFoundException is deprecated, catch NotFoundException instead.
It will be removed in the next major version.auth_key_is_free_account() is deprecated, use is_free_account_auth_key().
Calling it emits a DeprecationWarning.deepl.http_client.user_agent is deprecated in
favour of a User-Agent entry in the headers option, and will be removed in
the next major version. Assigning it emits a DeprecationWarning.translate_document_download() or
download_translation_memory_export() without output_file now emits a
DeprecationWarning. It still returns the streaming requests.Response; in
the next major version output_file will be required and both methods will
return None.skip_language_check to Translator() or DeepLClient(), or
skip_cache to get_source_languages() or get_target_languages(), now
emits a DeprecationWarning. Both parameters have no effect and will be
removed in the next major version. Their defaults changed from False to
None; passing False explicitly also warns.deepl.http_client.max_network_retries and
deepl.http_client.min_connection_timeout are deprecated in favour of the
max_retries and timeout_s client options, and will be removed in the
next major version. They still apply to clients created without these
options. Assigning either setting emits a DeprecationWarning.Language (Language.GERMAN,
Language.ENGLISH_AMERICAN, ...) are deprecated and will be removed in the
next major version. Pass language codes as strings, for example "de", or
use the codes returned by get_source_languages() and
get_target_languages(). The constants keep working and emit no warning.style keyword of rephrase_text() is deprecated in favour of
writing_style and emits a DeprecationWarning. It keeps working; if both
are given, writing_style is used.get_multilingual_glossary_entries() is deprecated, use
get_multilingual_glossary_dictionary_entries().glossary_dicts, glossary_dict, csv_data and
glossary_id of the multilingual glossary functions are deprecated, use
dictionaries, dictionary, csv and glossary.input_file keyword of upload_translation_memory_file() is
deprecated in favour of content and will be removed in the next major
version. Passing it emits a DeprecationWarning.SplitSentences.DEFAULT is deprecated, use SplitSentences.ALL, which it is
an alias of.translate_text_with_glossary() is deprecated, use translate_text() with
the glossary parameter. Calling it emits a DeprecationWarning.ValueError naming
the row; previously a bare IndexError (it is still an IndexError).ConnectionException with should_retry True once retries are used up.
create_developer_key() is still not retried after it.translate_document_download() now streams the translated document to
output_file in chunks, instead of first reading the whole document into
memory for the debug log.translate_document_download() or
download_translation_memory_export() reads the downloaded file now raises
ConnectionException, instead of a requests exception.Location) now raise DeepLException with
http_status_code, instead of being parsed as a successful response.ConnectionException
with should_retry False.%20 instead of +.should_retry as [secure] for HTTP 429 and 5xx, and dropping the
response body of a failed download from the message.export_translation_memory_to_filepath() no longer leaves a
partially written file behind.DeepLException.should_retry is now True for every HTTP 5xx error. It was
False for all of them except 503, although they are retried.message or detail is not a string (a number,
object or null) no longer raises TypeError; the value is included as
JSON, null is left out.:fx check that selects the API Free server. A
key of only whitespace is rejected with ValueError.translate_text() raising TypeError when a translation in the
response has no billed_characters. TextResult.billed_characters is now
None in that case.translate_text() raising IndexError when the response holds fewer
translations than texts sent. It now raises DeepLException.translate_document_get_status() raising ValueError and
translate_document_wait_until_done() stopping when the API returns a
document status this version does not know. DocumentStatus.status keeps
such a status as a string, and polling continues.translate_document() and translate_document_from_filepath()
sending formality=default when formality was not set. It is now sent
only when given.translate_document_get_status() and translate_document_download()
not URL-encoding the document ID in the request path.translate_document_upload() returning an empty DocumentHandle when
the response lacks document_id or document_key, and raising
AttributeError when the response body is not a JSON object. Both now
raise DeepLException.DocumentStatus.error_message, which is a
string, not an integer./, ? or # addressed a different resource.KeyError, ValueError,
TypeError or AttributeError on a malformed StyleRuleInfo or
CustomInstruction response. They now raise DeepLException.DeprecationWarning messages of Usage.Detail.limit_exceeded and
Usage.any_limit_exceeded, which named the replacement instead of the
deprecated property. They now read "limit_exceeded is deprecated, use
limit_reached" and "any_limit_exceeded is deprecated, use any_limit_reached".Language.ENGLISH and Language.PORTUGUESE comments that
claimed they are only usable as source languages.create_glossary_from_csv() failing with "Object of type bytes is not
JSON serializable" when the CSV data is given as bytes or as a file opened in
binary mode.rephrase CLI command always failing with an unexpected keyword
argument error. --show-detected-source now prints the detected source
language of each text.translate CLI alias of the text command failing with
'action_translate'.extra_body_parameters documentation, which claimed that entries
do not overwrite request fields set by the library. They do, since 1.24.0.MultilingualGlossaryInfo.to_json() raising TypeError when called on
an instance.rephrase_text() and correct_text() failing with "Object of type
... is not JSON serializable" when target_lang is a Language object or
the style or tone is a WritingStyle or WritingTone member. The value is
now sent as its string code.rephrase_text() and correct_text() now raise DeepLException when the
response has no improvements list, fewer improvements than input texts, or
an improvement without text. Before, this raised IndexError or
AttributeError, or silently returned a shorter list.get_source_languages() and get_target_languages() now raise
DeepLException when the response is not a list (they returned an empty
list before) or a language in it is missing its code or name (instead of a
raw KeyError, AttributeError or TypeError). A null features field is
treated as no features./v3/glossaries request paths, and the
language pair in the query of get_multilingual_glossary_entries() and
delete_multilingual_glossary_dictionary() is URL-encoded.
delete_multilingual_glossary_dictionary() now also strips regional variants
(EN-GB becomes EN), like the other multilingual glossary functions.DeepLException instead of
a raw KeyError, TypeError or ValueError.MultilingualGlossaryInfo.to_json() returns a JSON-serialisable dictionary:
creation_time as an ISO 8601 string and dictionaries as dictionaries./, ? or spaces no longer change the requested URL.KeyError,
TypeError or AttributeError when the API returns a malformed response.
They now raise DeepLException. list_translation_memories() also raises
DeepLException for a non-JSON response instead of returning an empty list.get_usage() returning a Usage with every value invalid when the
response body is not a JSON object. It now raises DeepLException.translate_document_download() now raises errors with the API's error
message. Before, a 400, 404 or 456 response raised without it, and other
statuses reported content: <file>.translate_document_wait_until_done() (and translate_document() with
timeout_s) shortens its last wait to the timeout, so it no longer runs up
to 5 seconds past timeout_s.Your coding agent can read these notes before it upgrades. Set up the MCP server →
chore: bump version to 1.32.0 (minor bump)
chore: bump version to 1.32.0 (minor bump)
correct_text() method to the DeepLClient class for fixing
spelling and grammar errors in text(s) via the /v2/write/correct
endpoint.Added support for using multiple glossaries via the glossary_ids parameter (up to 5 glossaries) in translate_text(), translate_document(), translate_d
glossary_ids parameter
(up to 5 glossaries) in translate_text(), translate_document(),
translate_document_upload(), and translate_document_from_filepath().style_rule
parameter in translate_document(), translate_document_upload(), and
translate_document_from_filepath().translation_memory and translation_memory_threshold parameters in
translate_document(), translate_document_upload(), and
translate_document_from_filepath().--glossary-ids CLI argument for the text and document commands,
allowing up to 5 glossaries to be used per translation.--style-id, --translation-memory-id, and
--translation-memory-threshold CLI arguments to the document command.get_translation_memory(), list_translation_memory_segments(),
delete_translation_memory(), create_translation_memory_import(),
upload_translation_memory_file(), create_translation_memory_export(),
get_translation_memory_job(),
wait_until_translation_memory_job_done(), and
download_translation_memory_export(), along with the
import_translation_memory_from_filepath() and
export_translation_memory_to_filepath() convenience functions that create
the job, transfer the TMX file, and wait for the job to finish. Because the
API detects the file upload asynchronously, an import job keeps reporting
awaiting_input for a while after the upload; the wait loop polls through
that status, so pass timeout_s to bound the wait.TranslationMemorySegments, TranslationMemorySegment,
TranslationMemoryTargetSegment, TranslationMemoryImport,
TranslationMemoryExport, TranslationMemoryJob, and
TranslationMemoryJobResult types.creation_time and updated_time properties to
TranslationMemoryInfo.translation-memory CLI command with the list, get,
segments, import, export, job, and delete subcommands.Added support for translation memories in text translation via translation_memory and translation_memory_threshold parameters in translate_text().
translation_memory and translation_memory_threshold parameters in
translate_text().list_translation_memories() method to the DeepLClient class for
listing available translation memories.--translation-memory-id and --translation-memory-threshold CLI
arguments.$HOME from the global image.Added new language constants from January 2026 API release of 81 new languages.
DeepLClient class:
create_style_rule(), get_style_rule(), update_style_rule_name(),
update_style_rule_configured_rules(), and delete_style_rule().DeepLClient class: create_style_rule_custom_instruction(),
get_style_rule_custom_instruction(),
update_style_rule_custom_instruction(), and
delete_style_rule_custom_instruction().
Please refer to the README for usage instructions.Updated dependencies to fix CVE-2025-66418 and CVE-2025-66471
NotFoundException error message by removing the misleading "check server_url" suggestion.Added tag_handling_version parameter to translate_text() to specify which version of the tag handling algorithm to use. Options are v1 and v2.
tag_handling_version parameter to translate_text() to specify which version
of the tag handling algorithm to use. Options are v1 and v2.Added custom_instructions parameter to translate_text() to customize translation behavior with up to 10 instructions (max 300 characters each). Only s
custom_instructions parameter to translate_text() to customize translation behavior with up to 10 instructions (max 300 characters each). Only supported for target languages: de, en, es, fr, it, ja, ko, zh and their variants. Note: using the custom_instructions parameter will use the quality_optimized model type as the default. Requests combining custom_instructions and the latency_optimized model type will be rejected.custom_instructions parameter to translate_text() to customize translation
behavior with up to 10 instructions (max 300 characters each). Only supported for
target languages: de, en, es, fr, it, ja, ko, zh and their variants.
Note: using the custom_instructions parameter will use the quality_optimized model
type as the default. Requests combining custom_instructions and the
latency_optimized model type will be rejected.Added support for the GET /v3/style_rules endpoint in the client library, the implementation can be found in the DeepLClient class. Please refer to th
GET /v3/style_rules endpoint in the client library, the implementation can be found in the DeepLClient class. Please refer to the README for usage instructionsstyle_id option to translate_text() which allows text translation with style rules.extra_body_parameters will now overwrite already set HTTP parameters
extra_body_parameters will now overwrite already set HTTP parametersUpdated requests minimum version to 2.32.4 to resolve security advisories CVE-2024-47081 and CVE-2024-35195.
translate_textrequests minimum version to 2.32.4 to resolve security advisories
CVE-2024-47081 and CVE-2024-35195.Added support for the /v3 Glossary APIs in the client library while providing backwards compatibility for the previous /v2 Glossary endpoints. Please
(beta) optional parameter to specify timeout for document translation calls
Added support for the Write API in the client library, the implementation can be found in the DeepLClient class. Please refer to the README for usage
DeepLClient class. Please refer to the README for usage
instructions.DeepLClient
class. Please change your code to use this over the Translator class whenever
convenient.Added model_type option to translate_text() to use models with higher translation quality (available for some language pairs), or better latency. Opti
model_type option to translate_text() to use models with higher
translation quality (available for some language pairs), or better latency.
Options are 'quality_optimized', 'latency_optimized', and 'prefer_quality_optimized'model_type_used field to translate_text() response, that
indicates the translation model used when the model_type option is
specified.Fixed typing issues, black-formatting and a test case failure.
New language available: Arabic ('ar'). Add language code constants and tests. Arabic is currently supported only for text translation; document transl
New language available: Arabic ('ar'). Add language code constants and tests.
Arabic is currently supported only for text translation; document translation
support for Arabic is coming soon.
Note: older library versions also support the new language, this update only adds new code constants.
Added a section in the readme on how to configure retry options in http_client.py
Added output_format parameter for document upload function, that indicates the file extension of the desired file format for the translated document.
output_format parameter for document upload function, that indicates
the file extension of the desired file format for the translated document.mypy's strict mode
Fixed typo in error message when no auth key is provided.
packaging by replacing version comparison.Add optional context parameter for text translation, that specifies additional context to influence translations, that is not translated itself.
context parameter for text translation, that specifies
additional context to influence translations, that is not translated itself.py.typed to the package so that our package is typed for our users.Removed CHANGELOG.md and SECURITY.md from the python package. The LICENSE file is no longer installed, but still included in package tarball and wheel
CHANGELOG.md and SECURITY.md from the python package. The LICENSE file is no longer installed, but still included in package tarball and wheel files.
Add example to translate JSON inputs.
verify_ssl option to Translator to control underlying requests session SSL certification verification.
Add example script to translate Mustache templates.
Add example script to translate Mustache templates.
Add support for storing your API Key in a keyring via the keyring module.
Added a CI check for copyright headers.
New languages available: Korean ('ko') and Norwegian (bokmål) ('nb'). Add language code constants and tests.
Note: older library versions also support the new languages, this update only adds new code constants.
certifi to resolve security advisory.
certifi is a development-only dependency; library users are unaffected.State explicitly that this library supports Python 3.11.
should_retry and http_status_code properties to all exceptions
thrown by the library.py dependency by upgrading pytest version to 7.2.0 for Python 3.7+.
For Python 3.6 tests pytest needs to be added manually.tox dependency.coverage dependency.Add formality options 'prefer_less' and 'prefer_more'.
'prefer_less' and 'prefer_more'.503 Service Unavailable errors are now retried.
Attempting to download a document before translation is completed will now
wait and retry (up to 5 times by default), rather than raising an exception.New language available: Ukrainian ('uk'). Add language code constant and tests.
New language available: Ukrainian ('uk'). Add language code constant and tests.
Note: older library versions also support new languages, this update only adds new code constant.
Add Translator.create_glossary_from_csv() allowing glossaries downloaded from website to be easily uploaded to API.
Translator.create_glossary_from_csv() allowing glossaries downloaded
from website to be easily uploaded to API.Optional filename parameter added to Translator.translate_document(), only required if uploading string or bytes containing file content.
Deprecate limit_exceeded and any_limit_exceeded properties of Usage object returned by get_usage(), use limit_reached and any_limit_reached instead.
New languages available: Indonesian ('id') and Turkish ('tr'). Add language code constants and tests.
Note: older library versions also support the new languages, this update only adds new code constants.
Add limit_reached and any_limit_reached properties to Usage object
returned by get_usage().
Add Translator.translate_document_wait_until_done() to poll translation
status until translation is complete or fails.
Add auth_key_is_free_account() utility function.
limit_exceeded and any_limit_exceeded properties of Usage
object returned by get_usage(), use limit_reached and any_limit_reached
instead.Add error_message property to DocumentStatus, describing the error in case of document translation failure.
error_message property to DocumentStatus, describing the error in case of document translation failure.translate_text_with_glossary is called without an instance of GlossaryInfo.translate_document and translate_document_from_filepath return final DocumentStatus, allowing the number of
billed characters to be queried.Fix bug in CLI languages command causing some target languages to be omitted.
DocumentTranslationException.document_request is deprecated, use document_handle instead.
translate_text().DocumentTranslationException.document_request is deprecated, use document_handle instead.Fix bug in DocumentTranslationException stringize function.
DocumentTranslationException stringize function.Add contribution guidelines -- currently we are unable to accept Pull Requests.
--glossary-id argument for CLI document command.DocumentNotReadyException when attempting to download a document before it has been translated. Previously the
base class DeepLException was thrown.translate_document_upload() to fix uploading file content as string or bytes.Limit document status update wait time to 60 seconds, and log wait times.
Add glossary support for document translation.
Note: the PyPI package for 1.3.0 included changes from 1.3.1, so it has been yanked.
Fix bug that caused User-Agent header to be omitted from HTTP requests.
Some optional arguments related to language caching are now deprecated, and will be removed in a future version:
Translator.get_glossary_languages() to query language pairs supported for glossaries.Language.GERMAN.Translator(): the skip_language_check argumentTranslator.get_source_languages() and Translator.get_target_languages(): the skip_cache argumentLoosen requirement for requests to 2.0 or higher.
Improve request exception messages and include exception stacktraces.
Fix typing.List issue on Python 3.6.
Add support for glossary API functions.
Add explicit copyright notice to all source files.
All API calls use Authorization header instead of auth_key parameter.
Minor updates to pyproject.toml and README.md.
Version increased to avoid conflicts with old packages on PyPI.
Version increased to avoid conflicts with old packages on PyPI.
Package uploaded to PyPI. Thanks to Adrian Freund for transferring the deepl package name.
Translator() server_url argument works with and without trailing slash.
[Unreleased]: https://github.com/DeepL/deepl-python/compare/v1.33.0...HEAD [1.33.0]: https://github.com/DeepL/deepl-python/compare/v1.32.0...v1.33.0 [
Initial version.
One column per quarter.