Seamless Multi-API Translation: Simplifying Language Barriers with DeepL, OpenAI, Gemini and Google Translate.
Readme
Table of Contents
Seamless Multi-API Translation: Simplifying Language Barriers with DeepL, OpenAI, Gemini and Google Translate.
EasyTL has a Trello board for tracking planned features and issues: https://trello.com/b/Td555CoW/easytl
To get started with EasyTL, install the package via pip:
pip install easytl
Then, you can translate text using by importing the global client.
For example, with DeepL:
from easytl import EasyTL
## Set your API key
EasyTL.credentials("deepl", "your_api_key_here")
## You can also validate your API keys; translation functions will do this automatically
is_valid, e = EasyTL.validate_credentials("deepl")
translated_text = EasyTL.deepl_translate("私は日本語が話せます", "EN-US") ## Text to translate, language to translate to, only two "required" arguments but there are more optional arguments for additional functionality and other services.
Python 3.10+
EasyTL can be installed using pip:
pip install easytl
This will install EasyTL along with its dependencies and requirements.
These are the dependencies/requirements that will be installed:
setuptools>=61.0
wheel
setuptools_scm>=6.0
tomli
google-generativeai==0.5.1
deepl==1.16.1
openai==1.13.3
backoff==2.2.1
tiktoken==0.6.0
google-cloud-translate==3.15.3
EasyTL offers seamless integration with several translation APIs, allowing users to easily switch between services based on their needs. Key features include:
Use deepl_translate, googletl_translate, openai_translate, or gemini_translate to translate text using the respective services. Each method accepts various parameters to customize the translation process, such as language, text format, and API-specific features like formality level or temperature for creative outputs.
All services offer asynchronous translation methods that return a future object for concurrent processing. These methods are suffixed with _async and can be awaited to retrieve the translated text.
Instead of receiving the translated text directly, you can also use the response parameter to get the full response object from the API.
EasyTL has generic translation methods translate and translate_async that can be used to translate text with any of the supported services. These methods accept the text, service, and kwargs of the respective service as parameters.
The calculate_cost method provides an estimate of the cost associated with translating a given text with specified settings for each supported service.
characters or tokens depending on the service.
num_characters, cost, model = EasyTL.calculate_cost("This has a lot of characters", "deepl")
or
num_tokens, cost, model = EasyTL.calculate_cost("This has a lot of tokens.", "openai", model="gpt-4", translation_instructions="Translate this text to Japanese.")
Credentials can be set and validated using set_credentials and validate_credentials methods to ensure they are active and correct before submitting translation requests.
This project, EasyTL, is licensed under the GNU Lesser General Public License v2.1 (LGPLv2.1) - see the LICENSE file for complete details.
The LGPL is a permissive copyleft license that enables this software to be freely used, modified, and distributed. It is particularly designed for libraries, allowing them to be included in both open source and proprietary software. When using or modifying EasyTL, you can choose to release your work under the LGPLv2.1 to contribute back to the community or incorporate it into proprietary software as per the license's permissions.
If you have any questions or suggestions, feel free to reach out to me at Bikatr7@proton.me
Also feel free to check out the GitHub repository for this project.
Or the issue tracker here.
Contributions are welcome! I don't have a specific format for contributions, but please feel free to submit a pull request or open an issue if you have any suggestions or improvements.
EasyTL was originally developed as a part of Kudasai, a Japanese preprocessor later turned Machine Translator. It was later split off into its own package to be used independently of Kudasai for multiple reasons.
This package is also my second serious attempt at creating a Python package, so I'm sure there are some things that could be improved. Feedback is welcomed.
FAQs
Seamless Multi-API Translation: Simplifying Language Barriers with DeepL, OpenAI, Gemini and Google Translate.
We found that easytl demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Application Security
New SEC disclosure rules aim to enforce timely cyber incident reporting, but fear of job loss and inadequate resources lead to significant underreporting.
Security News
The Python Software Foundation has secured a 5-year sponsorship from Fastly that supports PSF's activities and events, most notably the security and reliability of the Python Package Index (PyPI).
Security News
LDAPjs, an LDAP Client and Server API for Node.js, was decommissioned after its maintainer received an abusive email from a user, raising concerns about this form of abuse as a potential attack vector.