Avoid deprecated class property stacking

.ruff.toml

@@ -55,7 +55,7 @@ unfixable = [
 ]
 ignore-init-module-imports = true
 
-[extend-per-file-ignores]
+[lint.extend-per-file-ignores]
 "instructor/distil.py" = ["ARG002"]
 "tests/test_distil.py" = ["ARG001"]
 "tests/test_patch.py" = ["ARG001"]

instructor/function_calls.py

@@ -4,19 +4,22 @@
 
 from docstring_parser import parse
 from openai.types.chat import ChatCompletion
-from pydantic import BaseModel, Field, TypeAdapter, create_model  # type: ignore - remove once Pydantic is updated
+from pydantic import BaseModel, Field, TypeAdapter, ConfigDict, create_model  # type: ignore - remove once Pydantic is updated
 from instructor.exceptions import IncompleteOutputException
 from instructor.mode import Mode
-from instructor.utils import extract_json_from_codeblock
+from instructor.utils import extract_json_from_codeblock, classproperty
+
 
 T = TypeVar("T")
 
 logger = logging.getLogger("instructor")
 
 
 class OpenAISchema(BaseModel):
-    @classmethod
-    @property
+    # Ignore classproperty, since Pydantic doesn't understand it like it would a normal property.
+    model_config = ConfigDict(ignored_types=(classproperty,))
+
+    @classproperty
     def openai_schema(cls) -> dict[str, Any]:
         """
         Return the schema in the format of OpenAI's schema as jsonschema
@@ -58,8 +61,7 @@ def openai_schema(cls) -> dict[str, Any]:
             "parameters": parameters,
         }
 
-    @classmethod
-    @property
+    @classproperty
     def anthropic_schema(cls) -> dict[str, Any]:
         return {
             "name": cls.openai_schema["name"],

instructor/utils.py

@@ -3,7 +3,15 @@
 import inspect
 import json
 import logging
-from typing import Callable, Generator, Iterable, AsyncGenerator, Protocol, TypeVar
+from typing import (
+    Callable,
+    Generator,
+    Generic,
+    Iterable,
+    AsyncGenerator,
+    Protocol,
+    TypeVar,
+)
 from openai.types.completion_usage import CompletionUsage
 from anthropic.types import Usage as AnthropicUsage
 from typing import Any
@@ -15,6 +23,7 @@
 )
 
 logger = logging.getLogger("instructor")
+R_co = TypeVar("R_co", covariant=True)
 T_Model = TypeVar("T_Model", bound="Response")
 
 from enum import Enum
@@ -179,3 +188,24 @@ def merge_consecutive_messages(messages: list[dict[str, Any]]) -> list[dict[str,
             )
 
     return new_messages
+
+
+class classproperty(Generic[R_co]):
+    """Descriptor for class-level properties.
+
+    Examples:
+        >>> from instructor.utils import classproperty
+
+        >>> class MyClass:
+        ...     @classproperty
+        ...     def my_property(cls):
+        ...         return cls
+
+        >>> assert MyClass.my_property
+    """
+
+    def __init__(self, method: Callable[[Any], R_co]) -> None:
+        self.cproperty = method
+
+    def __get__(self, instance: object, cls: type[Any]) -> R_co:
+        return self.cproperty(cls)

pyproject.toml

@@ -100,4 +100,3 @@ typeCheckingMode = "strict"
 # Allow "redundant" runtime type-checking.
 reportUnnecessaryIsInstance = "none"
 reportUnnecessaryTypeIgnoreComment = "error"
-reportDeprecated = "warning"

tests/test_utils.py

@@ -1,6 +1,7 @@
 import json
 import pytest
 from instructor.utils import (
+    classproperty,
     extract_json_from_codeblock,
     extract_json_from_stream,
     extract_json_from_stream_async,
@@ -170,3 +171,23 @@ def test_merge_consecutive_messages_single():
         {"role": "user", "content": [{"type": "text", "text": "Hello"}]},
         {"role": "assistant", "content": [{"type": "text", "text": "Hello"}]},
     ]
+
+
+def test_classproperty():
+    """Test custom `classproperty` descriptor."""
+
+    class MyClass:
+        @classproperty
+        def my_property(cls):
+            return cls
+
+    assert MyClass.my_property is MyClass
+
+    class MyClass:
+        clvar = 1
+
+        @classproperty
+        def my_property(cls):
+            return cls.clvar
+
+    assert MyClass.my_property == 1