SmartlingApiSdk 3.1.6__py2-none-any.whl

SmartlingApiSdk-3.1.6.dist-info/METADATA

@@ -0,0 +1,14 @@
+Metadata-Version: 2.1
+Name: SmartlingApiSdk
+Version: 3.1.6
+Summary: python library to work with Smartling translation services APIs
+Home-page: UNKNOWN
+Author: Smartling, Inc.
+Author-email: aartamonov@smartling.com
+License: Apache License v2.0
+Keywords: translation localization internationalization
+Platform: UNKNOWN
+
+python SDK to work with Smartling API for computer assisted translation
+
+

SmartlingApiSdk-3.1.6.dist-info/RECORD

@@ -0,0 +1,53 @@
+smartlingApiSdk/ApiResponse.py,sha256=Z3zZOokJnzXSNv3QeSUGKhFDZddKpYNzIcYKywLeeic,2286
+smartlingApiSdk/ApiV2.py,sha256=YURZ7LUAyw6mOPRTwbuG1jmCKw5NZ6oEfQKoKghQDjc,3105
+smartlingApiSdk/AuthClient.py,sha256=2ouzC3LgjZeOtGbbGH7SfAYWOk0xpRz4Wvvvg6XXYTY,2831
+smartlingApiSdk/Constants.py,sha256=IWfAKUKdD0znvKH-YY4HIYhCsHLA07lafqP-s97VwFc,2155
+smartlingApiSdk/Credentials.py,sha256=mn2uIbWCTkwE-pBQFhtgPzsiKAiRUni-VIXY7Wc6uJc,2565
+smartlingApiSdk/FileApiBase.py,sha256=46-n57YNyLEvaolZ1zDUTJmAL6ev0Dg0BXxtz6PRRRo,5046
+smartlingApiSdk/FileApiV2.py,sha256=bKFqSTU7S5egQke2-FSKZDCb6Cznl_NOxLQeTx6wm2c,8855
+smartlingApiSdk/HttpClient.py,sha256=IoFk-pRTU8lE_iDhKSfX_jnuJXn6zQ2-cKXfvcUfdsQ,5982
+smartlingApiSdk/Logger.py,sha256=mjiMsXDm3ScGJi023C62eBByJ8sKMwyXctA3U3DDsz0,1954
+smartlingApiSdk/MultipartPostHandler.py,sha256=uSH8gVF27_8GI_APGqynJ_sCM-Lni1g-a9IWfZ88NF4,4681
+smartlingApiSdk/ObsoleteApiV1.py,sha256=E1mbV_zhSq1AB8UIofhP_EDqVnJarIK4oxFEFKpPkVE,3769
+smartlingApiSdk/ObsoleteSmartlingFileApi.py,sha256=k4VI8DL4lsN5urHX7FYy4SjpORFSq6L4X1yDM8qgE_c,5208
+smartlingApiSdk/ProjectsApiV2.py,sha256=8XBLVVUGQNgQFt05VgbWWI2BZjnPSEHSIdLgCkBX7yA,1970
+smartlingApiSdk/ProxySettings.py,sha256=qcCzasZA09E46XHXfqYOYdlCanzm6OKYW1gfXRs8wzU,1025
+smartlingApiSdk/Settings.py,sha256=x-CN71SEAP1Q3piG3sgKGVywT8ydti4BfahxJEX_-SQ,927
+smartlingApiSdk/SmartlingDirective.py,sha256=5q993mwiKMAa0Jy8OdmHrBnnHklo-hep3z7UgqDQjOo,1191
+smartlingApiSdk/SmartlingFileApiV2.py,sha256=FU1WTEN-LxCLxFptUZRwL4Ipa6dS331dozyL6WhEuzk,9839
+smartlingApiSdk/SmartlingProjectsApiV2.py,sha256=PiuoxW6i_kdXhr3fjc6WkOhh64eA9V46wAHJ7lPVlng,2697
+smartlingApiSdk/UploadData.py,sha256=0LVFGECq4nYQ4M_nZKI1JHhdr6nfbplwAO7_nr_Cegs,1457
+smartlingApiSdk/UrlV2Helper.py,sha256=wFV6U0Y5Y2WG5YLVZa9E-XDPmf5eVG23tt_eupjIk04,3205
+smartlingApiSdk/__init__.py,sha256=qdVmH7eXiL4lQzfaI0FatSD4wSBap5t0sVUh5p0r_x0,743
+smartlingApiSdk/version.py,sha256=2mKIa33NQxUN4rYR5uX6GYH4kZbEcKHS7OWa0Cx-VR4,686
+smartlingApiSdk/api/AccountProjectsApi.py,sha256=b1onXCMpW5h7HZkssdzRg2m1JJVSUqVvgwtWO4s8l10,4752
+smartlingApiSdk/api/ContextApi.py,sha256=odfBimYYN4zxvcAbGePP0btEJlibq57qjrLVfBFMlFE,9896
+smartlingApiSdk/api/EstimatesApi.py,sha256=4B5t4gtNLmR07H-2Hi_S96tGSKrEyWmQVBA_IwGGlMc,8471
+smartlingApiSdk/api/FilesApi.py,sha256=innbMQkl_GLkRGpi7Y97ZzZG_UQP1idzrSsXYvaOa00,15936
+smartlingApiSdk/api/JobBatchesV2Api.py,sha256=rZZvZj5NucQb1HooLG4pQCmQEOygszD54Uewg8nvkQo,6368
+smartlingApiSdk/api/JobsApi.py,sha256=xUZSwI0mCFC_fsF-lNhvyspgPy8ggf_JZ_GlPm3z2Vw,25353
+smartlingApiSdk/api/StringsApi.py,sha256=mInS484yAqI7QFWO8D95JeAlm_6TqK9uQTP9kvnwZC4,4792
+smartlingApiSdk/api/TagsApi.py,sha256=ULvdrovHa-79GH6AWiiGqe-696ddO2OjooD7jAFj_Jk,6151
+smartlingApiSdk/api/__init__.py,sha256=SKWZ9FbAuABhf__YLJJ1Ca9FGKJMl6QcXRx47M-enlo,48
+smartlingApiSdk/example/AccountProjectsExample.py,sha256=YMOmOJ2XHzDuPMb_-v6jJ79fM_m3zcwt9x5asbAuvw4,7185
+smartlingApiSdk/example/ContextExample.py,sha256=nF-n6qo8Tt6GjkWyR9agnYvXI1CoR9tvlWLeWbNTKZM,13247
+smartlingApiSdk/example/EstimatesExample.py,sha256=OF2wK5of-KOCc9pHlf0illPdtvu9F4cka_K4z2Tta4c,11738
+smartlingApiSdk/example/FilesExample.py,sha256=HqbX0NlJcX3DGZk2i2Skd1_Rf19sGMyFJsGMfPUlvm0,21115
+smartlingApiSdk/example/FilesSimpleExample.py,sha256=7rmgAJfVjiaNiz4knmVe7X0EmlJo232AI9lUx9ENxI0,3171
+smartlingApiSdk/example/JobBatchesV2Example.py,sha256=MGfAoZMyDwtXV1TffwRFd4vS2Ye8KlpcucjCrJuyuiY,8143
+smartlingApiSdk/example/JobsExample.py,sha256=w-y87I-3ij8IDPIp9kcjzMiVQ6NTRNAJq7aVHxWXN1w,27326
+smartlingApiSdk/example/MultipleAccountsExample.py,sha256=Twd5Yq9V2_76kK86tZb8E7FOxtgljZ5J2IXoYMlkaLI,2770
+smartlingApiSdk/example/MultipleProjectsExample.py,sha256=6Faa4DqL1RL8zDK8lnmk2yqL84LuZCBU55t5FNYgm40,4647
+smartlingApiSdk/example/StringsExample.py,sha256=GHSQhVG90a4BPSdUstyf5Si8ie9yoLgusvrqjJeGnQQ,9083
+smartlingApiSdk/example/TagsExample.py,sha256=1KkSriVU0CEbbkZtdFox7jH-Uy_cMWi1bQPvOo0j9Ek,8496
+smartlingApiSdk/example/__init__.py,sha256=SKWZ9FbAuABhf__YLJJ1Ca9FGKJMl6QcXRx47M-enlo,48
+smartlingApiSdk/resources/ctx_api_test.png,sha256=QuHjmQp7LQK36XjdSPP7xsnVMab3tmS1WkYyc8Uwvyc,86324
+smartlingApiSdk/resources/java.properties,sha256=rnVIRoE_ZcKPCNRbpyKeP44gAV2pMsYcGv6ZVINB9f4,131
+smartlingApiSdk/resources/javaUTF16.properties,sha256=qdf-viEU2xkzzFW6foepsvtoT1BGGzJfyYP7OMOljRk,442
+smartlingApiSdk/resources/test.csv,sha256=5KiwUBT6oMFg_FtODmVPbLO1bP3BY2j8eNIu4CtW9OU,32
+smartlingApiSdk/resources/test_import.xml,sha256=TM_flmNi8kp4eRI5QONKj-k0F8o29qe0Bp4x_F13V0U,155
+smartlingApiSdk/resources/test_import_es.xml,sha256=Lgw-dZnmvsmM1uS7iSZjwE7eYKbWKf1h5lIdpa4x4sU,152
+SmartlingApiSdk-3.1.6.dist-info/METADATA,sha256=Lo-_WPn_T_HVDLnX0pXjgW90TYdIHBoFjOkdhBireiM,392
+SmartlingApiSdk-3.1.6.dist-info/WHEEL,sha256=1VPi6hfNQaRRNuEdK_3dv9o8COtLGnHWJghhj4CQ28k,92
+SmartlingApiSdk-3.1.6.dist-info/top_level.txt,sha256=e38w7yd0va1Chiw-UZcdu7NkI0jewljDg-OR21eenL0,86
+SmartlingApiSdk-3.1.6.dist-info/RECORD,,

