Files.com 1.6.498__tar.gz → 1.6.500__tar.gz

{files_com-1.6.498/files_com.egg-info → files_com-1.6.500}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.498
+Version: 1.6.500
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5
@@ -734,6 +734,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`TooManySharesError`|  `RateLimitedError` |
 |`AutomationsUnavailableError`|  `ServiceUnavailableError` |
 |`MigrationInProgressError`|  `ServiceUnavailableError` |
+|`SearchUnavailableError`|  `ServiceUnavailableError` |
 |`SiteDisabledError`|  `ServiceUnavailableError` |
 |`UploadsUnavailableError`|  `ServiceUnavailableError` |
 |`AccountAlreadyExistsError`|  `SiteConfigurationError` |

{files_com-1.6.498 → files_com-1.6.500}/README.md

@@ -722,6 +722,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`TooManySharesError`|  `RateLimitedError` |
 |`AutomationsUnavailableError`|  `ServiceUnavailableError` |
 |`MigrationInProgressError`|  `ServiceUnavailableError` |
+|`SearchUnavailableError`|  `ServiceUnavailableError` |
 |`SiteDisabledError`|  `ServiceUnavailableError` |
 |`UploadsUnavailableError`|  `ServiceUnavailableError` |
 |`AccountAlreadyExistsError`|  `SiteConfigurationError` |

files_com-1.6.500/_VERSION

@@ -0,0 +1 @@
+1.6.500

{files_com-1.6.498 → files_com-1.6.500/files_com.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: files_com
-Version: 1.6.498
+Version: 1.6.500
 Summary: Python bindings for the Files.com API
 License: MIT
 Requires-Python: >=3.5
@@ -734,6 +734,7 @@ files_sdk.error.FolderAdminPermissionRequiredError -> files_sdk.error.NotAuthori
 |`TooManySharesError`|  `RateLimitedError` |
 |`AutomationsUnavailableError`|  `ServiceUnavailableError` |
 |`MigrationInProgressError`|  `ServiceUnavailableError` |
+|`SearchUnavailableError`|  `ServiceUnavailableError` |
 |`SiteDisabledError`|  `ServiceUnavailableError` |
 |`UploadsUnavailableError`|  `ServiceUnavailableError` |
 |`AccountAlreadyExistsError`|  `SiteConfigurationError` |

{files_com-1.6.498 → files_com-1.6.500}/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.498 → files_com-1.6.500}/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.498"
+version = "1.6.500"
 
 __version__ = version
 

{files_com-1.6.498 → files_com-1.6.500}/files_sdk/error.py

@@ -3197,6 +3197,21 @@ class MigrationInProgressError(ServiceUnavailableError):
         )
 
 
+class SearchUnavailableError(ServiceUnavailableError):
+    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 SiteDisabledError(ServiceUnavailableError):
     def __init__(
         self,

{files_com-1.6.498 → files_com-1.6.500}/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.498 → files_com-1.6.500}/files_sdk/models/folder.py

@@ -84,7 +84,7 @@ class Folder:
 #   path (required) - string - Path to operate on.
 #   preview_size - string - Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
 #   sort_by - object - Search by field and direction. Valid fields are `path`, `size`, `modified_at_datetime`, `provided_modified_at`.  Valid directions are `asc` and `desc`.  Defaults to `{"path":"asc"}`.
-#   search - string - If specified, will search the folders/files list by name. Ignores text before last `/`. This is the same API used by the search bar in the web UI when running 'Search This Folder'.  Search results are a best effort, not real time, and not guaranteed to perfectly match the latest folder listing.  Results may be truncated if more than 1,000 possible matches exist.  This field should only be used for ad-hoc (human) searching, and not as part of an automated process.
+#   search - string - If specified, will search the folders/files list by name. Ignores text before last `/`. This is the same API used by the search bar in the web UI when running 'Search This Folder'.  Search results are a best effort, not real time, and not guaranteed to perfectly match the latest folder listing.  Results may be truncated if more than 1,000 possible matches exist.  This field should only be used for ad-hoc (human) searching, and not as part of an automated process. During scheduled search maintenance, indexed searches return HTTP 422 with error type `service-unavailable/search-unavailable`; retry after maintenance ends. Folder listing without `search` remains available.
 #   search_custom_metadata_key - string - If provided, the search string in `search` will search for files where this custom metadata key matches the value sent in `search`.  Set this to `*` to allow any metadata key to match the value sent in `search`.
 #   search_all - boolean - Search entire site?  If true, we will search the entire site.  Do not provide a path when using this parameter.  This is the same API used by the search bar in the web UI when running 'Search All Files'.  Search results are a best effort, not real time, and not guaranteed to match every file.  This field should only be used for ad-hoc (human) searching, and not as part of an automated process.
 #   with_previews - boolean - Include file previews?

{files_com-1.6.498 → files_com-1.6.500}/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.498 → files_com-1.6.500}/pyproject.toml

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

files_com-1.6.500/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.498/_VERSION

@@ -1 +0,0 @@
-1.6.498