Add bind_logger helper for binding logger_name

Author: GDYendell

src/fastcs/attributes.py

@@ -6,13 +6,13 @@
 
 from fastcs.attribute_io_ref import AttributeIORefT
 from fastcs.datatypes import ATTRIBUTE_TYPES, DataType, T
-from fastcs.logging import logger as _logger
+from fastcs.logging import bind_logger
 from fastcs.tracer import Tracer
 
 ONCE = float("inf")
 """Special value to indicate that an attribute should be updated once on start up."""
 
-logger = _logger.bind(logger_name=__name__)
+logger = bind_logger(logger_name=__name__)
 
 
 class Attribute(Generic[T, AttributeIORefT], Tracer):

src/fastcs/logging/__init__.py

@@ -7,7 +7,7 @@
 from ._graylog import GraylogStaticFields as GraylogStaticFields
 from ._graylog import parse_graylog_env_fields as parse_graylog_env_fields
 from ._graylog import parse_graylog_static_fields as parse_graylog_static_fields
-from ._logging import LogLevel, _configure_logger
+from ._logging import Logger, LogLevel, _configure_logger
 
 logger = _logger.bind(logger_name="fastcs")
 """FastCS logger
@@ -50,13 +50,25 @@
 fastcs. Instead there is a ``Tracer`` class for verbose logging with fine-grained
 controls that can be enabled by the user at runtime.
 
-Use ``configure_logging`` to re-confi the logger at runtime. For more advanced
+Use ``configure_logging`` to re-configure the logger at runtime. For more advanced
 controls, configure the ``logger`` singleton directly.
 
 See the ``loguru`` docs for more information: https://loguru.readthedocs.io
 """
 
 
+def bind_logger(logger_name: str) -> Logger:
+    """Create a wrapper of the singleton fastcs logger with the given name bound
+
+    The name will be displayed in all log messages from the returned wrapper.
+
+    See the docstring for ``fastcs.logging.logger`` for more information.
+
+    """
+
+    return logger.bind(logger_name=logger_name)
+
+
 def configure_logging(
     level: LogLevel | None = None,
     graylog_endpoint: GraylogEndpoint | None = None,

src/fastcs/transport/epics/ca/ioc.py

@@ -10,7 +10,7 @@
 from fastcs.controller_api import ControllerAPI
 from fastcs.cs_methods import Command
 from fastcs.datatypes import DataType, T
-from fastcs.logging import logger as _logger
+from fastcs.logging import bind_logger
 from fastcs.tracer import Tracer
 from fastcs.transport.epics.ca.util import (
     builder_callable_from_attribute,
@@ -27,7 +27,7 @@
 
 
 tracer = Tracer(name=__name__)
-logger = _logger.bind(logger_name=__name__)
+logger = bind_logger(logger_name=__name__)
 
 
 class EpicsCAIOC: