databento 0.76.0__tar.gz → 0.78.0__tar.gz

{databento-0.76.0 → databento-0.78.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: databento
-Version: 0.76.0
+Version: 0.78.0
 Summary: Official Python client library for Databento
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -21,7 +21,7 @@ Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Dist: aiohttp (>=3.8.3,<4.0.0) ; python_version < "3.12"
 Requires-Dist: aiohttp (>=3.9.0,<4.0.0) ; python_version >= "3.12"
-Requires-Dist: databento-dbn (>=0.55.0,<0.56.0)
+Requires-Dist: databento-dbn (>=0.58.0,<0.59.0)
 Requires-Dist: numpy (>=1.23.5) ; python_version < "3.12"
 Requires-Dist: numpy (>=1.26.0) ; python_version >= "3.12"
 Requires-Dist: pandas (>=1.5.3,<4.0.0)
@@ -69,7 +69,7 @@ The library is fully compatible with distributions of Anaconda 2023.x and above.
 The minimum dependencies as found in the `pyproject.toml` are also listed below:
 - python = "^3.10"
 - aiohttp = "^3.8.3"
-- databento-dbn = "~0.55.0"
+- databento-dbn = "~0.58.0"
 - numpy = ">=1.23.5"
 - pandas = ">=1.5.3"
 - pip-system-certs = ">=4.0" (Windows only)

{databento-0.76.0 → databento-0.78.0}/README.md

@@ -32,7 +32,7 @@ The library is fully compatible with distributions of Anaconda 2023.x and above.
 The minimum dependencies as found in the `pyproject.toml` are also listed below:
 - python = "^3.10"
 - aiohttp = "^3.8.3"
-- databento-dbn = "~0.55.0"
+- databento-dbn = "~0.58.0"
 - numpy = ">=1.23.5"
 - pandas = ">=1.5.3"
 - pip-system-certs = ">=4.0" (Windows only)

{databento-0.76.0 → databento-0.78.0}/databento/common/bentologging.py

@@ -5,8 +5,9 @@ import logging
 
 def enable_logging(level: int | str = logging.INFO) -> None:
     """
-    Enable logging for the Databento module. This function should be used for
-    simple applications and examples. It is advisable to configure your own
+    Enable logging for the Databento module.
+
+    This function should be used for simple applications and examples. It is advisable to configure your own
     logging for serious applications.
 
     Parameters

{databento-0.76.0 → databento-0.78.0}/databento/common/dbnstore.py

@@ -244,8 +244,9 @@ class MemoryDataSource(DataSource):
     @property
     def name(self) -> str:
         """
-        Return the name of the source buffer. Equivalent to `repr` of the
-        input.
+        Return the name of the source buffer.
+
+        Equivalent to `repr` of the input.
 
         Returns
         -------
@@ -269,8 +270,9 @@ class MemoryDataSource(DataSource):
     @property
     def reader(self) -> BytesIO:
         """
-        Return a reader for this buffer. The reader beings at the start of the
-        buffer.
+        Return a reader for this buffer.
+
+        The reader beings at the start of the buffer.
 
         Returns
         -------
@@ -391,8 +393,7 @@ class DBNStore:
         while True:
             raw = reader.read(DBNStore.DBN_READ_SIZE)
             if raw:
-                decoder.write(raw)
-                records = decoder.decode()
+                records = decoder.write_and_decode(raw)
                 for record in records:
                     if isinstance(record, databento_dbn.Metadata):
                         continue
@@ -416,8 +417,9 @@ class DBNStore:
     @property
     def compression(self) -> Compression:
         """
-        Return the data compression format (if any). This is determined by
-        inspecting the data.
+        Return the data compression format (if any).
+
+        This is determined by inspecting the data.
 
         Returns
         -------
@@ -441,8 +443,9 @@ class DBNStore:
     @property
     def end(self) -> pd.Timestamp | None:
         """
-        Return the query end for the data. If None, the end time was not known
-        when the data was generated.
+        Return the query end for the data.
+
+        If None, the end time was not known when the data was generated.
 
         Returns
         -------
@@ -546,11 +549,13 @@ class DBNStore:
     @property
     def schema(self) -> Schema | None:
         """
-        Return the DBN record schema. If None, may contain one or more schemas.
+        Return the DBN record schema.
+
+        If None, may contain one or more schemas.
 
         Returns
         -------
-        Schema or None
+                Schema or None
 
         """
         schema = self._metadata.schema
@@ -577,8 +582,9 @@ class DBNStore:
     @property
     def stype_in(self) -> SType | None:
         """
-        Return the query input symbology type for the data. If None, the
-        records may contain mixed STypes.
+        Return the query input symbology type for the data.
+
+        If None, the records may contain mixed STypes.
 
         Returns
         -------

{databento-0.76.0 → databento-0.78.0}/databento/common/enums.py

@@ -85,8 +85,10 @@ def coercible(enum_type: type[M]) -> type[M]:
 
 class StringyMixin:
     """
-    Mixin class for overloading __str__ on Enum types. This will use the
-    Enumerations subclass, if any, to modify the behavior of str().
+    Mixin class for overloading __str__ on Enum types.
+
+    This will use the Enumerations subclass, if any, to modify the
+    behavior of str().
 
     For subclasses of enum.Flag a comma separated string of names is
     returned. For integer enumerations, the lowercase member name is
@@ -134,6 +136,7 @@ class SplitDuration(StringyMixin, str, Enum):
     DAY = "day"
     WEEK = "week"
     MONTH = "month"
+    YEAR = "year"
     NONE = "none"
 
 
@@ -195,6 +198,8 @@ class RecordFlags(StringyMixin, IntFlag):  # type: ignore
     """
     Represents record flags.
 
+    Attributes
+    ----------
     F_LAST
         Marks the last record in a single event for a given `instrument_id`.
     F_TOB

{databento-0.76.0 → databento-0.78.0}/databento/common/parsing.py

@@ -168,8 +168,9 @@ def symbols_list_to_list(
 @symbols_list_to_list.register(cls=Integral)
 def _(symbols: Integral, stype_in: SType) -> list[str]:
     """
-    Dispatch method for optional_symbols_list_to_list. Handles integral types,
-    alerting when an integer is given for STypes that expect strings.
+    Dispatch method for optional_symbols_list_to_list.
+
+    Handles integral types, alerting when an integer is given for STypes that expect strings.
 
     See Also
     --------
@@ -187,8 +188,9 @@ def _(symbols: Integral, stype_in: SType) -> list[str]:
 @symbols_list_to_list.register(cls=str)
 def _(symbols: str, stype_in: SType) -> list[str]:
     """
-    Dispatch method for optional_symbols_list_to_list. Handles str, splitting
-    on commas and validating smart symbology.
+    Dispatch method for optional_symbols_list_to_list.
+
+    Handles str, splitting on commas and validating smart symbology.
 
     See Also
     --------
@@ -212,8 +214,9 @@ def _(symbols: str, stype_in: SType) -> list[str]:
 @symbols_list_to_list.register(cls=Iterable)
 def _(symbols: Iterable[Any], stype_in: SType) -> list[str]:
     """
-    Dispatch method for optional_symbols_list_to_list. Handles Iterables by
-    dispatching the individual members.
+    Dispatch method for optional_symbols_list_to_list.
+
+    Handles Iterables by dispatching the individual members.
 
     See Also
     --------

{databento-0.76.0 → databento-0.78.0}/databento/common/publishers.py

@@ -126,6 +126,8 @@ class Venue(StringyMixin, str, Enum):
         MX2 Options.
     IEXO
         IEX Options LLC.
+    CGIF
+        Cboe Global Indices Feed.
 
     """
 
@@ -184,6 +186,7 @@ class Venue(StringyMixin, str, Enum):
     OCEA = "OCEA"
     MXTO = "MXTO"
     IEXO = "IEXO"
+    CGIF = "CGIF"
 
     @classmethod
     def from_int(cls, value: int) -> Venue:
@@ -300,6 +303,8 @@ class Venue(StringyMixin, str, Enum):
             return Venue.MXTO
         if value == 55:
             return Venue.IEXO
+        if value == 56:
+            return Venue.CGIF
         raise ValueError(f"Integer value {value} does not correspond with any Venue variant")
 
     def to_int(self) -> int:
@@ -416,6 +421,8 @@ class Venue(StringyMixin, str, Enum):
             return 54
         if self == Venue.IEXO:
             return 55
+        if self == Venue.CGIF:
+            return 56
         raise ValueError("Invalid Venue")
 
     @property
@@ -533,6 +540,8 @@ class Venue(StringyMixin, str, Enum):
             return "MX2 Options"
         if self == Venue.IEXO:
             return "IEX Options LLC"
+        if self == Venue.CGIF:
+            return "Cboe Global Indices Feed"
         raise ValueError("Unexpected Venue value")
 
 
@@ -624,6 +633,8 @@ class Dataset(StringyMixin, str, Enum):
         CFE Depth.
     OCEA_MEMOIR
         Blue Ocean ATS MEMOIR Depth.
+    CGIF_TITANIUM
+        Cboe Titanium Cboe Global Indices Feed.
 
     """
 
@@ -668,6 +679,7 @@ class Dataset(StringyMixin, str, Enum):
     XEEE_EOBI = "XEEE.EOBI"
     XCBF_PITCH = "XCBF.PITCH"
     OCEA_MEMOIR = "OCEA.MEMOIR"
+    CGIF_TITANIUM = "CGIF.TITANIUM"
 
     @classmethod
     def from_int(cls, value: int) -> Dataset:
@@ -756,6 +768,8 @@ class Dataset(StringyMixin, str, Enum):
             return Dataset.XCBF_PITCH
         if value == 41:
             return Dataset.OCEA_MEMOIR
+        if value == 42:
+            return Dataset.CGIF_TITANIUM
         raise ValueError(f"Integer value {value} does not correspond with any Dataset variant")
 
     def to_int(self) -> int:
@@ -844,6 +858,8 @@ class Dataset(StringyMixin, str, Enum):
             return 40
         if self == Dataset.OCEA_MEMOIR:
             return 41
+        if self == Dataset.CGIF_TITANIUM:
+            return 42
         raise ValueError("Invalid Dataset")
 
     @property
@@ -933,6 +949,8 @@ class Dataset(StringyMixin, str, Enum):
             return "CFE Depth"
         if self == Dataset.OCEA_MEMOIR:
             return "Blue Ocean ATS MEMOIR Depth"
+        if self == Dataset.CGIF_TITANIUM:
+            return "Cboe Titanium Cboe Global Indices Feed"
         raise ValueError("Unexpected Dataset value")
 
 
@@ -1160,6 +1178,8 @@ class Publisher(StringyMixin, str, Enum):
         OPRA - MEMX MX2 Options.
     OPRA_PILLAR_IEXO
         OPRA - IEX Options LLC.
+    CGIF_TITANIUM_CGIF
+        Cboe Global Indices Feed.
 
     """
 
@@ -1272,6 +1292,7 @@ class Publisher(StringyMixin, str, Enum):
     OCEA_MEMOIR_OCEA = "OCEA.MEMOIR.OCEA"
     OPRA_PILLAR_MXTO = "OPRA.PILLAR.MXTO"
     OPRA_PILLAR_IEXO = "OPRA.PILLAR.IEXO"
+    CGIF_TITANIUM_CGIF = "CGIF.TITANIUM.CGIF"
 
     @classmethod
     def from_int(cls, value: int) -> Publisher:
@@ -1496,6 +1517,8 @@ class Publisher(StringyMixin, str, Enum):
             return Publisher.OPRA_PILLAR_MXTO
         if value == 109:
             return Publisher.OPRA_PILLAR_IEXO
+        if value == 110:
+            return Publisher.CGIF_TITANIUM_CGIF
         raise ValueError(f"Integer value {value} does not correspond with any Publisher variant")
 
     def to_int(self) -> int:
@@ -1720,6 +1743,8 @@ class Publisher(StringyMixin, str, Enum):
             return 108
         if self == Publisher.OPRA_PILLAR_IEXO:
             return 109
+        if self == Publisher.CGIF_TITANIUM_CGIF:
+            return 110
         raise ValueError("Invalid Publisher")
 
     @property
@@ -1945,6 +1970,8 @@ class Publisher(StringyMixin, str, Enum):
             return Venue.MXTO
         if self == Publisher.OPRA_PILLAR_IEXO:
             return Venue.IEXO
+        if self == Publisher.CGIF_TITANIUM_CGIF:
+            return Venue.CGIF
         raise ValueError("Unexpected Publisher value")
 
     @property
@@ -2170,6 +2197,8 @@ class Publisher(StringyMixin, str, Enum):
             return Dataset.OPRA_PILLAR
         if self == Publisher.OPRA_PILLAR_IEXO:
             return Dataset.OPRA_PILLAR
+        if self == Publisher.CGIF_TITANIUM_CGIF:
+            return Dataset.CGIF_TITANIUM
         raise ValueError("Unexpected Publisher value")
 
     @property
@@ -2395,4 +2424,6 @@ class Publisher(StringyMixin, str, Enum):
             return "OPRA - MEMX MX2 Options"
         if self == Publisher.OPRA_PILLAR_IEXO:
             return "OPRA - IEX Options LLC"
+        if self == Publisher.CGIF_TITANIUM_CGIF:
+            return "Cboe Global Indices Feed"
         raise ValueError("Unexpected Publisher value")

{databento-0.76.0 → databento-0.78.0}/databento/common/symbology.py

@@ -645,8 +645,9 @@ class InstrumentMap:
 
     def build_symbol_map(self) -> dict[int, list[tuple[dt.date, dt.date, str]]]:
         """
-        Build a simple symbol map. This is to interface with methods of
-        databento-dbn.
+        Build a simple symbol map.
+
+        This is to interface with methods of databento-dbn.
 
         Returns
         -------

{databento-0.76.0 → databento-0.78.0}/databento/common/types.py

@@ -22,8 +22,9 @@ _T = TypeVar("_T")
 
 class Default(Generic[_T]):
     """
-    A container for a default value. This is to be used when a callable wants
-    to detect if a default parameter value is being used.
+    A container for a default value.
+
+    This is to be used when a callable wants to detect if a default parameter value is being used.
 
     Example
     -------
@@ -152,8 +153,9 @@ class ClientStream:
 
     def write(self, data: bytes) -> None:
         """
-        Write data to the underlying stream. Any exceptions encountered will be
-        dispatched to the exception callback, if defined.
+        Write data to the underlying stream.
+
+        Any exceptions encountered will be dispatched to the exception callback, if defined.
 
         Parameters
         ----------

{databento-0.76.0 → databento-0.78.0}/databento/common/validation.py

@@ -20,8 +20,9 @@ E = TypeVar("E", bound=Enum)
 
 def validate_path(value: PathLike[str] | str, param: str) -> Path:
     """
-    Validate whether the given value is a valid path. This also expands user
-    directories to form valid paths.
+    Validate whether the given value is a valid path.
+
+    This also expands user directories to form valid paths.
 
     Parameters
     ----------

{databento-0.76.0 → databento-0.78.0}/databento/historical/api/batch.py

@@ -122,7 +122,7 @@ class BatchHttpAPI(BentoHttpAPI):
             `dbn`.
         split_symbols : bool, default False
             If files should be split by raw symbol. Cannot be requested with `'ALL_SYMBOLS'`.
-        split_duration : SplitDuration or str {'day', 'week', 'month', 'none'}, default 'day'
+        split_duration : SplitDuration or str {'day', 'week', 'month', 'year', 'none'}, default 'day'
             The maximum time duration before batched data is split into multiple files.
             A week starts on Sunday UTC.
         split_size : int, optional
@@ -588,7 +588,8 @@ class _BatchJob:
     """
     Helper class for downloading multiple batch files from a job.
 
-    Supports sync and async downloads using a shared `ThreadPoolExecutor`.
+    Supports sync and async downloads using a shared
+    `ThreadPoolExecutor`.
 
     """
 

{databento-0.76.0 → databento-0.78.0}/databento/live/client.py

@@ -159,8 +159,9 @@ class Live:
     @property
     def dataset(self) -> str:
         """
-        Return the dataset for this live client. If no subscriptions have been
-        made an empty string will be returned.
+        Return the dataset for this live client.
+
+        If no subscriptions have been made an empty string will be returned.
 
         Returns
         -------
@@ -234,8 +235,9 @@ class Live:
     @property
     def session_id(self) -> str | None:
         """
-        Return the session ID for the current session. If `None`, the client is
-        not connected.
+        Return the session ID for the current session.
+
+        If `None`, the client is not connected.
 
         Returns
         -------
@@ -279,8 +281,9 @@ class Live:
     @property
     def symbology_map(self) -> dict[int, str | int]:
         """
-        Return the symbology map for this client session. A symbol mapping is
-        added when the client receives a SymbolMappingMsg.
+        Return the symbology map for this client session.
+
+        A symbol mapping is added when the client receives a SymbolMappingMsg.
 
         This can be used to transform an `instrument_id` in a DBN record
         to the input symbology.
@@ -398,8 +401,9 @@ class Live:
         exception_callback: ExceptionCallback | None = None,
     ) -> None:
         """
-        Add a callback for handling client reconnection events. This will only
-        be called when using a reconnection policy other than
+        Add a callback for handling client reconnection events.
+
+        This will only be called when using a reconnection policy other than
         `ReconnectPolicy.NONE` and if the session has been started with
         `Live.start`.
 
@@ -614,8 +618,9 @@ class Live:
         timeout: float | None = None,
     ) -> None:
         """
-        Block until the session closes or a timeout is reached. A session will
-        close after the remote gateway disconnects, or after `Live.stop` or
+        Block until the session closes or a timeout is reached.
+
+        A session will close after the remote gateway disconnects, or after `Live.stop` or
         `Live.terminate` are called.
 
         If a `timeout` is specified, `Live.terminate` will be called when the
@@ -661,8 +666,9 @@ class Live:
         timeout: float | None = None,
     ) -> None:
         """
-        Coroutine to wait until the session closes or a timeout is reached. A
-        session will close when the remote gateway disconnects, or after
+        Coroutine to wait until the session closes or a timeout is reached.
+
+        A session will close when the remote gateway disconnects, or after
         `Live.stop` or `Live.terminate` are called.
 
         If a `timeout` is specified, `Live.terminate` will be called when the
@@ -718,8 +724,9 @@ class Live:
 
 class LiveIterator:
     """
-    Iterator class for the `Live` client. Automatically starts the client when
-    created and will stop it when destroyed. This provides context-manager-like
+    Iterator class for the `Live` client.
+
+    Automatically starts the client when created and will stop it when destroyed. This provides context-manager-like
     behavior to for loops.
 
     Parameters

{databento-0.76.0 → databento-0.78.0}/databento/live/gateway.py

@@ -194,8 +194,9 @@ class GatewayDecoder:
 
     def write(self, data: bytes) -> None:
         """
-        Write data to the decoder's buffer. This will make the data available
-        for decoding.
+        Write data to the decoder's buffer.
+
+        This will make the data available for decoding.
 
         Parameters
         ----------
@@ -208,8 +209,9 @@ class GatewayDecoder:
 
     def decode(self) -> list[GatewayControl]:
         """
-        Decode messages from the decoder's buffer. This will consume decoded
-        data from the buffer.
+        Decode messages from the decoder's buffer.
+
+        This will consume decoded data from the buffer.
 
         Returns
         -------

{databento-0.76.0 → databento-0.78.0}/databento/live/protocol.py

@@ -150,8 +150,9 @@ class DatabentoLiveProtocol(asyncio.BufferedProtocol):
     @property
     def is_streaming(self) -> bool:
         """
-        True if the session has started streaming. This occurs when the
-        SessionStart message is sent to the gateway.
+        True if the session has started streaming.
+
+        This occurs when the SessionStart message is sent to the gateway.
 
         Returns
         -------
@@ -255,7 +256,7 @@ class DatabentoLiveProtocol(asyncio.BufferedProtocol):
 
         """
         logger.debug("read %d bytes from remote gateway", nbytes)
-        data = self.__buffer[:nbytes]
+        data = bytes(memoryview(self.__buffer)[:nbytes])
 
         if self.authenticated.done():
             self._process_dbn(data)
@@ -266,8 +267,9 @@ class DatabentoLiveProtocol(asyncio.BufferedProtocol):
 
     def received_metadata(self, metadata: databento_dbn.Metadata) -> None:
         """
-        Call when the protocol receives a Metadata header. This is always sent
-        by the gateway before any data records.
+        Call when the protocol receives a Metadata header.
+
+        This is always sent by the gateway before any data records.
 
         Parameters
         ----------
@@ -297,8 +299,9 @@ class DatabentoLiveProtocol(asyncio.BufferedProtocol):
         subscription_id: int | None = None,
     ) -> list[SubscriptionRequest]:
         """
-        Send a SubscriptionRequest to the gateway. Returns a list of all
-        subscription requests sent to the gateway.
+        Send a SubscriptionRequest to the gateway.
+
+        Returns a list of all subscription requests sent to the gateway.
 
         Parameters
         ----------
@@ -375,8 +378,7 @@ class DatabentoLiveProtocol(asyncio.BufferedProtocol):
             raise ValueError("not connected")
 
         try:
-            self._dbn_decoder.write(bytes(data))
-            records = self._dbn_decoder.decode()
+            records = self._dbn_decoder.write_and_decode(data)
         except Exception:
             logger.exception("error decoding DBN record")
             self.__transport.close()

{databento-0.76.0 → databento-0.78.0}/databento/live/session.py

@@ -36,6 +36,9 @@ logger = logging.getLogger(__name__)
 AUTH_TIMEOUT_SECONDS: Final = 30.0
 CONNECT_TIMEOUT_SECONDS: Final = 10.0
 DBN_QUEUE_CAPACITY: Final = 2**20
+DBN_QUEUE_LAG_THRESHOLD: Final = 128
+DBN_QUEUE_MAX_LAG_NS: Final = 1_000_000_000
+DBN_QUEUE_FULL_WARNING_INTERVAL_S: Final = 60.0
 DEFAULT_REMOTE_PORT: Final = 13000
 CLIENT_TIMEOUT_MARGIN_SECONDS: Final = 10
 
@@ -48,6 +51,8 @@ class DBNQueue(queue.SimpleQueue):  # type: ignore [type-arg]
     def __init__(self) -> None:
         super().__init__()
         self._enabled = threading.Event()
+        self._front_ts_index: int | None = None
+        self._back_ts_index: int | None = None
 
     def is_enabled(self) -> bool:
         """
