m/market labResearch, with a record.
Source on GitHub ↗

context.py

1"""One Platform for a CLI invocation; handlers borrow it without closing it."""23from __future__ import annotations45from contextlib import contextmanager6from pathlib import Path7from typing import Iterator, Optional, Union89from sim_platform.application.platform import Platform10from sim_platform.application.lifecycle import PlatformLifecycle11from sim_platform.domain.models import ContractError12from sim_platform.persistence.paths import data_directory131415class CliContext:16    """The data directory and the one Platform of a CLI invocation.1718    main() creates it per invocation; handlers borrow the Platform from19    open_platform() without closing it, and close() closes it at the end.20    """2122    def __init__(self, data_dir: Optional[Path] = None) -> None:23        self.data_dir = data_dir24        self._lifecycle: Optional[PlatformLifecycle] = None25        self._closed = False26        self._selected_directory: Optional[Path] = None2728    def resolve_directory(self) -> Path:29        """The --data-dir override, or the OS application data directory."""30        directory = self.data_dir if self.data_dir is not None else data_directory()31        if not directory.is_absolute():32            raise ContractError('data directory must be absolute')33        return directory3435    def select_directory(self, directory: Union[str, Path]) -> None:36        """Select temporary comparison storage before acquiring this invocation's Platform."""37        if self._closed or self._lifecycle is not None:38            raise ContractError('cannot change storage after platform acquisition')39        directory = Path(directory)40        if not directory.is_absolute():41            raise ContractError('data directory must be absolute')42        self._selected_directory = directory4344    @contextmanager45    def open_platform(self, *, database: bool = True) -> Iterator[Platform]:46        if self._closed:47            raise ContractError('CLI context is closed')48        if self._lifecycle is None:49            directory = self._selected_directory or self.resolve_directory()50            self._lifecycle = PlatformLifecycle(directory, factory=Platform)51        yield self._lifecycle.open(database=database)5253    def close(self) -> None:54        if not self._closed:55            self._closed = True56            if self._lifecycle is not None:57                self._lifecycle.close()5859    def __enter__(self) -> CliContext:60        if self._closed:61            raise ContractError('CLI context is closed')62        return self6364    def __exit__(self, *_: object) -> None:65        self.close()