lintel-schema-cache

Disk-backed cache for JSON Schema files. Fetches schemas over HTTP and stores them locally for fast subsequent lookups.

Features

• Transparent caching — schemas are stored as <cache_dir>/<hash>.json where <hash> is a deterministic hash of the URI
• Pluggable HTTP — bring your own HTTP client via the HttpClient trait, or use the built-in UreqClient
• jsonschema integration — implements both jsonschema::Retrieve and jsonschema::AsyncRetrieve for seamless use as a schema resolver

Usage

use lintel_schema_cache::{SchemaCache, UreqClient, default_cache_dir};

let cache = SchemaCache::new(Some(default_cache_dir()), UreqClient);
let (schema, status) = cache.fetch("https://json.schemastore.org/tsconfig.json")?;
// status: Hit (from disk), Miss (fetched and cached), or Disabled (no cache dir)

Custom HTTP Client

use lintel_schema_cache::{SchemaCache, HttpClient};

#[derive(Clone)]
struct MyClient;

impl HttpClient for MyClient {
    fn get(&self, uri: &str) -> Result<String, Box<dyn std::error::Error + Send + Sync>> {
        // your HTTP implementation
        todo!()
    }
}

let cache = SchemaCache::new(None, MyClient);