Struct ModelHub 

pub struct ModelHub { /* private fields */ }

Hub per il download e la cache locale dei modelli ONNX.

Tutti i file finiscono in <cache_dir>/<version>/:

• det.onnx — detection model
• rec.onnx — recognition model
• rec_inference.yml — config rec (contiene character_dict inline)
• dict.txt — caratteri estratti dal YML (una riga per char)

Implementations

impl ModelHub

pub fn new(cache_dir: impl Into<PathBuf>) -> Self

Crea un hub con la directory di cache specificata.

pub fn with_default_cache() -> Result<Self, OcrError>

Crea un hub con la directory di cache di default del sistema:

• Windows: %LOCALAPPDATA%\ppocr-rs\models\
• macOS/Linux: $HOME/.cache/ppocr-rs/models/

pub fn ensure(&self, version: PpOcrVersion) -> Result<ModelPaths, OcrError>

Assicura che i modelli per la versione richiesta siano presenti. Scarica da HuggingFace se mancanti (richiede feature fetch-models).

Il download è bloccante — esegui su un thread secondario in GUI o in runtime async.

pub fn cache_dir(&self) -> &Path

Ritorna la directory di cache usata da questo hub.

pub fn ensure_single( &self, model: PpStructureModel, ) -> Result<StructureModelPaths, OcrError>

Scarica (o riusa dalla cache) un singolo modello PP-StructureV3.

Tutti i file finiscono in <cache_dir>/<model.dir_name()>/:

• inference.onnx — sempre presente
• inference.yml — solo se il modello ha vocabolario inline
• dict.txt — estratto dall’yml (per SLANeXt)

Esempio

use ppocr_rs::{ModelHub, PpStructureModel};
let hub = ModelHub::with_default_cache().unwrap();
let paths = hub.ensure_single(PpStructureModel::TableCls).unwrap();
// usa paths.onnx con TableTypeClassifier::from_path(paths.onnx)