Files.com 1.6.437__tar.gz → 1.6.439__tar.gz

{files_com-1.6.437/files_com.egg-info → files_com-1.6.439}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.437
+Version: 1.6.439
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5
@@ -644,6 +644,8 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`ReauthenticationNeededActionError`|  `NotAuthorizedError` |
 |`RecaptchaFailedError`|  `NotAuthorizedError` |
 |`RemoteDesktopDebugLoggingDisabledError`|  `NotAuthorizedError` |
+|`RootFolderBehaviorSiteAdminRequiredError`|  `NotAuthorizedError` |
+|`RootFolderBehaviorSkipSiteAdminRequiredError`|  `NotAuthorizedError` |
 |`SelfManagedRequiredError`|  `NotAuthorizedError` |
 |`SiteAdminOrPartnerAdminPermissionRequiredError`|  `NotAuthorizedError` |
 |`SiteAdminOrWorkspaceAdminOrFolderAdminPermissionRequiredError`|  `NotAuthorizedError` |

{files_com-1.6.437 → files_com-1.6.439}/README.md

@@ -632,6 +632,8 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`ReauthenticationNeededActionError`|  `NotAuthorizedError` |
 |`RecaptchaFailedError`|  `NotAuthorizedError` |
 |`RemoteDesktopDebugLoggingDisabledError`|  `NotAuthorizedError` |
+|`RootFolderBehaviorSiteAdminRequiredError`|  `NotAuthorizedError` |
+|`RootFolderBehaviorSkipSiteAdminRequiredError`|  `NotAuthorizedError` |
 |`SelfManagedRequiredError`|  `NotAuthorizedError` |
 |`SiteAdminOrPartnerAdminPermissionRequiredError`|  `NotAuthorizedError` |
 |`SiteAdminOrWorkspaceAdminOrFolderAdminPermissionRequiredError`|  `NotAuthorizedError` |

files_com-1.6.439/_VERSION

@@ -0,0 +1 @@
+1.6.439

{files_com-1.6.437 → files_com-1.6.439/files_com.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.437
+Version: 1.6.439
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5
@@ -644,6 +644,8 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`ReauthenticationNeededActionError`|  `NotAuthorizedError` |
 |`RecaptchaFailedError`|  `NotAuthorizedError` |
 |`RemoteDesktopDebugLoggingDisabledError`|  `NotAuthorizedError` |
+|`RootFolderBehaviorSiteAdminRequiredError`|  `NotAuthorizedError` |
+|`RootFolderBehaviorSkipSiteAdminRequiredError`|  `NotAuthorizedError` |
 |`SelfManagedRequiredError`|  `NotAuthorizedError` |
 |`SiteAdminOrPartnerAdminPermissionRequiredError`|  `NotAuthorizedError` |
 |`SiteAdminOrWorkspaceAdminOrFolderAdminPermissionRequiredError`|  `NotAuthorizedError` |

{files_com-1.6.437 → files_com-1.6.439}/files_sdk/__init__.py

@@ -320,7 +320,7 @@ source_ip = None
 workspace_id = None
 base_url = "https://app.files.com"
 base_path = "api/rest/v1"
-version = "1.6.437"
+version = "1.6.439"
 
 __version__ = version
 

{files_com-1.6.437 → files_com-1.6.439}/files_sdk/error.py

@@ -1702,6 +1702,36 @@ class RemoteDesktopDebugLoggingDisabledError(NotAuthorizedError):
         )
 
 
