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()