REF: Align Python type stubs with reality

Author: threecgreen

CHANGELOG.md

@@ -1,8 +1,17 @@
 # Changelog
 
+## 0.46.0 - TBD
+
+### Breaking changes
+- Added `DBNRecord` union type to Python which includes all record types
+- Removed `Record` class from Python type stubs to match code: the record classes don't
+  share a base class. Use `DBNRecord` instead.
+- Removed `_DBNRecord` union type alias which only existed in typestub and wasn't
+  importable. Use `DBNRecord | Metadata` instead
+
 ## 0.45.0 - 2025-12-09
 
-#### Enhancements
+### Enhancements
 - Added new venue, dataset, and publisher for Cboe Futures Exchange (`XCBF.PITCH`)
 - Added support for Python 3.14 to `databento_dbn`
 

python/python/databento_dbn/__init__.py

@@ -1,56 +1,34 @@
-import datetime as dt
-from collections.abc import Sequence
-from typing import Protocol
-from typing import TypedDict
+# ruff: noqa: F401, F405, UP007
+from typing import Union
+
+from databento_dbn.metadata import MappingInterval
+from databento_dbn.metadata import MappingIntervalDict
+from databento_dbn.metadata import SymbolMapping
 
 # Import native module
 from ._lib import *  # noqa: F403
 
 
-class MappingInterval(Protocol):
-    """
-    Represents a symbol mapping over a start and end date range interval.
-
-    Parameters
-    ----------
-    start_date : dt.date
-        The start of the mapping period.
-    end_date : dt.date
-        The end of the mapping period.
-    symbol : str
-        The symbol value.
-
-    """
-
-    start_date: dt.date
-    end_date: dt.date
-    symbol: str
-
-
-class MappingIntervalDict(TypedDict):
-    """
-    Represents a symbol mapping over a start and end date range interval.
-
-    Parameters
-    ----------
-    start_date : dt.date
-        The start of the mapping period.
-    end_date : dt.date
-        The end of the mapping period.
-    symbol : str
-        The symbol value.
-
-    """
-
-    start_date: dt.date
-    end_date: dt.date
-    symbol: str
-
-
-class SymbolMapping(Protocol):
-    """
-    Represents the mappings for one native symbol.
-    """
-
-    raw_symbol: str
-    intervals: Sequence[MappingInterval]
+DBNRecord = Union[
+    MBOMsg,
+    TradeMsg,
+    MBP1Msg,
+    MBP10Msg,
+    BBOMsg,
+    CMBP1Msg,
+    CBBOMsg,
+    OHLCVMsg,
+    StatusMsg,
+    InstrumentDefMsg,
+    ImbalanceMsg,
+    StatMsg,
+    ErrorMsg,
+    SymbolMappingMsg,
+    SystemMsg,
+    ErrorMsgV1,
+    InstrumentDefMsgV1,
+    StatMsgV1,
+    SymbolMappingMsgV1,
+    SystemMsgV1,
+    InstrumentDefMsgV2,
+]