+class RootFolderBehaviorSiteAdminRequiredError(NotAuthorizedError):
+    def __init__(
+        self,
+        message=None,
+        http_body=None,
+        http_status=None,
+        json_body=None,
+        headers=None,
+        code=None,
+    ):
+        super().__init__(
+            message, http_body, http_status, json_body, headers, code
+        )
+
+
+class RootFolderBehaviorSkipSiteAdminRequiredError(NotAuthorizedError):
+    def __init__(
+        self,
+        message=None,
+        http_body=None,
+        http_status=None,
+        json_body=None,
+        headers=None,
+        code=None,
+    ):
+        super().__init__(
+            message, http_body, http_status, json_body, headers, code
+        )
+
+
 class SelfManagedRequiredError(NotAuthorizedError):
     def __init__(
         self,

{files_com-1.6.437 → files_com-1.6.439}/files_sdk/models/behavior.py

@@ -21,6 +21,9 @@ class Behavior:
         "public_hosting_url": None,  # string - Public URL for this publicly hosted folder when the `Serve Publicly` behavior has a key configured.  When a Custom Domain with `public_hosting` destination is attached to this behavior, the URL uses that domain.  Otherwise it uses the site's `subdomain.hosted-by-files.com` host.
         "disable_parent_folder_behavior": None,  # boolean - If true, the parent folder's behavior will be disabled for this folder and its children.
         "recursive": None,  # boolean - Whether this behavior is recursive for this record. `always` behaviors are always `true`, `never` behaviors are always `false`, and `sometimes` behaviors may be either value.
+        "inherited": None,  # boolean - If true, this behavior is inherited from a higher scope rather than owned by the requested workspace.
+        "managed": None,  # boolean - If true, this behavior is controlled by a parent-site policy and cannot be modified locally.
+        "root_behavior_site_admin_only": None,  # boolean - If true, this behavior may only be modified by a site admin because it is at the site root or disables a root behavior.
         "attachment_file": None,  # file - Certain behaviors may require a file, for instance, the `watermark` behavior requires a watermark image. Attach that file here.
         "attachment_delete": None,  # boolean - If `true`, delete the file stored in `attachment`.
     }

{files_com-1.6.437 → files_com-1.6.439}/files_sdk/models/child_site_management_policy.py

@@ -17,7 +17,9 @@ class ChildSiteManagementPolicy:
         "description": None,  # string - Description for this policy.
         "value": None,  # object - Policy configuration data. Attributes differ by policy type. For more information, refer to the Value Hash section of the developer documentation.
         "applied_child_site_ids": None,  # array(int64) - IDs of child sites that this policy has been applied to. This field is read-only.
-        "skip_child_site_ids": None,  # array(int64) - IDs of child sites that this policy has been exempted from. If `skip_child_site_ids` is empty, the policy will be applied to all child sites. To apply a policy to a child site that has been exempted, remove it from `skip_child_site_ids` or set it to an empty array (`[]`).
+        "skip_child_site_ids": None,  # array(int64) - IDs of child sites excluded from this default policy.
+        "child_site_ids": None,  # array(int64) - IDs of child sites explicitly assigned to this non-default policy.
+        "default_policy": None,  # boolean - Whether this policy applies to child sites not explicitly assigned to another policy.
         "created_at": None,  # date-time - When this policy was created.
         "updated_at": None,  # date-time - When this policy was last updated.
     }
@@ -48,7 +50,9 @@ class ChildSiteManagementPolicy:
 
     # Parameters:
     #   value - object - Policy configuration data. Attributes differ by policy type. For more information, refer to the Value Hash section of the developer documentation.
-    #   skip_child_site_ids - array(int64) - IDs of child sites that this policy has been exempted from. If `skip_child_site_ids` is empty, the policy will be applied to all child sites. To apply a policy to a child site that has been exempted, remove it from `skip_child_site_ids` or set it to an empty array (`[]`).
+    #   skip_child_site_ids - array(int64) - IDs of child sites excluded from this default policy.
+    #   child_site_ids - array(int64) - IDs of child sites explicitly assigned to this non-default policy.
+    #   default_policy - boolean - Whether this policy applies to child sites not explicitly assigned to another policy.
     #   policy_type - string - Type of policy.  Valid values: `settings`.
     #   name - string - Name for this policy.
     #   description - string - Description for this policy.
@@ -70,6 +74,12 @@ class ChildSiteManagementPolicy:
             raise InvalidParameterError(
                 "Bad parameter: skip_child_site_ids must be an list"
             )
+        if "child_site_ids" in params and not isinstance(
+            params["child_site_ids"], builtins.list
+        ):
+            raise InvalidParameterError(
+                "Bad parameter: child_site_ids must be an list"
+            )
         if "policy_type" in params and not isinstance(
             params["policy_type"], str
         ):
@@ -183,7 +193,9 @@ def get(id, params=None, options=None):
 
 # Parameters:
 #   value - object - Policy configuration data. Attributes differ by policy type. For more information, refer to the Value Hash section of the developer documentation.
