anthropic 0.57.1__tar.gz → 0.58.0__tar.gz

anthropic-0.58.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.58.0"
+}

{anthropic-0.57.1 → anthropic-0.58.0}/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.58.0 (2025-07-18)
+
+Full Changelog: [v0.57.1...v0.58.0](https://github.com/anthropics/anthropic-sdk-python/compare/v0.57.1...v0.58.0)
+
+### Features
+
+* clean up environment call outs ([4f64e9c](https://github.com/anthropics/anthropic-sdk-python/commit/4f64e9c1bdb142bbcff2072baa709afdea348889))
+
+
+### Bug Fixes
+
+* **client:** don't send Content-Type header on GET requests ([727268f](https://github.com/anthropics/anthropic-sdk-python/commit/727268f2bd4cb42aa1472e1f0c6a92fd6a5cb122))
+* **parsing:** correctly handle nested discriminated unions ([44dd47e](https://github.com/anthropics/anthropic-sdk-python/commit/44dd47e15ed91af912eac4791421e11504c3094b))
+
+
+### Chores
+
+* **internal:** bump pinned h11 dep ([9a947e1](https://github.com/anthropics/anthropic-sdk-python/commit/9a947e1061021529937395758acb4d77b685a68b))
+* **internal:** codegen related update ([33f2b34](https://github.com/anthropics/anthropic-sdk-python/commit/33f2b3468a971ca2ce6eb8b823b26d45092303f7))
+* **internal:** version bump ([5f0f5ad](https://github.com/anthropics/anthropic-sdk-python/commit/5f0f5adba5392facf8331451c449513ae005a054))
+* **package:** mark python 3.13 as supported ([703d557](https://github.com/anthropics/anthropic-sdk-python/commit/703d55747456a3825ba8c79cd492d6e64276dc15))
+* **readme:** fix version rendering on pypi ([dd956a6](https://github.com/anthropics/anthropic-sdk-python/commit/dd956a616a45191398aac9061eaaa5f3b7cbf2f6))
+
+
+### Documentation
+
+* model in examples ([89b6925](https://github.com/anthropics/anthropic-sdk-python/commit/89b69256dcbd107970d0763afc62f2cbf08e3d5a))
+* model in examples ([1eccecb](https://github.com/anthropics/anthropic-sdk-python/commit/1eccecbec9e0c0cde748695e0cb1bc61ac8ffca5))
+
 ## 0.57.1 (2025-07-03)
 
 Full Changelog: [v0.57.0...v0.57.1](https://github.com/anthropics/anthropic-sdk-python/compare/v0.57.0...v0.57.1)

{anthropic-0.57.1 → anthropic-0.58.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anthropic
-Version: 0.57.1
+Version: 0.58.0
 Summary: The official Python library for the anthropic API
 Project-URL: Homepage, https://github.com/anthropics/anthropic-sdk-python
 Project-URL: Repository, https://github.com/anthropics/anthropic-sdk-python
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.8
@@ -30,7 +31,7 @@ Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.10
 Provides-Extra: aiohttp
 Requires-Dist: aiohttp; extra == 'aiohttp'
-Requires-Dist: httpx-aiohttp>=0.1.6; extra == 'aiohttp'
+Requires-Dist: httpx-aiohttp>=0.1.8; extra == 'aiohttp'
 Provides-Extra: bedrock
 Requires-Dist: boto3>=1.28.57; extra == 'bedrock'
 Requires-Dist: botocore>=1.31.57; extra == 'bedrock'
@@ -40,7 +41,8 @@ Description-Content-Type: text/markdown
 
 # Anthropic Python API library
 
-[![PyPI version](https://github.com/anthropics/anthropic-sdk-python/tree/main/<https://img.shields.io/pypi/v/anthropic.svg?label=pypi%20(stable)>)](https://pypi.org/project/anthropic/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/anthropic.svg?label=pypi%20(stable))](https://pypi.org/project/anthropic/)
 
 The Anthropic Python library provides convenient access to the Anthropic REST API from any Python 3.8+
 application. It includes type definitions for all request params and response fields,
@@ -134,7 +136,6 @@ pip install anthropic[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
-import os
 import asyncio
 from anthropic import DefaultAioHttpClient
 from anthropic import AsyncAnthropic
@@ -142,7 +143,7 @@ from anthropic import AsyncAnthropic
 
 async def main() -> None:
     async with AsyncAnthropic(
-        api_key=os.environ.get("ANTHROPIC_API_KEY"),  # This is the default and can be omitted
+        api_key="my-anthropic-api-key",
         http_client=DefaultAioHttpClient(),
     ) as client:
         message = await client.messages.create(
@@ -329,7 +330,7 @@ message = client.messages.create(
             "content": "Hello!",
         }
     ],
-    model="anthropic.claude-sonnet-4-20250514-v2:0",
+    model="anthropic.claude-sonnet-4-20250514-v1:0",
 )
 print(message)
 ```

{anthropic-0.57.1 → anthropic-0.58.0}/README.md

@@ -1,6 +1,7 @@
 # Anthropic Python API library
 
-[![PyPI version](<https://img.shields.io/pypi/v/anthropic.svg?label=pypi%20(stable)>)](https://pypi.org/project/anthropic/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/anthropic.svg?label=pypi%20(stable))](https://pypi.org/project/anthropic/)
 
 The Anthropic Python library provides convenient access to the Anthropic REST API from any Python 3.8+
 application. It includes type definitions for all request params and response fields,
@@ -94,7 +95,6 @@ pip install anthropic[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
-import os
 import asyncio
 from anthropic import DefaultAioHttpClient
 from anthropic import AsyncAnthropic
@@ -102,7 +102,7 @@ from anthropic import AsyncAnthropic
 
 async def main() -> None:
     async with AsyncAnthropic(
-        api_key=os.environ.get("ANTHROPIC_API_KEY"),  # This is the default and can be omitted
+        api_key="my-anthropic-api-key",
         http_client=DefaultAioHttpClient(),
     ) as client:
         message = await client.messages.create(
@@ -289,7 +289,7 @@ message = client.messages.create(
             "content": "Hello!",
         }
     ],
-    model="anthropic.claude-sonnet-4-20250514-v2:0",
+    model="anthropic.claude-sonnet-4-20250514-v1:0",
 )
 print(message)
 ```

{anthropic-0.57.1 → anthropic-0.58.0}/examples/bedrock.py

@@ -19,7 +19,7 @@ message = client.messages.create(
             "content": "Hello!",
         }
     ],
-    model="anthropic.claude-3-sonnet-20240229-v1:0",
+    model="anthropic.claude-sonnet-4-20250514-v1:0",
 )
 print(message.model_dump_json(indent=2))
 
@@ -33,7 +33,7 @@ with client.messages.stream(
             "content": "Say hello there!",
         }
     ],
-    model="anthropic.claude-3-sonnet-20240229-v1:0",
+    model="anthropic.claude-sonnet-4-20250514-v1:0",
 ) as stream:
     for text in stream.text_stream:
         print(text, end="", flush=True)

{anthropic-0.57.1 → anthropic-0.58.0}/examples/images.py

@@ -25,6 +25,6 @@ response = client.messages.create(
             ],
         },
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(response.model_dump_json(indent=2))

{anthropic-0.57.1 → anthropic-0.58.0}/examples/mcp.py

@@ -5,7 +5,7 @@ from anthropic import Anthropic
 anthropic = Anthropic()
 
 response = anthropic.beta.messages.create(
-    model="claude-3-7-sonnet-20250219",
+    model="claude-sonnet-4-20250514",
     max_tokens=1000,
     messages=[
         {

{anthropic-0.57.1 → anthropic-0.58.0}/examples/messages.py

@@ -10,7 +10,7 @@ response = client.messages.create(
             "content": "Hello!",
         }
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(response)
 
@@ -30,6 +30,6 @@ response2 = client.messages.create(
             "content": "How are you?",
         },
     ],
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
 )
 print(response2)

{anthropic-0.57.1 → anthropic-0.58.0}/examples/messages_stream.py

@@ -16,7 +16,7 @@ async def main() -> None:
                 "content": "Say hello there!",
             }
         ],
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
     ) as stream:
         async for event in stream:
             if event.type == "text":

{anthropic-0.57.1 → anthropic-0.58.0}/examples/text_completions_demo_async.py

@@ -10,7 +10,7 @@ async def main() -> None:
     client = AsyncAnthropic()
 
     res = await client.completions.create(
-        model="claude-2.1",
+        model="claude-sonnet-4-20250514",
         prompt=f"{anthropic.HUMAN_PROMPT} how does a court case get to the Supreme Court? {anthropic.AI_PROMPT}",
         max_tokens_to_sample=1000,
     )

{anthropic-0.57.1 → anthropic-0.58.0}/examples/text_completions_demo_sync.py

@@ -8,7 +8,7 @@ def main() -> None:
     client = Anthropic()
 
     res = client.completions.create(
-        model="claude-2.1",
+        model="claude-sonnet-4-20250514",
         prompt=f"{anthropic.HUMAN_PROMPT} how does a court case get to the Supreme Court? {anthropic.AI_PROMPT}",
         max_tokens_to_sample=1000,
     )

{anthropic-0.57.1 → anthropic-0.58.0}/examples/text_completions_streaming.py

@@ -15,7 +15,7 @@ Hey Claude! How can I recursively list all files in a directory in Python?
 def sync_stream() -> None:
     stream = client.completions.create(
         prompt=f"{HUMAN_PROMPT} {question}{AI_PROMPT}",
-        model="claude-2.1",
+        model="claude-sonnet-4-20250514",
         stream=True,
         max_tokens_to_sample=300,
     )
@@ -29,7 +29,7 @@ def sync_stream() -> None:
 async def async_stream() -> None:
     stream = await async_client.completions.create(
         prompt=f"{HUMAN_PROMPT} {question}{AI_PROMPT}",
-        model="claude-2.1",
+        model="claude-sonnet-4-20250514",
         stream=True,
         max_tokens_to_sample=300,
     )

{anthropic-0.57.1 → anthropic-0.58.0}/examples/thinking.py

@@ -3,7 +3,7 @@ import anthropic
 client = anthropic.Anthropic()
 
 response = client.messages.create(
-    model="claude-3-7-sonnet-20250219",
+    model="claude-sonnet-4-20250514",
     max_tokens=3200,
     thinking={"type": "enabled", "budget_tokens": 1600},
     messages=[{"role": "user", "content": "Create a haiku about Anthropic."}],

{anthropic-0.57.1 → anthropic-0.58.0}/examples/thinking_stream.py

@@ -3,7 +3,7 @@ import anthropic
 client = anthropic.Anthropic()
 
 with client.messages.stream(
-    model="claude-3-7-sonnet-20250219",
+    model="claude-sonnet-4-20250514",
     max_tokens=3200,
     thinking={"type": "enabled", "budget_tokens": 1600},
     messages=[{"role": "user", "content": "Create a haiku about Anthropic."}],

{anthropic-0.57.1 → anthropic-0.58.0}/examples/tools.py

@@ -21,7 +21,7 @@ tools: list[ToolParam] = [
 ]
 
 message = client.messages.create(
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
     max_tokens=1024,
     messages=[user_message],
     tools=tools,
@@ -32,7 +32,7 @@ assert message.stop_reason == "tool_use"
 
 tool = next(c for c in message.content if c.type == "tool_use")
 response = client.messages.create(
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
     max_tokens=1024,
     messages=[
         user_message,

{anthropic-0.57.1 → anthropic-0.58.0}/examples/tools_stream.py

@@ -8,7 +8,7 @@ client = AsyncAnthropic()
 async def main() -> None:
     async with client.messages.stream(
         max_tokens=1024,
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
         tools=[
             {
                 "name": "get_weather",

{anthropic-0.57.1 → anthropic-0.58.0}/examples/vertex.py

@@ -9,7 +9,7 @@ def sync_client() -> None:
     client = AnthropicVertex()
 
     message = client.messages.create(
-        model="claude-3-sonnet@20240229",
+        model="claude-sonnet-4@20250514",
         max_tokens=100,
         messages=[
             {
@@ -27,7 +27,7 @@ async def async_client() -> None:
     client = AsyncAnthropicVertex()
 
     message = await client.messages.create(
-        model="claude-3-sonnet@20240229",
+        model="claude-sonnet-4@20250514",
         max_tokens=1024,
         messages=[
             {

{anthropic-0.57.1 → anthropic-0.58.0}/examples/web_search.py

@@ -6,7 +6,7 @@ client = Anthropic()
 
 # Create a message with web search enabled
 message = client.messages.create(
-    model="claude-3-5-sonnet-latest",
+    model="claude-sonnet-4-20250514",
     max_tokens=1024,
     messages=[{"role": "user", "content": "What's the weather in New York?"}],
     tools=[

{anthropic-0.57.1 → anthropic-0.58.0}/examples/web_search_stream.py

@@ -11,7 +11,7 @@ async def main() -> None:
 
     # Create an async stream with web search enabled
     async with client.beta.messages.stream(
-        model="claude-3-5-sonnet-latest",
+        model="claude-sonnet-4-20250514",
         max_tokens=1024,
         messages=[{"role": "user", "content": "What's the weather in New York?"}],
         tools=[

{anthropic-0.57.1 → anthropic-0.58.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anthropic"
-version = "0.57.1"
+version = "0.58.0"
 description = "The official Python library for the anthropic API"
 dynamic = ["readme"]
 license = "MIT"
@@ -25,6 +25,7 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Operating System :: OS Independent",
   "Operating System :: POSIX",
   "Operating System :: MacOS",
@@ -35,7 +36,7 @@ classifiers = [
 ]
 
 [project.optional-dependencies]
-aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.6"]
+aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.8"]
 vertex = ["google-auth[requests] >=2, <3"]
 bedrock = ["boto3 >= 1.28.57", "botocore >= 1.31.57"]
 

{anthropic-0.57.1 → anthropic-0.58.0}/requirements-dev.lock

@@ -11,8 +11,10 @@ anyio==4.8.0 ; python_full_version >= '3.9'
     # via
     #   anthropic
     #   httpx
-boto3-stubs==1.38.42
-botocore-stubs==1.38.30
+boto3-stubs==1.39.4
+botocore-stubs==1.38.30 ; python_full_version < '3.9'
+    # via boto3-stubs
+botocore-stubs==1.38.46 ; python_full_version >= '3.9'
     # via boto3-stubs
 certifi==2024.12.14
     # via
@@ -29,9 +31,9 @@ exceptiongroup==1.2.2 ; python_full_version < '3.11'
     #   pytest
 execnet==2.1.1
     # via pytest-xdist
-h11==0.14.0
+h11==0.16.0
     # via httpcore
-httpcore==1.0.7
+httpcore==1.0.9
     # via httpx
 httpx==0.28.1
     # via
@@ -96,7 +98,7 @@ tomli==2.2.1 ; python_full_version < '3.11'
     # via
     #   mypy
     #   pytest
-types-awscrt==0.27.2
+types-awscrt==0.27.4
     # via botocore-stubs
 types-s3transfer==0.13.0
     # via boto3-stubs

{anthropic-0.57.1 → anthropic-0.58.0}/src/anthropic/_base_client.py

@@ -542,6 +542,15 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
             # work around https://github.com/encode/httpx/discussions/2880
             kwargs["extensions"] = {"sni_hostname": prepared_url.host.replace("_", "-")}
 
+        is_body_allowed = options.method.lower() != "get"
+
+        if is_body_allowed:
+            kwargs["json"] = json_data if is_given(json_data) else None
+            kwargs["files"] = files
+        else:
+            headers.pop("Content-Type", None)
+            kwargs.pop("data", None)
+
         # TODO: report this error to httpx
         return self._client.build_request(  # pyright: ignore[reportUnknownMemberType]
             headers=headers,
@@ -553,8 +562,6 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
             # so that passing a `TypedDict` doesn't cause an error.
             # https://github.com/microsoft/pyright/issues/3526#event-6715453066
             params=self.qs.stringify(cast(Mapping[str, Any], params)) if params else None,
-            json=json_data if is_given(json_data) else None,
-            files=files,
             **kwargs,
         )
 

{anthropic-0.57.1 → anthropic-0.58.0}/src/anthropic/_models.py

@@ -5,6 +5,7 @@ import inspect
 from typing import TYPE_CHECKING, Any, Type, Union, Generic, TypeVar, Callable, Optional, cast
 from datetime import date, datetime
 from typing_extensions import (
+    List,
     Unpack,
     Literal,
     ClassVar,
@@ -382,7 +383,7 @@ def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if type_ is None:
         raise RuntimeError(f"Unexpected field type is None for {key}")
 
-    return construct_type(value=value, type_=type_)
+    return construct_type(value=value, type_=type_, metadata=getattr(field, "metadata", None))
 
 
 def is_basemodel(type_: type) -> bool:
@@ -436,7 +437,7 @@ def construct_type_unchecked(*, value: object, type_: type[_T]) -> _T:
     return cast(_T, construct_type(value=value, type_=type_))
 
 
-def construct_type(*, value: object, type_: object) -> object:
+def construct_type(*, value: object, type_: object, metadata: Optional[List[Any]] = None) -> object:
     """Loose coercion to the expected type with construction of nested values.
 
     If the given value does not match the expected type then it is returned as-is.
@@ -454,8 +455,10 @@ def construct_type(*, value: object, type_: object) -> object:
         type_ = type_.__value__  # type: ignore[unreachable]
 
     # unwrap `Annotated[T, ...]` -> `T`
-    if is_annotated_type(type_):
-        meta: tuple[Any, ...] = get_args(type_)[1:]
+    if metadata is not None:
+        meta: tuple[Any, ...] = tuple(metadata)
+    elif is_annotated_type(type_):
+        meta = get_args(type_)[1:]
         type_ = extract_type_arg(type_, 0)
     else:
         meta = tuple()

{anthropic-0.57.1 → anthropic-0.58.0}/src/anthropic/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "anthropic"
-__version__ = "0.57.1"  # x-release-please-version
+__version__ = "0.58.0"  # x-release-please-version

{anthropic-0.57.1 → anthropic-0.58.0}/tests/test_client.py

@@ -472,7 +472,7 @@ class TestAnthropic:
     def test_multipart_repeating_array(self, client: Anthropic) -> None:
         request = client._build_request(
             FinalRequestOptions.construct(
-                method="get",
+                method="post",
                 url="/foo",
                 headers={"Content-Type": "multipart/form-data; boundary=6b7ba517decee4a450543ea6ae821c82"},
                 json_data={"array": ["foo", "bar"]},
@@ -1370,7 +1370,7 @@ class TestAsyncAnthropic:
     def test_multipart_repeating_array(self, async_client: AsyncAnthropic) -> None:
         request = async_client._build_request(
             FinalRequestOptions.construct(
-                method="get",
+                method="post",
                 url="/foo",
                 headers={"Content-Type": "multipart/form-data; boundary=6b7ba517decee4a450543ea6ae821c82"},
                 json_data={"array": ["foo", "bar"]},

{anthropic-0.57.1 → anthropic-0.58.0}/tests/test_models.py

@@ -889,3 +889,48 @@ def test_discriminated_union_case() -> None:
     )
 
     assert isinstance(m, ModelB)
+
+
+def test_nested_discriminated_union() -> None:
+    class InnerType1(BaseModel):
+        type: Literal["type_1"]
+
+    class InnerModel(BaseModel):
+        inner_value: str
+
+    class InnerType2(BaseModel):
+        type: Literal["type_2"]
+        some_inner_model: InnerModel
+
+    class Type1(BaseModel):
+        base_type: Literal["base_type_1"]
+        value: Annotated[
+            Union[
+                InnerType1,
+                InnerType2,
+            ],
+            PropertyInfo(discriminator="type"),
+        ]
+
+    class Type2(BaseModel):
+        base_type: Literal["base_type_2"]
+
+    T = Annotated[
+        Union[
+            Type1,
+            Type2,
+        ],
+        PropertyInfo(discriminator="base_type"),
+    ]
+
+    model = construct_type(
+        type_=T,
+        value={
+            "base_type": "base_type_1",
+            "value": {
+                "type": "type_2",
+            },
+        },
+    )
+    assert isinstance(model, Type1)
+    assert isinstance(model.value, InnerType2)