Metadata-Version: 2.4
Name: tertran
Version: 1.0.1
Summary: Terminal translator CLI
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: certifi
Requires-Dist: charset-normalizer
Requires-Dist: click
Requires-Dist: colorama
Requires-Dist: idna
Requires-Dist: platformdirs
Requires-Dist: requests
Requires-Dist: requests-cache
Requires-Dist: tabulate
Requires-Dist: urllib3
Dynamic: license-file

# Tertran (Terminal translator)

Tertran is a very bad name to my CLI built in python made to work in the terminal without the need for any browser.

## Requirements

It needs python and pip to work. It will also require external packages which can be installed with pip.

## Install

Download or use Git to clone this repository, once the directory is selected, use pip to install it on your machine

```cmd
pip install .
```

or:

```cmd
pip install tertran
```

## Usage

Write tertran to use the translation function

```cmd
tertran <source lang> <target lang> <input>
```

Example:
![Using terminal translator](images/tertran_basic_usage.png "Tertran terminal translator")

Use tertran-langs to get a table with all language codes :D

![Display of table with language codes](images/tertran_basic_langs.png "Display of table with language codes")

## How it works?

It's simple, works by requesting a translation from the google translate API.

_Example:_

```py
  api_url = "https://translate.googleapis.com/translate_a/single?client=gtx&sl={}&tl={}&dt=t&q={}"

  r = requests.get(api_url.format(source_lang, target_lang, input_text))

```

Feel free to add new features if you want, but maybe my code is a bad base to work on, I'm inexperienced in this