SmartlingApiSdk-3.1.6.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.37.1)
+Root-Is-Purelib: true
+Tag: py2-none-any
+

SmartlingApiSdk-3.1.6.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+smartlingApiSdk
+smartlingApiSdk/api
+smartlingApiSdk/example
+smartlingApiSdk/resources

smartlingApiSdk/ApiResponse.py

@@ -0,0 +1,67 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+
+""" Copyright 2012-2021 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.
+"""
+
+import json
+
+
+class Data:
+    """ provides dictionary items to be object attributes """
+    def __init__(self, dict):
+        self.dict = dict
+
+    def __getattr__(self, key):
+        return self.dict[key]
+
+    def __str__(self):
+        return repr(self.dict)
+
+
+class ApiResponse:
+    """ response object to store parsed json response as python object, it also behaves like string for backward
+        compatibility with previous SDK versions where response was a string """
+    def __init__(self, responseString, statusCode, headers):
+        self.statusCode = statusCode
+        self.responseString = responseString
+        self.responseDict = json.loads(responseString)
+        self.isApiResonse = self.responseDict.get('response', None) and dict == type(self.responseDict['response'])
+        self.headers = headers
+        if self.isApiResonse:
+            self.parseResponse()
+
+    def parseResponse(self):
+        """ parses json and fills object attributes according json attributes """
+
+        for k, v in list(self.responseDict['response'].items()):
+            if k == 'data':
+                self.data = Data(v)
+            else:
+                setattr(self, k, v)
+
+    def __getattr__(self, key):
+        """ provides string object methods to be available for response to behave like a string """
+        if hasattr(self.responseDict, key):
+            return getattr(self.responseDict, key)
+
+        try:
+            return self.__dict__[key]
+        except:
+            raise AttributeError("ApiResponse has no attribute %r" % ( key ))
+
+    def __str__(self):
+        return str(self.responseString)

