49 lines
1.9 KiB
Python
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
|