Files.com 1.6.470__tar.gz → 1.6.472__tar.gz

{files_com-1.6.470/files_com.egg-info → files_com-1.6.472}/PKG-INFO

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

files_com-1.6.472/_VERSION

@@ -0,0 +1 @@
+1.6.472

{files_com-1.6.470 → files_com-1.6.472/files_com.egg-info}/PKG-INFO

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

{files_com-1.6.470 → files_com-1.6.472}/files_sdk/__init__.py

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

{files_com-1.6.470 → files_com-1.6.472}/files_sdk/models/api_key.py

@@ -29,7 +29,7 @@ class ApiKey:
         "url": None,  # string - URL for API host.
         "user_id": None,  # int64 - User ID for the owner of this API Key.  May be blank for Site-wide API Keys.
         "workspace_id": None,  # int64 - Workspace ID for this API Key. `0` means the default workspace.
-        "path": None,  # string - Folder path restriction for `office_integration` permission set API keys.
+        "path": None,  # string - Restricts this API key to the specified folder and its descendants. Applies to every permission set and all paths accessed by a request, including copy and move destinations. Does not grant access beyond the owning user's permissions. Optional except for `office_integration` keys, which require a path the owning user can read.
     }
 
     def __init__(self, attributes=None, options=None):
@@ -208,7 +208,7 @@ def get(id, params=None, options=None):
 #   expires_at - string - API Key expiration date
 #   name (required) - string - Internal name for the API Key.  For your use.
 #   aws_style_credentials - boolean - If `true`, this API key will be usable with AWS-compatible endpoints, such as our Inbound S3-compatible endpoint.
-#   path - string - Folder path restriction for `office_integration` permission set API keys.
+#   path - string - Restricts this API key to the specified folder and its descendants. Applies to every permission set and all paths accessed by a request, including copy and move destinations. Does not grant access beyond the owning user's permissions. Optional except for `office_integration` keys, which require a path the owning user can read.
 #   permission_set - string - Permissions for this API Key. Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations). Keys with the `office_integration` permission set are auto generated, and automatically expire, to allow users to interact with office integration platforms. Keys with the `files_only` permission set can perform file operations as a full-access file user in the key's workspace scope, but cannot use site admin, workspace admin, folder admin, group admin, partner admin, or billing privileges from the owning user.
 #   workspace_id - int64 - Workspace ID for this API Key. `0` means the default workspace.
 def create(params=None, options=None):

{files_com-1.6.470 → files_com-1.6.472}/files_sdk/models/bundle.py

@@ -154,6 +154,7 @@ class Bundle:
     #   user_id - int64 - The owning user id. Only site admins can set this.
     #   watermark_attachment_delete - boolean - If true, will delete the file stored in watermark_attachment
     #   watermark_attachment_file - file - Preview watermark image applied to all bundle items.
+    #   watermark_value - object - Preview watermark settings applied to all bundle items. Uses the same keys as Behavior.value
     #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
     def update(self, params=None):
         if not isinstance(params, dict):
@@ -410,6 +411,7 @@ def get(id, params=None, options=None):
 #   snapshot_id - int64 - ID of the snapshot containing this bundle's contents.
 #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
 #   watermark_attachment_file - file - Preview watermark image applied to all bundle items.
+#   watermark_value - object - Preview watermark settings applied to all bundle items. Uses the same keys as Behavior.value
 def create(params=None, options=None):
     if not isinstance(params, dict):
         params = {}
@@ -550,6 +552,12 @@ def create(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: workspace_id must be an int"
         )
+    if "watermark_value" in params and not isinstance(
+        params["watermark_value"], dict
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: watermark_value must be an dict"
+        )
     if "paths" not in params:
         raise MissingParameterError("Parameter missing: paths")
     response, options = Api.send_request("POST", "/bundles", params, options)
@@ -621,6 +629,7 @@ def share(id, params=None, options=None):
 #   user_id - int64 - The owning user id. Only site admins can set this.
 #   watermark_attachment_delete - boolean - If true, will delete the file stored in watermark_attachment
 #   watermark_attachment_file - file - Preview watermark image applied to all bundle items.
