Translation-Gummy

Translation Gummy is a magical gadget which enables user to be able to speak and understand other languages.


Keywords
python, journal, translation, pypi, chromedriver, english-learning, deepl
License
MIT
Install
pip install Translation-Gummy==3.9.0

Documentation

Translation-Gummy

header PyPI version GitHub version Execute Translation-Gummy Upload to PyPI license Open in Colab Docker file Documentation twitter badge Qiita badge1 Qiita badge2 website Sponsor Add to Slack

Translation Gummy is a magical gadget which enables user to be able to speak and understand other languages. ※ Supported journals are listed here.

Installation

  1. Install Translation-Gummy (There are two ways to install):
    • Install from PyPI (recommended):
      $ sudo pip install Translation-Gummy
    • Alternatively: install Translation-Gummy from the GitHub source:
      $ git clone https://github.com/iwasakishuto/Translation-Gummy.git
      # If you want to use the latest version (under development)
      $ git clone -b develop https://github.com/iwasakishuto/Translation-Gummy.git
      $ cd Translation-Gummy
      $ sudo python setup.py install
  2. Install wkhtmltopdf
    • Debian/Ubuntu:
      $ sudo apt-get install wkhtmltopdf
    • macOS:
      $ brew install homebrew/cask/wkhtmltopdf
  3. Install driver for selenium: Selenium requires a driver to interface with the chosen browser, so please visit the documentation to install it.
    # Example: Chrome
    # visit "chrome://settings/help" to check your chrome version.
    # visit "https://chromedriver.chromium.org/downloads" to check <Suitable.Driver.Version> for your chrome.
    $ wget https://chromedriver.storage.googleapis.com/<Suitable.Driver.Version>/chromedriver_mac64.zip
    $ unzip chromedriver_mac64.zip
    $ mv chromedriver /usr/local/bin/chromedriver
    $ chmod +x /usr/local/bin/chromedriver

※ See Docker file or Open in Colab for more specific example.

Pyenv + Poetry

  • Pyenv is a python installation manager.
  • Poetry is a packaging and dependency manager.

I recommend you to use these tools to avoid the chaos of the python environment. See other sites for how to install these tools.

$ pyenv install 3.8.9
$ pyenv local 3.8.9
$ python -V
Python 3.8.9
$ poetry install
$ poetry run gummy-translate "This is a pen." --from-lang en --to-lang ja
$ poetry run gummy-journal "https://www.nature.com/articles/ncb0800_500"

Quick example

  • example notebooks
  • Translation:
    • Python Module:
    >>> from gummy import TranslationGummy
    >>> model = TranslationGummy(translator="deepl", from_lang="en", to_lang="ja")
    [success] local driver can be built.
    [failure] remote driver can't be built.
    DRIVER_TYPE: local
    >>> model.en2ja("This is a pen.")
    DeepLTranslator (query1) 02/30[#-------------------]  6.67% - 2.144[s]   translated: これはペン
    'これはペンです。'
    • Command line:
    $ gummy-translate "This is a pen." --from-lang en --to-lang ja
    [success] local driver can be built.
    [failure] remote driver can't be built.
    DRIVER_TYPE: local
    DeepLTranslator (query1) 02/30[#-------------------]  6.67% - 2.185[s]   translated: これはペン
    これはペンです。
    • Output gummy-translate
  • Create PDF (with translation)
    • Python Module:
    >>> from gummy import TranslationGummy
    >>> model = TranslationGummy(gateway="utokyo", translator="deepl")
    >>> pdfpath = model.toPDF(url="https://www.nature.com/articles/ncb0800_500", delete_html=True)
    • Command line:
    $ gummy-journal "https://www.nature.com/articles/ncb0800_500"
    • Output gummy-journal