Skip to main content

No project description provided

Project description

PyPI version Python Package codecov Code style: black

DeepL Translate

An unofficial python package to translate text using DeepL.

Installation

pip install deepl-translate

Usage

Supported languages

Currently the following languages are supported:

Abbreviation Language Writing in own language
BG Bulgarian Български
ZH Chinese 中文
CS Czech Česky
DA Danish Dansk
NL Dutch Nederlands
EN English English
ET Estonian Eesti
FI Finnish Suomi
FR French Français
DE German Deutsch
EL Greek Ελληνικά
HU Hungarian Magyar
IT Italian Italiano
JA Japanese 日本語
LV Latvian Latviešu
LT Lithuanian Lietuvių
PL Polish Polski
PT Portuguese Português
RO Romanian Română
RU Russian Русский
SK Slovak Slovenčina
SL Slovenian Slovenščina
ES Spanish Español
SV Swedish Svenska

You can either input the abbreviation or the language written in english.

Command line tool

Help

deepl --help
usage: deepl [-h] [--version] [--formal | --informal] [-t TEXT | -f FILE] source_language target_language

Python client to translate texts using deepl.com

positional arguments:
  source_language       Source language of your text
  target_language       Target language of your desired text

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --formal              Use formal tone in translation
  --informal            Use informal tone in translation
  -t TEXT, --text TEXT  Text to be translated
  -f FILE, --file FILE  File to be translated

Example 1

This will translate a Spanish (ES) text into Russian (RU):

deepl spanish russian -t "¡Buenos días!"
Доброе утро!

Example 2

This will translate the file (test.txt) text from Italian (IT) into Portuguese (PT):

deepl IT PT --file test.txt

Example 3

This will translate a Spanish (ES) text into Russian (RU) in formal tone:

deepl ES RU --text "¿Cómo te llamas?" --formal
Как Вас зовут?

Note: informal would be "Как тебя зовут?"

Example 4

This will translate a Japanese (JP) text into German (DE) in informal tone:

deepl JP DE --text "お元気ですか?" --informal
Wie geht es dir?

Note: formal would be "Wie geht es Ihnen?"

Python library

Example 1

This will translate a Chinese (ZH) text into Dutch (NL):

import deepl
deepl.translate(source_language="ZH", target_language="NL", text="你好")
'Hallo'

Example 2

This will translate a danish text into german in informal tone:

import deepl
deepl.translate(source_language="danish", target_language="german", text="Ring til mig!", formality_tone="informal")
'Ruf mich an!'

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deepl-translate-1.2.0.tar.gz (6.7 kB view hashes)

Uploaded Source

Built Distribution

deepl_translate-1.2.0-py3-none-any.whl (8.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page