smartlingApiSdk/ApiV2.py

@@ -0,0 +1,73 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+
+""" Copyright 2012-2021 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.
+"""
+
+# FileApi class implementation
+
+from .AuthClient import AuthClient
+from .Constants import FileTypes
+from .Constants import Params
+from .FileApiBase import FileApiBase
+from .SmartlingDirective import SmartlingDirective
+from .UrlV2Helper import UrlV2Helper
+from .version import version
+
+
+class ApiV2(FileApiBase):
+    """ Api v2 basic functionality """
+    hostProd = 'api.smartling.com'
+    hostStg = 'api.stg.smartling.net'
+    clientUid = "{\"client\":\"smartling-api-sdk-python\",\"version\":\"%s\"}" % version
+
+    def __init__(self, userIdentifier, userSecret, projectId, proxySettings=None, permanentHeaders={}, env='prod'):
+        self.host = self.hostProd
+        self.userIdentifier = userIdentifier
+        if 'stg'==env:
+            self.host = self.hostStg
+        FileApiBase.__init__(self, self.host, userIdentifier, userSecret, proxySettings, permanentHeaders=permanentHeaders)
+        self.authClient = AuthClient(self.host, userIdentifier, userSecret, proxySettings)
+        self.urlHelper = UrlV2Helper(projectId)
+
+    def addAuth(self, params):
+        token = self.authClient.getToken()
+        if token is None:
+            raise Exception("Error getting token, userIdentifier:%s" % (self.userIdentifier))
+        return {"Authorization": "Bearer " + token}
+
+    def validateFileTypes(self, kw):
+        fileTypes = kw.get("fileTypes", [])
+        if type(fileTypes) != type([]) and type(fileTypes) != type(()):
+            fileTypes = [fileTypes]
+        for t in fileTypes:
+            if not getattr(FileTypes, t, None):
+                unsupported = "\nUnsupported file type:%s\n" % t
+                raise Exception(unsupported)
+
+    def checkRetrievalType(self, kw):
+        if Params.RETRIEVAL_TYPE in kw and not kw[Params.RETRIEVAL_TYPE] in Params.allowedRetrievalTypes:
+            Exception("Not allowed value `%s` for parameter:%s try one of %s" % (kw[Params.RETRIEVAL_TYPE],
+                                                                                 Params.RETRIEVAL_TYPE,
+                                                                                 Params.allowedRetrievalTypes))
+
+    def processDirectives(self, params, directives):
+        for name, value in list(directives.items()):
+            params[SmartlingDirective.SL_PREFIX + name] = value
+
+    def addLibIdDirective(self, params):
+        name = "client_lib_id"
+        params[SmartlingDirective.SL_PREFIX + name] = self.clientUid