+#   watermark_value - object - Preview watermark settings applied to all bundle items. Uses the same keys as Behavior.value
 #   workspace_id - int64 - Workspace ID. `0` means the default workspace.
 def update(id, params=None, options=None):
     if not isinstance(params, dict):
@@ -761,6 +770,12 @@ def update(id, params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: watermark_attachment_delete must be an bool"
         )
+    if "watermark_value" in params and not isinstance(
+        params["watermark_value"], dict
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: watermark_value must be an dict"
+        )
     if "workspace_id" in params and not isinstance(
         params["workspace_id"], int
     ):

{files_com-1.6.470 → files_com-1.6.472}/files_sdk/models/group.py

@@ -23,6 +23,7 @@ class Group:
         "sftp_permission": None,  # boolean - If true, users in this group can use SFTP to login.  This will override a false value of `sftp_permission` on the user level.
         "dav_permission": None,  # boolean - If true, users in this group can use WebDAV to login.  This will override a false value of `dav_permission` on the user level.
         "restapi_permission": None,  # boolean - If true, users in this group can use the REST API to login.  This will override a false value of `restapi_permission` on the user level.
+        "s3_compatible_endpoint_permission": None,  # boolean - If true, users in this group can access the S3-compatible endpoint. This will override a false value of `s3_compatible_endpoint_permission` on the user level. Defaults to false.
         "desktop_configuration_profile_id": None,  # int64 - Desktop Configuration Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
         "integration_centric_profile_id": None,  # int64 - Integration Centric Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
         "site_id": None,  # int64 - Site ID
@@ -59,6 +60,7 @@ class Group:
     #   sftp_permission - boolean - If true, users in this group can use SFTP to login.  This will override a false value of `sftp_permission` on the user level.
     #   dav_permission - boolean - If true, users in this group can use WebDAV to login.  This will override a false value of `dav_permission` on the user level.
     #   restapi_permission - boolean - If true, users in this group can use the REST API to login.  This will override a false value of `restapi_permission` on the user level.
+    #   s3_compatible_endpoint_permission - boolean - If true, users in this group can access the S3-compatible endpoint. This will override a false value of `s3_compatible_endpoint_permission` on the user level. Defaults to false.
     #   desktop_configuration_profile_id - int64 - Desktop Configuration Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
     #   integration_centric_profile_id - int64 - Integration Centric Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
     #   allowed_ips - string - A list of allowed IPs if applicable.  Newline delimited
@@ -228,6 +230,7 @@ def get(id, params=None, options=None):
 #   sftp_permission - boolean - If true, users in this group can use SFTP to login.  This will override a false value of `sftp_permission` on the user level.
 #   dav_permission - boolean - If true, users in this group can use WebDAV to login.  This will override a false value of `dav_permission` on the user level.
 #   restapi_permission - boolean - If true, users in this group can use the REST API to login.  This will override a false value of `restapi_permission` on the user level.
+#   s3_compatible_endpoint_permission - boolean - If true, users in this group can access the S3-compatible endpoint. This will override a false value of `s3_compatible_endpoint_permission` on the user level. Defaults to false.
 #   desktop_configuration_profile_id - int64 - Desktop Configuration Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
 #   integration_centric_profile_id - int64 - Integration Centric Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
 #   allowed_ips - string - A list of allowed IPs if applicable.  Newline delimited
@@ -274,6 +277,12 @@ def create(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: restapi_permission must be an bool"
         )
