dycw-utilities 0.129.6__tar.gz → 0.129.8__tar.gz

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.129.6
+Version: 0.129.8
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -93,12 +93,11 @@ Requires-Dist: polars-lts-cpu<1.31,>=1.30.0; extra == 'zzz-test-iterables'
 Requires-Dist: whenever<0.9,>=0.8.4; extra == 'zzz-test-iterables'
 Provides-Extra: zzz-test-jupyter
 Requires-Dist: jupyterlab<4.3,>=4.2.0; extra == 'zzz-test-jupyter'
-Requires-Dist: pandas<2.3,>=2.2.2; extra == 'zzz-test-jupyter'
+Requires-Dist: pandas<2.4,>=2.3.0; extra == 'zzz-test-jupyter'
 Requires-Dist: polars-lts-cpu<1.31,>=1.30.0; extra == 'zzz-test-jupyter'
 Provides-Extra: zzz-test-logging
 Requires-Dist: atomicwrites<1.5,>=1.4.1; extra == 'zzz-test-logging'
 Requires-Dist: coloredlogs<15.1,>=15.0.1; extra == 'zzz-test-logging'
-Requires-Dist: concurrent-log-handler<0.10,>=0.9.26; extra == 'zzz-test-logging'
 Requires-Dist: rich<14.1,>=14.0.0; extra == 'zzz-test-logging'
 Requires-Dist: tomlkit<0.14,>=0.13.2; extra == 'zzz-test-logging'
 Requires-Dist: tzlocal<5.4,>=5.3.1; extra == 'zzz-test-logging'
@@ -173,7 +172,7 @@ Requires-Dist: scipy<1.16,>=1.15.3; extra == 'zzz-test-scipy'
 Provides-Extra: zzz-test-sentinel
 Provides-Extra: zzz-test-shelve
 Provides-Extra: zzz-test-slack-sdk
-Requires-Dist: aiohttp<3.12.8,>=3.12.7; extra == 'zzz-test-slack-sdk'
+Requires-Dist: aiohttp<3.12.10,>=3.12.9; extra == 'zzz-test-slack-sdk'
 Requires-Dist: slack-sdk<3.36,>=3.35.0; extra == 'zzz-test-slack-sdk'
 Provides-Extra: zzz-test-socket
 Provides-Extra: zzz-test-sqlalchemy

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/pyproject.toml

