anthropic 0.67.0__tar.gz → 0.68.0__tar.gz

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

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

{anthropic-0.67.0 → anthropic-0.68.0}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.68.0 (2025-09-17)
+
+Full Changelog: [v0.67.0...v0.68.0](https://github.com/anthropics/anthropic-sdk-python/compare/v0.67.0...v0.68.0)
+
+### Features
+
+* add tool running helpers ([d9c9ce6](https://github.com/anthropics/anthropic-sdk-python/commit/d9c9ce63de5b5888dff0d9ba2d79724520152420))
+
+
+### Chores
+
+* **internal:** fix tests ([9858c79](https://github.com/anthropics/anthropic-sdk-python/commit/9858c791309a1af2fbc2cb4d042812de83d1a635))
+* **internal:** update pydantic dependency ([f59c2f1](https://github.com/anthropics/anthropic-sdk-python/commit/f59c2f196a09c80f6b46cac19e9d0ace18200da8))
+* **tests:** simplify `get_platform` test ([7596748](https://github.com/anthropics/anthropic-sdk-python/commit/7596748699ff3113b6cb6c1511cf4a33d0453233))
+
 ## 0.67.0 (2025-09-10)
 
 Full Changelog: [v0.66.0...v0.67.0](https://github.com/anthropics/anthropic-sdk-python/compare/v0.66.0...v0.67.0)

{anthropic-0.67.0 → anthropic-0.68.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anthropic
-Version: 0.67.0
+Version: 0.68.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
@@ -24,6 +24,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.8
 Requires-Dist: anyio<5,>=3.5.0
 Requires-Dist: distro<2,>=1.7.0
+Requires-Dist: docstring-parser<1,>=0.15
 Requires-Dist: httpx<1,>=0.25.0
 Requires-Dist: jiter<1,>=0.4.0
 Requires-Dist: pydantic<3,>=1.9.0
@@ -208,6 +209,55 @@ async for event in stream:
     print(event.type)
 ```
 
+### Tool helpers
+
+This library provides helper functions for defining and running tools as pure python functions, for example:
+
+```py
+import json
+import rich
+from typing_extensions import Literal
+from anthropic import Anthropic, beta_tool
+
+client = Anthropic()
+
+
+@beta_tool
+def get_weather(location: str) -> str:
+    """Lookup the weather for a given city in either celsius or fahrenheit
+
+    Args:
+        location: The city and state, e.g. San Francisco, CA
+    Returns:
+        A dictionary containing the location, temperature, and weather condition.
+    """
+    # Here you would typically make an API call to a weather service
+    # For demonstration, we return a mock response
+    return json.dumps(
+        {
+            "location": location,
+            "temperature": "68°F",
+            "condition": "Sunny",
+        }
+    )
+
+
+runner = client.beta.messages.tool_runner(
+    max_tokens=1024,
+    model="claude-sonnet-4-20250514",
+    tools=[get_weather],
+    messages=[
+        {"role": "user", "content": "What is the weather in SF?"},
+    ],
+)
+for message in runner:
+    rich.print(message)
+```
+
+On every iteration, an API request will be made, if Claude wants to call one of the given tools then it will be automatically called, and the result will be returned directly to the model in the next iteration.
+
+For more information see the [full docs](https://github.com/anthropics/anthropic-sdk-python/tree/main/tools.md).
+
 ### Streaming Helpers
 
 This library provides several conveniences for streaming messages, for example:

{anthropic-0.67.0 → anthropic-0.68.0}/README.md

@@ -167,6 +167,55 @@ async for event in stream:
     print(event.type)
 ```
 
+### Tool helpers
+
+This library provides helper functions for defining and running tools as pure python functions, for example:
+
+```py
+import json
+import rich
+from typing_extensions import Literal
+from anthropic import Anthropic, beta_tool
+
+client = Anthropic()
+
+
+@beta_tool
+def get_weather(location: str) -> str:
+    """Lookup the weather for a given city in either celsius or fahrenheit
+
+    Args:
+        location: The city and state, e.g. San Francisco, CA
+    Returns:
+        A dictionary containing the location, temperature, and weather condition.
+    """
+    # Here you would typically make an API call to a weather service
+    # For demonstration, we return a mock response
+    return json.dumps(
+        {
+            "location": location,
+            "temperature": "68°F",
+            "condition": "Sunny",
+        }
+    )
+
+
+runner = client.beta.messages.tool_runner(
+    max_tokens=1024,
+    model="claude-sonnet-4-20250514",
+    tools=[get_weather],
+    messages=[
+        {"role": "user", "content": "What is the weather in SF?"},
+    ],
+)
+for message in runner:
+    rich.print(message)
+```
+
+On every iteration, an API request will be made, if Claude wants to call one of the given tools then it will be automatically called, and the result will be returned directly to the model in the next iteration.
+
+For more information see the [full docs](tools.md).
+
 ### Streaming Helpers
 
 This library provides several conveniences for streaming messages, for example:

anthropic-0.68.0/examples/tools_runner.py

@@ -0,0 +1,56 @@
+import json
+from typing_extensions import Literal
+
+import rich
+
+from anthropic import Anthropic, beta_tool
+
+client = Anthropic()
+
+
+@beta_tool
+def get_weather(location: str, units: Literal["c", "f"]) -> str:
+    """Lookup the weather for a given city in either celsius or fahrenheit
+
+    Args:
+        location: The city and state, e.g. San Francisco, CA
+        units: Unit for the output, either 'c' for celsius or 'f' for fahrenheit
+    Returns:
+        A dictionary containing the location, temperature, and weather condition.
+    """
+    # Simulate a weather API call
+    print(f"Fetching weather for {location} in {units}")
+
+    # Here you would typically make an API call to a weather service
+    # For demonstration, we return a mock response
+    if units == "c":
+        return json.dumps(
+            {
+                "location": location,
+                "temperature": "20°C",
+                "condition": "Sunny",
+            }
+        )
+    else:
+        return json.dumps(
+            {
+                "location": location,
+                "temperature": "68°F",
+                "condition": "Sunny",
+            }
+        )
+
+
+def main() -> None:
+    runner = client.beta.messages.tool_runner(
+        max_tokens=1024,
+        model="claude-3-5-sonnet-latest",
+        # alternatively, you can use `tools=[anthropic.beta_tool(get_weather)]`
+        tools=[get_weather],
+        messages=[{"role": "user", "content": "What is the weather in SF?"}],
+    )
+    for message in runner:
+        rich.print(message)
+
+
+main()

{anthropic-0.67.0 → anthropic-0.68.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anthropic"
-version = "0.67.0"
+version = "0.68.0"
 description = "The official Python library for the anthropic API"
 dynamic = ["readme"]
 license = "MIT"
@@ -15,6 +15,7 @@ dependencies = [
     "distro>=1.7.0, <2",
     "sniffio",
     "jiter>=0.4.0, <1",
+    "docstring-parser>=0.15,<1",
 ]
 requires-python = ">= 3.8"
 classifiers = [
@@ -60,8 +61,8 @@ dev-dependencies = [
     "importlib-metadata>=6.7.0",
     "boto3-stubs >= 1",
     "rich>=13.7.1",
-    "nest_asyncio==1.6.0",
     "pytest-xdist>=3.6.1",
+    "inline-snapshot>=0.28.0",
     "griffe>=1",
 ]
 conflicts = [
@@ -127,6 +128,9 @@ filterwarnings = [
   "error"
 ]
 
+[tool.inline-snapshot]
+format-command="ruff format --stdin-filename {filename}"
+
 [tool.pyright]
 # this enables practically every flag given by pyright.
 # there are a couple of flags that are still disabled by
@@ -135,10 +139,10 @@ typeCheckingMode = "strict"
 pythonVersion = "3.8"
 
 exclude = [
+    ".git",
     "_dev",
     ".venv",
     ".nox",
-    ".git",
 ]
 
 reportImplicitOverride = true
@@ -157,7 +161,7 @@ show_error_codes = true
 #
 # We also exclude our `tests` as mypy doesn't always infer
 # types correctly and Pyright will still catch any type errors.
-exclude = ['src/anthropic/_files.py', '_dev/.*.py', 'tests/.*']
+exclude = ['src/anthropic/_files.py', '_dev/.*.py', 'tests/.*', 'examples/mcp_server_weather.py', 'examples/tools_with_mcp.py']
 
 strict_equality = true
 implicit_reexport = true

{anthropic-0.67.0 → anthropic-0.68.0}/requirements-dev.lock

@@ -11,12 +11,14 @@ anyio==4.8.0 ; python_full_version >= '3.9'
     # via
     #   anthropic
     #   httpx
+asttokens==3.0.0
+    # via inline-snapshot
 astunparse==1.6.3 ; python_full_version < '3.9'
     # via griffe
-boto3-stubs==1.40.12
+boto3-stubs==1.40.31
 botocore-stubs==1.38.30 ; python_full_version < '3.9'
     # via boto3-stubs
-botocore-stubs==1.38.46 ; python_full_version >= '3.9'
+botocore-stubs==1.40.31 ; python_full_version >= '3.9'
     # via boto3-stubs
 certifi==2024.12.14
     # via
@@ -29,14 +31,18 @@ colorama==0.4.6
 dirty-equals==0.9.0
 distro==1.9.0
     # via anthropic
+docstring-parser==0.17.0
+    # via anthropic
 exceptiongroup==1.2.2 ; python_full_version < '3.11'
     # via
     #   anyio
     #   pytest
 execnet==2.1.1
     # via pytest-xdist
+executing==2.2.1
+    # via inline-snapshot
 griffe==1.4.0 ; python_full_version < '3.9'
-griffe==1.14.0 ; python_full_version >= '3.9'
+griffe==1.13.0 ; python_full_version >= '3.9'
 h11==0.16.0
     # via httpcore
 httpcore==1.0.9
@@ -53,9 +59,10 @@ importlib-metadata==8.5.0 ; python_full_version < '3.9'
 importlib-metadata==8.6.1 ; python_full_version >= '3.9'
 iniconfig==2.0.0
     # via pytest
+inline-snapshot==0.29.0
 jiter==0.9.1 ; python_full_version < '3.9'
     # via anthropic
-jiter==0.10.0 ; python_full_version >= '3.9'
+jiter==0.11.0 ; python_full_version >= '3.9'
     # via anthropic
 markdown-it-py==3.0.0
     # via rich
@@ -64,16 +71,19 @@ mdurl==0.1.2
 mypy==1.14.1
 mypy-extensions==1.0.0
     # via mypy
-nest-asyncio==1.6.0
 nodeenv==1.9.1
     # via pyright
 packaging==24.2
     # via pytest
 pluggy==1.5.0
     # via pytest
-pydantic==2.10.3
+pydantic==2.10.6 ; python_full_version < '3.9'
+    # via anthropic
+pydantic==2.11.9 ; python_full_version >= '3.9'
     # via anthropic
-pydantic-core==2.27.1
+pydantic-core==2.27.2 ; python_full_version < '3.9'
+    # via pydantic
+pydantic-core==2.33.2 ; python_full_version >= '3.9'
     # via pydantic
 pygments==2.19.1
     # via
@@ -82,10 +92,12 @@ pygments==2.19.1
 pyright==1.1.399
 pytest==8.3.5 ; python_full_version < '3.9'
     # via
+    #   inline-snapshot
     #   pytest-asyncio
     #   pytest-xdist
 pytest==8.4.1 ; python_full_version >= '3.9'
     # via
+    #   inline-snapshot
     #   pytest-asyncio
     #   pytest-xdist
 pytest-asyncio==0.24.0
@@ -97,6 +109,7 @@ pytz==2024.2 ; python_full_version < '3.9'
     # via dirty-equals
 respx==0.22.0
 rich==13.9.4
+    # via inline-snapshot
 ruff==0.9.4
 six==1.17.0
     # via
@@ -110,11 +123,12 @@ time-machine==2.15.0 ; python_full_version < '3.9'
 time-machine==2.16.0 ; python_full_version >= '3.9'
 tomli==2.2.1 ; python_full_version < '3.11'
     # via
+    #   inline-snapshot
     #   mypy
     #   pytest
 types-awscrt==0.27.6
     # via botocore-stubs
-types-s3transfer==0.13.0
+types-s3transfer==0.13.1
     # via boto3-stubs
 typing-extensions==4.12.2
     # via
@@ -127,6 +141,9 @@ typing-extensions==4.12.2
     #   pydantic-core
     #   pyright
     #   rich
+    #   typing-inspection
+typing-inspection==0.4.1 ; python_full_version >= '3.9'
+    # via pydantic
 wheel==0.45.1 ; python_full_version < '3.9'
     # via astunparse
 zipp==3.20.2 ; python_full_version < '3.9'

{anthropic-0.67.0 → anthropic-0.68.0}/src/anthropic/__init__.py

@@ -87,11 +87,14 @@ __all__ = [
     "DefaultAioHttpClient",
     "HUMAN_PROMPT",
     "AI_PROMPT",
+    "beta_tool",
+    "beta_async_tool",
 ]
 
 if not _t.TYPE_CHECKING:
     from ._utils._resources_proxy import resources as resources
 
+from .lib.tools import beta_tool, beta_async_tool
 from .lib.vertex import *
 from .lib.bedrock import *
 from .lib.streaming import *

{anthropic-0.67.0 → anthropic-0.68.0}/src/anthropic/_models.py

@@ -272,7 +272,7 @@ class BaseModel(pydantic.BaseModel):
             mode: Literal["json", "python"] | str = "python",
             include: IncEx | None = None,
             exclude: IncEx | None = None,
-            by_alias: bool = False,
+            by_alias: bool | None = None,
             exclude_unset: bool = False,
             exclude_defaults: bool = False,
             exclude_none: bool = False,
@@ -280,6 +280,7 @@ class BaseModel(pydantic.BaseModel):
             warnings: bool | Literal["none", "warn", "error"] = True,
             context: dict[str, Any] | None = None,
             serialize_as_any: bool = False,
+            fallback: Callable[[Any], Any] | None = None,
         ) -> dict[str, Any]:
             """Usage docs: https://docs.pydantic.dev/2.4/concepts/serialization/#modelmodel_dump
 
@@ -311,10 +312,12 @@ class BaseModel(pydantic.BaseModel):
                 raise ValueError("context is only supported in Pydantic v2")
             if serialize_as_any != False:
                 raise ValueError("serialize_as_any is only supported in Pydantic v2")
+            if fallback is not None:
+                raise ValueError("fallback is only supported in Pydantic v2")
             dumped = super().dict(  # pyright: ignore[reportDeprecated]
                 include=include,
                 exclude=exclude,
-                by_alias=by_alias,
+                by_alias=by_alias if by_alias is not None else False,
                 exclude_unset=exclude_unset,
                 exclude_defaults=exclude_defaults,
                 exclude_none=exclude_none,
@@ -329,13 +332,14 @@ class BaseModel(pydantic.BaseModel):
             indent: int | None = None,
             include: IncEx | None = None,
             exclude: IncEx | None = None,
-            by_alias: bool = False,
+            by_alias: bool | None = None,
             exclude_unset: bool = False,
             exclude_defaults: bool = False,
             exclude_none: bool = False,
             round_trip: bool = False,
             warnings: bool | Literal["none", "warn", "error"] = True,
             context: dict[str, Any] | None = None,
+            fallback: Callable[[Any], Any] | None = None,
             serialize_as_any: bool = False,
         ) -> str:
             """Usage docs: https://docs.pydantic.dev/2.4/concepts/serialization/#modelmodel_dump_json
@@ -364,11 +368,13 @@ class BaseModel(pydantic.BaseModel):
                 raise ValueError("context is only supported in Pydantic v2")
             if serialize_as_any != False:
                 raise ValueError("serialize_as_any is only supported in Pydantic v2")
+            if fallback is not None:
+                raise ValueError("fallback is only supported in Pydantic v2")
             return super().json(  # type: ignore[reportDeprecated]
                 indent=indent,
                 include=include,
                 exclude=exclude,
-                by_alias=by_alias,
+                by_alias=by_alias if by_alias is not None else False,
                 exclude_unset=exclude_unset,
                 exclude_defaults=exclude_defaults,
                 exclude_none=exclude_none,
@@ -780,6 +786,9 @@ elif not TYPE_CHECKING:  # TODO: condition is weird
     def _create_pydantic_model(type_: _T) -> Type[RootModel[_T]]:
         return RootModel[type_]  # type: ignore
 
+    def TypeAdapter(*_args: Any, **_kwargs: Any) -> Any:
+        raise RuntimeError("attempted to use TypeAdapter in pydantic v1")
+
 
 class FinalRequestOptionsInput(TypedDict, total=False):
     method: Required[str]

{anthropic-0.67.0 → anthropic-0.68.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.67.0"  # x-release-please-version
+__version__ = "0.68.0"  # x-release-please-version

anthropic-0.68.0/src/anthropic/lib/tools/__init__.py

@@ -0,0 +1,20 @@
+from ._beta_runner import BetaToolRunner, BetaAsyncToolRunner, BetaStreamingToolRunner, BetaAsyncStreamingToolRunner
+from ._beta_functions import (
+    BetaFunctionTool,
+    BetaAsyncFunctionTool,
+    BetaFunctionToolResultType,
+    beta_tool,
+    beta_async_tool,
+)
+
+__all__ = [
+    "beta_tool",
+    "beta_async_tool",
+    "BetaFunctionTool",
+    "BetaAsyncFunctionTool",
+    "BetaToolRunner",
+    "BetaAsyncStreamingToolRunner",
+    "BetaStreamingToolRunner",
+    "BetaAsyncToolRunner",
+    "BetaFunctionToolResultType",
+]