geometor.euclid.folio_review

Euclid folio review Flask application.

Submodules

Classes

FolioScanner

Scans and indexes folios from resources/heath/.

ReviewManager

Manages reading and writing vetting / review records for folios.

Functions

create_app(→ flask.Flask)

Create and configure the Flask application.

main()

Run review application CLI entrypoint.

Package Contents

geometor.euclid.folio_review.create_app(heath_dir: pathlib.Path | None = None, reviews_path: pathlib.Path | None = None) → flask.Flask

Create and configure the Flask application.

geometor.euclid.folio_review.main()

Run review application CLI entrypoint.

class geometor.euclid.folio_review.FolioScanner(root_dir: pathlib.Path | None = None)

Scans and indexes folios from resources/heath/.

refresh(force: bool = False) → None

Refresh index from disk if TTL expired or forced.

get_stats() → Dict[str, Any]

Return aggregate statistics across all volumes.

get_volumes() → List[Dict[str, Any]]

Return list of volumes.

get_sections(volume_id: str | None = None) → List[str]

Return list of section relative paths.

get_folios(volume_id: str | None = None, section: str | None = None, filter_status: str | None = None, search_query: str | None = None) → List[Dict[str, Any]]

Filter folios by volume, section, status, or search query.

get_folio(volume_id: str, folio_id: str) → Dict[str, Any] | None

Retrieve full details of a specific folio.

get_adjacent_folios(volume_id: str, folio_id: str, section: str | None = None) → Tuple[Dict[str, Any] | None, Dict[str, Any] | None]

Return (previous_folio, next_folio) within volume or section.

class geometor.euclid.folio_review.ReviewManager(storage_path: pathlib.Path | None = None)

Manages reading and writing vetting / review records for folios.

get_review(volume: str, folio: str) → Dict[str, Any]

Get review record for a specific folio, returning default if unreviewed.

set_review(volume: str, folio: str, status: str, checklist: Dict[str, bool] | None = None, notes: str = '', reviewer: str | None = 'phi') → Dict[str, Any]

Save or update review record for a specific folio.

get_all_reviews() → Dict[str, Dict[str, Any]]

Return all stored reviews.

get_review_stats() → Dict[str, int]

Return count breakdown of review statuses.