tt-terminal-translator


Namett-terminal-translator JSON
Version 0.2.1 PyPI version JSON
download
home_pageNone
SummaryTerminal Translator is a translation CLI that uses the Google Cloud API.
upload_time2024-07-13 15:40:40
maintainerNone
docs_urlNone
authorgbPagano
requires_python<4.0,>=3.10
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Terminal Translator 
[![Documentation Status](https://readthedocs.org/projects/terminal-translator/badge/?version=latest)](https://terminal-translator.readthedocs.io/en/latest/?badge=latest)

Terminal Translator is a translation CLI that uses the [Google Cloud API](https://cloud.google.com/translate).

## Documentation

See the [full documentation](https://terminal-translator.readthedocs.io/en/latest/)

## Installation

Installation is very simple, just run the following command in the terminal:

```bash
pip install tt-terminal-translator
```

## Basic Usage

The CLI consists of two commands, `tt` and `tt-configure`.

### tt

`tt` is the main CLI command.

**Usage**

Basically we call the command passing the text to be translated

By default the text will be translated to `en-us`

```bash
tt ola mundo
```
![tt](./docs/assets/images/tt.png)

We can also inform the target language for the translation

```bash
tt ola mundo --target es  # spanish
```
![tt-2](./docs/assets/images/tt-2.png)

There is also a parameter to translate directly into Portuguese

```bash
tt hello world -p
```
![tt-3](./docs/assets/images/tt-3.png)


In addition there is a parameter to copy the output directly to the clipboard

```bash
tt -c hola mundo
```
![tt-4](./docs/assets/images/tt-4.png)

For more information use the parameter `--help`

```bash
tt --help
```

![tt-5](./docs/assets/images/tt-5.png)



### tt-configure

`tt-configure` is only for the initial configuration of the Google Cloud API credentials, as seen in the [settings section](/#configuration).

**Usage**

Basically we call the command passing two arguments, first the project-id followed by the path of the credentials Json file.

```bash
tt-configure <project-id> <google-api-credentials>
```

For quick help use the `--help` argument.


```bash
tt-configure --help
```
![tt-configure](./docs/assets/images/tt-configure.png)


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "tt-terminal-translator",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.10",
    "maintainer_email": null,
    "keywords": null,
    "author": "gbPagano",
    "author_email": "guilhermebpagano@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/8b/dc/a294fa5ae6cd51ce5faca589b7fd1ce375e7a26c88056ddd8268685329ad/tt_terminal_translator-0.2.1.tar.gz",
    "platform": null,
    "description": "# Terminal Translator \n[![Documentation Status](https://readthedocs.org/projects/terminal-translator/badge/?version=latest)](https://terminal-translator.readthedocs.io/en/latest/?badge=latest)\n\nTerminal Translator is a translation CLI that uses the [Google Cloud API](https://cloud.google.com/translate).\n\n## Documentation\n\nSee the [full documentation](https://terminal-translator.readthedocs.io/en/latest/)\n\n## Installation\n\nInstallation is very simple, just run the following command in the terminal:\n\n```bash\npip install tt-terminal-translator\n```\n\n## Basic Usage\n\nThe CLI consists of two commands, `tt` and `tt-configure`.\n\n### tt\n\n`tt` is the main CLI command.\n\n**Usage**\n\nBasically we call the command passing the text to be translated\n\nBy default the text will be translated to `en-us`\n\n```bash\ntt ola mundo\n```\n![tt](./docs/assets/images/tt.png)\n\nWe can also inform the target language for the translation\n\n```bash\ntt ola mundo --target es  # spanish\n```\n![tt-2](./docs/assets/images/tt-2.png)\n\nThere is also a parameter to translate directly into Portuguese\n\n```bash\ntt hello world -p\n```\n![tt-3](./docs/assets/images/tt-3.png)\n\n\nIn addition there is a parameter to copy the output directly to the clipboard\n\n```bash\ntt -c hola mundo\n```\n![tt-4](./docs/assets/images/tt-4.png)\n\nFor more information use the parameter `--help`\n\n```bash\ntt --help\n```\n\n![tt-5](./docs/assets/images/tt-5.png)\n\n\n\n### tt-configure\n\n`tt-configure` is only for the initial configuration of the Google Cloud API credentials, as seen in the [settings section](/#configuration).\n\n**Usage**\n\nBasically we call the command passing two arguments, first the project-id followed by the path of the credentials Json file.\n\n```bash\ntt-configure <project-id> <google-api-credentials>\n```\n\nFor quick help use the `--help` argument.\n\n\n```bash\ntt-configure --help\n```\n![tt-configure](./docs/assets/images/tt-configure.png)\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Terminal Translator is a translation CLI that uses the Google Cloud API. ",
    "version": "0.2.1",
    "project_urls": {
        "Code": "https://github.com/gbPagano/terminal-translator",
        "Documentation": "https://terminal-translator.readthedocs.io/en/latest/"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f596caaf132eec50cae9d8c47b2155060f16eaa6fe9fd4dca704194056e8a91f",
                "md5": "87208d3864ed7c472151453b88d64df0",
                "sha256": "53c30455355fc80b37cd6216f4af15f4c30f9acfa820550c71abca8418dd0202"
            },
            "downloads": -1,
            "filename": "tt_terminal_translator-0.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "87208d3864ed7c472151453b88d64df0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.10",
            "size": 5671,
            "upload_time": "2024-07-13T15:40:38",
            "upload_time_iso_8601": "2024-07-13T15:40:38.530431Z",
            "url": "https://files.pythonhosted.org/packages/f5/96/caaf132eec50cae9d8c47b2155060f16eaa6fe9fd4dca704194056e8a91f/tt_terminal_translator-0.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8bdca294fa5ae6cd51ce5faca589b7fd1ce375e7a26c88056ddd8268685329ad",
                "md5": "2c9f6ebc24f6e30ebb63ff5865457441",
                "sha256": "1bd92fca40b2c7fa0ee34991ab72e7c38fcf5d8f5cb9351a20f4e0a7723b491c"
            },
            "downloads": -1,
            "filename": "tt_terminal_translator-0.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "2c9f6ebc24f6e30ebb63ff5865457441",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.10",
            "size": 4576,
            "upload_time": "2024-07-13T15:40:40",
            "upload_time_iso_8601": "2024-07-13T15:40:40.138555Z",
            "url": "https://files.pythonhosted.org/packages/8b/dc/a294fa5ae6cd51ce5faca589b7fd1ce375e7a26c88056ddd8268685329ad/tt_terminal_translator-0.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-13 15:40:40",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "gbPagano",
    "github_project": "terminal-translator",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "tt-terminal-translator"
}
        
Elapsed time: 0.65924s