@@ -62,7 +67,16 @@ class DBNQueue(queue.SimpleQueue):  # type: ignore [type-arg]
         """
         Return True when the queue has reached capacity; False otherwise.
         """
-        return self.qsize() > DBN_QUEUE_CAPACITY
+        if self.qsize() > DBN_QUEUE_CAPACITY:
+            return True
+        if (
+            self.qsize() > DBN_QUEUE_LAG_THRESHOLD
+            and self._front_ts_index is not None
+            and self._back_ts_index is not None
+            and self._back_ts_index - self._front_ts_index > DBN_QUEUE_MAX_LAG_NS
+        ):
+            return True
+        return False
 
     def enable(self) -> None:
         """
@@ -106,6 +120,9 @@ class DBNQueue(queue.SimpleQueue):  # type: ignore [type-arg]
 
         """
         if self._enabled.wait(timeout):
+            if self._front_ts_index is None:
+                self._front_ts_index = item.ts_index
+            self._back_ts_index = item.ts_index
             return super().put(item, block, timeout)
         if timeout is not None:
             raise BentoError(f"queue is not enabled after {timeout} second(s)")
@@ -131,9 +148,34 @@ class DBNQueue(queue.SimpleQueue):  # type: ignore [type-arg]
 
         """
         if self.is_enabled():
+            if self._front_ts_index is None:
+                self._front_ts_index = item.ts_index
+            self._back_ts_index = item.ts_index
             return super().put_nowait(item)
         raise BentoError("queue is not enabled")
 
+    def get(
+        self,
+        block: bool = True,
+        timeout: float | None = None,
+    ) -> DBNRecord:
+        record = super().get(block, timeout)
+        if self.empty():
+            self._front_ts_index = None
+            self._back_ts_index = None
+        else:
+            self._front_ts_index = record.ts_index
+        return record
+
+    def get_nowait(self) -> DBNRecord:
+        record = super().get_nowait()
+        if self.empty():
+            self._front_ts_index = None
+            self._back_ts_index = None
+        else:
+            self._front_ts_index = record.ts_index
+        return record
+
 
 @dataclasses.dataclass
 class SessionMetadata:
@@ -160,8 +202,9 @@ class SessionMetadata:
 
     def check(self, other: databento_dbn.Metadata) -> None:
         """