+    if "s3_compatible_endpoint_permission" in params and not isinstance(
+        params["s3_compatible_endpoint_permission"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: s3_compatible_endpoint_permission must be an bool"
+        )
     if "desktop_configuration_profile_id" in params and not isinstance(
         params["desktop_configuration_profile_id"], int
     ):
@@ -313,6 +322,7 @@ def create(params=None, options=None):
 #   sftp_permission - boolean - If true, users in this group can use SFTP to login.  This will override a false value of `sftp_permission` on the user level.
 #   dav_permission - boolean - If true, users in this group can use WebDAV to login.  This will override a false value of `dav_permission` on the user level.
 #   restapi_permission - boolean - If true, users in this group can use the REST API to login.  This will override a false value of `restapi_permission` on the user level.
+#   s3_compatible_endpoint_permission - boolean - If true, users in this group can access the S3-compatible endpoint. This will override a false value of `s3_compatible_endpoint_permission` on the user level. Defaults to false.
 #   desktop_configuration_profile_id - int64 - Desktop Configuration Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
 #   integration_centric_profile_id - int64 - Integration Centric Profile ID assigned to this Group, if any. Users in the Group inherit it unless a direct per-user assignment overrides it.
 #   allowed_ips - string - A list of allowed IPs if applicable.  Newline delimited
@@ -361,6 +371,12 @@ def update(id, params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: restapi_permission must be an bool"
         )
+    if "s3_compatible_endpoint_permission" in params and not isinstance(
+        params["s3_compatible_endpoint_permission"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: s3_compatible_endpoint_permission must be an bool"
+        )
     if "desktop_configuration_profile_id" in params and not isinstance(
         params["desktop_configuration_profile_id"], int
     ):

{files_com-1.6.470 → files_com-1.6.472}/files_sdk/models/history_export.py

@@ -26,7 +26,7 @@ class HistoryExport:
         "query_destination": None,  # string - Return results that are file moves with paths matching this pattern as destination.
         "query_ip": None,  # string - Filter results by this IP address.
         "query_username": None,  # string - Filter results by this username.
-        "query_failure_type": None,  # string - If searching for Histories about login failures, this parameter restricts results to failures of this specific type.  Valid values: `expired_trial`, `account_overdue`, `locked_out`, `ip_mismatch`, `password_mismatch`, `site_mismatch`, `username_not_found`, `none`, `no_ftp_permission`, `no_web_permission`, `no_directory`, `errno_enoent`, `no_sftp_permission`, `no_dav_permission`, `no_restapi_permission`, `key_mismatch`, `region_mismatch`, `expired_access`, `desktop_ip_mismatch`, `desktop_api_key_not_used_quickly_enough`, `disabled`, `country_mismatch`, `insecure_ftp`, `insecure_cipher`, `rate_limited`
+        "query_failure_type": None,  # string - If searching for Histories about login failures, this parameter restricts results to failures of this specific type.  Valid values: `expired_trial`, `account_overdue`, `locked_out`, `ip_mismatch`, `password_mismatch`, `site_mismatch`, `username_not_found`, `none`, `no_ftp_permission`, `no_web_permission`, `no_directory`, `errno_enoent`, `no_sftp_permission`, `no_dav_permission`, `no_restapi_permission`, `key_mismatch`, `region_mismatch`, `expired_access`, `desktop_ip_mismatch`, `desktop_api_key_not_used_quickly_enough`, `disabled`, `country_mismatch`, `insecure_ftp`, `insecure_cipher`, `rate_limited`, `no_s3_compatible_endpoint_permission`
         "query_target_id": None,  # string - If searching for Histories about specific objects (such as Users, or API Keys), this parameter restricts results to objects that match this ID.
         "query_target_name": None,  # string - If searching for Histories about Users, Groups or other objects with names, this parameter restricts results to objects with this name/username.
         "query_target_permission": None,  # string - If searching for Histories about Permissions, this parameter restricts results to permissions of this level.
@@ -113,7 +113,7 @@ def get(id, params=None, options=None):
 #   query_destination - string - Return results that are file moves with paths matching this pattern as destination.
 #   query_ip - string - Filter results by this IP address.
 #   query_username - string - Filter results by this username.
-#   query_failure_type - string - If searching for Histories about login failures, this parameter restricts results to failures of this specific type.  Valid values: `expired_trial`, `account_overdue`, `locked_out`, `ip_mismatch`, `password_mismatch`, `site_mismatch`, `username_not_found`, `none`, `no_ftp_permission`, `no_web_permission`, `no_directory`, `errno_enoent`, `no_sftp_permission`, `no_dav_permission`, `no_restapi_permission`, `key_mismatch`, `region_mismatch`, `expired_access`, `desktop_ip_mismatch`, `desktop_api_key_not_used_quickly_enough`, `disabled`, `country_mismatch`, `insecure_ftp`, `insecure_cipher`, `rate_limited`
+#   query_failure_type - string - If searching for Histories about login failures, this parameter restricts results to failures of this specific type.  Valid values: `expired_trial`, `account_overdue`, `locked_out`, `ip_mismatch`, `password_mismatch`, `site_mismatch`, `username_not_found`, `none`, `no_ftp_permission`, `no_web_permission`, `no_directory`, `errno_enoent`, `no_sftp_permission`, `no_dav_permission`, `no_restapi_permission`, `key_mismatch`, `region_mismatch`, `expired_access`, `desktop_ip_mismatch`, `desktop_api_key_not_used_quickly_enough`, `disabled`, `country_mismatch`, `insecure_ftp`, `insecure_cipher`, `rate_limited`, `no_s3_compatible_endpoint_permission`
 #   query_target_id - string - If searching for Histories about specific objects (such as Users, or API Keys), this parameter restricts results to objects that match this ID.
 #   query_target_name - string - If searching for Histories about Users, Groups or other objects with names, this parameter restricts results to objects with this name/username.
 #   query_target_permission - string - If searching for Histories about Permissions, this parameter restricts results to permissions of this level.

{files_com-1.6.470 → files_com-1.6.472}/files_sdk/models/history_export_result.py

@@ -24,7 +24,7 @@ class HistoryExportResult:
         "username": None,  # string - Username of the user that performed the action
         "user_is_from_parent_site": None,  # boolean - true if this change was performed by a user on a parent site.
         "action": None,  # string - What action was taken. Valid values: `create`, `read`, `update`, `destroy`, `move`, `login`, `failedlogin`, `copy`, `user_create`, `user_update`, `user_destroy`, `group_create`, `group_update`, `group_destroy`, `permission_create`, `permission_destroy`, `api_key_create`, `api_key_update`, `api_key_destroy`, `archived_delete`
-        "failure_type": None,  # string - The type of login failure, if applicable.  Valid values: `expired_trial`, `account_overdue`, `locked_out`, `ip_mismatch`, `password_mismatch`, `site_mismatch`, `username_not_found`, `none`, `no_ftp_permission`, `no_web_permission`, `no_directory`, `errno_enoent`, `no_sftp_permission`, `no_dav_permission`, `no_restapi_permission`, `key_mismatch`, `region_mismatch`, `expired_access`, `desktop_ip_mismatch`, `desktop_api_key_not_used_quickly_enough`, `disabled`, `country_mismatch`, `insecure_ftp`, `insecure_cipher`, `rate_limited`
+        "failure_type": None,  # string - The type of login failure, if applicable.  Valid values: `expired_trial`, `account_overdue`, `locked_out`, `ip_mismatch`, `password_mismatch`, `site_mismatch`, `username_not_found`, `none`, `no_ftp_permission`, `no_web_permission`, `no_directory`, `errno_enoent`, `no_sftp_permission`, `no_dav_permission`, `no_restapi_permission`, `key_mismatch`, `region_mismatch`, `expired_access`, `desktop_ip_mismatch`, `desktop_api_key_not_used_quickly_enough`, `disabled`, `country_mismatch`, `insecure_ftp`, `insecure_cipher`, `rate_limited`, `no_s3_compatible_endpoint_permission`
         "interface": None,  # string - Interface through which the action was taken. Valid values: `web`, `ftp`, `robot`, `jsapi`, `webdesktopapi`, `sftp`, `dav`, `desktop`, `restapi`, `scim`, `office`, `mobile`, `as2`, `inbound_email`, `remote`, `inbound_s3`
         "target_id": None,  # int64 - ID of the object (such as Users, or API Keys) on which the action was taken
         "target_name": None,  # string - Name of the User, Group or other object with a name related to this action

{files_com-1.6.470 → files_com-1.6.472}/files_sdk/models/user.py

@@ -79,6 +79,7 @@ class User:
         "responsible_user_id": None,  # int64 - ID of the internal User responsible for this Partner User, overriding the Partner default.
         "readonly_site_admin": None,  # boolean - Is the user an allowed to view all (non-billing) site configuration for this site?
         "restapi_permission": None,  # boolean - Can this user access the Web app, Desktop app, SDKs, or REST API?  (All of these tools use the API internally, so this is one unified permission set.)
+        "s3_compatible_endpoint_permission": None,  # boolean - Can the user access the S3-compatible endpoint? Defaults to true.
         "self_managed": None,  # boolean - Does this user manage it's own credentials or is it a shared/bot user?
         "sftp_permission": None,  # boolean - Can the user access with SFTP?
         "site_admin": None,  # boolean - Is the user an administrator for this site?
@@ -252,6 +253,7 @@ class User:
     #   responsible_group_id - int64 - ID of the internal Group responsible for this Partner User, overriding the Partner default.
     #   responsible_user_id - int64 - ID of the internal User responsible for this Partner User, overriding the Partner default.
     #   restapi_permission - boolean - Can this user access the Web app, Desktop app, SDKs, or REST API?  (All of these tools use the API internally, so this is one unified permission set.)
+    #   s3_compatible_endpoint_permission - boolean - Can the user access the S3-compatible endpoint? Defaults to true.
     #   self_managed - boolean - Does this user manage it's own credentials or is it a shared/bot user?
     #   sftp_permission - boolean - Can the user access with SFTP?
     #   site_admin - boolean - Is the user an administrator for this site?
@@ -664,6 +666,7 @@ def get(id, params=None, options=None):
 #   responsible_group_id - int64 - ID of the internal Group responsible for this Partner User, overriding the Partner default.
 #   responsible_user_id - int64 - ID of the internal User responsible for this Partner User, overriding the Partner default.
 #   restapi_permission - boolean - Can this user access the Web app, Desktop app, SDKs, or REST API?  (All of these tools use the API internally, so this is one unified permission set.)
+#   s3_compatible_endpoint_permission - boolean - Can the user access the S3-compatible endpoint? Defaults to true.
 #   self_managed - boolean - Does this user manage it's own credentials or is it a shared/bot user?
 #   sftp_permission - boolean - Can the user access with SFTP?
 #   site_admin - boolean - Is the user an administrator for this site?
@@ -955,6 +958,12 @@ def create(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: restapi_permission must be an bool"
         )
+    if "s3_compatible_endpoint_permission" in params and not isinstance(
+        params["s3_compatible_endpoint_permission"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: s3_compatible_endpoint_permission must be an bool"
+        )
     if "self_managed" in params and not isinstance(
         params["self_managed"], bool
     ):
@@ -1140,6 +1149,7 @@ def user_2fa_reset(id, params=None, options=None):
 #   responsible_group_id - int64 - ID of the internal Group responsible for this Partner User, overriding the Partner default.
 #   responsible_user_id - int64 - ID of the internal User responsible for this Partner User, overriding the Partner default.
 #   restapi_permission - boolean - Can this user access the Web app, Desktop app, SDKs, or REST API?  (All of these tools use the API internally, so this is one unified permission set.)
+#   s3_compatible_endpoint_permission - boolean - Can the user access the S3-compatible endpoint? Defaults to true.
 #   self_managed - boolean - Does this user manage it's own credentials or is it a shared/bot user?
 #   sftp_permission - boolean - Can the user access with SFTP?
 #   site_admin - boolean - Is the user an administrator for this site?
@@ -1436,6 +1446,12 @@ def update(id, params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: restapi_permission must be an bool"
         )
+    if "s3_compatible_endpoint_permission" in params and not isinstance(
+        params["s3_compatible_endpoint_permission"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: s3_compatible_endpoint_permission must be an bool"
+        )
     if "self_managed" in params and not isinstance(
         params["self_managed"], bool
     ):

{files_com-1.6.470 → files_com-1.6.472}/pyproject.toml

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

files_com-1.6.470/_VERSION

@@ -1 +0,0 @@
-1.6.470