Handle a case when model_config is defined as a model property

docs/errors/usage_errors.md

@@ -1089,4 +1089,18 @@ pydantic.errors.PydanticUserError: Dataclass field bar has init=False and init_v
 """
 ```
 
+## `model_config` is used as a model property {#model-config-cannot-be-a-property}
+This error is raised when `model_config` is used as as property.
+```py
+from pydantic import BaseModel, PydanticUserError
+
+try:
+
+    class Model(BaseModel):
+        model_config: str
+
+except PydanticUserError as exc_info:
+    assert exc_info.code == 'model-config-cannot-be-a-property'
+```
+
 {% endraw %}

pydantic/_internal/_config.py

@@ -116,6 +116,13 @@ def for_model(cls, bases: tuple[type[Any], ...], namespace: dict[str, Any], kwar
         config_class_from_namespace = namespace.get('Config')
         config_dict_from_namespace = namespace.get('model_config')
 
+        raw_annotations = namespace.get('__annotations__', {})
+        if raw_annotations.get('model_config') and not config_dict_from_namespace:
+            raise PydanticUserError(
+                '"model_config" cannot be used as a model property. Use "model_config" for model configuration',
+                code='model-config-cannot-be-a-property',
+            )
+
         if config_class_from_namespace and config_dict_from_namespace:
             raise PydanticUserError('"Config" and "model_config" cannot be used together', code='config-both')
 

pydantic/errors.py

@@ -61,6 +61,7 @@
     'unevaluable-type-annotation',
     'dataclass-init-false-extra-allow',
     'clashing-init-and-init-var',
+    'model-config-cannot-be-a-property',
 ]
 
 

tests/test_config.py

@@ -796,3 +796,16 @@ def create_partial(model, optionals):
 
     # AssertionError: assert ['a', 'b'] == ['b']
     assert partial.model_json_schema()['required'] == ['b']
+
+
+def test_model_config_use_as_property():
+    """
+    Test: raises PydandicUserError when 'model_config' is used
+    as a property
+    """
+    with pytest.raises(PydanticUserError) as exc_info:
+
+        class MyModel(BaseModel):
+            model_config: str
+
+    assert exc_info.value.code == 'model-config-cannot-be-a-property'