Files.com 1.6.370__tar.gz → 1.6.372__tar.gz

{files_com-1.6.370 → files_com-1.6.372}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.370
+Version: 1.6.372
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5
@@ -449,6 +449,39 @@ For example, the following two paths are treated as equivalent after NFC normali
 
 <div></div>
 
+## Workspaces
+
+A Workspace is a lightweight way to organize related resources inside a single Files.com Site.
+
+Customers commonly group resources by project, department, client, or region. Workspaces provide a built-in structure for that grouping, so the UI can operate within a clear "workspace context" and admins can delegate management for a subset of resources without requiring full site-level isolation.
+
+Every Site has an implicit Default workspace (ID `0`). Resources that are not explicitly assigned to a named workspace are considered part of the Default workspace.
+<div></div>
+
+### SDK Support
+
+We are still in the process of adding Workspaces support to each SDK. If you require Workspaces support right now, you need to use the REST API.
+<div></div>
+
+### Using Workspaces with the REST API
+
+To use Workspaces with the REST API, send the following request header:
+
+```http
+X-Files-Workspace-Id: <workspace_id>
+```
+
+This changes path mapping and "what you're looking at."
+
+When the `X-Files-Workspace-Id` header is provided:
+
+- List, show, update, and delete operations are constrained to that workspace for workspace-scoped models.
+- Create operations default `workspace_id` to the scoped workspace when not explicitly provided.
+- Attempts to provide a mismatching `workspace_id` are rejected with `not-authorized/insufficient-permission-for-params`.
+
+This header only works for sitewide keys, or keys related to users with permissions to more than one workspace.
+<div></div>
+
 ## Foreign Language Support
 
 The Files.com Python SDK supports localized responses by using the `files_sdk.set_language` configuration method.

files_com-1.6.370/files_com.egg-info/PKG-INFO → files_com-1.6.372/README.md

@@ -1,15 +1,3 @@
-Metadata-Version: 2.4
-Name: files_com
-Version: 1.6.370
-Summary: Python bindings for the Files.com API
-License: MIT
-Requires-Python: >=3.5
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.20
-Requires-Dist: requests-toolbelt>=1.0.0
-Dynamic: license-file
-
 # Files.com Python Client
 
 The Files.com Python Client provides a direct, high performance integration to Files.com from applications written in Python.
@@ -449,6 +437,39 @@ For example, the following two paths are treated as equivalent after NFC normali
 
 <div></div>
 
+## Workspaces
+
+A Workspace is a lightweight way to organize related resources inside a single Files.com Site.
+
+Customers commonly group resources by project, department, client, or region. Workspaces provide a built-in structure for that grouping, so the UI can operate within a clear "workspace context" and admins can delegate management for a subset of resources without requiring full site-level isolation.
+
+Every Site has an implicit Default workspace (ID `0`). Resources that are not explicitly assigned to a named workspace are considered part of the Default workspace.
+<div></div>
+
+### SDK Support
+
+We are still in the process of adding Workspaces support to each SDK. If you require Workspaces support right now, you need to use the REST API.
+<div></div>
+
+### Using Workspaces with the REST API
+
+To use Workspaces with the REST API, send the following request header:
+
+```http
+X-Files-Workspace-Id: <workspace_id>
+```
+
+This changes path mapping and "what you're looking at."
+
+When the `X-Files-Workspace-Id` header is provided:
+
+- List, show, update, and delete operations are constrained to that workspace for workspace-scoped models.
+- Create operations default `workspace_id` to the scoped workspace when not explicitly provided.
+- Attempts to provide a mismatching `workspace_id` are rejected with `not-authorized/insufficient-permission-for-params`.
+
+This header only works for sitewide keys, or keys related to users with permissions to more than one workspace.
+<div></div>
+
 ## Foreign Language Support
 
 The Files.com Python SDK supports localized responses by using the `files_sdk.set_language` configuration method.

files_com-1.6.372/_VERSION

@@ -0,0 +1 @@
+1.6.372

files_com-1.6.370/README.md → files_com-1.6.372/files_com.egg-info/PKG-INFO

@@ -1,3 +1,15 @@
+Metadata-Version: 2.4
+Name: files_com
+Version: 1.6.372
+Summary: Python bindings for the Files.com API
+License: MIT
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.20
+Requires-Dist: requests-toolbelt>=1.0.0
+Dynamic: license-file
+
 # Files.com Python Client
 
 The Files.com Python Client provides a direct, high performance integration to Files.com from applications written in Python.
@@ -437,6 +449,39 @@ For example, the following two paths are treated as equivalent after NFC normali
 
 <div></div>
 
+## Workspaces
+
+A Workspace is a lightweight way to organize related resources inside a single Files.com Site.
+
+Customers commonly group resources by project, department, client, or region. Workspaces provide a built-in structure for that grouping, so the UI can operate within a clear "workspace context" and admins can delegate management for a subset of resources without requiring full site-level isolation.
+
+Every Site has an implicit Default workspace (ID `0`). Resources that are not explicitly assigned to a named workspace are considered part of the Default workspace.
+<div></div>
+
+### SDK Support
+
+We are still in the process of adding Workspaces support to each SDK. If you require Workspaces support right now, you need to use the REST API.
+<div></div>
+
+### Using Workspaces with the REST API
+
+To use Workspaces with the REST API, send the following request header:
+
+```http
+X-Files-Workspace-Id: <workspace_id>
+```
+
+This changes path mapping and "what you're looking at."
+
+When the `X-Files-Workspace-Id` header is provided:
+
+- List, show, update, and delete operations are constrained to that workspace for workspace-scoped models.
+- Create operations default `workspace_id` to the scoped workspace when not explicitly provided.
+- Attempts to provide a mismatching `workspace_id` are rejected with `not-authorized/insufficient-permission-for-params`.
+
+This header only works for sitewide keys, or keys related to users with permissions to more than one workspace.
+<div></div>
+
 ## Foreign Language Support
 
 The Files.com Python SDK supports localized responses by using the `files_sdk.set_language` configuration method.

