Gengo Clojure Library (for the Gengo API)

This clj library provides access to the Gengo API for ordering and managing your translations.

Building

With Leiningen installed:

lein deps && lein jar

Installing

The gengo-clj library can be installed as a dependency from Clojars

    [gengoclj "0.1.0-SNAPSHOT"]

Or gradle

compile "gengoclj:gengoclj:0.1.0-SNAPSHOT"

Or maven

<dependency>
  <groupId>gengoclj</groupId>
  <artifactId>gengoclj</artifactId>
  <version>0.1.0-SNAPSHOT</version>
</dependency>

Usage

(use 'gengoclj.gengo)

(def is-sandbox? true)

;; get jobs by order id
(with-gengo ["gengo-key" "gengo-secret" is-sandbox?]
  (get-order-jobs 123456789))

;;=> {:opstat "ok", :response {:order {:total_credits "0.15", :jobs_pending [], :total_jobs "2", :jobs_available ["123" "456"],:total_units "3", :jobs_queued "0", :currency "USD", :order_id "123456789", :as_group 1, :jobs_revising [], :jobs_reviewable [], :jobs_approved []}}}

;; send new translations
(with-gengo ["gengo-key" "gengo-secret" is-sandbox?]
  (let [job1 (struct job "slug1" "content1" "en" "es" "standard")
        job2 (struct job "slug2" "content2" "en" "es" "standard")]
    (post-translation-jobs '(job1 job2) true)))

;;=> {:opstat "ok", :response {:group_id "1234", :order_id "5678", :job_count 2, :credits_used "0.20", :currency "USD"}}

with-gengo macro is going to give you the wrapper for running any command you need to within gengo-clj.

Here is the list of supported functions:

• get-account-stats []
• get-account-balance []
• get-account-preferred-translators []
• post-translation-jobs [jobs as-group?]
• revise-translation-job [job-id comment]
• approve-translation-job [job-id rating translator-comments gengo-comments is-public?]
• reject-translation-job [job-id reason comments captcha requeue?]
• get-translation-job [job-id]
• get-translation-jobs [& [job-ids]]
• post-translation-job-comment [job-id comments]
• get-translation-job-comments [job-id]
• get-translation-job-feedback [job-id]
• get-translation-job-revisions [job-id]
• get-translation-job-revision [job-id revision-id]
• delete-translation-job [job-id]
• get-service-languages []
• get-service-language-pairs [&[source-lang-code]]
• determine-translation-cost [jobs]
• get-order-jobs [order-id]

There's also a struct for a job since it's a common argument:

    (defstruct job :slug :body_src :lc_src :lc_tgt :tier)

It contains only the required parts, but other options include:

:force :comment :use_preferred :callback_url :auto_approve :custom_data :position :glossary_id :max_char

Otherwise, here is the Official Documentation

Questions or Comments

• email: thoersch@gmail.com

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

Documentation

Check out gengo-clj docs

or

Check out the full Gengo API Documentation.

License

Copyright © 2014 Tyler Hoersch

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.