mirror of
https://github.com/Garmelon/PFERD.git
synced 2023-12-21 10:23:01 +01:00
81 lines
2.5 KiB
Python
81 lines
2.5 KiB
Python
"""Helper functions and classes for temporary folders."""
|
|
|
|
import logging
|
|
import shutil
|
|
from pathlib import Path
|
|
from types import TracebackType
|
|
from typing import Optional, Type
|
|
|
|
from .utils import resolve_path
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
class TmpDir():
|
|
"""A temporary folder that can create files or nested temp folders."""
|
|
|
|
def __init__(self, path: Path):
|
|
"""Create a new temporary folder for the given path."""
|
|
self._counter = 0
|
|
self._path = path
|
|
self._path.mkdir(parents=True, exist_ok=True)
|
|
|
|
def __str__(self) -> str:
|
|
"""Format the folder as a string."""
|
|
return f"Folder at {self.path}"
|
|
|
|
def __enter__(self) -> 'TmpDir':
|
|
"""Context manager entry function."""
|
|
return self
|
|
|
|
def __exit__(self,
|
|
type: Optional[Type[BaseException]],
|
|
value: Optional[BaseException],
|
|
traceback: Optional[TracebackType]) -> Optional[bool]:
|
|
"""Context manager exit function. Calls cleanup()."""
|
|
self.cleanup()
|
|
return None
|
|
|
|
@property
|
|
def path(self) -> Path:
|
|
"""Return the path of this folder."""
|
|
return self._path
|
|
|
|
def resolve(self, target_file: Path) -> Path:
|
|
"""Resolve a file relative to this folder.
|
|
|
|
Raises a [ResolveException] if the path is outside the folder.
|
|
"""
|
|
return resolve_path(self.path, target_file)
|
|
|
|
def new_file(self, prefix: Optional[str] = None) -> Path:
|
|
"""Return a unique path inside the folder, but don't create a file."""
|
|
name = f"{prefix if prefix else 'tmp'}-{self._inc_and_get_counter():03}"
|
|
|
|
logger.debug(f"Creating temp file '{name}'")
|
|
|
|
return self.resolve(Path(name))
|
|
|
|
def new_folder(self, prefix: Optional[str] = None) -> 'TmpDir':
|
|
"""Create a new nested temporary folder and return its path."""
|
|
name = f"{prefix if prefix else 'tmp'}-{self._inc_and_get_counter():03}"
|
|
|
|
sub_path = self.resolve(Path(name))
|
|
sub_path.mkdir(parents=True)
|
|
|
|
logger.debug(f"Creating temp dir '{name}' at {sub_path}")
|
|
|
|
return TmpDir(sub_path)
|
|
|
|
def cleanup(self) -> None:
|
|
"""Delete this folder and all contained files."""
|
|
logger.debug(f"Deleting temp folder {self.path}")
|
|
|
|
shutil.rmtree(self.path.resolve())
|
|
|
|
def _inc_and_get_counter(self) -> int:
|
|
"""Get and increment the counter by one."""
|
|
counter = self._counter
|
|
self._counter += 1
|
|
return counter
|