-        Verify the Metadata is compatible with another Metadata message. This
-        is used to ensure DBN streams are compatible with one another.
+        Verify the Metadata is compatible with another Metadata message.
+
+        This is used to ensure DBN streams are compatible with one another.
 
         Parameters
         ----------
@@ -225,6 +268,7 @@ class _SessionProtocol(DatabentoLiveProtocol):
         self._user_streams = user_streams
         self._last_ts_event: int | None = None
         self._last_msg_loop_time: float = math.inf
+        self._last_queue_full_warning_t: float = -math.inf
 
     def received_metadata(self, metadata: databento_dbn.Metadata) -> None:
         if self._metadata:
@@ -282,10 +326,13 @@ class _SessionProtocol(DatabentoLiveProtocol):
         self._dbn_queue.put(record)
         # DBNQueue has no max size; so check if it's above capacity, and if so, pause reading
         if self._dbn_queue.is_full():
-            logger.warning(
-                "record queue is full; %d record(s) to be processed",
-                self._dbn_queue.qsize(),
-            )
+            now = self._loop.time()
+            if now - self._last_queue_full_warning_t >= DBN_QUEUE_FULL_WARNING_INTERVAL_S:
+                logger.warning(
+                    "record queue is full; %d record(s) to be processed",
+                    self._dbn_queue.qsize(),
+                )
+                self._last_queue_full_warning_t = now
             self.transport.pause_reading()
 
 
@@ -485,8 +532,9 @@ class LiveSession:
         snapshot: bool = False,
     ) -> int:
         """
-        Send a subscription request on the current connection. This will create
-        a new connection if there is no active connection to the gateway.
+        Send a subscription request on the current connection.
+
+        This will create a new connection if there is no active connection to the gateway.
 
         Parameters
         ----------

databento-0.78.0/databento/version.py

@@ -0,0 +1 @@
+__version__ = "0.78.0"

{databento-0.76.0 → databento-0.78.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "databento"
-version = "0.76.0"
+version = "0.78.0"
 description = "Official Python client library for Databento"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -10,7 +10,7 @@ dynamic = [ "classifiers" ]
 dependencies = [
     "aiohttp>=3.8.3,<4.0.0; python_version < '3.12'",
     "aiohttp>=3.9.0,<4.0.0; python_version >= '3.12'",
-    "databento-dbn~=0.55.0",
+    "databento-dbn~=0.58.0",
     "numpy>=1.23.5; python_version < '3.12'",
     "numpy>=1.26.0; python_version >= '3.12'",
     "pandas>=1.5.3,<4.0.0",

databento-0.76.0/databento/version.py

@@ -1 +0,0 @@
-__version__ = "0.76.0"