aidial-client 0.8.0.dev3__tar.gz → 0.9.0.dev1__tar.gz

{aidial_client-0.8.0.dev3 → aidial_client-0.9.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aidial-client
-Version: 0.8.0.dev3
+Version: 0.9.0.dev1
 Summary: A Python client library for the AI DIAL API
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -552,6 +552,36 @@ await async_client.files.delete(
 )
 ```
 
+#### Moving and Copying Files
+
+Use `move_to()` to relocate a file within DIAL storage and `copy_to()` to duplicate it. Both accept the same `source` / `destination` URLs (relative, absolute, or `PurePosixPath`) and an optional `overwrite` flag (default `False`):
+
+```python
+# Sync client
+sync_client.files.move_to(
+    source=sync_client.my_files_home() / "draft/my-file.txt",
+    destination=sync_client.my_files_home() / "final/my-file.txt",
+)
+sync_client.files.copy_to(
+    source=sync_client.my_files_home() / "final/my-file.txt",
+    destination=sync_client.my_files_home() / "backup/my-file.txt",
+    overwrite=True,
+)
+
+# Async client
+await async_client.files.move_to(
+    source=await async_client.my_files_home() / "draft/my-file.txt",
+    destination=await async_client.my_files_home() / "final/my-file.txt",
+)
+await async_client.files.copy_to(
+    source=await async_client.my_files_home() / "final/my-file.txt",
+    destination=await async_client.my_files_home() / "backup/my-file.txt",
+    overwrite=True,
+)
+```
+
+Both methods return `None` on success. `source` and `destination` must point to files in the same DIAL storage (passing a `prompts/...` URL raises `InvalidDialURLError`).
+
 #### Accessing Metadata
 
 Use `metadata()` to access metadata of a file:

{aidial_client-0.8.0.dev3 → aidial_client-0.9.0.dev1}/README.md

@@ -530,6 +530,36 @@ await async_client.files.delete(
 )
 ```
 
+#### Moving and Copying Files
+
+Use `move_to()` to relocate a file within DIAL storage and `copy_to()` to duplicate it. Both accept the same `source` / `destination` URLs (relative, absolute, or `PurePosixPath`) and an optional `overwrite` flag (default `False`):
+
+```python
+# Sync client
+sync_client.files.move_to(
+    source=sync_client.my_files_home() / "draft/my-file.txt",
+    destination=sync_client.my_files_home() / "final/my-file.txt",
+)
+sync_client.files.copy_to(
+    source=sync_client.my_files_home() / "final/my-file.txt",
+    destination=sync_client.my_files_home() / "backup/my-file.txt",
+    overwrite=True,
+)
+
+# Async client
+await async_client.files.move_to(
+    source=await async_client.my_files_home() / "draft/my-file.txt",
+    destination=await async_client.my_files_home() / "final/my-file.txt",
+)
+await async_client.files.copy_to(
+    source=await async_client.my_files_home() / "final/my-file.txt",
+    destination=await async_client.my_files_home() / "backup/my-file.txt",
+    overwrite=True,
+)
+```
+
+Both methods return `None` on success. `source` and `destination` must point to files in the same DIAL storage (passing a `prompts/...` URL raises `InvalidDialURLError`).
+
 #### Accessing Metadata
 
 Use `metadata()` to access metadata of a file:

{aidial_client-0.8.0.dev3 → aidial_client-0.9.0.dev1}/aidial_client/_http_client/_base.py

@@ -51,7 +51,7 @@ class BaseHTTPClient(ABC, Generic[_HttpInternalClientT, AuthValueT]):
             merge_raw_path = (
                 self.base_url.raw_path + parsed_url.raw_path.lstrip(b"/")
             )
-            return self.base_url.copy_with(raw_path=merge_raw_path.rstrip(b"/"))
+            return self.base_url.copy_with(raw_path=merge_raw_path)
         return parsed_url
 
     def _build_request(

{aidial_client-0.8.0.dev3 → aidial_client-0.9.0.dev1}/aidial_client/resources/files.py

@@ -109,6 +109,46 @@ class Files(Resource, DialStorageResourceMixin):
             on_http_error=_files_error_processor,
         )
 
+    def move_to(
+        self,
+        source: Union[str, PurePosixPath],
+        destination: Union[str, PurePosixPath],
+        overwrite: bool = False,
+    ) -> None:
+        return self.http_client.request(
+            cast_to=NoneType,
+            options=FinalRequestOptions(
+                method="POST",
+                url=urljoin(API_PREFIX, "ops/resource/move"),
+                json_data={
+                    "sourceUrl": self.get_api_path(str(source)),
+                    "destinationUrl": self.get_api_path(str(destination)),
+                    "overwrite": overwrite,
+                },
+            ),
+            on_http_error=_files_error_processor,
+        )
+
+    def copy_to(
+        self,
+        source: Union[str, PurePosixPath],
+        destination: Union[str, PurePosixPath],
+        overwrite: bool = False,
+    ) -> None:
+        return self.http_client.request(
+            cast_to=NoneType,
+            options=FinalRequestOptions(
+                method="POST",
+                url=urljoin(API_PREFIX, "ops/resource/copy"),
+                json_data={
+                    "sourceUrl": self.get_api_path(str(source)),
+                    "destinationUrl": self.get_api_path(str(destination)),
+                    "overwrite": overwrite,
+                },
+            ),
+            on_http_error=_files_error_processor,
+        )
+
     def get_metadata(self, url: Union[str, PurePosixPath]) -> FileMetadata:
         return self.metadata.get(
             resource="files",
@@ -188,6 +228,46 @@ class AsyncFiles(AsyncResource, DialStorageResourceMixin):
             on_http_error=_files_error_processor,
         )
 
+    async def move_to(
+        self,
+        source: Union[str, PurePosixPath],
+        destination: Union[str, PurePosixPath],
+        overwrite: bool = False,
+    ) -> None:
+        return await self.http_client.request(
+            cast_to=NoneType,
+            options=FinalRequestOptions(
+                method="POST",
+                url=urljoin(API_PREFIX, "ops/resource/move"),
+                json_data={
+                    "sourceUrl": self.get_api_path(str(source)),
+                    "destinationUrl": self.get_api_path(str(destination)),
+                    "overwrite": overwrite,
+                },
+            ),
+            on_http_error=_files_error_processor,
+        )
+
+    async def copy_to(
+        self,
+        source: Union[str, PurePosixPath],
+        destination: Union[str, PurePosixPath],
+        overwrite: bool = False,
+    ) -> None:
+        return await self.http_client.request(
+            cast_to=NoneType,
+            options=FinalRequestOptions(
+                method="POST",
+                url=urljoin(API_PREFIX, "ops/resource/copy"),
+                json_data={
+                    "sourceUrl": self.get_api_path(str(source)),
+                    "destinationUrl": self.get_api_path(str(destination)),
+                    "overwrite": overwrite,
+                },
+            ),
+            on_http_error=_files_error_processor,
+        )
+
     async def get_metadata(
         self, url: Union[str, PurePosixPath]
     ) -> FileMetadata:

{aidial_client-0.8.0.dev3 → aidial_client-0.9.0.dev1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aidial-client"
-version = "0.8.0.dev3"
+version = "0.9.0.dev1"
 description = "A Python client library for the AI DIAL API"
 readme = "README.md"
 license = "Apache-2.0"