Files.com 1.6.497__tar.gz → 1.6.499__tar.gz

{files_com-1.6.497/files_com.egg-info → files_com-1.6.499}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.497
+Version: 1.6.499
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5
@@ -611,6 +611,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`BillingPermissionRequiredError`|  `NotAuthorizedError` |
 |`BundleMaximumUsesReachedError`|  `NotAuthorizedError` |
 |`BundlePermissionRequiredError`|  `NotAuthorizedError` |
+|`CannotAdministerHigherLevelUserError`|  `NotAuthorizedError` |
 |`CannotLoginWhileUsingKeyError`|  `NotAuthorizedError` |
 |`CantActForOtherUserError`|  `NotAuthorizedError` |
 |`ContactAdminForPasswordChangeHelpError`|  `NotAuthorizedError` |
@@ -712,6 +713,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`MultipleProcessingErrorsError`|  `ProcessingFailureError` |
 |`PathTooLongError`|  `ProcessingFailureError` |
 |`RecipientAlreadySharedError`|  `ProcessingFailureError` |
+|`RemoteEntryReadOnlyError`|  `ProcessingFailureError` |
 |`RemoteServerErrorError`|  `ProcessingFailureError` |
 |`ResourceBelongsToParentSiteError`|  `ProcessingFailureError` |
 |`ResourceLockedError`|  `ProcessingFailureError` |

{files_com-1.6.497 → files_com-1.6.499}/README.md

@@ -599,6 +599,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`BillingPermissionRequiredError`|  `NotAuthorizedError` |
 |`BundleMaximumUsesReachedError`|  `NotAuthorizedError` |
 |`BundlePermissionRequiredError`|  `NotAuthorizedError` |
+|`CannotAdministerHigherLevelUserError`|  `NotAuthorizedError` |
 |`CannotLoginWhileUsingKeyError`|  `NotAuthorizedError` |
 |`CantActForOtherUserError`|  `NotAuthorizedError` |
 |`ContactAdminForPasswordChangeHelpError`|  `NotAuthorizedError` |
@@ -700,6 +701,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`MultipleProcessingErrorsError`|  `ProcessingFailureError` |
 |`PathTooLongError`|  `ProcessingFailureError` |
 |`RecipientAlreadySharedError`|  `ProcessingFailureError` |
+|`RemoteEntryReadOnlyError`|  `ProcessingFailureError` |
 |`RemoteServerErrorError`|  `ProcessingFailureError` |
 |`ResourceBelongsToParentSiteError`|  `ProcessingFailureError` |
 |`ResourceLockedError`|  `ProcessingFailureError` |

files_com-1.6.499/_VERSION

@@ -0,0 +1 @@
+1.6.499

{files_com-1.6.497 → files_com-1.6.499/files_com.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.497
+Version: 1.6.499
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5
@@ -611,6 +611,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`BillingPermissionRequiredError`|  `NotAuthorizedError` |
 |`BundleMaximumUsesReachedError`|  `NotAuthorizedError` |
 |`BundlePermissionRequiredError`|  `NotAuthorizedError` |
+|`CannotAdministerHigherLevelUserError`|  `NotAuthorizedError` |
 |`CannotLoginWhileUsingKeyError`|  `NotAuthorizedError` |
 |`CantActForOtherUserError`|  `NotAuthorizedError` |
 |`ContactAdminForPasswordChangeHelpError`|  `NotAuthorizedError` |
@@ -712,6 +713,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`MultipleProcessingErrorsError`|  `ProcessingFailureError` |
 |`PathTooLongError`|  `ProcessingFailureError` |
 |`RecipientAlreadySharedError`|  `ProcessingFailureError` |
+|`RemoteEntryReadOnlyError`|  `ProcessingFailureError` |
 |`RemoteServerErrorError`|  `ProcessingFailureError` |
 |`ResourceBelongsToParentSiteError`|  `ProcessingFailureError` |
 |`ResourceLockedError`|  `ProcessingFailureError` |

{files_com-1.6.497 → files_com-1.6.499}/files_com.egg-info/SOURCES.txt

@@ -223,6 +223,7 @@ tests/test_file.py
 tests/test_file_action.py
 tests/test_file_comment.py
 tests/test_file_comment_reaction.py
+tests/test_file_download_default_path.py
 tests/test_file_migration.py
 tests/test_file_migration_log.py
 tests/test_file_underscore_destinations.py

{files_com-1.6.497 → files_com-1.6.499}/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.497"
+version = "1.6.499"
 
 __version__ = version
 

{files_com-1.6.497 → files_com-1.6.499}/files_sdk/error.py

@@ -1282,6 +1282,21 @@ class BundlePermissionRequiredError(NotAuthorizedError):
         )
 
 
+class CannotAdministerHigherLevelUserError(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 CannotLoginWhileUsingKeyError(NotAuthorizedError):
     def __init__(
         self,
@@ -2833,6 +2848,21 @@ class RecipientAlreadySharedError(ProcessingFailureError):
         )
 
 
+class RemoteEntryReadOnlyError(ProcessingFailureError):
+    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 RemoteServerErrorError(ProcessingFailureError):
     def __init__(
         self,

{files_com-1.6.497 → files_com-1.6.499}/files_sdk/models/file.py

@@ -3,6 +3,7 @@ from urllib.parse import quote
 from builtins import open as builtin_open
 from datetime import datetime
 import io
+import os
 from pathlib import Path
 import files_sdk.path_util as path_util
 from files_sdk.models.zip_list_entry import ZipListEntry
@@ -1590,11 +1591,22 @@ def move_to_child_site(path, site_id, destination, params=None, options=None):
     return move(path, params, options)
 
 
+def _default_local_path(path):
+    name = path_util.normalize(path).split("/")[-1]
+    # On Windows a colon makes the name a drive-relative path or an NTFS
+    # stream, which can write outside the working directory or onto another file.
+    if os.name == "nt" and ":" in name:
+        raise InvalidParameterError(
+            f"Bad parameter: local_path is required because {name!r} is not a valid local file name"
+        )
+    return name
+
+
 def download_file(path, local_path=None, options=None):
     if not isinstance(options, dict):
         options = {}
     if local_path is None:
-        local_path = Path(path).name
+        local_path = _default_local_path(path)
     return File(path, {}, options).download_file(local_path)
 
 

{files_com-1.6.497 → files_com-1.6.499}/files_sdk/models/remote_server.py

@@ -38,7 +38,7 @@ class RemoteServer:
         "s3_assume_role_duration_seconds": None,  # int64 - Session duration in seconds for AssumeRole authentication (900-43200).
         "s3_assume_role_external_id": None,  # string - External ID for AssumeRole authentication.
         "server_certificate": None,  # string - Remote server certificate
-        "server_host_key": None,  # string - Pinned plain SSH host key for SFTP, in OpenSSH public key format. If omitted, Files.com detects and stores the server's plain host key, including when the server offers an OpenSSH host certificate. With `server_certificate=require_match` (the default), the server must present the pinned key and prove it holds the matching private key. The pin remains in force until an administrator updates `server_host_key`. Files.com does not authenticate remote hosts through SSH certificates and does not check their CA signatures, principals, or validity periods. Certificate expiration does not end the pin; update `server_host_key` to retire a host key.
+        "server_host_key": None,  # string - Pinned SSH host key or OpenSSH host certificate for SFTP. If omitted, Files.com detects and stores a host key, preferring plain keys over certificates. With `server_certificate=require_match` (the default), the server must present the exact pinned key or certificate and prove it holds the matching private key. A pinned certificate is compared in full, so renewal can require updating `server_host_key` even when its underlying key is unchanged. Files.com does not check certificate CA signatures, principals, or validity periods. Certificate expiration alone does not end the pin. Update `server_host_key` to replace the pin.
         "server_type": None,  # string - Remote server type.
         "workspace_id": None,  # int64 - Workspace ID (0 for default workspace)
         "ssl": None,  # string - Should we require SSL?
@@ -264,7 +264,7 @@ class RemoteServer:
     #   s3_compatible_virtual_hosted_style - boolean - S3-compatible: If true, use virtual-hosted-style URLs instead of path-style URLs
     #   s3_region - string - S3 region
     #   server_certificate - string - Remote server certificate
-    #   server_host_key - string - Pinned plain SSH host key for SFTP, in OpenSSH public key format. If omitted, Files.com detects and stores the server's plain host key, including when the server offers an OpenSSH host certificate. With `server_certificate=require_match` (the default), the server must present the pinned key and prove it holds the matching private key. The pin remains in force until an administrator updates `server_host_key`. Files.com does not authenticate remote hosts through SSH certificates and does not check their CA signatures, principals, or validity periods. Certificate expiration does not end the pin; update `server_host_key` to retire a host key.
+    #   server_host_key - string - Pinned SSH host key or OpenSSH host certificate for SFTP. If omitted, Files.com detects and stores a host key, preferring plain keys over certificates. With `server_certificate=require_match` (the default), the server must present the exact pinned key or certificate and prove it holds the matching private key. A pinned certificate is compared in full, so renewal can require updating `server_host_key` even when its underlying key is unchanged. Files.com does not check certificate CA signatures, principals, or validity periods. Certificate expiration alone does not end the pin. Update `server_host_key` to replace the pin.
     #   server_type - string - Remote server type.
     #   sharepoint_client_id - string - SharePoint: Microsoft Entra application client ID for app-only authentication.
     #   sharepoint_site_url - string - SharePoint: Site URL to scope app-only authentication to a single site. Leave blank to browse all sites.
@@ -957,7 +957,7 @@ def find_configuration_file(id, params=None, options=None):
 #   s3_compatible_virtual_hosted_style - boolean - S3-compatible: If true, use virtual-hosted-style URLs instead of path-style URLs
 #   s3_region - string - S3 region
 #   server_certificate - string - Remote server certificate
-#   server_host_key - string - Pinned plain SSH host key for SFTP, in OpenSSH public key format. If omitted, Files.com detects and stores the server's plain host key, including when the server offers an OpenSSH host certificate. With `server_certificate=require_match` (the default), the server must present the pinned key and prove it holds the matching private key. The pin remains in force until an administrator updates `server_host_key`. Files.com does not authenticate remote hosts through SSH certificates and does not check their CA signatures, principals, or validity periods. Certificate expiration does not end the pin; update `server_host_key` to retire a host key.
+#   server_host_key - string - Pinned SSH host key or OpenSSH host certificate for SFTP. If omitted, Files.com detects and stores a host key, preferring plain keys over certificates. With `server_certificate=require_match` (the default), the server must present the exact pinned key or certificate and prove it holds the matching private key. A pinned certificate is compared in full, so renewal can require updating `server_host_key` even when its underlying key is unchanged. Files.com does not check certificate CA signatures, principals, or validity periods. Certificate expiration alone does not end the pin. Update `server_host_key` to replace the pin.
 #   server_type - string - Remote server type.
 #   sharepoint_client_id - string - SharePoint: Microsoft Entra application client ID for app-only authentication.
 #   sharepoint_site_url - string - SharePoint: Site URL to scope app-only authentication to a single site. Leave blank to browse all sites.
@@ -1555,7 +1555,7 @@ def agent_push_update(id, params=None, options=None):
 #   s3_compatible_virtual_hosted_style - boolean - S3-compatible: If true, use virtual-hosted-style URLs instead of path-style URLs
 #   s3_region - string - S3 region
 #   server_certificate - string - Remote server certificate
-#   server_host_key - string - Pinned plain SSH host key for SFTP, in OpenSSH public key format. If omitted, Files.com detects and stores the server's plain host key, including when the server offers an OpenSSH host certificate. With `server_certificate=require_match` (the default), the server must present the pinned key and prove it holds the matching private key. The pin remains in force until an administrator updates `server_host_key`. Files.com does not authenticate remote hosts through SSH certificates and does not check their CA signatures, principals, or validity periods. Certificate expiration does not end the pin; update `server_host_key` to retire a host key.
+#   server_host_key - string - Pinned SSH host key or OpenSSH host certificate for SFTP. If omitted, Files.com detects and stores a host key, preferring plain keys over certificates. With `server_certificate=require_match` (the default), the server must present the exact pinned key or certificate and prove it holds the matching private key. A pinned certificate is compared in full, so renewal can require updating `server_host_key` even when its underlying key is unchanged. Files.com does not check certificate CA signatures, principals, or validity periods. Certificate expiration alone does not end the pin. Update `server_host_key` to replace the pin.
 #   server_type - string - Remote server type.
 #   sharepoint_client_id - string - SharePoint: Microsoft Entra application client ID for app-only authentication.
 #   sharepoint_site_url - string - SharePoint: Site URL to scope app-only authentication to a single site. Leave blank to browse all sites.

{files_com-1.6.497 → files_com-1.6.499}/files_sdk/models/site.py

@@ -18,7 +18,7 @@ class Site:
         "id": None,  # int64 - Site Id
         "name": None,  # string - Site name
         "additional_text_file_types": None,  # array(string) - Additional extensions that are considered text files
-        "ai_feature_availability": None,  # object - Availability settings for AI features by user class
+        "ai_feature_availability": None,  # object - Availability settings for AI features. Each feature requires the site_admins, workspace_admins, folder_admins, and all_users keys. Optional selected_group_members defaults to false; when true, members of at least one group in group_ids get access regardless of the other options. All availability options are additive: any enabled option matching the user grants access. Optional group_ids is an array of integer IDs of active groups on this site, from any workspace. Omitted or empty group_ids grants no access through selected_group_members and does not affect other options. Disabling all AI features overrides these settings.
         "allowed_2fa_method_sms": None,  # boolean - Is SMS two factor authentication allowed?
         "allowed_2fa_method_totp": None,  # boolean - Is TOTP two factor authentication allowed?
         "allowed_2fa_method_webauthn": None,  # boolean - Is WebAuthn two factor authentication allowed?
@@ -165,6 +165,7 @@ class Site:
         "require_2fa_user_type": None,  # string - What type of user is required to use two-factor authentication (when require_2fa is set to `true` for this site)?
         "require_logout_from_bundles_and_inboxes": None,  # boolean - If true, we will hide the 'Remember Me' box on Inbox and Bundle registration pages, requiring that the user logout and log back in every time they visit the page.
         "session": None,  # Session - Current session
+        "s3_compatible_endpoint_enabled": None,  # boolean - Is the S3-compatible endpoint enabled for all users and workspaces on this site? Defaults to true. When false, user and group S3 permissions do not allow access.
         "sftp_enabled": None,  # boolean - Is SFTP enabled?
         "sftp_finalize_partial_uploads": None,  # boolean - Finalize partial SFTP uploads from interrupted connections? Default: true.
         "sftp_host_key_type": None,  # string - Sftp Host Key Type
@@ -298,7 +299,7 @@ def get_usage(params=None, options=None):
 #   motd_use_for_sftp - boolean - Show message to users connecting via SFTP
 #   left_navigation_visibility - object - Visibility settings for account navigation
 #   disable_all_ai_features - boolean - If true, all AI features are disabled for this site.
-#   ai_feature_availability - object - Availability settings for AI features by user class
+#   ai_feature_availability - object - Availability settings for AI features. Each feature requires the site_admins, workspace_admins, folder_admins, and all_users keys. Optional selected_group_members defaults to false; when true, members of at least one group in group_ids get access regardless of the other options. All availability options are additive: any enabled option matching the user grants access. Optional group_ids is an array of integer IDs of active groups on this site, from any workspace. Omitted or empty group_ids grants no access through selected_group_members and does not affect other options. Disabling all AI features overrides these settings.
 #   mcp_dcr_enabled - boolean - Is OAuth DCR (dynamic client registration) for MCP enabled?
 #   additional_text_file_types - array(string) - Additional extensions that are considered text files
 #   bundle_require_note - boolean - Do Bundles require internal notes?
@@ -367,6 +368,7 @@ def get_usage(params=None, options=None):
 #   user_requests_notify_admins - boolean - Send email to site admins when a user request is received?
 #   dav_enabled - boolean - Is WebDAV enabled?
 #   ftp_enabled - boolean - Is FTP enabled?
+#   s3_compatible_endpoint_enabled - boolean - Is the S3-compatible endpoint enabled for all users and workspaces on this site? Defaults to true. When false, user and group S3 permissions do not allow access.
 #   sftp_enabled - boolean - Is SFTP enabled?
 #   sftp_finalize_partial_uploads - boolean - Finalize partial SFTP uploads from interrupted connections? Default: true.
 #   users_can_create_api_keys - boolean - Allow users to create their own API keys?
@@ -1059,6 +1061,12 @@ def update(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: ftp_enabled must be an bool"
         )
+    if "s3_compatible_endpoint_enabled" in params and not isinstance(
+        params["s3_compatible_endpoint_enabled"], bool
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: s3_compatible_endpoint_enabled must be an bool"
+        )
     if "sftp_enabled" in params and not isinstance(
         params["sftp_enabled"], bool
     ):

{files_com-1.6.497 → files_com-1.6.499}/pyproject.toml

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

files_com-1.6.499/tests/test_file_download_default_path.py

@@ -0,0 +1,27 @@
+import unittest
+from unittest import mock
+
+import files_sdk
+from files_sdk.error import InvalidParameterError
+from files_sdk.models import file as file_model
+
+
+class TestFileDownloadDefaultPath(unittest.TestCase):
+    def test_download_without_local_path_uses_the_remote_file_name(self):
+        with mock.patch.object(file_model.os, "name", "posix"), mock.patch.object(file_model.File, "download_file") as mock_download_file:
+            files_sdk.file.download_file("folder/report:2026.txt")
+
+        mock_download_file.assert_called_once_with("report:2026.txt")
+
+    def test_windows_download_without_local_path_rejects_drive_and_stream_names(self):
+        for remote_path in ("folder/C:victim.txt", "C:victim.txt", "folder/victim.txt::$DATA"):
+            with self.subTest(remote_path=remote_path):
+                with mock.patch.object(file_model.os, "name", "nt"), mock.patch.object(file_model.File, "download_file") as mock_download_file:
+                    with self.assertRaises(InvalidParameterError):
+                        files_sdk.file.download_file(remote_path)
+
+                mock_download_file.assert_not_called()
+
+
+if __name__ == '__main__':
+    unittest.main()

files_com-1.6.497/_VERSION

@@ -1 +0,0 @@
-1.6.497