Files.com 1.6.503__tar.gz → 1.6.505__tar.gz

{files_com-1.6.503/files_com.egg-info → files_com-1.6.505}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.503
+Version: 1.6.505
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5

files_com-1.6.505/_VERSION

@@ -0,0 +1 @@
+1.6.505

{files_com-1.6.503 → files_com-1.6.505/files_com.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.503
+Version: 1.6.505
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5

{files_com-1.6.503 → files_com-1.6.505}/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.503"
+version = "1.6.505"
 
 __version__ = version
 

{files_com-1.6.503 → files_com-1.6.505}/files_sdk/models/restore.py

@@ -18,10 +18,10 @@ class Restore:
         "files_restored": None,  # int64 - Number of files successfully restored.
         "files_errored": None,  # int64 - Number of files that were not able to be restored.
         "files_total": None,  # int64 - Total number of files processed.
-        "prefix": None,  # string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+        "prefix": None,  # string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. A trailing slash selects that folder and its contents only; without it, the prefix matches any path beginning with that text. Do not use a leading slash. To restore all deleted items of the selected restoration type within the selected site or workspace scope, specify an empty string (`''`) or omit the field.
         "restoration_type": None,  # string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
         "restore_in_place": None,  # boolean - If true, we will restore the files in place (into their original paths). If false, we will create a new restoration folder in the root and restore files there.
-        "restore_deleted_permissions": None,  # boolean - If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
+        "restore_deleted_permissions": None,  # boolean - If true, a user restore restores permissions removed as part of deleting the selected users. An in-place file restore restores user and group permissions on returned folders and their subfolders that were deleted from the time of the folder's deletion through 24 hours afterward, including permissions removed independently within that window. File restores into a new folder do not restore permissions.
         "users_restored": None,  # int64 - Number of users successfully restored (only present for `restoration_type=users`).
         "users_errored": None,  # int64 - Number of users that failed to restore (only present for `restoration_type=users`).
         "users_total": None,  # int64 - Total number of users processed (only present for `restoration_type=users`).
@@ -93,9 +93,9 @@ def all(params=None, options=None):
 
 # Parameters:
 #   earliest_date (required) - string - Restore files or users deleted on or after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
-#   prefix - string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+#   prefix - string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. A trailing slash selects that folder and its contents only; without it, the prefix matches any path beginning with that text. Do not use a leading slash. To restore all deleted items of the selected restoration type within the selected site or workspace scope, specify an empty string (`''`) or omit the field.
 #   restoration_type - string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
-#   restore_deleted_permissions - boolean - If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
+#   restore_deleted_permissions - boolean - If true, a user restore restores permissions removed as part of deleting the selected users. An in-place file restore restores user and group permissions on returned folders and their subfolders that were deleted from the time of the folder's deletion through 24 hours afterward, including permissions removed independently within that window. File restores into a new folder do not restore permissions.
 #   restore_in_place - boolean - If true, we will restore the files in place (into their original paths). If false, we will create a new restoration folder in the root and restore files there.
 #   update_timestamps - boolean - If true, we will update the last modified timestamp of restored files to today's date. If false, we might trigger File Expiration to delete the file again.
 #   workspace_id - int64 - Workspace ID for a workspace-scoped restore. `0` means the default site-wide scope.

{files_com-1.6.503 → files_com-1.6.505}/files_sdk/models/site.py

@@ -185,7 +185,7 @@ class Site:
         "smtp_authentication": None,  # string - SMTP server authentication type
         "smtp_from": None,  # string - From address to use when mailing through custom SMTP
         "smtp_port": None,  # int64 - SMTP server port
-        "smtp_ssl": None,  # string - Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted; require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address.
+        "smtp_ssl": None,  # string - Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted. A certificate-verified STARTTLS connection automatically changes if_available to require unless smtp_ssl is managed by a parent policy. require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address. Encryption is never automatically downgraded.
         "smtp_username": None,  # string - SMTP server username
         "session_expiry_minutes": None,  # int64 - Session expiry in minutes
         "snapshot_sharing_enabled": None,  # boolean - Allow snapshot share links creation
@@ -418,7 +418,7 @@ def get_usage(params=None, options=None):
 #   smtp_from - string - From address to use when mailing through custom SMTP
 #   smtp_username - string - SMTP server username
 #   smtp_port - int64 - SMTP server port
-#   smtp_ssl - string - Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted; require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address.
+#   smtp_ssl - string - Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted. A certificate-verified STARTTLS connection automatically changes if_available to require unless smtp_ssl is managed by a parent policy. require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address. Encryption is never automatically downgraded.
 #   ldap_enabled - boolean - Main LDAP setting: is LDAP enabled?
 #   ldap_type - string - LDAP type
 #   ldap_host - string - LDAP host

{files_com-1.6.503 → files_com-1.6.505}/files_sdk/models/user_lifecycle_rule.py

@@ -17,13 +17,13 @@ class UserLifecycleRule:
         "action": None,  # string - Action to take on inactive users (disable or delete)
         "inactivity_days": None,  # int64 - Number of days of inactivity before the rule applies
         "include_folder_admins": None,  # boolean - If true, the rule will apply to folder admins.
-        "include_site_admins": None,  # boolean - If true, the rule will apply to site admins.
-        "apply_to_all_workspaces": None,  # boolean - If true, a default-workspace rule also applies to users in all workspaces.
+        "include_site_admins": None,  # boolean - If true, the rule includes Site Administrators, who always belong to the Default Workspace. Can only be enabled when `workspace_id` is `0`.
+        "apply_to_all_workspaces": None,  # boolean - If true, a Default Workspace rule also applies to users in all Custom Workspaces. Can only be enabled when `workspace_id` is `0`.
         "name": None,  # string - User Lifecycle Rule name
         "notify_users": None,  # boolean - If true, users will be emailed before the rule disables or deletes them.
         "partner_tag": None,  # string - If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
         "site_id": None,  # int64 - Site ID
-        "workspace_id": None,  # int64 - Workspace ID. `0` means the default workspace.
+        "workspace_id": None,  # int64 - Workspace whose users the rule applies to. `0` means the Default Workspace. A Custom Workspace rule applies only to users who belong to that Workspace, regardless of access granted to other users.
         "user_state": None,  # string - State of the users to apply the rule to (inactive or disabled)
         "user_tag": None,  # string - If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
     }
