feat(api): manual updates

add /uploads endpoint

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 4
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/meta%2Fllama-api-bfa0267b010dcc4b39e62dfbd698ac6f9421f3212c44b3408b9b154bd6c67a8b.yml
-openapi_spec_hash: 7f424537bc7ea7638e3934ef721b8d71
-config_hash: fd80f72884b7fef46327f3fb70dcb1c4
+configured_endpoints: 7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/meta%2Fllama-api-edf0a308dd29bea2feb29f2e7f04eec4dbfb130ffe52511641783958168f60a4.yml
+openapi_spec_hash: 23af966c58151516aaef00e0af602c01
+config_hash: 431a8aed31c3576451a36d2db8f48c25

README.md

@@ -172,6 +172,24 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## File uploads
+
+Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
+
+```python
+from pathlib import Path
+from llama_api_client import LlamaAPIClient
+
+client = LlamaAPIClient()
+
+client.uploads.part(
+    upload_id="upload_id",
+    data=Path("/path/to/file"),
+)
+```
+
+The async client uses the exact same interface. If you pass a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance, the file contents will be read asynchronously automatically.
+
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `llama_api_client.APIConnectionError` is raised.

api.md

@@ -35,6 +35,20 @@ Methods:
 - <code title="get /models/{model}">client.models.<a href="./src/llama_api_client/resources/models.py">retrieve</a>(model) -> <a href="./src/llama_api_client/types/llama_model.py">LlamaModel</a></code>
 - <code title="get /models">client.models.<a href="./src/llama_api_client/resources/models.py">list</a>() -> <a href="./src/llama_api_client/types/model_list_response.py">ModelListResponse</a></code>
 
+# Uploads
+
+Types:
+
+```python
+from llama_api_client.types import UploadCreateResponse, UploadGetResponse, UploadPartResponse
+```
+
+Methods:
+
+- <code title="post /uploads">client.uploads.<a href="./src/llama_api_client/resources/uploads.py">create</a>(\*\*<a href="src/llama_api_client/types/upload_create_params.py">params</a>) -> <a href="./src/llama_api_client/types/upload_create_response.py">UploadCreateResponse</a></code>
+- <code title="get /uploads/{upload_id}">client.uploads.<a href="./src/llama_api_client/resources/uploads.py">get</a>(upload_id) -> <a href="./src/llama_api_client/types/upload_get_response.py">UploadGetResponse</a></code>
+- <code title="post /uploads/{upload_id}">client.uploads.<a href="./src/llama_api_client/resources/uploads.py">part</a>(upload_id, \*\*<a href="src/llama_api_client/types/upload_part_params.py">params</a>) -> <a href="./src/llama_api_client/types/upload_part_response.py">UploadPartResponse</a></code>
+
 # Moderations
 
 Types:

src/llama_api_client/_client.py

