nab 0.7.1

Token-optimized HTTP client for LLMs — fetches any URL as clean markdown
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//! Stub OCR engine for non-macOS platforms.
//!
//! Returns a human-readable "not available" message. Phase 3 will add
//! `PaddleOCR` and `Tesseract` backends that work cross-platform.

use async_trait::async_trait;

use super::{OcrEngine, OcrError, OcrResult};

// ─── Languages ────────────────────────────────────────────────────────────────

/// Stub supports no languages — callers should check `is_available()` first.
const STUB_LANGUAGES: [&str; 0] = [];

// ─── Stub engine ─────────────────────────────────────────────────────────────

/// Placeholder OCR engine returned on non-macOS platforms.
///
/// Always returns [`OcrError::NotAvailable`] from [`OcrEngine::ocr_image`].
/// Phase 3 will replace this with a real cross-platform implementation.
pub struct StubEngine;

#[async_trait]
impl OcrEngine for StubEngine {
    fn name(&self) -> &'static str {
        "stub"
    }

    fn supported_languages(&self) -> &'static [&'static str] {
        &STUB_LANGUAGES
    }

    fn is_available(&self) -> bool {
        false
    }

    async fn ocr_image(&self, _image_bytes: &[u8]) -> Result<OcrResult, OcrError> {
        Err(OcrError::NotAvailable(
            "stub".to_string(),
            "OCR is not available on this platform. \
             Use `nab models fetch paddle-ocr` in Phase 3 for cross-platform OCR support."
                .to_string(),
        ))
    }
}

// ─── Unit tests ───────────────────────────────────────────────────────────────

#[cfg(test)]
mod tests {
    use super::*;

    /// `StubEngine::name()` returns "stub".
    #[test]
    fn stub_name_is_stub() {
        assert_eq!(StubEngine.name(), "stub");
    }

    /// `StubEngine::is_available()` returns false.
    #[test]
    fn stub_is_not_available() {
        assert!(!StubEngine.is_available());
    }

    /// `StubEngine::supported_languages()` is empty.
    #[test]
    fn stub_supports_no_languages() {
        assert!(StubEngine.supported_languages().is_empty());
    }
}