semvec/pypi-packages huggingface dataset:
deepl-cli 2.2.0
DeepL Translator CLI without API Key
License: MIT
Requires Python: <4,>=3.10
Keywords: cli, deepl, translate

# deepl-cli

[![Release Package](
  <https://github.com/eggplants/deepl-cli/workflows/Release%20Package/badge.svg>
  )](
  <https://github.com/eggplants/deepl-cli/actions/workflows/release.yml>
) [![PyPI version](
  <https://badge.fury.io/py/deepl-cli.svg>
  )](
  <https://badge.fury.io/py/deepl-cli>
) [![Code Coverage](
  <https://qlty.sh/badges/bafc68a7-d3c7-4f3f-b09b-b86739801231/test_coverage.svg>
  )](
  <https://qlty.sh/gh/eggplants/projects/deepl-cli>
) [![CI](
  <https://github.com/eggplants/deepl-cli/actions/workflows/ci.yml/badge.svg>
  )](
  <https://github.com/eggplants/deepl-cli/actions/workflows/test.yml>
) [![Maintainability](
  <https://qlty.sh/badges/bafc68a7-d3c7-4f3f-b09b-b86739801231/maintainability.svg>
  )](
  <https://qlty.sh/gh/eggplants/projects/deepl-cli>
)

![image](https://user-images.githubusercontent.com/42153744/159145088-752decf7-8736-44c3-86aa-37fd0cee83df.png)

- [DeepL Translator](https://www.deepl.com/translator) CLI using [playwright-python](https://github.com/microsoft/playwright-python)

Note: *This project works without DeepL API key. With DeepL API, use [DeepLcom/deepl-python](https://github.com/DeepLcom/deepl-python)*

## Install

```bash
pip install deepl-cli
```

## Usage

### CLI

```bash
deepl -F en -T ja -s <<<'This tool is useful for me.'
# このツールは私にとって便利だ。
deepl -F ja -T en -s <<<'このツールは私にとって便利だ。'
# This tool is useful for me.

curl https://example.com | sed -nr '/^<body>/,/<\/body>/s/<[^>]+>//gp' | tr -d \\n > txt
deepl -f txt -F en -T ja
# 例文ドメイン このドメインは、文書の例文に使用するためのものです。事前の調整や許可を得ることなく、このドメインを文献で使用することができます。   詳細はこちら
```

```shellsession
$ deepl -h
usage: deepl [-h] (-f PATH | -s) -F FR -T TO [-t MS] [-v] [-V]

DeepL Translator CLI without API Key

options:
  -h, --help        show this help message and exit
  -f, --file PATH   source text file to translate (default: None)
  -s, --stdin       read source text from stdin (default: False)
  -F, --fr FR       input language (default: None)
  -T, --to TO       output language (default: None)
  -t, --timeout MS  timeout interval (default: 5000)
  -v, --verbose     make output verbose (default: False)
  -V, --version     show program's version number and exit

valid languages of `-F` / --fr`:
{'cs', 'fr', 'ru', 'hu', 'zh', 'da', 'nl', 'es', 'lv', 'nb', 'de', 'ko', 'it', 'pt', 'pl', 'et', 'ar', 'el', 'en', 'id', 'sv', 'ro', 'ja', 'uk', 'bg', 'sk', 'fi', 'tr', 'sl', 'lt'}

valid languages of `-T` / `--to`:
{'cs', 'fr', 'ru', 'hu', 'zh', 'da', 'nl', 'en-gb', 'es', 'lv', 'nb', 'de', 'ko', 'it', 'pt', 'zh-hans', 'pl', 'et', 'pt-br', 'ar', 'el', 'en', 'id', 'sv', 'ro', 'ja', 'uk', 'bg', 'en-us', 'sk', 'zh-hant', 'pt-pt', 'fi', 'tr', 'sl', 'lt'}
```

### Package

```python
from deepl import DeepLCLI

deepl = DeepLCLI("en", "ja")
deepl.translate("hello") #=> "こんにちわ"
```

If you use with asyncio, Use `DeepLCLI.translate_async`. See [examples/async.py](https://github.com/eggplants/deepl-cli/blob/master/examples/async.py).

## License

MIT
nextcloud-cookbook-api 0.1.0
Python API client for nextcloud cookbook app API
License: MIT
Requires Python: >=3.10

# Nextcloud cookbook API

Python API client for nextcloud cookbook app API

--- 

### Table of contents

1. [About](#about)
2. [Installation](#installation)
    1. [Installation from pip](#installation-from-pip)
    2. [Installation from source](#installation-from-source)
3. [Usage](#usage)
4. [License](#license)

## About

This is a Python API client for the Nextcloud Cookbook app API. It allows you to interact with your Nextcloud Cookbook
instance programmatically, enabling you to manage recipes, ingredients, and other related data.

## Installation

### Installation from pip

Install the latest version of the API client from pip:

```commandline
pip install nextcloud-cookbook-api
```

You can also very easily update to a newer version:

```commandline
pip install -U nextcloud-cookbook-api
```

### Installation from source

You can also install the latest version of the API client directly from source:

```commandline
git clone https://github.com/infinityofspace/nextcloud_cookbook_api.git
cd nextcloud_cookbook_api
pip install .
```

## Usage

You can find the full documentation for the API
client [here](https://infinityofspace.github.io/nextcloud_cookbook_api/).

## Development

### Setup environment

First get the source code:

```commandline
git clone https://github.com/infinityofspace/nextcloud_cookbook_api.git
cd nextcloud_cookbook_api
```

Now create a virtual environment, activate it and install all dependencies with the following commands:

```commandline
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```

Now you can start developing.

### Contributing

Feel free to contribute to this project by creating a pull request. Before you create a pull request, make sure that you
code meets the following requirements (you can use the specified commands to check/fulfill the requirements):

1. check unit tests: `python -m unittest tests/**/*.py`
2. format the code: `ruff format`
3. check linting errors: `ruff check`

### Tests

You can run the tests with the following command:

```commandline
python -m unittest tests/*.py
```

### Documentation

To build the documentation, you can use the following commands:

```commandline
sphinx-apidoc -f -o docs/source nextcloud_cookbook_api
cd docs && make html
```

## License

This project is licensed under the MIT License - see the [LICENSE](License) file for details.