@@ -8,7 +8,7 @@ requires = ["hatchling"]
 # dependency groups
 [dependency-groups]
 dev = [
-  "aiohttp >= 3.12.7, < 3.12.8",  # for slack
+  "aiohttp >= 3.12.9, < 3.12.10",  # for slack
   "aiosqlite >= 0.21.0, < 0.22",
   "altair >= 5.5.0, < 5.6",
   "asyncpg >= 0.30.0, < 0.31",  # for sqlalchemy async
@@ -17,7 +17,6 @@ dev = [
   "cachetools >= 5.5.2, < 5.6",
   "click >= 8.2.1, < 8.3",
   "coloredlogs >= 15.0.1, < 15.1",
-  "concurrent-log-handler >= 0.9.26, < 0.10",
   "cryptography >= 45.0.3, < 45.1",
   "cvxpy >= 1.6.5, < 1.7",
   "eventkit >= 1.0.3, < 1.1",
@@ -54,7 +53,7 @@ dev = [
   "python-dotenv >= 1.1.0, < 1.2",
   "redis >= 6.2.0, < 6.3",
   "rich >= 14.0.0, < 14.1",
-  "scikit-learn >= 1.6.1, < 1.7",
+  "scikit-learn >= 1.7.0, < 1.8",
   "scipy >= 1.15.3, < 1.16",
   "slack-sdk >= 3.35.0, < 3.36",
   "sqlalchemy >= 2.0.41, < 2.1",
@@ -94,7 +93,7 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.129.6"
+version = "0.129.8"
 
 [project.optional-dependencies]
 test = [
@@ -191,13 +190,12 @@ zzz-test-iterables = [
 ]
 zzz-test-jupyter = [
   "jupyterlab >= 4.2.0, < 4.3",
-  "pandas >= 2.2.2, < 2.3",
+  "pandas >= 2.3.0, < 2.4",
   "polars-lts-cpu >= 1.30.0, < 1.31",
 ]
 zzz-test-logging = [
   "atomicwrites >= 1.4.1, < 1.5",
   "coloredlogs >= 15.0.1, < 15.1",
-  "concurrent-log-handler >= 0.9.26, < 0.10",
   "rich >= 14.0.0, < 14.1",
   "tomlkit >= 0.13.2, < 0.14",
   "tzlocal >= 5.3.1, < 5.4",
@@ -270,7 +268,7 @@ zzz-test-scipy = ["scipy >= 1.15.3, < 1.16"]
 zzz-test-sentinel = []
 zzz-test-shelve = []
 zzz-test-slack-sdk = [
-  "aiohttp >= 3.12.7, < 3.12.8",  # for slack
+  "aiohttp >= 3.12.9, < 3.12.10",  # for slack
   "slack-sdk >= 3.35.0, < 3.36",
 ]
 zzz-test-socket = []
@@ -334,7 +332,7 @@ zzz-test-zoneinfo = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.129.6"
+current_version = "0.129.8"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/src/tests/conftest.py

@@ -39,6 +39,8 @@ def traceback_func_chain() -> Pattern[str]:
         strip_and_dedent(
             r"""
             Date/time \| .+
+            Started   \| .+
+            Duration  \| .+
             User      \| .+
             Host      \| .+
             Version   \|\s
@@ -98,6 +100,8 @@ def traceback_func_one() -> Pattern[str]:
         strip_and_dedent(
             r"""
             Date/time \| .+
+            Started   \| .+
+            Duration  \| .+
             User      \| .+
             Host      \| .+
             Version   \|\s
@@ -134,6 +138,8 @@ def traceback_func_many_long() -> Pattern[str]:
         strip_and_dedent(
             r"""
             Date/time \| .+
+            Started   \| .+
+            Duration  \| .+
             User      \| .+
             Host      \| .+
             Version   \|\s
@@ -192,6 +198,8 @@ def traceback_func_many_short() -> Pattern[str]:
         strip_and_dedent(
             r"""
             Date/time \| .+
+            Started   \| .+
+            Duration  \| .+
             User      \| .+
             Host      \| .+
             Version   \|\s
@@ -228,6 +236,8 @@ def traceback_func_task_group_one() -> Pattern[str]:
         strip_and_dedent(
             r"""
             Date/time \| .+
+            Started   \| .+
+            Duration  \| .+
             User      \| .+
             Host      \| .+
             Version   \|\s
@@ -287,6 +297,8 @@ def traceback_func_two() -> Pattern[str]:
         strip_and_dedent(
             r"""
             Date/time \| .+
+            Started   \| .+
+            Duration  \| .+
             User      \| .+
             Host      \| .+
             Version   \|\s

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/src/tests/test_logging.py

@@ -73,9 +73,13 @@ class TestAddFilters:
 
 class TestBasicConfig:
     @mark.parametrize("log", [param(True), param(False)])
-    def test_main(self, *, caplog: LogCaptureFixture, log: bool) -> None:
+    @mark.parametrize("whenever", [param(True), param(False)])
+    @mark.parametrize("plain", [param(True), param(False)])
+    def test_main(
+        self, *, caplog: LogCaptureFixture, log: bool, whenever: bool, plain: bool
+    ) -> None:
         logger = unique_str() if log else None
-        basic_config(logger=logger)
+        basic_config(obj=logger, whenever=whenever, plain=plain)
         logger_use = getLogger()
         logger_use.warning("message")
         assert "message" in caplog.messages
@@ -484,6 +488,13 @@ class TestSizeAndTimeRotatingFileHandler:
             content = fh.read()
         assert content == "message\n"
 
+    @skipif_windows
+    def test_create_parents(self, *, tmp_path: Path) -> None:
+        logger = getLogger(unique_str())
+        filename = tmp_path.joinpath("foo", "bar", "bar", "log")
+        logger.addHandler(SizeAndTimeRotatingFileHandler(filename=filename))
+        assert filename.exists()
+
     @skipif_windows
     def test_size(self, *, tmp_path: Path) -> None:
         logger = getLogger(unique_str())

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/src/tests/test_whenever.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import datetime as dt
 from datetime import timezone
+from logging import getLogger, setLogRecordFactory
 from re import escape
 from typing import TYPE_CHECKING
 from zoneinfo import ZoneInfo
@@ -40,6 +41,7 @@ from utilities.hypothesis import (
     timedeltas_2w,
     zoned_datetimes,
 )
+from utilities.text import unique_str
 from utilities.tzdata import HongKong
 from utilities.whenever import (
     MAX_SERIALIZABLE_TIMEDELTA,
@@ -60,6 +62,7 @@ from utilities.whenever import (
     SerializePlainDateTimeError,
     SerializeTimeDeltaError,
     SerializeZonedDateTimeError,
+    WheneverLogRecord,
     _CheckValidZonedDateTimeUnequalError,
     _EnsureTimedeltaNanosecondError,
     _EnsureTimedeltaParseError,
@@ -492,3 +495,10 @@ class TestToDateTimeDelta:
             _ToDateTimeDeltaError, match="Unable to create DateTimeDelta; got .*"
         ):
             _ = _to_datetime_delta(timedelta)
+
+
+class TestWheneverLogRecord:
+    def test_main(self) -> None:
+        logger = getLogger(unique_str())
+        setLogRecordFactory(WheneverLogRecord)
+        logger.warning("message")

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.129.6"
+__version__ = "0.129.8"

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/src/utilities/logging.py

@@ -107,8 +107,9 @@ class SizeAndTimeRotatingFileHandler(BaseRotatingHandler):
         utc: bool = False,
         atTime: dt.time | None = None,
     ) -> None:
-        filename = str(Path(filename))
-        super().__init__(filename, mode, encoding=encoding, delay=delay, errors=errors)
+        path = Path(filename)
+        path.parent.mkdir(parents=True, exist_ok=True)
+        super().__init__(path, mode, encoding=encoding, delay=delay, errors=errors)
         self._max_bytes = maxBytes if maxBytes >= 1 else None
         self._backup_count = backupCount if backupCount >= 1 else None
         self._filename = Path(self.baseFilename)
@@ -117,7 +118,7 @@ class SizeAndTimeRotatingFileHandler(BaseRotatingHandler):
         self._suffix = self._filename.suffix
         self._patterns = _compute_rollover_patterns(self._stem, self._suffix)
         self._time_handler = TimedRotatingFileHandler(
-            filename,
+            path,
             when=when,
             interval=interval,
             backupCount=backupCount,
@@ -415,26 +416,53 @@ def add_filters(handler: Handler, /, *filters: _FilterType) -> None:
 
 def basic_config(
     *,
-    logger: LoggerOrName | None = None,
+    obj: LoggerOrName | Handler | None = None,
     format_: str = "{asctime} | {name} | {levelname:8} | {message}",
+    whenever: bool = False,
     level: LogLevel = "INFO",
+    plain: bool = False,
 ) -> None:
     """Do the basic config."""
+    if whenever:
+        format_ = format_.replace("{asctime}", "{zoned_datetime}")
     datefmt = maybe_sub_pct_y("%Y-%m-%d %H:%M:%S")
-    if logger is None:
-        basicConfig(format=format_, datefmt=datefmt, style="{", level=level)
-    else:
-        logger_use = get_logger(logger=logger)
-        logger_use.setLevel(level)
-        logger_use.addHandler(handler := StreamHandler())
-        handler.setLevel(level)
-        try:
-            from coloredlogs import ColoredFormatter
-        except ModuleNotFoundError:  # pragma: no cover
-            formatter = Formatter(fmt=format_, datefmt=datefmt, style="{")
-        else:
-            formatter = ColoredFormatter(fmt=format_, datefmt=datefmt, style="{")
-        handler.setFormatter(formatter)
+    match obj:
+        case None:
+            basicConfig(format=format_, datefmt=datefmt, style="{", level=level)
+        case Logger() as logger:
+            logger.setLevel(level)
+            logger.addHandler(handler := StreamHandler())
+            basic_config(
+                obj=handler,
+                format_=format_,
+                whenever=whenever,
+                level=level,
+                plain=plain,
+            )
+        case str() as name:
+            basic_config(
+                obj=get_logger(logger=name),
+                format_=format_,
+                whenever=whenever,
+                level=level,
+                plain=plain,
+            )
+        case Handler() as handler:
+            handler.setLevel(level)
+            if plain:
+                formatter = Formatter(fmt=format_, datefmt=datefmt, style="{")
+            else:
+                try:
+                    from coloredlogs import ColoredFormatter
+                except ModuleNotFoundError:  # pragma: no cover
+                    formatter = Formatter(fmt=format_, datefmt=datefmt, style="{")
+                else:
+                    formatter = ColoredFormatter(
+                        fmt=format_, datefmt=datefmt, style="{"
+                    )
+            handler.setFormatter(formatter)
+        case _ as never:
+            assert_never(never)
 
 
 ##

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/src/utilities/traceback.py

@@ -26,6 +26,7 @@ from typing import (
     runtime_checkable,
 )
 
+from utilities.datetime import get_datetime, get_now
 from utilities.errors import ImpossibleCaseError
 from utilities.functions import (
     ensure_not_none,
@@ -45,8 +46,9 @@ from utilities.reprlib import (
     yield_call_args_repr,
     yield_mapping_repr,
 )
-from utilities.types import TBaseException, TCallable
+from utilities.types import MaybeCallableDateTime, TBaseException, TCallable
 from utilities.version import get_version
+from utilities.whenever import serialize_duration
 
 if TYPE_CHECKING:
     from collections.abc import Callable, Iterable, Iterator
@@ -60,6 +62,7 @@ if TYPE_CHECKING:
 _T = TypeVar("_T")
 _CALL_ARGS = "_CALL_ARGS"
 _INDENT = 4 * " "
+_START = get_now()
 
 
 ##
@@ -78,6 +81,7 @@ class RichTracebackFormatter(Formatter):
         /,
         *,
         defaults: StrMapping | None = None,
+        start: MaybeCallableDateTime | None = _START,
         version: MaybeCallableVersionLike | None = None,
         max_width: int = RICH_MAX_WIDTH,
         indent_size: int = RICH_INDENT_SIZE,
@@ -89,7 +93,8 @@ class RichTracebackFormatter(Formatter):
         post: Callable[[str], str] | None = None,
     ) -> None:
         super().__init__(fmt, datefmt, style, validate, defaults=defaults)
-        self._version = version
+        self._start = get_datetime(datetime=start)
+        self._version = get_version(version=version)
         self._max_width = max_width
         self._indent_size = indent_size
         self._max_length = max_length
@@ -110,6 +115,7 @@ class RichTracebackFormatter(Formatter):
         exc_value = ensure_not_none(exc_value, desc="exc_value")
         error = get_rich_traceback(
             exc_value,
+            start=self._start,
             version=self._version,
             max_width=self._max_width,
             indent_size=self._indent_size,
@@ -263,6 +269,7 @@ class ExcChainTB(Generic[TBaseException]):
     errors: list[
         ExcGroupTB[TBaseException] | ExcTB[TBaseException] | TBaseException
     ] = field(default_factory=list)
+    start: MaybeCallableDateTime | None = field(default=_START, repr=False)
     version: MaybeCallableVersionLike | None = field(default=None, repr=False)
     max_width: int = RICH_MAX_WIDTH
     indent_size: int = RICH_INDENT_SIZE
@@ -292,7 +299,7 @@ class ExcChainTB(Generic[TBaseException]):
         """Format the traceback."""
         lines: list[str] = []
         if header:  # pragma: no cover
-            lines.extend(_yield_header_lines(version=self.version))
+            lines.extend(_yield_header_lines(start=self.start, version=self.version))
         total = len(self.errors)
         for i, errors in enumerate(self.errors, start=1):
             lines.append(f"Exception chain {i}/{total}:")
@@ -315,6 +322,7 @@ class ExcGroupTB(Generic[TBaseException]):
     errors: list[
         ExcGroupTB[TBaseException] | ExcTB[TBaseException] | TBaseException
     ] = field(default_factory=list)
+    start: MaybeCallableDateTime | None = field(default=_START, repr=False)
     version: MaybeCallableVersionLike | None = field(default=None, repr=False)
     max_width: int = RICH_MAX_WIDTH
     indent_size: int = RICH_INDENT_SIZE
@@ -333,7 +341,7 @@ class ExcGroupTB(Generic[TBaseException]):
         """Format the traceback."""
         lines: list[str] = []  # skipif-ci
         if header:  # pragma: no cover
-            lines.extend(_yield_header_lines(version=self.version))
+            lines.extend(_yield_header_lines(start=self.start, version=self.version))
         lines.append("Exception group:")  # skipif-ci
         match self.exc_group:  # skipif-ci
             case ExcTB() as exc_tb:
@@ -363,6 +371,7 @@ class ExcTB(Generic[TBaseException]):
 
     frames: list[_Frame] = field(default_factory=list)
     error: TBaseException
+    start: MaybeCallableDateTime | None = field(default=_START, repr=False)
     version: MaybeCallableVersionLike | None = field(default=None, repr=False)
     max_width: int = RICH_MAX_WIDTH
     indent_size: int = RICH_INDENT_SIZE
@@ -391,7 +400,7 @@ class ExcTB(Generic[TBaseException]):
         total = len(self)
         lines: list[str] = []
         if header:  # pragma: no cover
-            lines.extend(_yield_header_lines(version=self.version))
+            lines.extend(_yield_header_lines(start=self.start, version=self.version))
         for i, frame in enumerate(self.frames):
             is_head = i < total - 1
             lines.append(
@@ -485,6 +494,7 @@ def get_rich_traceback(
     error: TBaseException,
     /,
     *,
+    start: MaybeCallableDateTime | None = _START,
     version: MaybeCallableVersionLike | None = None,
     max_width: int = RICH_MAX_WIDTH,
     indent_size: int = RICH_INDENT_SIZE,
@@ -506,6 +516,7 @@ def get_rich_traceback(
             err_recast = cast("TBaseException", err)
             return _get_rich_traceback_non_chain(
                 err_recast,
+                start=start,
                 version=version,
                 max_width=max_width,
                 indent_size=indent_size,
@@ -520,6 +531,7 @@ def get_rich_traceback(
                 errors=[
                     _get_rich_traceback_non_chain(
                         e,
+                        start=start,
                         version=version,
                         max_width=max_width,
                         indent_size=indent_size,
@@ -530,6 +542,7 @@ def get_rich_traceback(
                     )
                     for e in errs_recast
                 ],
+                start=start,
                 version=version,
                 max_width=max_width,
                 indent_size=indent_size,
@@ -544,6 +557,7 @@ def _get_rich_traceback_non_chain(
     error: ExceptionGroup[Any] | TBaseException,
     /,
     *,
+    start: MaybeCallableDateTime | None = _START,
     version: MaybeCallableVersionLike | None = None,
     max_width: int = RICH_MAX_WIDTH,
     indent_size: int = RICH_INDENT_SIZE,
@@ -567,6 +581,7 @@ def _get_rich_traceback_non_chain(
             errors = [
                 _get_rich_traceback_non_chain(
                     e,
+                    start=start,
                     version=version,
                     max_width=max_width,
                     indent_size=indent_size,
@@ -580,6 +595,7 @@ def _get_rich_traceback_non_chain(
             return ExcGroupTB(
                 exc_group=exc_group_or_exc_tb,
                 errors=errors,
+                start=start,
                 version=version,
                 max_width=max_width,
                 indent_size=indent_size,
@@ -591,6 +607,7 @@ def _get_rich_traceback_non_chain(
         case BaseException() as base_exc:
             return _get_rich_traceback_base_one(
                 base_exc,
+                start=start,
                 version=version,
                 max_width=max_width,
                 indent_size=indent_size,
@@ -607,6 +624,7 @@ def _get_rich_traceback_base_one(
     error: TBaseException,
     /,
     *,
+    start: MaybeCallableDateTime | None = _START,
     version: MaybeCallableVersionLike | None = None,
     max_width: int = RICH_MAX_WIDTH,
     indent_size: int = RICH_INDENT_SIZE,
@@ -638,6 +656,7 @@ def _get_rich_traceback_base_one(
         return ExcTB(
             frames=frames,
             error=error,
+            start=start,
             version=version,
             max_width=max_width,
             indent_size=indent_size,
@@ -793,13 +812,25 @@ def _merge_frames(
 
 
 def _yield_header_lines(
-    *, version: MaybeCallableVersionLike | None = None
+    *,
+    start: MaybeCallableDateTime | None = _START,
+    version: MaybeCallableVersionLike | None = None,
 ) -> Iterator[str]:
     """Yield the header lines."""
-    from utilities.tzlocal import get_now_local
+    from utilities.tzlocal import get_local_time_zone, get_now_local
     from utilities.whenever import serialize_zoned_datetime
 
-    yield f"Date/time | {serialize_zoned_datetime(get_now_local())}"
+    now = get_now_local()
+    start_use = get_datetime(datetime=start)
+    start_use = (
+        None if start_use is None else start_use.astimezone(get_local_time_zone())
+    )
+    yield f"Date/time | {serialize_zoned_datetime(now)}"
+    start_str = "" if start_use is None else serialize_zoned_datetime(start_use)
+    yield f"Started   | {start_str}"
+    duration = None if start_use is None else (now - start_use)
+    duration_str = "" if duration is None else serialize_duration(duration)
+    yield f"Duration  | {duration_str}"
     yield f"User      | {getuser()}"
     yield f"Host      | {gethostname()}"
     version_use = "" if version is None else get_version(version=version)

{dycw_utilities-0.129.6 → dycw_utilities-0.129.8}/src/utilities/whenever.py

@@ -4,7 +4,9 @@ import datetime as dt
 import re
 from contextlib import suppress
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, override
+from functools import cache
+from logging import LogRecord
+from typing import TYPE_CHECKING, Any, override
 
 from whenever import (
     Date,
@@ -33,6 +35,8 @@ from utilities.re import (
 from utilities.zoneinfo import UTC, ensure_time_zone, get_time_zone_name
 
 if TYPE_CHECKING:
+    from zoneinfo import ZoneInfo
+
     from utilities.types import (
         DateLike,
         DateTimeLike,
@@ -561,6 +565,64 @@ class SerializeZonedDateTimeError(Exception):
 ##
 
 
+class WheneverLogRecord(LogRecord):
+    """Log record powered by `whenever`."""
+
+    zoned_datetime: str
+
+    @override
+    def __init__(
+        self,
+        name: str,
+        level: int,
+        pathname: str,
+        lineno: int,
+        msg: object,
+        args: Any,
+        exc_info: Any,
+        func: str | None = None,
+        sinfo: str | None = None,
+    ) -> None:
+        super().__init__(
+            name, level, pathname, lineno, msg, args, exc_info, func, sinfo
+        )
+        length = self._get_length()
+        plain = format(self._get_now().to_plain().format_common_iso(), f"{length}s")
+        time_zone = self._get_time_zone_key()
+        self.zoned_datetime = f"{plain}[{time_zone}]"
+
+    @classmethod
+    @cache
+    def _get_time_zone(cls) -> ZoneInfo:
+        """Get the local timezone."""
+        try:
+            from utilities.tzlocal import get_local_time_zone
+        except ModuleNotFoundError:  # pragma: no cover
+            return UTC
+        return get_local_time_zone()
+
+    @classmethod
+    @cache
+    def _get_time_zone_key(cls) -> str:
+        """Get the local timezone as a string."""
+        return cls._get_time_zone().key
+
+    @classmethod
+    @cache
+    def _get_length(cls) -> int:
+        """Get maximum length of a formatted string."""
+        now = cls._get_now().replace(nanosecond=1000).to_plain()
+        return len(now.format_common_iso())
+
+    @classmethod
+    def _get_now(cls) -> ZonedDateTime:
+        """Get the current zoned datetime."""
+        return ZonedDateTime.now(cls._get_time_zone().key)
+
+
+##
+
+
 def _to_datetime_delta(timedelta: dt.timedelta, /) -> DateTimeDelta:
     """Serialize a timedelta."""
     total_microseconds = datetime_duration_to_microseconds(timedelta)
@@ -610,6 +672,7 @@ __all__ = [
     "SerializePlainDateTimeError",
     "SerializeTimeDeltaError",
     "SerializeZonedDateTimeError",
+    "WheneverLogRecord",
     "check_valid_zoned_datetime",
     "ensure_date",
     "ensure_datetime",