feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-17320f0488a9b933245c77e962932c0323d8e940123f2571f93e476c5b5c2d18.yml
-openapi_spec_hash: 8c13c404e5eb19f455dc7155c7f93e45
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-aebc3d012c87df9d5cb4d651a374fceefb5154e74c70f51d927c76b923267a85.yml
+openapi_spec_hash: 98493a823305edac2c711cd052971f3d
 config_hash: eb32087403f958eead829e810f5a71b8

README.md

@@ -24,11 +24,10 @@ pip install --pre supermemory
 The full API of this library can be found in [api.md](api.md).
 
 ```python
-import os
 from supermemory import Supermemory
 
 client = Supermemory(
-    api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
+    api_key="My API Key",
 )
 
 response = client.search.execute(
@@ -37,22 +36,16 @@ response = client.search.execute(
 print(response.results)
 ```
 
-While you can provide an `api_key` keyword argument,
-we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/)
-to add `SUPERMEMORY_API_KEY="My API Key"` to your `.env` file
-so that your API Key is not stored in source control.
-
 ## Async usage
 
 Simply import `AsyncSupermemory` instead of `Supermemory` and use `await` with each API call:
 
 ```python
-import os
 import asyncio
 from supermemory import AsyncSupermemory
 
 client = AsyncSupermemory(
-    api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
+    api_key="My API Key",
 )
 
 
@@ -90,7 +83,9 @@ All errors inherit from `supermemory.APIError`.
 import supermemory
 from supermemory import Supermemory
 
-client = Supermemory()
+client = Supermemory(
+    api_key="My API Key",
+)
 
 try:
     client.memory.create(
@@ -133,6 +128,7 @@ from supermemory import Supermemory
 
 # Configure the default for all requests:
 client = Supermemory(
+    api_key="My API Key",
     # default is 2
     max_retries=0,
 )
@@ -153,12 +149,14 @@ from supermemory import Supermemory
 
 # Configure the default for all requests:
 client = Supermemory(
+    api_key="My API Key",
     # 20 seconds (default is 1 minute)
     timeout=20.0,
 )
 
 # More granular control:
 client = Supermemory(
+    api_key="My API Key",
     timeout=httpx.Timeout(60.0, read=5.0, write=10.0, connect=2.0),
 )
 
@@ -205,7 +203,9 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 ```py
 from supermemory import Supermemory
 
-client = Supermemory()
+client = Supermemory(
+    api_key="My API Key",
+)
 response = client.memory.with_raw_response.create(
     content="This is a detailed article about machine learning concepts...",
 )
@@ -284,6 +284,7 @@ import httpx
 from supermemory import Supermemory, DefaultHttpxClient
 
 client = Supermemory(
+    api_key="My API Key",
     # Or use the `SUPERMEMORY_BASE_URL` env var
     base_url="http://my.test.server.example.com:8083",
     http_client=DefaultHttpxClient(
@@ -306,7 +307,9 @@ By default the library closes underlying HTTP connections whenever the client is
 ```py
 from supermemory import Supermemory
 
-with Supermemory() as client:
+with Supermemory(
+    api_key="My API Key",
+) as client:
   # make requests here
   ...
 

src/supermemory/_client.py

@@ -116,12 +116,6 @@ def __init__(
     def qs(self) -> Querystring:
         return Querystring(array_format="comma")
 
-    @property
-    @override
-    def auth_headers(self) -> dict[str, str]:
-        api_key = self.api_key
-        return {"X-API-Key": api_key}
-
     @property
     @override
     def default_headers(self) -> dict[str, str | Omit]:
@@ -290,12 +284,6 @@ def __init__(
     def qs(self) -> Querystring:
         return Querystring(array_format="comma")
 
-    @property
-    @override
-    def auth_headers(self) -> dict[str, str]:
-        api_key = self.api_key
-        return {"X-API-Key": api_key}
-
     @property
     @override
     def default_headers(self) -> dict[str, str | Omit]:

tests/test_client.py

@@ -26,7 +26,7 @@
 from supermemory._utils import maybe_transform
 from supermemory._models import BaseModel, FinalRequestOptions
 from supermemory._constants import RAW_RESPONSE_HEADER
-from supermemory._exceptions import APIStatusError, APITimeoutError, SupermemoryError, APIResponseValidationError
+from supermemory._exceptions import APIStatusError, APITimeoutError, APIResponseValidationError
 from supermemory._base_client import (
     DEFAULT_TIMEOUT,
     HTTPX_DEFAULT_TIMEOUT,
@@ -336,16 +336,6 @@ def test_default_headers_option(self) -> None:
         assert request.headers.get("x-foo") == "stainless"
         assert request.headers.get("x-stainless-lang") == "my-overriding-header"
 
-    def test_validate_headers(self) -> None:
-        client = Supermemory(base_url=base_url, api_key=api_key, _strict_response_validation=True)
-        request = client._build_request(FinalRequestOptions(method="get", url="/foo"))
-        assert request.headers.get("X-API-Key") == api_key
-
-        with pytest.raises(SupermemoryError):
-            with update_env(**{"SUPERMEMORY_API_KEY": Omit()}):
-                client2 = Supermemory(base_url=base_url, api_key=None, _strict_response_validation=True)
-            _ = client2
-
     def test_default_query_option(self) -> None:
         client = Supermemory(
             base_url=base_url, api_key=api_key, _strict_response_validation=True, default_query={"query_param": "bar"}
@@ -1128,16 +1118,6 @@ def test_default_headers_option(self) -> None:
         assert request.headers.get("x-foo") == "stainless"
         assert request.headers.get("x-stainless-lang") == "my-overriding-header"
 
-    def test_validate_headers(self) -> None:
-        client = AsyncSupermemory(base_url=base_url, api_key=api_key, _strict_response_validation=True)
-        request = client._build_request(FinalRequestOptions(method="get", url="/foo"))
-        assert request.headers.get("X-API-Key") == api_key
-
-        with pytest.raises(SupermemoryError):
-            with update_env(**{"SUPERMEMORY_API_KEY": Omit()}):
-                client2 = AsyncSupermemory(base_url=base_url, api_key=None, _strict_response_validation=True)
-            _ = client2
-
     def test_default_query_option(self) -> None:
         client = AsyncSupermemory(
             base_url=base_url, api_key=api_key, _strict_response_validation=True, default_query={"query_param": "bar"}