Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gengo/gengo-python

A Python library to interface with the Gengo API for translation.
https://github.com/gengo/gengo-python

gengo python

Last synced: 13 days ago
JSON representation

A Python library to interface with the Gengo API for translation.

Awesome Lists containing this project

README

        

.. image:: https://travis-ci.org/gengo/gengo-python.svg?branch=master
:target: https://travis-ci.org/gengo/gengo-python

Gengo Python Library (for the `Gengo 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 `_ 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.

`CHANGELOG is here `_

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

Tests - Running Them, etc
-------------------------
Gengo has a full suite of unit tests. To run them, make sure you have the `mock` library installed, and then simply run:

::

flake8 gengo

If you wish 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
* IRC: `#gengo `_

If you come across any issues, please file them on the `Github project issue tracker `_. Thanks!

Documentation
-------------
Full documentation can be found `here `_, but anyone should be able to get a working script with the following:

.. code-block:: 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 `_.