はじめに

2023年Crystalアドベントカレンダーです。これまでに作ったツールでQiita記事にしていなかった DeepL CLI を紹介します。

DeepL CLI

DeepL APIを使用してテキストを翻訳するためのシンプルなコマンドラインツールです。

準備

まず、DeepLから有効なAPIキーを取得し、それを環境変数として設定します。(無料版でも十分に使えます）

export DEEPL_API_KEY=あなたのapiキー

インストール

最新のソースコードをダウンロードし、以下のコマンドを実行します。

cd deepl-cli
shards build --release

有料版の DeepL API Pro を契約している人は下記のように環境変数を指定してエンドポイントを変更してください。（この環境変数はコンパイル時に評価されるので、実行時に指定しても効果がないことにご注意ください。）

DEEPL_API_PRO=1 shards build --release # DeepL API Pro用

コンパイルされたバイナリファイルが bin フォルダに作成されます。

Linuxユーザーで、deepl-cli を使いたいだけの人は、muslで静的にコンパイルしたバイナリをGitHub Releaseから入手することもできます（DeepL API Freeのみ）

プロキシ設定（オプション）

プロキシ環境下でも動作します。

export HTTP_PROXY=http://[IP]:[port]
export HTTPS_PROXY=https://[IP]:[port]

使用方法

DeepL Translator CLIを使用するには、deepl コマンドに続けて渡したい引数を実行します。

Usage: deepl [arguments]
    doc                              Upload and translate a document
    -i, --input [TEXT]               Input text
    -f, --from [LANG]                Source language [AUTO]
    -t, --to [LANG]                  Target language [EN]
    -u, --usage                      Check Usage and Limits
    -v, --version                    Show version
    -h, --help                       Show this help

例えば、以下のように使用します：

$ ./bin/deepl deepl -f en -t ja -i "I am a cat"
私は猫である

これで、"I am a cat." が日本語に翻訳されます。
コマンドラインツールなので標準入力を取ることもできます。

echo "I am a cat" | deepl -t ja
# 私は猫である

複数行を入力したいときは、この標準入力の機能を使えばOKです。

deepl -f ja
吾輩は猫である。
名前はまだない。

入力し終わったら CTRL + D を入力してEOFを送信します。

I am a cat.
I don't have a name yet.

利用できる言語のリストを表示したいときは、deepl -f もしくは deepl -t を入力します。

deepl -f | head

- BG     Bulgarian
- CS     Czech
- DA     Danish
- DE     German
- EL     Greek
- EN     English
- ES     Spanish
- ET     Estonian
- FI     Finnish
- FR     French

deepl -t | tail

- PT-BR  Portuguese (Brazilian)	true
- PT-PT  Portuguese (European)	true
- RO     Romanian            	false
- RU     Russian             	true
- SK     Slovak              	false
- SL     Slovenian           	false
- SV     Swedish             	false
- TR     Turkish             	false
- UK     Ukrainian           	false
- ZH     Chinese (simplified)	false

また、deepl --usage で、無料枠をどの程度使ったか確認することもできます。

deepl --usage

https://api-free.deepl.com/v2
character_count: 84
character_limit: 500000

おわりに

基本機能のみの簡単ツールですが便利に使うことができるかと思います。

ドキュメントの翻訳や、グロサリーなども実装されていないので機能拡張の余地はあります。PRを送ってくれたり、このツールをフォークして改良して独自のツールとしてメンテナンスしていただくのも大歓迎です。

この記事は以上です。