textra-api-wrapper 0.1.0

Add your description here

textra-api-wrapper

本APIラッパーは、みんなの自動翻訳＠TexTra®を利用してテキスト翻訳を行うためのPythonラッパーです。

特徴

• 簡単にAPIを利用して翻訳を実行できます。
• Wikipediaやオープンソースソフトウェアのドキュメントの翻訳に適しています。

注意事項

• 本APIラッパーは「みんなの自動翻訳＠TexTra®」の利用規約に基づき、商用目的での利用を禁止しています。
• 不適切な利用が発見された場合、APIの利用が制限されることがあります。
• 利用回数に上限が設けられる場合があります。
• サービス提供期間は保証されていません。
• 入力されたテキストや用語はNICTのサーバーに記録されることがあります。個人情報や機密情報を入力しないようお願いします。

インストール

pip install textra-api-wrapper

Usage

環境変数の設定

利用の前に以下の環境変数を設定してください。

• TEXTRA_LOGIN_ID: ログインID
• TEXTRA_API_KEY: API_KEY
• TEXTRA_API_SECRET: API_SECRET

ターミナルから設定する例を示します。

export TEXTRA_LOGIN_ID='your_login_id'
export TEXTRA_API_KEY='your_api_key'
export TEXTRA_API_SECRET='your_api_secret'

利用中のOSやシェルによって設定方法は異なりますのでご注意ください。

使用例

テストコードをご参照ください。

from textra_api_wrapper import APIClient


def test_client():
    client = APIClient()
    text = "Hello everyone. My name is ｟John.｠"
    res = client.translate(text)

    expected = "皆さんこんにちは、John.と申します。"
    assert res.text == expected
    assert res.original_text == text
    assert res.information["text-s"] == text
    assert res.information["text-t"] == expected
    assert (
        res.request_url
        == "https://mt-auto-minhon-mlt.ucri.jgn-x.jp/api/mt/generalNT_en_ja/"
    )

• APIClient()により生成されるインスタンスは、英語から日本語への翻訳となります。
• 翻訳不要記号で囲むことで原文をそのまま出力します。例: ｟John.｠
• 言語の指定はAPIClient(source_lang="ja", target_lang="en")などとします。

def test_ja_to_en():
    client = APIClient(source_lang="ja", target_lang="en")
    text = "こんにちは、皆さん。私の名前は｟タロー｠です"
    res = client.translate(text)

    expected = "Hi everyone. My name is タロー."
    assert res.text == expected
    assert res.original_text == text
    assert (
        res.request_url
        == "https://mt-auto-minhon-mlt.ucri.jgn-x.jp/api/mt/generalNT_ja_en/"
    )

License

本APIラッパーはMITライセンスにより提供されますが、利用にはみんなの自動翻訳＠TexTra®の利用規約に従う必要がありますのでご注意ください。