Skip to main content

Want to translate using the world's best translator, DeepL, but don't want to give out your credit card? Use DeeptransTool and translate EVERYTHING you want, for FREE! Here is a solution for accessing the DeepL API with Python. 🐸

Project description

DeeptransTool

License: GPLv3 Python 3.10 PyPi Package

The package is still under development, you may find serious bugs or features like the pdf translator still missing. Any serious bugs please let me know by discord!

Summary and details


The perfect module to make translations with no character limitations, no need to pay and no need to give your bank details to access the API of DeepL. Translate the main text files (soon also pdf's) or give the text directly!

To fulfill the purpose, we make use of Selenium and the browser Chrome therefore, it is *necessary to have the browser installed on your computer. If you are on windows, download the latest version, if you are on linux, we recommend you to download this version.

Functions


- file_translate(route, string_characters, l_from, l_to, new_file, new_file_extension)

Use the world's "best translator" to translate files with python, and without API key.

  • Parameters:

    • route: STR | Path of the file to translate.

    • string_characters: INT | how many characters will contain the string to be translated (it is done by parts, by the limitation that has the same translator). Use at most 5000, and with margin of error.

    • l_from: STR | Language of origin. Generally the first acronym of the original language is used! An example of this is "Español", its acronym being "es". If you have any doubts about the acronym of your source or target language, check the website DeepL.

    • l_to: STR | Target Language. Generally the first acronym of the original language is used! An example of this is "English", its acronym being "en". If you have any doubts about the acronym of your source or target language, check the website DeepL.

    • new_file: BOOL | If you want the translation of the file to be done on a new one, you should activate this option.

    • new_file_extension: STR | If the previous option is True (new_file), you have to provide a valid file extension for the new file. If it is not provided, your new extension will be assumed to be txt.

- string_translate(text, string_characters, l_from, l_to)

Use the world's "best translator" to translate any text and make use of it, without any restrictions!

  • Parameters:

    • text: STR | Text to translate!

    • string_characters: INT | how many characters will contain the string to be translated (it is done by parts, by the limitation that has the same translator). Use at most 5000, and with margin of error.

    • l_from: STR | Language of origin. Generally the first acronym of the original language is used! An example of this is "Español", its acronym being "es".

    • l_to: STR | Target Language. Generally the first acronym of the original language is used! An example of this is "English", its acronym being "en".

  • Return: Return the text translate.

Installation and Use!


Installation:

To use this package, the best idea is to do it through pip:

pip install DeeptransTool

IT IS VERY IMPORTANT THAT THE "C" AND THE "T" ARE CAPITALIZED.

Or, on the contrary, you can clone this repository and access it:

git clone https://github.com/ElHaban3ro/DeeptransTool

This will create a folder of the project itself inside your python root project. Next we have to install the necessary dependencies for the project to work correctly, this can be done with:

pip install -r requirements.txt 

This would ideally have to install all the necessary libraries for you. This will be installed in the virtual environment of your project. See how to create a virtual environment here.

In addition to this, remember to have the Chrome browser installed on your device. Remember that, if you are on Windows, you should install the latest version, and if you are on linux, install the version that I leave in my repository (Any problem, contact me by Discord or Twitter).

Use:

To use this package of this form:

from DTT.deepLTranslate import file_translate


mi_traduccion = file_translate('C:/miruta/archivo.txt', 4999, 'es', 'en', True, 'srt')

Autor Contact


Contact Twitter Contact Discord Contact Discord

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

DeeptransTool-1.1.tar.gz (20.8 kB view hashes)

Uploaded Source

Built Distribution

DeeptransTool-1.1-py3-none-any.whl (19.3 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