files-com 1.5.5__py3-none-any.whl → 1.5.6__py3-none-any.whl

README.md

@@ -357,14 +357,20 @@ except files_sdk.error.Error as err:
 
 ## Foreign Language Support
 
-The Files.com Python SDK will soon be updated to support localized responses by using a configuration
-method. When available, it can be used to guide the API in selecting a preferred language for applicable response content.
+The Files.com PHP SDK supports localized responses by using the `files_sdk.set_language` configuration method.
+When configured, this guides the API in selecting a preferred language for applicable response content.
 
 Language support currently applies to select human-facing fields only, such as notification messages
 and error descriptions.
 
 If the specified language is not supported or the value is omitted, the API defaults to English.
 
+```shell title="Example Request"
+import files_sdk
+
+files_sdk.set_language('es')
+```
+
 ## Errors
 
 The Files.com Python SDK will return errors by raising exceptions. There are many exception classes defined in the Files SDK that correspond

_VERSION

@@ -1 +1 @@
-1.5.5
+1.5.6

{files_com-1.5.5.dist-info → files_com-1.5.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.5.5
+Version: 1.5.6
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5
@@ -369,14 +369,20 @@ except files_sdk.error.Error as err:
 
 ## Foreign Language Support
 
-The Files.com Python SDK will soon be updated to support localized responses by using a configuration
-method. When available, it can be used to guide the API in selecting a preferred language for applicable response content.
+The Files.com PHP SDK supports localized responses by using the `files_sdk.set_language` configuration method.
+When configured, this guides the API in selecting a preferred language for applicable response content.
 
 Language support currently applies to select human-facing fields only, such as notification messages
 and error descriptions.
 
 If the specified language is not supported or the value is omitted, the API defaults to English.
 
+```shell title="Example Request"
+import files_sdk
+
+files_sdk.set_language('es')
+```
+
 ## Errors
 
 The Files.com Python SDK will return errors by raising exceptions. There are many exception classes defined in the Files SDK that correspond

{files_com-1.5.5.dist-info → files_com-1.5.6.dist-info}/RECORD

@@ -1,9 +1,9 @@
-README.md,sha256=rVOUbl9T_vio5S50NXggbFF5vlAtu7TOWgMQOWVXrl0,28303
-_VERSION,sha256=BMk7fnY1pD0MttCX-a8KcqmXMEHRGEflIcxoLxZoxgU,6
-files_com-1.5.5.dist-info/licenses/LICENSE,sha256=ziANl9OTD-5-iE8XYIZNm6IYBDxOCHwQ-mdhci7lNew,1102
-files_sdk/__init__.py,sha256=Ujtxe062kdVfC3ymeJ-Of3pdkNx2uXNGgR-uAJZBHpI,12163
-files_sdk/api.py,sha256=pApkR1SYNByTLJICNnuC3S9DP5QzIsGv401Z_00oEpI,1717
-files_sdk/api_client.py,sha256=bMzG89eFrAfqy3u69AuZlIj3AFwEKbufC0w2EEKdHPA,11041
+README.md,sha256=g4zPluTMBI4fOaRMhczJi2WgpYWAUVg8YJsXEZwQvmM,28378
+_VERSION,sha256=2rZOBsCBfXe0-IcmGDLLs0ugI8rHx01y2BBoVTZS0MU,6
+files_com-1.5.6.dist-info/licenses/LICENSE,sha256=ziANl9OTD-5-iE8XYIZNm6IYBDxOCHwQ-mdhci7lNew,1102
+files_sdk/__init__.py,sha256=_eUmsS77LgZi9OHvZvKsDZJYxA7Q3CwpGsr7T3_p82g,12329
+files_sdk/api.py,sha256=HOLk50HLQCbnHwnAr9OElQEWvdA_BABBSEvvFSt1S4A,1846
+files_sdk/api_client.py,sha256=cfFvm-o4Ao8SWADiJv7t7qnJfG_LJmWV3l6ALTC-Opo,11264
 files_sdk/error.py,sha256=lZKht6lYj9i99CzRbHschmdSs6T2Y51-YrZX_5Y_o7A,64945
 files_sdk/list_obj.py,sha256=MWgmESLAmfh1uaSw76PWxmnf9f6_08TLUHe8_mCYKL4,1157
 files_sdk/path_util.py,sha256=7x8X3JLoMkcqNefCaBeHYXD8MGvPby4AOy-xnBX_LNk,1694
@@ -107,7 +107,7 @@ files_sdk/models/user_request.py,sha256=ykA5Lq0MYB7qTDOMMFBuyKa_R_LgQwGVorC-q-6q
 files_sdk/models/user_sftp_client_use.py,sha256=VnOo3ll6fwSc8grG5ZqGK8o3grYKg5P9b5B_hGS4vCs,2827
 files_sdk/models/web_dav_action_log.py,sha256=jPX4sOmR9TbYnsU8DU3b0-KQ8E2cHNaqdmFZKTjzpwE,56358
 files_sdk/models/webhook_test.py,sha256=dHqPZ-xhsC83rq7suHA5n6tb9M8yhg0k6i9-u-N_WWQ,4601
-files_com-1.5.5.dist-info/METADATA,sha256=vA5Btky5xghq98a7IXtfgjJjEU3B89o4VBKbXtiY1yc,28594
-files_com-1.5.5.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-files_com-1.5.5.dist-info/top_level.txt,sha256=p_2P-gluT_8boeXQNixTP3x-tFd1-la2NedKOiln21I,10
-files_com-1.5.5.dist-info/RECORD,,
+files_com-1.5.6.dist-info/METADATA,sha256=rVhT26Rf3IPO67eg4JuqCYNXoGDyeBiX-QEHrqQ-qKQ,28669
+files_com-1.5.6.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+files_com-1.5.6.dist-info/top_level.txt,sha256=p_2P-gluT_8boeXQNixTP3x-tFd1-la2NedKOiln21I,10
+files_com-1.5.6.dist-info/RECORD,,

files_sdk/__init__.py

@@ -208,11 +208,12 @@ import socket
 from urllib.parse import urlparse
 
 the_api_key = ""
+language = None
 session_id = None
 source_ip = None
 base_url = "https://app.files.com"
 base_path = "api/rest/v1"
-version = "1.5.5"
+version = "1.5.6"
 
 __version__ = version
 
@@ -224,7 +225,7 @@ max_network_retries = 3
 
 console_log_level = "none"
 
-OPTS = ("api_key", "client", "session_id", "source_ip")
+OPTS = ("api_key", "client", "session_id", "source_ip", "language")
 
 
 def set_api_key(_api_key):
@@ -237,6 +238,16 @@ def get_api_key():
     return the_api_key
 
 
+def set_language(_language):
+    global language
+    language = _language
+
+
+def get_language():
+    global language
+    return language
+
+
 def set_session(_session):
     if not _session.id:
         _session.save()

files_sdk/api.py

@@ -23,6 +23,7 @@ class Api:
         headers = copy.deepcopy(options)
         api_key = headers.pop("api_key", None)
         session_id = headers.pop("session_id", None)
+        language = headers.pop("language", None)
 
         session = headers.pop("session", None)
         if session:
@@ -31,7 +32,12 @@ class Api:
             session_id = str(session.id)
 
         response = Api.client().send_request(
-            verb, path, api_key=api_key, session_id=session_id, params=params
+            verb,
+            path,
+            api_key=api_key,
+            session_id=session_id,
+            language=language,
+            params=params,
         )
 
         # Remove options not in the allow list

files_sdk/api_client.py

@@ -48,6 +48,7 @@ class ApiClient:
         path,
         api_key=None,
         session_id=None,
+        language=None,
         headers=None,
         params=None,
     ):
@@ -66,7 +67,13 @@ class ApiClient:
                 api_key = files_sdk.get_api_key()
             self.check_api_key(api_key)
 
-        headers = {**headers, **self.request_headers(api_key, session_id)}
+        if files_sdk.language:
+            language = files_sdk.language
+
+        headers = {
+            **headers,
+            **self.request_headers(api_key, session_id, language),
+        }
 
         data = None
         query_params = None
@@ -187,7 +194,7 @@ class ApiClient:
         sleep_seconds *= 0.5 * (1 + random.random())
         return max(files_sdk.initial_network_retry_delay, sleep_seconds)
 
-    def request_headers(self, api_key, session_id):
+    def request_headers(self, api_key, session_id, language):
         user_agent = "Files.com Python SDK v{version}".format(
             version=files_sdk.version
         )
@@ -201,6 +208,8 @@ class ApiClient:
             headers["X-FilesAPI-Key"] = api_key
         if session_id:
             headers["X-FilesAPI-Auth"] = session_id
+        if language:
+            headers["Accept-Language"] = language
 
         return headers