"""Project document inventory and its search index, independent of tree widgets.""" from pathlib import Path from .document_tree import DocumentEntry, discover_documents, document_directory_signature, first_heading from .search import SearchIndex class ProjectCatalog: def __init__(self): self.entries: list[DocumentEntry] = [] self.entries_signature = () self.directory_signature = () self.search_index = SearchIndex([]) @staticmethod def signature(entries): return tuple(sorted((str(entry.path), entry.title) for entry in entries)) def adopt(self, entries, directory_signature=()) -> None: self.entries = entries self.entries_signature = self.signature(entries) self.directory_signature = directory_signature self.search_index.rebuild(entries) def scan(self, root, groups, *, force=False, directory_signature=None) -> bool: entries = discover_documents(root, groups) signature = self.signature(entries) self.directory_signature = directory_signature or document_directory_signature(root, groups) if not force and signature == self.entries_signature: return False self.adopt(entries, self.directory_signature) return True def directory_changed(self, root, groups): signature = document_directory_signature(root, groups) return signature if signature != self.directory_signature else None def ensure(self, path: Path, root: Path) -> bool: if any(entry.path == path for entry in self.entries): return False title = first_heading(path) or path.stem.replace('_', ' ').title() try: relative = path.relative_to(root).as_posix() except ValueError: relative = str(path) self.entries.append(DocumentEntry(path=path, title=title, relative_path=relative)) self.adopt(self.entries, self.directory_signature) return True