magscope._logging
=================

.. py:module:: magscope._logging

.. autoapi-nested-parse::

   Internal logging helpers for MagScope.

   This module centralizes logging configuration so that the console
   output can be silenced by default.

   Only warnings and errors remain active unless :func:`configure_logging` is
   invoked with ``verbose=True`` (or an explicit log level).  The helper returns
   ``logging.Logger`` instances namespaced under ``"magscope"`` so that
   submodules can log without manually wiring handlers.



Attributes
----------

.. autoapisummary::

   magscope._logging._ROOT_LOGGER_NAME


Functions
---------

.. autoapisummary::

   magscope._logging.get_logger
   magscope._logging.configure_logging


Module Contents
---------------

.. py:data:: _ROOT_LOGGER_NAME
   :value: 'magscope'


.. py:function:: get_logger(name: str) -> logging.Logger

   Return a child logger scoped under ``magscope``.

   :param name: Module or component name to suffix the root logger with.


.. py:function:: configure_logging(*, verbose: bool = False, level: Optional[int] = None) -> None

   Configure console logging for MagScope modules.

   By default only warnings and errors propagate to the console.  Passing
   ``verbose=True`` (or an explicit ``level``) elevates the logging so that
   informational messages become visible.