smartlingApiSdk/AuthClient.py

@@ -0,0 +1,78 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+
+""" Copyright 2012-2021 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.
+"""
+
+from .HttpClient import HttpClient
+from .ApiResponse import ApiResponse
+from .Constants import ReqMethod
+
+import time
+
+
+class AuthClient:
+    authUri = "/auth-api/v2/authenticate"
+    refreshUri = "/auth-api/v2/authenticate/refresh"
+    timeJitter = 5  # Seconds off server expiration time
+
+    def __init__(self, host, userIdentifier, userSecret, proxySettings=None):
+        self.httpClient = HttpClient(host, proxySettings)
+        self.userIdentifier = userIdentifier
+        self.userSecret = userSecret
+        self.accessExpiresAt = 0
+        self.refreshExpiresAt = 0
+
+    def request(self, uri, body):
+        header = {"Content-Type": "application/json"}
+        body = body.encode()
+        response_data, status_code, headers = self.httpClient.getHttpResponseAndStatus(
+            ReqMethod.POST, uri, params={}, extraHeaders=header, requestBody=body)
+        apiResponse = ApiResponse(response_data, status_code, headers)
+
+        now = time.time()
+        try:
+            self.accessToken = apiResponse.data.accessToken
+            self.refreshToken = apiResponse.data.refreshToken
+            self.accessExpiresAt = now + apiResponse.data.expiresIn - self.timeJitter
+            self.refreshExpiresAt = now + apiResponse.data.refreshExpiresIn - self.timeJitter
+        except Exception as e:
+            print(e)
+            self.accessToken = None
+
+    def authenticate(self):
+        body = '{"userIdentifier": "%s", "userSecret": "%s"}' % (self.userIdentifier, self.userSecret)
+        if '@smartling.com' in self.userIdentifier:
+            self.request(self.authUri + '/user', body)
+        else:
+            self.request(self.authUri, body)
+
+    def refresh(self):
+        body = '{"refreshToken":"%s"}' % self.refreshToken
+        self.request(self.refreshUri, body)
+
+    def getToken(self):
+        if not getattr(self, 'accessToken', None):
+            self.authenticate()
+            return self.accessToken
+
+        now = time.time()
+        if now >= self.accessExpiresAt:
+            if now < self.refreshExpiresAt:
+                self.refresh()
+            else:
+                self.authenticate()
+        return self.accessToken

smartlingApiSdk/Constants.py

@@ -0,0 +1,78 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+
+""" Copyright 2012-2021 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.
+"""
+
+#constants for File API
+
+
+class Params:
+    allowedRetrievalTypes = ('pending', 'published', 'pseudo', 'contextMatchingInstrumented')
+
+    API_KEY    = 'apiKey'
+    PROJECT_ID = 'projectId'
+    FILE_PATH  = 'file_path'
+    FILE_URI   = 'fileUri'
+    FILE_TYPE  = 'fileType'
+    LOCALE     = 'locale'
+    FILE       = 'file'
+    APPROVED   = 'approved'
+    RETRIEVAL_TYPE = 'retrievalType'
+    FILE_URI_NEW   = 'newFileUri'
+    CALLBACK_URL    = 'callbackUrl'
+    LOCALES_TO_APPROVE = 'localesToApprove'
+    LOCALE_IDS = 'localeIds'
+    LOCALE_IDS_BRACKET = 'localeIds[]'
+    FILE_URIS   = 'fileUris'
+
+class Uri:
+    base = '/v1/file/'
+    UPLOAD = base + 'upload'
+    LIST   = base + 'list'
+    GET    = base + 'get'
+    STATUS = base + 'status'
+    DELETE = base + 'delete'
+    RENAME = base + 'rename'
+    IMPORT = base + 'import'
+    LAST_MODIFIED = base + 'last_modified'
+
+
+class ReqMethod:
+    POST   = "POST"
+    GET    = "GET"
+    DELETE = "DELETE"
+    PUT    = "PUT"
+
+
+class FileTypes:
+    android        = "android"
+    ios            = "ios"
+    gettext        = "gettext"
+    html           = "html"
+    javaProperties = "javaProperties"
+    yaml           = "yaml"
+    xliff          = "xliff"
+    xml            = "xml"
+    json           = "json"
+    docx           = "docx"
+    pptx           = "pptx"
+    xlsx           = "xlsx"
+    idml           = "idml"
+    qt             = "qt"
+    resx           = "resx"
+    plaintext      = "plaintext"
+    cvs            = "cvs"

smartlingApiSdk/Credentials.py

@@ -0,0 +1,74 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+
+""" Copyright 2012-2021 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.
+"""
+
+import os
+
+
+class CredentialsNotSet(Exception):
+    noKeyMessage = """ 
+     don't forget to set real MY_PROJECT_ID, MY_USER_IDENTIFIER, MY_USER_SECRET, MY_LOCALE
+     in Credentials class
+     or use environment variables:
+     export SL_LOCALE=**-**
+     export SL_USER_IDENTIFIER=******************************
+     export SL_USER_SECRET=*******************************************************
+     
+     #optional
+     export SL_ACCOUNT_UID=******* #required only to list projects api call
+     export SL_PROJECT_ID=******* #required for api calls `projects` and `project_details`
+    """
+
+    def __init__(self, id, env):
+        self.id = id
+        self.env = env
+
+    def getMessage(self):
+        res = self.noKeyMessage
+        if 'stg' == self.env:
+            res = res.replace('SL_USER_IDENTIFIER=', 'SL_USER_IDENTIFIER_STG=')
+            res = res.replace('SL_USER_SECRET=', 'SL_USER_SECRET_STG=')
+        return res
+
+    def __str__(self):
+        return "Missing:" + self.id + self.getMessage()
+
+
+class Credentials():
+
+    MY_PROJECT_ID = "CHANGE_ME"
+    MY_ACCOUNT_UID = "CHANGE_ME"
+    MY_USER_IDENTIFIER = "CHANGE_ME"
+    MY_USER_SECRET = "CHANGE_ME"
+    MY_LOCALE ="CHANGE_ME"
+
+    CREDS = ("PROJECT_ID", "ACCOUNT_UID", "USER_IDENTIFIER", "USER_SECRET", "LOCALE")
+    OPTIONAL_CREDS = ("ACCOUNT_UID", "LOCALE")
+   
+    def __init__(self, env='prod'):
+        for id in self.CREDS:
+            cred = "MY_"+id
+            suffix = ''
+            if env == 'stg' and id.startswith("USER_"):
+                suffix = '_STG'
+            value = getattr(self, cred + suffix, "CHANGE_ME")
+            if "CHANGE_ME" == value:
+                value = os.environ.get('SL_' + id + suffix, getattr(self, cred))
+            if "CHANGE_ME" == value and id not in self.OPTIONAL_CREDS:
+                raise CredentialsNotSet('SL_' + id + suffix, env)
+            setattr(self, cred, value)

smartlingApiSdk/FileApiBase.py

