SmartlingApiSdk 3.1.7__py3-none-any.whl

SmartlingApiSdk-3.1.7.dist-info/METADATA

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

SmartlingApiSdk-3.1.7.dist-info/RECORD

@@ -0,0 +1,54 @@
+smartlingApiSdk/ApiResponse.py,sha256=COT-y66h1t7vkBwMtEPoizQwa91U_TdWxLBcfE_RP10,2286
+smartlingApiSdk/ApiV2.py,sha256=AfqfFKTXKSY4XA9wcK3DyC7rDvX8gIOaTq6ttqrDXCI,3105
+smartlingApiSdk/AuthClient.py,sha256=Owbv-FzOByHdOlnhfmoPmhi1yScRh0rkEgIy53kdStE,2831
+smartlingApiSdk/Constants.py,sha256=T4EZjJf-2x6VWBb8nCZD6rbbYvCpCWglLKJuakko2ps,2155
+smartlingApiSdk/Credentials.py,sha256=MrR-1v76loT9EJDrd1C7QiF7CCI1qQ-Eic227hXQcAU,2565
+smartlingApiSdk/FileApiBase.py,sha256=IbSZiL4uiM7R0OrlncfudUva56HQ1xNH97TzBVov_Rs,5090
+smartlingApiSdk/FileApiV2.py,sha256=dxWCYHNQX8cNjb8lGvvx4_BH2y5QrcrlBCxlxni_0O8,7756
+smartlingApiSdk/HttpClient.py,sha256=CFmi3BkEvzqVVfIDLIsxBfAUUoiFAewgHJ6sfaMLlH0,5982
+smartlingApiSdk/Logger.py,sha256=seUEhL0axRwFuF68Uh6JTNNohDc3XBn-kmDS8ZKTXpc,1954
+smartlingApiSdk/MultipartPostHandler.py,sha256=uSH8gVF27_8GI_APGqynJ_sCM-Lni1g-a9IWfZ88NF4,4681
+smartlingApiSdk/ObsoleteApiV1.py,sha256=JGKhhkmDgKyyZ9P1hI6T1Jjl0z3Ws5b99-N-j1dP_wo,3769
+smartlingApiSdk/ObsoleteSmartlingFileApi.py,sha256=k4VI8DL4lsN5urHX7FYy4SjpORFSq6L4X1yDM8qgE_c,5208
+smartlingApiSdk/ProjectsApiV2.py,sha256=kEb7JmIsSsk0VBvfVH0rc83rbrItm2dkz8HyE4rftqo,1970
+smartlingApiSdk/ProxySettings.py,sha256=ZILRR8ktpznDudCp2IldvKotSF7CY7CGfGxOqYRDydU,1025
+smartlingApiSdk/Settings.py,sha256=agZxZ8zFYQjdVZQYPyqfdmDg673NVsrveO_sNBRUoTY,993
+smartlingApiSdk/SmartlingDirective.py,sha256=WkCO20gkUZiX_bIBSbF7PCev9gb_MWiNcMMoVRvdOoM,1191
+smartlingApiSdk/SmartlingFileApiV2.py,sha256=JfT4Tcvcm-e_0vyD7Rp0EWySBRSUe4wJNkvC0_JHsMg,9839
+smartlingApiSdk/SmartlingProjectsApiV2.py,sha256=AJmqx3tVEYRBkogm3oOgL7RpVlsx1SAdDfKYUFPUnqM,2697
+smartlingApiSdk/UploadData.py,sha256=fPibrkVjkWRfC_G3snKB7VemoJnBFaIrldFV4uG0b2k,1457
+smartlingApiSdk/UrlV2Helper.py,sha256=NcqHig2YZzr9GchALO4kfnViFm9iFVyRiYX9zcHANSI,2958
+smartlingApiSdk/__init__.py,sha256=SHtzLS5iUbHZfKmzpWscfgPKtPFcvkUKgUhfXkOg0sw,743
+smartlingApiSdk/version.py,sha256=XjhZAURDBMNqGbmjxTF7huXxhRSXzmk5PyuqdDaB0h8,686
+smartlingApiSdk/api/AccountProjectsApi.py,sha256=2xz5bdQHQbCJKDbPIcXkUpRqF38F4_DJmI0Hrd3y9v8,4752
+smartlingApiSdk/api/ContextApi.py,sha256=zS0Z3-TsE9WSEsL_pQR8pLbaSoPTotvb2t5JyarRTKk,9896
+smartlingApiSdk/api/EstimatesApi.py,sha256=N4qsl2cDeTf4QJ7zVbdJk-QfKlUKYADdtZi_SfacGLQ,8471
+smartlingApiSdk/api/FilesApi.py,sha256=6sbjGFEsoDoFLpsKmt7Hcc8p84BeKae3REC8r3srztY,15936
+smartlingApiSdk/api/JobBatchesV2Api.py,sha256=N1ZhvYa5AToqAkOFhbuYKrh2xG7VVvzbSUfUgBRIYs8,6368
+smartlingApiSdk/api/JobsApi.py,sha256=9Ea0SRq2ZBOF81B8P9R-e4iT_7qCIvzgIZ063uunYow,25353
+smartlingApiSdk/api/StringsApi.py,sha256=2Dr4COMKsPIaq8OzTMLEhMEQlHcI_m5asP2tSRz9Xy0,4792
+smartlingApiSdk/api/TagsApi.py,sha256=SY59ds2wsHIttzmExBzJBtjWPkogphir_X776K3hhaY,6151
+smartlingApiSdk/api/__init__.py,sha256=SKWZ9FbAuABhf__YLJJ1Ca9FGKJMl6QcXRx47M-enlo,48
+smartlingApiSdk/api/patch_nose.py,sha256=hts7Uxm5GJDKB3kdDx1Zi_j1mZq3q1oyqIOstRGRLOg,914
+smartlingApiSdk/example/AccountProjectsExample.py,sha256=gIm3zAl1aidDtAws3K7UzHgrd94CSiikQA8L7a0igGo,7185
+smartlingApiSdk/example/ContextExample.py,sha256=4ku-vCM3rBtoi_UyAxuVYMNsZLLIx7EEOxmHY6TSvLQ,13260
+smartlingApiSdk/example/EstimatesExample.py,sha256=1kNzhnSXFTGW-c4TVqO22cp8-NPqIVhVHK7bkUVgYGU,11738
+smartlingApiSdk/example/FilesExample.py,sha256=RQPuKTj7QA01A995n15jhgtlmA60f1XuhlN0ZYFlHO8,21115
+smartlingApiSdk/example/FilesSimpleExample.py,sha256=2b2X84vjFQVz99McD9_4HJMdL-IqBmUzH4rBWLDpvG0,3171
+smartlingApiSdk/example/JobBatchesV2Example.py,sha256=MvRKPW8TABazV9gL_9UwDAM5xNlqZaNoAhBQT8824tw,8143
+smartlingApiSdk/example/JobsExample.py,sha256=xgvBX3EiPA1bBJvnyx4x3zkg99vGRJSHWCWLJ0PmzzE,27326
+smartlingApiSdk/example/MultipleAccountsExample.py,sha256=dCZdKAlgOcEm-l2yxEzdivWOKD8ODLBdnmAUQHwTUQE,2770
+smartlingApiSdk/example/MultipleProjectsExample.py,sha256=LH49S8KHwPzEC1yKwErasKtmOGRK_ZeKki2Tm8_F9dQ,4647
+smartlingApiSdk/example/StringsExample.py,sha256=JI-ba8qiE_-3gQvvoTW_H344jwjmA0UCYAEW5LQS1gA,9083
+smartlingApiSdk/example/TagsExample.py,sha256=tmBo9HCMlkCtlRdI7Rq1VbM_XDUcx6PNynkLJV0LMuA,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.7.dist-info/METADATA,sha256=Ee4GeTyEuLN85AuOrPEulueeH_u-7t1im3k1XgxJ2Mg,365
+SmartlingApiSdk-3.1.7.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
+SmartlingApiSdk-3.1.7.dist-info/top_level.txt,sha256=e38w7yd0va1Chiw-UZcdu7NkI0jewljDg-OR21eenL0,86
+SmartlingApiSdk-3.1.7.dist-info/RECORD,,

SmartlingApiSdk-3.1.7.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (73.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

SmartlingApiSdk-3.1.7.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-2025 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-2025 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-2025 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-2025 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-2025 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,128 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+
+""" Copyright 2012-2025 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)
+        if Settings.printToLogfile:
+            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