Skip to main content

Official Python library for interfacing with the Gengo API.

Project 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).

Project details


Release history Release notifications

History Node

1.0.0

History Node

0.1.31

History Node

0.1.30

History Node

0.1.29

History Node

0.1.28

History Node

0.1.26

History Node

0.1.25

History Node

0.1.24

History Node

0.1.23

History Node

0.1.22

History Node

0.1.21

History Node

0.1.19

History Node

0.1.18

History Node

0.1.17

History Node

0.1.16

History Node

0.1.15

History Node

0.1.14

History Node

0.1.13

This version
History Node

0.1.12

History Node

0.1.11

History Node

0.1.10

History Node

0.1.9

History Node

0.1.8

History Node

0.1.6

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
gengo-0.1.12.tar.gz (13.0 kB) Copy SHA256 hash SHA256 Source None Nov 8, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page