@@ -54,18 +54,18 @@ class UserLifecycleRule:
 
     # Parameters:
     #   action - string - Action to take on inactive users (disable or delete)
-    #   apply_to_all_workspaces - boolean - If true, a default-workspace rule also applies to users in all workspaces.
+    #   apply_to_all_workspaces - boolean - If true, a Default Workspace rule also applies to users in all Custom Workspaces. Can only be enabled when `workspace_id` is `0`.
     #   authentication_method - string - User authentication method for which the rule will apply. Use `all_non_sso` to target every non-SSO authentication method with one rule.
     #   group_ids - array(int64) - Array of Group IDs to which the rule applies. If empty or not set, the rule applies to all users.
     #   inactivity_days - int64 - Number of days of inactivity before the rule applies
-    #   include_site_admins - boolean - If true, the rule will apply to site admins.
+    #   include_site_admins - boolean - If true, the rule includes Site Administrators, who always belong to the Default Workspace. Can only be enabled when `workspace_id` is `0`.
     #   include_folder_admins - boolean - If true, the rule will apply to folder admins.
     #   name - string - User Lifecycle Rule name
     #   notify_users - boolean - If true, users will be emailed before the rule disables or deletes them.
     #   partner_tag - string - If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
     #   user_state - string - State of the users to apply the rule to (inactive or disabled)
     #   user_tag - string - If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
