ncaa_eval.utils package

Submodules

• ncaa_eval.utils.logger module
  • DEBUG
  • NORMAL
  • QUIET
  • VERBOSE
  • configure_logging()
  • get_logger()

Module contents

Shared utilities module.

ncaa_eval.utils.configure_logging(level: str | None = None) → None

Configure project-wide logging with the given verbosity level.

Resolution order:

1. Explicit level argument (if not None).

2. NCAA_EVAL_LOG_LEVEL environment variable.

3. "NORMAL" default.

Parameters:

level – One of "QUIET", "NORMAL", "VERBOSE", or "DEBUG" (case-insensitive). None means fall through to the environment variable or default.

Raises:

ValueError – If the resolved level name is not recognised.

Example

>>> from ncaa_eval.utils.logger import configure_logging, get_logger
>>> configure_logging("VERBOSE")
>>> log = get_logger("ingest")
>>> log.info("Loading data...")

ncaa_eval.utils.get_logger(name: str) → Logger

Return a logger under the ncaa_eval hierarchy.

Parameters:

name – Dot-separated path appended to the root ncaa_eval logger (e.g. "transform.features" yields ncaa_eval.transform.features).

Returns:

A logging.Logger instance.

Example

>>> log = get_logger("transform.features")
>>> log.info("Computing features for season %d", 2025)