-#   skip_child_site_ids - array(int64) - IDs of child sites that this policy has been exempted from. If `skip_child_site_ids` is empty, the policy will be applied to all child sites. To apply a policy to a child site that has been exempted, remove it from `skip_child_site_ids` or set it to an empty array (`[]`).
+#   skip_child_site_ids - array(int64) - IDs of child sites excluded from this default policy.
+#   child_site_ids - array(int64) - IDs of child sites explicitly assigned to this non-default policy.
+#   default_policy - boolean - Whether this policy applies to child sites not explicitly assigned to another policy.
 #   policy_type (required) - string - Type of policy.  Valid values: `settings`.
 #   name - string - Name for this policy.
 #   description - string - Description for this policy.
@@ -200,6 +212,18 @@ def create(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: skip_child_site_ids must be an list"
         )
+    if "child_site_ids" in params and not isinstance(
+        params["child_site_ids"], builtins.list
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: child_site_ids must be an list"
+        )
+    if "default_policy" in params and not isinstance(
+        params["default_policy"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: default_policy must be an bool"
+        )
     if "policy_type" in params and not isinstance(params["policy_type"], str):
         raise InvalidParameterError(
             "Bad parameter: policy_type must be an str"
@@ -220,7 +244,9 @@ def create(params=None, options=None):
 
 # Parameters:
 #   value - object - Policy configuration data. Attributes differ by policy type. For more information, refer to the Value Hash section of the developer documentation.
-#   skip_child_site_ids - array(int64) - IDs of child sites that this policy has been exempted from. If `skip_child_site_ids` is empty, the policy will be applied to all child sites. To apply a policy to a child site that has been exempted, remove it from `skip_child_site_ids` or set it to an empty array (`[]`).
+#   skip_child_site_ids - array(int64) - IDs of child sites excluded from this default policy.
+#   child_site_ids - array(int64) - IDs of child sites explicitly assigned to this non-default policy.
+#   default_policy - boolean - Whether this policy applies to child sites not explicitly assigned to another policy.
 #   policy_type - string - Type of policy.  Valid values: `settings`.
 #   name - string - Name for this policy.
 #   description - string - Description for this policy.
@@ -240,6 +266,18 @@ def update(id, params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: skip_child_site_ids must be an list"
         )
+    if "child_site_ids" in params and not isinstance(
+        params["child_site_ids"], builtins.list
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: child_site_ids must be an list"
+        )
+    if "default_policy" in params and not isinstance(
+        params["default_policy"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: default_policy must be an bool"
+        )
     if "policy_type" in params and not isinstance(params["policy_type"], str):
         raise InvalidParameterError(
             "Bad parameter: policy_type must be an str"

{files_com-1.6.437 → files_com-1.6.439}/files_sdk/models/site.py

@@ -154,6 +154,8 @@ class Site:
         "prevent_root_permissions_for_non_site_admins": None,  # boolean - If true, we will prevent non-administrators from receiving any permissions directly on the root folder.  This is commonly used to prevent the accidental application of permissions.
         "protocol_access_groups_only": None,  # boolean - If true, protocol access permissions on users will be ignored, and only protocol access permissions set on Groups will be honored.  Make sure that your current user is a member of a group with API permission when changing this value to avoid locking yourself out of your site.
         "require_2fa": None,  # boolean - Require two-factor authentication for all users?
+        "restrict_root_folder_behaviors_to_site_admins": None,  # boolean - If true, only site admins may create, modify, or delete any behavior at the site root, or a skip that would disable one.
+        "root_folder_behaviors_apply_to_workspaces": None,  # boolean - If true, supported protective behaviors at the site root also apply within named workspaces. Requires restrict_root_folder_behaviors_to_site_admins to be enabled.
         "require_2fa_exempt_all_sso_users": None,  # boolean - If true, SSO users using the default user-level two-factor authentication setting are exempt from the site-wide two-factor authentication requirement.
         "require_2fa_stop_time": None,  # date-time - If set, requirement for two-factor authentication has been scheduled to end on this date-time.
         "revoke_bundle_access_on_disable_or_delete": None,  # boolean - Auto-removes bundles for disabled/deleted users and enforces bundle expiry within user access period.
@@ -346,6 +348,8 @@ def get_usage(params=None, options=None):
 #   document_edits_in_bundle_allowed - boolean - If true, allow public viewers of Bundles with full permissions to use document editing integrations.
 #   password_requirements_apply_to_bundles - boolean - Require bundles' passwords, and passwords for other items (inboxes, public shares, etc.) to conform to the same requirements as users' passwords?
 #   prevent_root_permissions_for_non_site_admins - boolean - If true, we will prevent non-administrators from receiving any permissions directly on the root folder.  This is commonly used to prevent the accidental application of permissions.
+#   restrict_root_folder_behaviors_to_site_admins - boolean - If true, only site admins may create, modify, or delete any behavior at the site root, or a skip that would disable one.
+#   root_folder_behaviors_apply_to_workspaces - boolean - If true, supported protective behaviors at the site root also apply within named workspaces. Requires restrict_root_folder_behaviors_to_site_admins to be enabled.
 #   opt_out_global - boolean - Use servers in the USA only?
 #   use_provided_modified_at - boolean - Allow uploaders to set `provided_modified_at` for uploaded files?
 #   custom_namespace - boolean - Is this site using a custom namespace for users?
@@ -953,6 +957,24 @@ def update(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: prevent_root_permissions_for_non_site_admins must be an bool"
         )
+    if (
+        "restrict_root_folder_behaviors_to_site_admins" in params
+        and not isinstance(
+            params["restrict_root_folder_behaviors_to_site_admins"], bool
+        )
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: restrict_root_folder_behaviors_to_site_admins must be an bool"
+        )
+    if (
+        "root_folder_behaviors_apply_to_workspaces" in params
+        and not isinstance(
+            params["root_folder_behaviors_apply_to_workspaces"], bool
+        )
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: root_folder_behaviors_apply_to_workspaces must be an bool"
+        )
     if "opt_out_global" in params and not isinstance(
         params["opt_out_global"], bool
     ):

{files_com-1.6.437 → files_com-1.6.439}/files_sdk/models/user.py

@@ -95,8 +95,8 @@ class User:
         "time_zone": None,  # string - User time zone
         "type_of_2fa": None,  # string - Type(s) of 2FA methods in use, for programmatic use.  Will be either `sms`, `totp`, `webauthn`, `yubi`, `email`, or multiple values sorted alphabetically and joined by an underscore.  Does not specify whether user has more than one of a given method.
         "type_of_2fa_for_display": None,  # string - Type(s) of 2FA methods in use, formatted for displaying in the UI.  Unlike `type_of_2fa`, this value will make clear when a user has more than 1 of the same type of method.
-        "user_root": None,  # string - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set).  Note that this is not used for API, Desktop, or Web interface.
-        "user_home": None,  # string - Home folder for FTP/SFTP.  Note that this is not used for API, Desktop, or Web interface.
+        "user_root": None,  # string - If filesystem layout is user_root, this path is the root path the user is fixed to for all interfaces. If the filesystem layout is site_root or partner_root, this acts as a root folder only for FTP and SFTP (SFTP applicability also requires a site-wide setting to be set). For partner_root layout, this path is relative to the Partner root folder for all callers and blank opts out of an additional protocol root. In this situation, this path is not applied to the API, Desktop, or Web interface.
+        "user_home": None,  # string - Home folder for FTP/SFTP. For users with the partner_root filesystem layout, this path is relative to the Partner root folder. In all other cases, it is an absolute path. Only applies to FTP and SFTP, and not any other interface.
         "days_remaining_until_password_expire": None,  # int64 - Number of days remaining until password expires
         "password_expire_at": None,  # date-time - Password expiration datetime
         "avatar_file": None,  # file - An image file for your user avatar.
@@ -262,8 +262,8 @@ class User:
     #   require_2fa - string - 2FA required setting. `use_system_setting` uses the site-wide setting, including SSO exemptions. `always_require` and `never_require` override the site-wide setting when user-level overrides are allowed.
     #   tags - string - Comma-separated list of Tags for this user. Tags are used for other features, such as UserLifecycleRules, which can target specific tags.  Tags must only contain lowercase letters, numbers, and hyphens.
     #   time_zone - string - User time zone
-    #   user_root - string - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set).  Note that this is not used for API, Desktop, or Web interface.
-    #   user_home - string - Home folder for FTP/SFTP.  Note that this is not used for API, Desktop, or Web interface.
+    #   user_root - string - If filesystem layout is user_root, this path is the root path the user is fixed to for all interfaces. If the filesystem layout is site_root or partner_root, this acts as a root folder only for FTP and SFTP (SFTP applicability also requires a site-wide setting to be set). For partner_root layout, this path is relative to the Partner root folder for all callers and blank opts out of an additional protocol root. In this situation, this path is not applied to the API, Desktop, or Web interface.
+    #   user_home - string - Home folder for FTP/SFTP. For users with the partner_root filesystem layout, this path is relative to the Partner root folder. In all other cases, it is an absolute path. Only applies to FTP and SFTP, and not any other interface.
     #   workspace_admin - boolean - Is the user a Workspace administrator?  Applicable only to the workspace ID related to this user, if one is set.
     #   username - string - User's username
     #   workspace_id - int64 - Workspace ID
@@ -674,8 +674,8 @@ def get(id, params=None, options=None):
 #   require_2fa - string - 2FA required setting. `use_system_setting` uses the site-wide setting, including SSO exemptions. `always_require` and `never_require` override the site-wide setting when user-level overrides are allowed.
 #   tags - string - Comma-separated list of Tags for this user. Tags are used for other features, such as UserLifecycleRules, which can target specific tags.  Tags must only contain lowercase letters, numbers, and hyphens.
 #   time_zone - string - User time zone
-#   user_root - string - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set).  Note that this is not used for API, Desktop, or Web interface.
-#   user_home - string - Home folder for FTP/SFTP.  Note that this is not used for API, Desktop, or Web interface.
+#   user_root - string - If filesystem layout is user_root, this path is the root path the user is fixed to for all interfaces. If the filesystem layout is site_root or partner_root, this acts as a root folder only for FTP and SFTP (SFTP applicability also requires a site-wide setting to be set). For partner_root layout, this path is relative to the Partner root folder for all callers and blank opts out of an additional protocol root. In this situation, this path is not applied to the API, Desktop, or Web interface.
+#   user_home - string - Home folder for FTP/SFTP. For users with the partner_root filesystem layout, this path is relative to the Partner root folder. In all other cases, it is an absolute path. Only applies to FTP and SFTP, and not any other interface.
 #   workspace_admin - boolean - Is the user a Workspace administrator?  Applicable only to the workspace ID related to this user, if one is set.
 #   username (required) - string - User's username
 #   workspace_id - int64 - Workspace ID
@@ -1150,8 +1150,8 @@ def user_2fa_reset(id, params=None, options=None):
 #   require_2fa - string - 2FA required setting. `use_system_setting` uses the site-wide setting, including SSO exemptions. `always_require` and `never_require` override the site-wide setting when user-level overrides are allowed.
 #   tags - string - Comma-separated list of Tags for this user. Tags are used for other features, such as UserLifecycleRules, which can target specific tags.  Tags must only contain lowercase letters, numbers, and hyphens.
 #   time_zone - string - User time zone
-#   user_root - string - Root folder for FTP (and optionally SFTP if the appropriate site-wide setting is set).  Note that this is not used for API, Desktop, or Web interface.
-#   user_home - string - Home folder for FTP/SFTP.  Note that this is not used for API, Desktop, or Web interface.
+#   user_root - string - If filesystem layout is user_root, this path is the root path the user is fixed to for all interfaces. If the filesystem layout is site_root or partner_root, this acts as a root folder only for FTP and SFTP (SFTP applicability also requires a site-wide setting to be set). For partner_root layout, this path is relative to the Partner root folder for all callers and blank opts out of an additional protocol root. In this situation, this path is not applied to the API, Desktop, or Web interface.
+#   user_home - string - Home folder for FTP/SFTP. For users with the partner_root filesystem layout, this path is relative to the Partner root folder. In all other cases, it is an absolute path. Only applies to FTP and SFTP, and not any other interface.
 #   workspace_admin - boolean - Is the user a Workspace administrator?  Applicable only to the workspace ID related to this user, if one is set.
 #   username - string - User's username
 #   workspace_id - int64 - Workspace ID

{files_com-1.6.437 → files_com-1.6.439}/pyproject.toml

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

files_com-1.6.437/_VERSION

@@ -1 +0,0 @@
-1.6.437