documentation_cache

function of dascore.utils.doc_cache

source

documentation_cache(
    rebuild: bool = False,
)

Prepare the local Markdown corpus and yield its absolute path and manifest.

Each source identity has its own corpus under get_config().docs_cache_dir / dascore.__version__. A corpus is built in private staging and published by renaming, so concurrent processes need no lock: a build that fails before publishing leaves the previous corpus in place, and the loser of a simultaneous first build uses the winner’s corpus. Each use refreshes the corpus’s modification time; corpora unused for a day are deleted.