[Smartling Translation API](https://docs.smartling.com/display/docs/Smartling+Translation+API)
=================

This repository contains the Python sdk for accessing the Smartling Translation API.

The Smartling Translation API allows developers to seamlessly internationalize their website by automating the translation and integration of their site content.
Developers can upload resource files and download the translated file(s) in a locale of their choosing. There are options to allow for professional translation, community translation and machine translation.

For a full description of the Smartling Translation API, please read the docs at: https://docs.smartling.com/display/docs/Smartling+Translation+API


Quick start
-----------

Clone the repo, `git clone git@github.com:Smartling/api-sdk-python.git`.
Use example or tests to see how to work with SDK.
Note that Smartling creadentials should be set for SDK to work
Both tests and example will raise exception if credentials are not set.

Use example in examples directory, or more full coverage of every api call in tests/testFapiV2.py:

(Note that nosetests package is requeired for tests)
cd tests
nosetests testFapiV2.py

But it can be also tested directly like:
    
    from testFapiV2 import testFapiV2

    t = testFapiV2()
    t.setUp()
    
    t.testGetTranslations()
    t.testGetOriginal()
    t.testGetAllLocalesZip()
    t.testGetAllLocalesCsv()
    t.testGetMultipleLocalesAsZip()
    t.testFileListTypes()
    t.testGet()
    t.testFileList()
    t.testProjects()
    t.testProjectDetails()
    t.testStatusLocale()
    t.testStatus()
    t.testFileRename()
    t.testLastModified()
    t.testLastModifiedAll()
    t.testImport()
    t.testListAuthorizedLocales()
    t.testUnauthorize()
    t.testAuthorize()
        
    t.tearDown()

Versioning
----------

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, the File Translation API SDK will be maintained under the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the follow format:

`<major>.<minor>.<patch>`

And constructed with the following guidelines:

* Breaking backward compatibility bumps the major
* New additions without breaking backward compatibility bumps the minor
* Bug fixes and misc changes bump the patch

For more information on SemVer, please visit http://semver.org/.


Bug tracker
-----------

Have a bug? Please create an issue here on GitHub!

https://github.com/Smartling/api-sdk-python/issues


Authors
-------

Anatoly Artamonov
* https://github.com/anatolija
* aartamonov@smartling.com

Alex Koval
* https://github.com/junky
* akoval@smartling.com

Greg Jones
* http://github.com/jones-smartling
* gjones@smartling.com


Copyright and license
---------------------

Copyright 2012 Smartling, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this work except in compliance with the License.
You may obtain a copy of the License in the LICENSE file, or at:

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.