aidial-client 0.13.0.dev4__tar.gz → 0.14.0.dev1__tar.gz

{aidial_client-0.13.0.dev4 → aidial_client-0.14.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aidial-client
-Version: 0.13.0.dev4
+Version: 0.14.0.dev1
 Summary: A Python client library for the AI DIAL API
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -545,6 +545,25 @@ sync_client.files.upload(
 )
 ```
 
+`upload()` returns a `FileItem` describing the stored file:
+
+```python
+FileItem(
+    name="my-file.txt",
+    parent_path="some-relative-path",
+    bucket="my-bucket",
+    url="files/my-bucket/some-relative-path/my-file.txt",
+    node_type="ITEM",
+    resource_type="FILE",
+    content_length=12,
+    content_type="text/plain",
+    etag="9749fad13d6e7092a6337c4af9d83764",
+    created_at=1724836229736,
+    updated_at=1724836248936,
+    author="user@example.com",
+)
+```
+
 #### Downloading Files
 
 Use `download()` to download files from your storage bucket:
@@ -686,11 +705,12 @@ FileMetadata(
     resource_type="FILE",
     content_length=12,
     content_type="application/octet-stream",
+    etag="9749fad13d6e7092a6337c4af9d83764",
+    created_at=1724836229736,
+    updated_at=1724836248936,
+    author="user@example.com",
     next_token=None,
     items=None,
-    updatedAt=1724836248936,
-    etag="9749fad13d6e7092a6337c4af9d83764",
-    createdAt=1724836229736,
 )
 ```
 

{aidial_client-0.13.0.dev4 → aidial_client-0.14.0.dev1}/README.md

@@ -523,6 +523,25 @@ sync_client.files.upload(
 )
 ```
 
+`upload()` returns a `FileItem` describing the stored file:
+
+```python
+FileItem(
+    name="my-file.txt",
+    parent_path="some-relative-path",
+    bucket="my-bucket",
+    url="files/my-bucket/some-relative-path/my-file.txt",
+    node_type="ITEM",
+    resource_type="FILE",
+    content_length=12,
+    content_type="text/plain",
+    etag="9749fad13d6e7092a6337c4af9d83764",
+    created_at=1724836229736,
+    updated_at=1724836248936,
+    author="user@example.com",
+)
+```
+
 #### Downloading Files
 
 Use `download()` to download files from your storage bucket:
@@ -664,11 +683,12 @@ FileMetadata(
     resource_type="FILE",
     content_length=12,
     content_type="application/octet-stream",
+    etag="9749fad13d6e7092a6337c4af9d83764",
+    created_at=1724836229736,
+    updated_at=1724836248936,
+    author="user@example.com",
     next_token=None,
     items=None,
-    updatedAt=1724836248936,
-    etag="9749fad13d6e7092a6337c4af9d83764",
-    createdAt=1724836229736,
 )
 ```
 

{aidial_client-0.13.0.dev4 → aidial_client-0.14.0.dev1}/aidial_client/resources/files.py

@@ -22,7 +22,7 @@ from aidial_client.helpers.storage_resource import DialStorageResourceMixin
 from aidial_client.resources.base import AsyncResource, Resource
 from aidial_client.resources.metadata import AsyncMetadata, Metadata
 from aidial_client.types.file import FileDownloadResponse
-from aidial_client.types.metadata import FileMetadata
+from aidial_client.types.metadata import FileItem, FileMetadata
 
 
 def _files_error_processor(
@@ -49,9 +49,9 @@ class Files(Resource, DialStorageResourceMixin):
         file: FileTypes,
         etag_if_match: str | None = None,
         etag_if_none_match: Literal["*"] | None = None,
-    ) -> FileMetadata:
+    ) -> FileItem:
         return self.http_client.request(
-            cast_to=FileMetadata,
+            cast_to=FileItem,
             options=FinalRequestOptions(
                 method="PUT",
                 url=urljoin(API_PREFIX, self.get_api_path(str(url))),
@@ -163,9 +163,9 @@ class AsyncFiles(AsyncResource, DialStorageResourceMixin):
         file: FileTypes,
         etag_if_match: str | None = None,
         etag_if_none_match: Literal["*"] | None = None,
-    ) -> FileMetadata:
+    ) -> FileItem:
         return await self.http_client.request(
-            cast_to=FileMetadata,
+            cast_to=FileItem,
             options=FinalRequestOptions(
                 method="PUT",
                 url=urljoin(API_PREFIX, self.get_api_path(str(url))),

{aidial_client-0.13.0.dev4 → aidial_client-0.14.0.dev1}/aidial_client/types/metadata.py

@@ -30,7 +30,10 @@ class FileItem(BaseMetadata):
     resource_type: Literal["FILE"]
     content_length: int | None = None
     content_type: str | None = None
+    created_at: int | None = None
     updated_at: int | None = None
+    etag: str | None = None
+    author: str | None = None
 
 
 class FileMetadata(BaseMetadata):

{aidial_client-0.13.0.dev4 → aidial_client-0.14.0.dev1}/pyproject.toml

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