-    #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+    #   workspace_id - int64 - Workspace whose users the rule applies to. `0` means the Default Workspace. A Custom Workspace rule applies only to users who belong to that Workspace, regardless of access granted to other users.
     def update(self, params=None):
         if not isinstance(params, dict):
             params = {}
@@ -223,18 +223,18 @@ def get(id, params=None, options=None):
 
 # Parameters:
 #   action - string - Action to take on inactive users (disable or delete)
-#   apply_to_all_workspaces - boolean - If true, a default-workspace rule also applies to users in all workspaces.
+#   apply_to_all_workspaces - boolean - If true, a Default Workspace rule also applies to users in all Custom Workspaces. Can only be enabled when `workspace_id` is `0`.
 #   authentication_method - string - User authentication method for which the rule will apply. Use `all_non_sso` to target every non-SSO authentication method with one rule.
 #   group_ids - array(int64) - Array of Group IDs to which the rule applies. If empty or not set, the rule applies to all users.
 #   inactivity_days - int64 - Number of days of inactivity before the rule applies
-#   include_site_admins - boolean - If true, the rule will apply to site admins.
+#   include_site_admins - boolean - If true, the rule includes Site Administrators, who always belong to the Default Workspace. Can only be enabled when `workspace_id` is `0`.
 #   include_folder_admins - boolean - If true, the rule will apply to folder admins.
 #   name - string - User Lifecycle Rule name
 #   notify_users - boolean - If true, users will be emailed before the rule disables or deletes them.
 #   partner_tag - string - If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
 #   user_state - string - State of the users to apply the rule to (inactive or disabled)
 #   user_tag - string - If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
-#   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+#   workspace_id - int64 - Workspace whose users the rule applies to. `0` means the Default Workspace. A Custom Workspace rule applies only to users who belong to that Workspace, regardless of access granted to other users.
 def create(params=None, options=None):
     if not isinstance(params, dict):
         params = {}
@@ -306,18 +306,18 @@ def create(params=None, options=None):
 
 # Parameters:
 #   action - string - Action to take on inactive users (disable or delete)
-#   apply_to_all_workspaces - boolean - If true, a default-workspace rule also applies to users in all workspaces.
+#   apply_to_all_workspaces - boolean - If true, a Default Workspace rule also applies to users in all Custom Workspaces. Can only be enabled when `workspace_id` is `0`.
 #   authentication_method - string - User authentication method for which the rule will apply. Use `all_non_sso` to target every non-SSO authentication method with one rule.
 #   group_ids - array(int64) - Array of Group IDs to which the rule applies. If empty or not set, the rule applies to all users.
 #   inactivity_days - int64 - Number of days of inactivity before the rule applies
-#   include_site_admins - boolean - If true, the rule will apply to site admins.
+#   include_site_admins - boolean - If true, the rule includes Site Administrators, who always belong to the Default Workspace. Can only be enabled when `workspace_id` is `0`.
 #   include_folder_admins - boolean - If true, the rule will apply to folder admins.
 #   name - string - User Lifecycle Rule name
 #   notify_users - boolean - If true, users will be emailed before the rule disables or deletes them.
 #   partner_tag - string - If provided, only users belonging to Partners with this tag at the Partner level will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
 #   user_state - string - State of the users to apply the rule to (inactive or disabled)
 #   user_tag - string - If provided, only users with this tag will be affected by the rule. Tags must only contain lowercase letters, numbers, and hyphens.
-#   workspace_id - int64 - Workspace ID. `0` means the default workspace.
+#   workspace_id - int64 - Workspace whose users the rule applies to. `0` means the Default Workspace. A Custom Workspace rule applies only to users who belong to that Workspace, regardless of access granted to other users.
 def update(id, params=None, options=None):
     if not isinstance(params, dict):
         params = {}

{files_com-1.6.503 → files_com-1.6.505}/pyproject.toml

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

files_com-1.6.503/_VERSION

@@ -1 +0,0 @@
-1.6.503