Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DavideGalilei/gpytranslate
A Python3 library for translating text using Google Translate API.
https://github.com/DavideGalilei/gpytranslate
google googletrans gpytranslate python python3 translate translation translator
Last synced: 3 months ago
JSON representation
A Python3 library for translating text using Google Translate API.
- Host: GitHub
- URL: https://github.com/DavideGalilei/gpytranslate
- Owner: DavideGalilei
- License: mit
- Created: 2020-08-26T12:02:34.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-02-04T21:53:56.000Z (almost 2 years ago)
- Last Synced: 2024-06-28T09:33:41.639Z (5 months ago)
- Topics: google, googletrans, gpytranslate, python, python3, translate, translation, translator
- Language: Python
- Homepage: https://pypi.org/project/gpytranslate
- Size: 125 KB
- Stars: 44
- Watchers: 5
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gpytranslate
A Python3 library for translating text using Google Translate API.
----
## Features
- **Both Synchronous and Asynchronous**
- **Dot accessible values**
- **Supports emoji**
- **Type hinted**
- **Free to use**
- **Easy**
----
## Quick Start
### Installation
Requirements:
- Python 3.7 or higher.
```bash
$ python3 -m pip install -U gpytranslate
```
----
### Usage
[Async Example:](/examples/async/example.py)
```python
from gpytranslate import Translator
import asyncio
async def main():
t = Translator()
translation = await t.translate("Ciao come stai? Io bene ahah.", targetlang="en")
language = await t.detect(translation.text)
print(f"Translation: {translation.text}\nDetected language: {language}")
if __name__ == "__main__":
asyncio.run(main())
```
[Sync Example:](/examples/sync/example.py)
```python
from gpytranslate import SyncTranslator
t = SyncTranslator()
translation = t.translate("Ciao come stai? Io bene ahah.", targetlang="en")
language = t.detect(translation.text)
print(f"Translation: {translation.text}\nDetected language: {language}")
```
❓ **Note:** you could also check [tests](/tests) folder for extra examples.
Output:
```
Translation: Hello how are you? I'm fine, haha.
Detected language: en
```
### Text to Speech
[Async Example:](/examples/async/tts.py)
```python
import asyncio, aiofiles
from gpytranslate import Translator
async def main():
translator = Translator()
async with aiofiles.open("test.mp3", "wb") as file:
await translator.tts("Hello world!", file=file)
if __name__ == "__main__":
asyncio.run(main())
```
[Sync Example:](/examples/sync/tts.py)
```python
from gpytranslate import SyncTranslator
translator = SyncTranslator()
with open("test.mp3", "wb") as file:
translator.tts("Hello world!", file=file)
```
----
## Useful Resources
https://danpetrov.xyz/programming/2021/12/30/telegram-google-translate.html
https://vielhuber.de/en/blog/google-translation-api-hacking/
https://github.com/OwlGramDev/OwlGram/blob/b9bb8a247758adbf7be7aaf3eb150f680bec1269/TMessagesProj/src/main/java/it/owlgram/android/translator/GoogleAppTranslator.java
----
## Development
Want to contribute? Pull requests are accepted!
----
## License
Licensed under the MIT License.
Click [here](/LICENSE) for further information.