Metadata-Version: 2.1
Name: md-translate
Version: 2.1.0
Summary: CLI tool to translate markdown files
Home-page: https://github.com/ilyachch/md_docs-trans-app
License: MIT
Author: Ilya Chichak
Author-email: ilyachch@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 4 - Beta
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: 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/ilyachch/md_docs-trans-app
Description-Content-Type: text/markdown

[![codecov](https://codecov.io/gh/ilyachch/md_docs-trans-app/branch/master/graph/badge.svg)](https://codecov.io/gh/ilyachch/md_docs-trans-app)
# MD Translate

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

Can use Yandex Translation API and Google Cloud translation.

## Installation

Install project:

```bash
$ pip install md-translate
```

## Settings file

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

Settings file content example:
```.json
{
  "source_lang": "ru",
  "target_lang": "en",
  "service_name": "Google",
}
```

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

## Usage

```bash
$ md-translate [-h] [-c CONFIG_PATH]
               [-s {Yandex,Google}] [-S] [-T]
               [path]
```

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

### 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`

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