@@ -21,7 +21,7 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import models, moderations
+from .resources import models, uploads, moderations
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import APIStatusError, LlamaAPIClientError
 from ._base_client import (
@@ -46,6 +46,7 @@
 class LlamaAPIClient(SyncAPIClient):
     chat: chat.ChatResource
     models: models.ModelsResource
+    uploads: uploads.UploadsResource
     moderations: moderations.ModerationsResource
     with_raw_response: LlamaAPIClientWithRawResponse
     with_streaming_response: LlamaAPIClientWithStreamedResponse
@@ -106,6 +107,7 @@ def __init__(
 
         self.chat = chat.ChatResource(self)
         self.models = models.ModelsResource(self)
+        self.uploads = uploads.UploadsResource(self)
         self.moderations = moderations.ModerationsResource(self)
         self.with_raw_response = LlamaAPIClientWithRawResponse(self)
         self.with_streaming_response = LlamaAPIClientWithStreamedResponse(self)
@@ -218,6 +220,7 @@ def _make_status_error(
 class AsyncLlamaAPIClient(AsyncAPIClient):
     chat: chat.AsyncChatResource
     models: models.AsyncModelsResource
+    uploads: uploads.AsyncUploadsResource
     moderations: moderations.AsyncModerationsResource
     with_raw_response: AsyncLlamaAPIClientWithRawResponse
     with_streaming_response: AsyncLlamaAPIClientWithStreamedResponse
@@ -278,6 +281,7 @@ def __init__(
 
         self.chat = chat.AsyncChatResource(self)
         self.models = models.AsyncModelsResource(self)
+        self.uploads = uploads.AsyncUploadsResource(self)
         self.moderations = moderations.AsyncModerationsResource(self)
         self.with_raw_response = AsyncLlamaAPIClientWithRawResponse(self)
         self.with_streaming_response = AsyncLlamaAPIClientWithStreamedResponse(self)
@@ -391,27 +395,31 @@ class LlamaAPIClientWithRawResponse:
     def __init__(self, client: LlamaAPIClient) -> None:
         self.chat = chat.ChatResourceWithRawResponse(client.chat)
         self.models = models.ModelsResourceWithRawResponse(client.models)
+        self.uploads = uploads.UploadsResourceWithRawResponse(client.uploads)
         self.moderations = moderations.ModerationsResourceWithRawResponse(client.moderations)
 
 
 class AsyncLlamaAPIClientWithRawResponse:
     def __init__(self, client: AsyncLlamaAPIClient) -> None:
         self.chat = chat.AsyncChatResourceWithRawResponse(client.chat)
         self.models = models.AsyncModelsResourceWithRawResponse(client.models)
+        self.uploads = uploads.AsyncUploadsResourceWithRawResponse(client.uploads)
         self.moderations = moderations.AsyncModerationsResourceWithRawResponse(client.moderations)
 
 
 class LlamaAPIClientWithStreamedResponse:
     def __init__(self, client: LlamaAPIClient) -> None:
         self.chat = chat.ChatResourceWithStreamingResponse(client.chat)
         self.models = models.ModelsResourceWithStreamingResponse(client.models)
+        self.uploads = uploads.UploadsResourceWithStreamingResponse(client.uploads)
         self.moderations = moderations.ModerationsResourceWithStreamingResponse(client.moderations)
 
 
 class AsyncLlamaAPIClientWithStreamedResponse:
     def __init__(self, client: AsyncLlamaAPIClient) -> None:
         self.chat = chat.AsyncChatResourceWithStreamingResponse(client.chat)
         self.models = models.AsyncModelsResourceWithStreamingResponse(client.models)
+        self.uploads = uploads.AsyncUploadsResourceWithStreamingResponse(client.uploads)
         self.moderations = moderations.AsyncModerationsResourceWithStreamingResponse(client.moderations)
 
 

src/llama_api_client/_files.py

@@ -34,7 +34,7 @@ def assert_is_file_content(obj: object, *, key: str | None = None) -> None:
     if not is_file_content(obj):
         prefix = f"Expected entry at `{key}`" if key is not None else f"Expected file input `{obj!r}`"
         raise RuntimeError(
-            f"{prefix} to be bytes, an io.IOBase instance, PathLike or a tuple but received {type(obj)} instead."
+            f"{prefix} to be bytes, an io.IOBase instance, PathLike or a tuple but received {type(obj)} instead. See https://github.com/meta-llama/llama-api-python/tree/main#file-uploads"
         ) from None
 
 

src/llama_api_client/resources/__init__.py

@@ -16,6 +16,14 @@
     ModelsResourceWithStreamingResponse,
     AsyncModelsResourceWithStreamingResponse,
 )
+from .uploads import (
+    UploadsResource,
+    AsyncUploadsResource,
+    UploadsResourceWithRawResponse,
+    AsyncUploadsResourceWithRawResponse,
+    UploadsResourceWithStreamingResponse,
+    AsyncUploadsResourceWithStreamingResponse,
+)
 from .moderations import (
     ModerationsResource,
     AsyncModerationsResource,
@@ -38,6 +46,12 @@
     "AsyncModelsResourceWithRawResponse",
     "ModelsResourceWithStreamingResponse",
     "AsyncModelsResourceWithStreamingResponse",
+    "UploadsResource",
+    "AsyncUploadsResource",
+    "UploadsResourceWithRawResponse",
+    "AsyncUploadsResourceWithRawResponse",
+    "UploadsResourceWithStreamingResponse",
+    "AsyncUploadsResourceWithStreamingResponse",
     "ModerationsResource",
     "AsyncModerationsResource",
     "ModerationsResourceWithRawResponse",