Metadata-Version: 2.1
Name: docs-translate
Version: 0.1.4
Summary: CLI tool to translate markdown and reStructuredText files
Home-page: https://github.com/gs-kikim/docs-trans-app
License: MIT
Author: kyeongin kim
Author-email: kikim@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Documentation
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Dist: google-cloud-translate (>=2.0.1,<3.0.0)
Requires-Dist: langdetect (>=1.0.8,<2.0.0)
Requires-Dist: loguru (>=0.5.3,<0.6.0)
Requires-Dist: requests (>=2.24.0,<3.0.0)
Requires-Dist: translators (>=4.7.2,<5.0.0)
Project-URL: Repository, https://github.com/gs-kikim/docs-trans-app
Description-Content-Type: text/markdown

# Docs Translate

CLI tool to translate `.md` and `.rst` files from English to Korea and back.

Can use Yandex Translation API and Google Cloud translation.

## Installation

Install project:

```bash
$ pip install docs-translate
```

## Settings file

You can store your default settings in `.json` file.

Settings file content example:

```.json
{
  "target_dir":"D:\\{language_convert_dir}",
  "source_lang": "ko",
  "target_lang": "en",
  "service_name": "Google_v2",
}
```

If you set config file, you should specify it with `-c CONFIG_PATH` argument!

## Usage

```bash
$ docs-translate [-h] [-c CONFIG_PATH]
               [-s {Google,Google_v2}] [-S] [-T]
               [-path {source_path}] [-d {target_dir}]
```

If you set config file, you can override any of settings by arguments

### Positional arguments:
* `path` Path to folder to process. If not set, uses current folder
* `-d TARGET_DIR, --target_dir TARGET_DIR`, If not set, the target_dir in config.json is set

### Optional arguments:
* `-h, --help`, show this help message and exit
* `-c CONFIG_PATH, --config_path CONFIG_PATH`, Path to config_file
* `-s {Yandex,Google,Bing,Deepl}, --service_name {Yandex,Google,Bing,Deepl}`, Translating service
* `-S SOURCE_LANG, --source_lang SOURCE_LANG`, Source language code
* `-T TARGET_LANG, --target_lang TARGET_LANG`, Target language code

### Translation services:
Now used `Yandex`, `Google`, `Bing`, `Deepl`, `Google_v2`

Some of them can be not working, try it and find the most suitable for you  

`Google --> It's free, but the translation isn't good.`  
`Google_v2 --> need to google Cloud Translation API key.` 