@@ -0,0 +1,127 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+
+""" Copyright 2012-2021 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.
+"""
+
+#FileApi class implementation
+
+from .HttpClient import HttpClient, isPython3
+from .MultipartPostHandler import MultipartPostHandler
+from .Constants import Params, ReqMethod
+from .ApiResponse import ApiResponse
+from .Logger import Logger
+from .Settings import Settings
+import io
+import sys
+import logging
+import json
+
+
+class FileApiBase:
+    """ basic class implementing low-level api calls """
+    response_as_string = False
+
+    def __init__(self, host, apiKey, projectId, proxySettings=None, permanentHeaders={}):
+        self.host = host
+        self.apiKey = apiKey
+        self.projectId = projectId
+        self.proxySettings = proxySettings
+        self.httpClient = HttpClient(host, proxySettings, permanentHeaders=permanentHeaders)
+        sys.stdout = Logger('python-sdk', Settings.logLevel, Settings.logPath)
+        sys.stderr = Logger('STDERR', logging.ERROR, Settings.logPath)
+
+    def addAuth(self, params):
+        params[Params.API_KEY] = self.apiKey
+        params[Params.PROJECT_ID] = self.projectId
+        return {}
+
+    def processFile(self, file):
+        """"
+            returns file-like object form string or file
+            tries to treat string as file path or make it file-like object to be uploaded
+        """
+        if not file or file==type(file):
+            return file
+        try:
+            f = open(file, 'rb')
+        except:
+            f = io.StringIO(file)
+            f.seek(0)
+            f.name = 'String'
+        return f
+
+    def filterOutDefaults(self, params):
+        if hasattr(params, 'items'):
+            for k, v in list(params.items()):
+                if k == 'namespace':
+                    continue #when namespace is not specified it's replaced with 'smartling.strings-api.default.namespace' for strings api
+                if bool == type(v): continue
+                if not v: del params[k]
+                if k == 'projectId': del params[k]
+
+    def uploadMultipart(self, uri, params, response_as_string=False):
+        self.filterOutDefaults(params)
+        authHeader = self.addAuth(params)
+        if Params.FILE_PATH in params:
+            params[Params.FILE] = open(params[Params.FILE_PATH], 'rb')
+            del params[Params.FILE_PATH]  # no need in extra field in POST
+
+        response_data, status_code, headers = self.getHttpResponseAndStatus(ReqMethod.POST ,uri, params, MultipartPostHandler, extraHeaders = authHeader)
+        response_data = response_data.strip()
+        if self.response_as_string or response_as_string or not self.isJsonResponse(headers):
+            return response_data, status_code
+        return ApiResponse(response_data, status_code, headers), status_code
+
+    def commandJson(self, method, uri, params):
+        authHeader = self.addAuth(params)
+        authHeader['Content-Type'] = 'application/json'
+        self.filterOutDefaults(params)
+        jsonBody = json.dumps(params).encode('utf8')
+
+        data, code, headers = self.httpClient.getHttpResponseAndStatus(method, uri, params={}, requestBody = jsonBody, extraHeaders = authHeader)
+        if not code in [200,202]:
+            rId = headers.get("X-SL-RequestId","Unknown")
+            print ("code:%d RequestId:%s jsonBody=%s" % (code, rId, jsonBody))
+
+
+        if self.response_as_string or not self.isJsonResponse(headers):
+            return data, code
+        return  ApiResponse(data, code, headers), code
+
+    def getHttpResponseAndStatus(self, method, uri, params, handler=None, extraHeaders = None):
+        return self.httpClient.getHttpResponseAndStatus(method, uri, params, handler, extraHeaders = extraHeaders)
+  
+    def getResponseAndStatus(self, method, uri, params):
+        authHeader = self.addAuth(params)
+        return self.getHttpResponseAndStatus(method, uri, params, extraHeaders = authHeader)
+
+    def isJsonResponse(self, headers):
+        if isPython3:
+            hdr = 'Content-Type'
+        else:
+            hdr = 'content-type'
+        return 'json' in headers.get(hdr,'')
+
+    def command(self, method, uri, params):
+        self.filterOutDefaults(params)
+        data, code, headers = self.getResponseAndStatus(method, uri, params)
+        if self.response_as_string or not self.isJsonResponse(headers):
+            return data, code
+        result = ApiResponse(data, code, headers)
+        if result.isApiResonse:
+            return result, code
+        return data, code