v1.20.0

Added

• Added 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'
• Added the model_type_used field to translate_text() response, that
  indicates the translation model used when the model_type option is
  specified.

v1.19.1

Fixed

• Fixed typing issues, black-formatting and a test case failure.

v1.19.0

Added

• Added billed_characters to response from translate_text().

v1.18.0

Added

• 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

v1.17.0

Added

• Added output_format parameter for document upload function, that indicates
  the file extension of the desired file format for the translated document.
• Added basic usage example of the library

Fixed

• Fixed typechecking errors when using mypy's strict mode
  • Thanks to derlikh-smart and vad for the report in #82

v1.16.1

Fixed

• Fixed typo in error message when no auth key is provided.
• Removed dependency on packaging by replacing version comparison.

v1.16.0

Added

• Add optional context parameter for text translation, that specifies
  additional context to influence translations, that is not translated itself.

Changed

• Added notice in Readme that starting in 2024 the library will drop support for
  Python versions that are officially end-of-life.
• DeepL API calls now send requests with JSON-encoded bodies where possible.

Fixed

• Catch failures while constructing the user agent string.
• Added py.typed to the package so that our package is typed for our users.
• Fixed most type errors in the package.

v1.15.0

Fixed

• 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 files.
  • Thanks to TurtleWilly for the report in #66.
• Fix a dependency error in our CI by updating to a higher poetry version in most cases.
• Fix getUsage request to be a HTTP GET request, not POST.
• Change document translation to poll the server every 5 seconds. This should greatly reduce observed document translation processing time.

v1.14.0

Added

• Add example to translate JSON inputs.
• Added platform and python version information to the user-agent string that is sent with API calls, along with an opt-out.
• Added method for applications that use this library to identify themselves in API requests they make.
• Added verify_ssl option to Translator to control underlying requests session SSL certification verification.
  • Thanks to andrefloriani for the suggestion in #60.

v1.13.0

Added

• 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.

Fixed

• Copyright headers are updated for 2023

Security

• Update certifi to resolve security advisory.
  • certifi is a development-only dependency; library users are unaffected.