Skip to main content

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

Project description

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
# For Windows
$ poetry install -E windows
# For the other platform
$ 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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Translation-Gummy-4.0.1.tar.gz (73.5 kB view hashes)

Uploaded Source

Built Distribution

Translation_Gummy-4.0.1-py3-none-any.whl (84.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page