Metadata-Version: 1.0
Name: pygtaw
Version: 0.0.7
Summary: A tiny Google Translate API wrapper written in Python.
Home-page: http://github.com/stephsamson/pygtaw
Author: Steph Samson
Author-email: sdvsamson@gmail.com
License: MIT
Description: pygtaw
        ======
        
        A tiny Google Translate API wrapper written in Python. An API key is needed to use this. More information on obtaining the API key can be found on the `Google Translate API site`_.
        
        .. _Google Translate API site: https://cloud.google.com/translate/.
        
        The full list of `supported languages`_.
        
        .. _supported languages: https://cloud.google.com/translate/v2/using_rest#language-params.
        
        
        Usage
        -----
        To install: ``pip install pygtaw``.
        
        Identify your api key and make a new Client object.
        
        .. code-block:: python
        
            >>> from pygtaw import wrapper
            >>> api_key = 'ENTER_API_KEY'
            >>> client = wrapper.Client(api_key)
        
        To make the translation request:
        
        .. code-block:: python
        
            >>> query = 'Hello, world!'
            >>> target = 'Korean'
            >>> source = 'English'
            >>> translation = client.translate(query, target, source)
            >>> 
            >>> print translation.translated_text
            안녕하세요
        
        You can send a translation request without a source as well--the Google Translate API can detect the source language:
        
        .. code-block:: python
        
            >>> translation = client.translate('Hello', target='Spanish')
            >>> print translation.translated_text
            Hola
            >>> print translation.detected_source_language
            English
        
        
        Tests
        -----
        Currently, tests are made by making requests to Google Translate API. To run the tests, make a ``key`` file in the ``tests`` folder and make sure it's added to ``.gitignore``.
        
Keywords: google translate API wrapper
Platform: UNKNOWN
