Metadata-Version: 1.1
Name: gengo
Version: 0.1.10
Summary: Official Python library for interfacing with the Gengo API.
Home-page: https://github.com/gengo/gengo-python
Author: Gengo
Author-email: api@gengo.com
License: LGPL License
Description: [![Build Status](https://secure.travis-ci.org/gengo/gengo-python.png)](http://travis-ci.org/gengo/gengo-python)
        
        Gengo Python Library (for the [Gengo API](http://gengo.com/api/))
        ======================================================================================================================================================
        Translating your tools and products helps people all over the world access them; this is, of course, a
        somewhat tricky problem to solve. **[Gengo](http://gengo.com/)** is a service that offers human-translation
        (which is often of higher quality than machine translation), and an API to manage sending in work and watching
        jobs. This is a Python interface to make using the API simpler.
        
        Installation & Requirements
        ------------------------------------------------------------------------------------------------------------------------------------------------------
        Installing this library using pip is very simple:
        
            pip install gengo
        
        Otherwise, you can install from source by getting the repo:
        
            git clone git://github.com/gengo/gengo-python.git
        
        And then installing the library:
        
            python setup.py install
        
        This will also install the `requests` package. If you're running on a version of Python prior to 2.6, you'll need to install simplejson as well:
        
            pip install simplejson
        
        
        Tests - Running Them, etc
        ------------------------------------------------------------------------------------------------------------------------------------------------------
        Gengo has a full suite of unit tests. To run them, export your public and private keys in the shell like so:
        
        ```shell
        export GENGO_PUBKEY='your public key here'
        export GENGO_PRIVKEY='your private key here'
        ```
        
        Then grab the source, and from the parent directory run the tests like so:
        
            python setup.py test
        
        Note that some of the tests rely on some deferred actions so there are timeouts (sleep) which you might have to adjust.
        
        To run a single test, such as TestTranslationJobFlowFileUpload:
        
            python -m unittest -v gengo.tests.TestTranslationJobFlowFileUpload
        
        
        Question, Comments, Complaints, Praise?
        ------------------------------------------------------------------------------------------------------------------------------------------------------
        If you have questions or comments and would like to reach us directly, please feel free to do so at the following outlets. We love hearing from
        developers!
        
        * Email: api [at] gengo dot com
        * Twitter: [@gengoit](https://twitter.com/gengoit)
        * IRC: [#gengo](irc://irc.freenode.net/gengo)
        
        If you come across any issues, please file them on the [Github project issue tracker](https://github.com/gengo/gengo-python/issues). Thanks!
        
        
        Documentation
        ------------------------------------------------------------------------------------------------------------------------------------------------------
        Full documentation can be found [here](http://developers.gengo.com), but anyone should be able to get a working script with the following:
        
        ```python
        from gengo import Gengo
        
        gengo = Gengo(
            public_key='your_public_key',
            private_key='your_private_key',
            sandbox=True,
        )
        
        print gengo.getAccountBalance()
        ```
        
        All function definitions can be found inside gengo/mockdb.py as a dictionary: the key of the dictionary entry is the function name, and the parameters
        are exactly the same as specified in the [Gengo API docs](http://developers.gengo.com).
        
Keywords: gengo translation language api
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet
