anthropic 0.66.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.66.0 → anthropic-0.68.0}/CHANGELOG.md

@@ -1,5 +1,41 @@
 # 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)
+
+### Features
+
+* **api:** adds support for web_fetch_20250910 tool ([f85b6a1](https://github.com/anthropics/anthropic-sdk-python/commit/f85b6a172b4b6d3b42119d75f0fefbbf7dcd2351))
+* improve future compat with pydantic v3 ([39f28c5](https://github.com/anthropics/anthropic-sdk-python/commit/39f28c51d328bc7bf5f86f252ea63e8325815c72))
+
+
+### Bug Fixes
+
+* more updates for future pydantic v3 compat ([7967d15](https://github.com/anthropics/anthropic-sdk-python/commit/7967d1501297e188f451fa39a33b38317dfcb883))
+* **types/beta:** add response content block type to params ([#1030](https://github.com/anthropics/anthropic-sdk-python/issues/1030)) ([9febe38](https://github.com/anthropics/anthropic-sdk-python/commit/9febe38a309d290f2c2a8d96eb458972652b98cd))
+
+
+### Chores
+
+* **internal:** move mypy configurations to `pyproject.toml` file ([c5347b6](https://github.com/anthropics/anthropic-sdk-python/commit/c5347b6affba397276c13e763f5eb820d11f912f))
+* update SDK settings ([36e6870](https://github.com/anthropics/anthropic-sdk-python/commit/36e687098acc8c66613712c89667edea73ce799f))
+
 ## 0.66.0 (2025-09-03)
 
 Full Changelog: [v0.65.0...v0.66.0](https://github.com/anthropics/anthropic-sdk-python/compare/v0.65.0...v0.66.0)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anthropic
-Version: 0.66.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.66.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.66.0 → anthropic-0.68.0}/api.md

@@ -216,6 +216,7 @@ from anthropic.types.beta import (
     BetaCacheCreation,
     BetaCitationCharLocation,
     BetaCitationCharLocationParam,
+    BetaCitationConfig,
     BetaCitationContentBlockLocation,
     BetaCitationContentBlockLocationParam,
     BetaCitationPageLocation,
@@ -246,6 +247,7 @@ from anthropic.types.beta import (
     BetaContentBlockParam,
     BetaContentBlockSource,
     BetaContentBlockSourceContent,
+    BetaDocumentBlock,
     BetaFileDocumentSource,
     BetaFileImageSource,
     BetaImageBlockParam,
@@ -321,6 +323,14 @@ from anthropic.types.beta import (
     BetaURLImageSource,
     BetaURLPDFSource,
     BetaUsage,
+    BetaWebFetchBlock,
+    BetaWebFetchBlockParam,
+    BetaWebFetchTool20250910,
+    BetaWebFetchToolResultBlock,
+    BetaWebFetchToolResultBlockParam,
+    BetaWebFetchToolResultErrorBlock,
+    BetaWebFetchToolResultErrorBlockParam,
+    BetaWebFetchToolResultErrorCode,
     BetaWebSearchResultBlock,
     BetaWebSearchResultBlockParam,
     BetaWebSearchTool20250305,

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.66.0 → anthropic-0.68.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anthropic"
-version = "0.66.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
@@ -147,6 +151,61 @@ reportOverlappingOverload = false
 reportImportCycles = false
 reportPrivateUsage = false
 
+[tool.mypy]
+pretty = true
+show_error_codes = true
+
+# Exclude _files.py because mypy isn't smart enough to apply
+# the correct type narrowing and as this is an internal module
+# it's fine to just use Pyright.
+#
+# 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/.*', 'examples/mcp_server_weather.py', 'examples/tools_with_mcp.py']
+
+strict_equality = true
+implicit_reexport = true
+check_untyped_defs = true
+no_implicit_optional = true
+
+warn_return_any = true
+warn_unreachable = true
+warn_unused_configs = true
+
+# Turn these options off as it could cause conflicts
+# with the Pyright options.
+warn_unused_ignores = false
+warn_redundant_casts = false
+
+disallow_any_generics = true
+disallow_untyped_defs = true
+disallow_untyped_calls = true
+disallow_subclassing_any = true
+disallow_incomplete_defs = true
+disallow_untyped_decorators = true
+cache_fine_grained = true
+
+# By default, mypy reports an error if you assign a value to the result
+# of a function call that doesn't return anything. We do this in our test
+# cases:
+# ```
+# result = ...
+# assert result is None
+# ```
+# Changing this codegen to make mypy happy would increase complexity
+# and would not be worth it.
+disable_error_code = "func-returns-value,overload-cannot-match"
+
+# https://github.com/python/mypy/issues/12162
+[[tool.mypy.overrides]]
+module = "black.files.*"
+ignore_errors = true
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "anthropic.lib.vertex._auth"
+disallow_untyped_calls = false
+
 [tool.ruff]
 line-length = 120
 output-format = "grouped"

{anthropic-0.66.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,12 +31,16 @@ 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.13.0 ; python_full_version >= '3.9'
 h11==0.16.0
@@ -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.66.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.66.0 → anthropic-0.68.0}/src/anthropic/_base_client.py

@@ -62,7 +62,7 @@ from ._types import (
     ModelBuilderProtocol,
 )
 from ._utils import is_dict, is_list, asyncify, is_given, lru_cache, is_mapping
-from ._compat import PYDANTIC_V2, model_copy, model_dump
+from ._compat import PYDANTIC_V1, model_copy, model_dump
 from ._models import GenericModel, FinalRequestOptions, validate_type, construct_type
 from ._response import (
     APIResponse,
@@ -237,7 +237,7 @@ class BaseSyncPage(BasePage[_T], Generic[_T]):
         model: Type[_T],
         options: FinalRequestOptions,
     ) -> None:
-        if PYDANTIC_V2 and getattr(self, "__pydantic_private__", None) is None:
+        if (not PYDANTIC_V1) and getattr(self, "__pydantic_private__", None) is None:
             self.__pydantic_private__ = {}
 
         self._model = model
@@ -325,7 +325,7 @@ class BaseAsyncPage(BasePage[_T], Generic[_T]):
         client: AsyncAPIClient,
         options: FinalRequestOptions,
     ) -> None:
-        if PYDANTIC_V2 and getattr(self, "__pydantic_private__", None) is None:
+        if (not PYDANTIC_V1) and getattr(self, "__pydantic_private__", None) is None:
             self.__pydantic_private__ = {}
 
         self._model = model