mirror of
https://github.com/shadoll/moma.git
synced 2026-08-28 11:33:25 +00:00
sha
8031c97999
This commit introduces a new module `logging_config.py` that implements a singleton pattern for logging configuration. The logger is initialized only once and can be configured based on an environment variable to log to a file or to the console. This centralizes logging setup and ensures consistent logging behavior throughout the application.
92 lines
2.9 KiB
Python
92 lines
2.9 KiB
Python
"""File system information extractor.
|
|
|
|
This module provides the FileInfoExtractor class for extracting basic
|
|
file system metadata such as size, timestamps, paths, and extensions.
|
|
"""
|
|
|
|
from pathlib import Path
|
|
import logging
|
|
from ..cache import cached_method, Cache
|
|
from ..logging_config import LoggerConfig # Initialize logging singleton
|
|
|
|
|
|
class FileInfoExtractor:
|
|
"""Extractor for basic file system information.
|
|
|
|
This class extracts file system metadata including size, modification time,
|
|
file name, path, and extension. All extraction methods are cached for
|
|
performance.
|
|
|
|
Attributes:
|
|
file_path: Path object pointing to the file
|
|
_size: Cached file size in bytes
|
|
_modification_time: Cached modification timestamp
|
|
_file_name: Cached file name
|
|
_file_path: Cached full file path as string
|
|
_cache: Internal cache for method results
|
|
|
|
Example:
|
|
>>> from pathlib import Path
|
|
>>> extractor = FileInfoExtractor(Path("movie.mkv"))
|
|
>>> size = extractor.extract_size() # Returns size in bytes
|
|
>>> name = extractor.extract_file_name() # Returns "movie.mkv"
|
|
"""
|
|
|
|
def __init__(self, file_path: Path, use_cache: bool = True):
|
|
"""Initialize the FileInfoExtractor.
|
|
|
|
Args:
|
|
file_path: Path object pointing to the file to extract info from
|
|
use_cache: Whether to use caching (default: True)
|
|
"""
|
|
self._file_path = file_path
|
|
self.file_path = file_path # Expose for cache key generation
|
|
self.cache = Cache() if use_cache else None # Singleton cache for @cached_method decorator
|
|
self.settings = None # Will be set by Settings singleton if needed
|
|
self._stat = file_path.stat()
|
|
self._cache: dict[str, any] = {} # Internal cache for method results
|
|
|
|
@cached_method()
|
|
def extract_size(self) -> int:
|
|
"""Extract file size in bytes.
|
|
|
|
Returns:
|
|
File size in bytes as an integer
|
|
"""
|
|
return self._stat.st_size
|
|
|
|
@cached_method()
|
|
def extract_modification_time(self) -> float:
|
|
"""Extract file modification time.
|
|
|
|
Returns:
|
|
Unix timestamp (seconds since epoch) as a float
|
|
"""
|
|
return self._stat.st_mtime
|
|
|
|
@cached_method()
|
|
def extract_file_name(self) -> str:
|
|
"""Extract file name (basename).
|
|
|
|
Returns:
|
|
File name including extension (e.g., "movie.mkv")
|
|
"""
|
|
return self._file_path.name
|
|
|
|
@cached_method()
|
|
def extract_file_path(self) -> str:
|
|
"""Extract full file path as string.
|
|
|
|
Returns:
|
|
Absolute file path as a string
|
|
"""
|
|
return str(self._file_path)
|
|
|
|
@cached_method()
|
|
def extract_extension(self) -> str:
|
|
"""Extract file extension without the dot.
|
|
|
|
Returns:
|
|
File extension in lowercase without leading dot (e.g., "mkv", "mp4")
|
|
"""
|
|
return self._file_path.suffix.lower().lstrip('.') |