chore: add shared MLBBaseModel and base tests

- Introduce MLBBaseModel (Pydantic v2) with extra="ignore" and populate_by_name
- Export MLBBaseModel from models package
- Add unit tests to verify ignoring unknown fields and alias population

Author: Mattsface

mlbstatsapi/models/__init__.py

@@ -0,0 +1,3 @@
+from .base import MLBBaseModel
+
+__all__ = ["MLBBaseModel"]

mlbstatsapi/models/base.py

@@ -0,0 +1,15 @@
+from pydantic import BaseModel, ConfigDict
+
+
+class MLBBaseModel(BaseModel):
+    """Common base for all MLB Stats API models.
+
+    - Pydantic v2
+    - Ignores unknown fields to remain resilient to API changes
+    - populate_by_name allows alias-based population when needed
+    """
+
+    model_config = ConfigDict(
+        extra="ignore",
+        populate_by_name=True,
+    )

tests/test_base_model.py

@@ -0,0 +1,22 @@
+from pydantic import Field
+
+from mlbstatsapi.models import MLBBaseModel
+
+
+class Sample(MLBBaseModel):
+    id: int
+    full_name: str = Field(alias="fullName")
+
+
+def test_ignore_extra_fields():
+    obj = Sample(id=1, full_name="Test", extra_field="ignored")
+    assert obj.id == 1
+    assert obj.full_name == "Test"
+    # Extra fields should be ignored and not set as attributes
+    assert not hasattr(obj, "extra_field")
+
+
+def test_populate_by_name_alias():
+    # populate_by_name allows alias population when present
+    obj = Sample(id=1, fullName="Alias Name")  # type: ignore[arg-type]
+    assert obj.full_name == "Alias Name"