Files
MDHelper/mdhelper/project_catalog.py
T

49 lines
1.9 KiB
Python

"""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