{files_com-1.6.370 → files_com-1.6.372}/files_sdk/__init__.py

@@ -283,7 +283,7 @@ session_id = None
 source_ip = None
 base_url = "https://app.files.com"
 base_path = "api/rest/v1"
-version = "1.6.370"
+version = "1.6.372"
 
 __version__ = version
 

{files_com-1.6.370 → files_com-1.6.372}/files_sdk/models/user.py

@@ -80,6 +80,7 @@ class User:
         "workspace_admin": None,  # boolean - Is the user a Workspace administrator?  Applicable only to the workspace ID related to this user, if one is set.
         "site_id": None,  # int64 - Site ID
         "workspace_id": None,  # int64 - Workspace ID
+        "default_workspace_id": None,  # int64 - Workspace ID the user should land in by default when more than one Workspace is available.
         "skip_welcome_screen": None,  # boolean - Skip Welcome page in the UI?
         "ssl_required": None,  # string - SSL required setting
         "sso_strategy_id": None,  # int64 - SSO (Single Sign On) strategy ID for the user, if applicable.
@@ -210,6 +211,7 @@ class User:
     #   bypass_site_allowed_ips - boolean - Allow this user to skip site-wide IP blacklists?
     #   dav_permission - boolean - Can the user connect with WebDAV?
     #   desktop_configuration_profile_id - int64 - Desktop Configuration Profile ID assigned directly to this user, if any.
+    #   default_workspace_id - int64 - Workspace ID the user should land in by default when more than one Workspace is available.
     #   disabled - boolean - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
     #   filesystem_layout - string - File system layout
     #   ftp_permission - boolean - Can the user access with FTP/FTPS?
@@ -333,6 +335,12 @@ class User:
             raise InvalidParameterError(
                 "Bad parameter: desktop_configuration_profile_id must be an int"
             )
+        if "default_workspace_id" in params and not isinstance(
+            params["default_workspace_id"], int
+        ):
+            raise InvalidParameterError(
+                "Bad parameter: default_workspace_id must be an int"
+            )
         if "filesystem_layout" in params and not isinstance(
             params["filesystem_layout"], str
         ):
@@ -577,6 +585,7 @@ def get(id, params=None, options=None):
 #   bypass_site_allowed_ips - boolean - Allow this user to skip site-wide IP blacklists?
 #   dav_permission - boolean - Can the user connect with WebDAV?
 #   desktop_configuration_profile_id - int64 - Desktop Configuration Profile ID assigned directly to this user, if any.
+#   default_workspace_id - int64 - Workspace ID the user should land in by default when more than one Workspace is available.
 #   disabled - boolean - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
 #   filesystem_layout - string - File system layout
 #   ftp_permission - boolean - Can the user access with FTP/FTPS?
@@ -726,6 +735,12 @@ def create(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: desktop_configuration_profile_id must be an int"
         )
+    if "default_workspace_id" in params and not isinstance(
+        params["default_workspace_id"], int
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: default_workspace_id must be an int"
+        )
     if "disabled" in params and not isinstance(params["disabled"], bool):
         raise InvalidParameterError("Bad parameter: disabled must be an bool")
     if "filesystem_layout" in params and not isinstance(
@@ -1013,6 +1028,7 @@ def user_2fa_reset(id, params=None, options=None):
 #   bypass_site_allowed_ips - boolean - Allow this user to skip site-wide IP blacklists?
 #   dav_permission - boolean - Can the user connect with WebDAV?
 #   desktop_configuration_profile_id - int64 - Desktop Configuration Profile ID assigned directly to this user, if any.
+#   default_workspace_id - int64 - Workspace ID the user should land in by default when more than one Workspace is available.
 #   disabled - boolean - Is user disabled? Disabled users cannot log in, and do not count for billing purposes. Users can be automatically disabled after an inactivity period via a Site setting or schedule to be deactivated after specific date.
 #   filesystem_layout - string - File system layout
 #   ftp_permission - boolean - Can the user access with FTP/FTPS?
@@ -1166,6 +1182,12 @@ def update(id, params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: desktop_configuration_profile_id must be an int"
         )
+    if "default_workspace_id" in params and not isinstance(
+        params["default_workspace_id"], int
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: default_workspace_id must be an int"
+        )
     if "disabled" in params and not isinstance(params["disabled"], bool):
         raise InvalidParameterError("Bad parameter: disabled must be an bool")
     if "filesystem_layout" in params and not isinstance(

{files_com-1.6.370 → files_com-1.6.372}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "files_com"
-version = "1.6.370"
+version = "1.6.372"
 description = "Python bindings for the Files.com API"
 readme = "README.md"
 license = { text = "MIT" }

files_com-1.6.370/_VERSION

@@ -1 +0,0 @@
-1.6.370