ADD: Function to setup logging for databento

Author: nmacholl

databento/__init__.py

@@ -1,5 +1,6 @@
 import logging
 
+from databento.common import utility
 from databento.common.bento import Bento
 from databento.common.enums import (
     Compression,
@@ -56,4 +57,5 @@
 logging.getLogger(__name__).addHandler(logging.NullHandler())
 
 # Convenience imports
+enable_logging = utility.enable_logging
 from_dbn = Bento.from_file

databento/common/utility.py

@@ -0,0 +1,34 @@
+import logging
+from typing import Union
+
+
+def enable_logging(level: Union[int, str] = logging.INFO) -> None:
+    """
+    Enable logging for the Databento module.
+    This function should be used for simple applications and examples.
+    It is advisible to configure your own logging for serious applications.
+
+    Parameters
+    ----------
+    level : str or int, default 'INFO'
+        The log level to configure.
+
+    See Also
+    --------
+    logging
+
+    """
+    # Create a basic formatter
+    formatter = logging.Formatter(
+        fmt=logging.BASIC_FORMAT,
+    )
+
+    # Construct a stream handler for stderr
+    handler = logging.StreamHandler()
+    handler.setFormatter(formatter)
+    handler.setLevel(level=level)
+
+    # Add the handler to the databento logger
+    databento_logger = logging.getLogger("databento")
+    databento_logger.setLevel(level=level)
+    databento_logger.addHandler(handler)