Unit Testing per Tesseract

Requisiti

File e struttura

├── langdata_lstm
│   ├── common.punc
│   ├── common.unicharambigs
│   ├── desired_bigrams.txt
│   ├── eng
│   │   ├── desired_characters
│   │   ├── eng.config
│   │   ├── eng.numbers
│   │   ├── eng.punc
│   │   ├── eng.singles_text
│   │   ├── eng.training_text
│   │   ├── eng.unicharambigs
│   │   ├── eng.wordlist
│   │   └── okfonts.txt
│   ├── extended
│   │   └── extended.config
│   ├── extendedhin
│   │   └── extendedhin.config
│   ├── font_properties
│   ├── forbidden_characters_default
│   ├── hin
│   │   ├── hin.config
│   │   ├── hin.numbers
│   │   ├── hin.punc
│   │   └── hin.wordlist
│   ├── kan
│   │   └── kan.config
│   ├── kor
│   │   └── kor.config
│   ├── osd
│   │   └── osd.unicharset
│   └── radical-stroke.txt
├── tessdata
│   ├── ara.traineddata
│   ├── chi_tra.traineddata
│   ├── eng.traineddata
│   ├── heb.traineddata
│   ├── hin.traineddata
│   ├── jpn.traineddata
│   ├── kmr.traineddata
│   ├── osd.traineddata
│   └── vie.traineddata
├── tessdata_best
│   ├── eng.traineddata
│   ├── fra.traineddata
│   ├── kmr.traineddata
│   └── osd.traineddata
├── tessdata_fast
│   ├── eng.traineddata
│   ├── kmr.traineddata
│   ├── osd.traineddata
│   └── script
│       └── Latin.traineddata
└── tesseract
    ...
    ├── test
    ├── unittest
    │   └── third_party/googletest
    └── VERSION

Font

• Font Microsoft: arialbi.ttf, times.ttf, verdana.ttf - guida all'installazione
• ae_Arab.ttf
• dejavu-fonts: DejaVuSans-ExtraLight.ttf
• Lohit-Hindi.ttf
• UnBatang.ttf

Eseguire i test

CMake

Per impostazione predefinita, CMake utilizza il sottomodulo unittest/third_party/googletest:

git submodule update --init unittest/third_party/googletest
cmake -S . -B build -DBUILD_TESTS=ON
cmake --build build
ctest --test-dir build --output-on-failure

Per utilizzare invece un pacchetto GoogleTest installato, installa sia GoogleTest che GoogleMock (ad esempio, libgtest-dev e libgmock-dev su Debian/Ubuntu) e configura con -DUSE_SYSTEM_GTEST=ON:

cmake -S . -B build -DBUILD_TESTS=ON -DUSE_SYSTEM_GTEST=ON

Se il pacchetto è installato al di fuori dei percorsi di ricerca standard, aggiungi il suo prefisso a CMAKE_PREFIX_PATH, oppure imposta GTest_DIR sulla directory che contiene GTestConfig.cmake. Il pacchetto installato deve fornire i target GTest::gtest_main e GTest::gmock. Con CMake 3.22, usa un pacchetto che fornisca GTestConfig.cmake; il rilevamento di GoogleMock basato sui moduli di CMake richiede la versione 3.23 o successiva.

Questo sostituisce solo il framework di testing, non i dati di test, i modelli linguistici, o i font elencati sopra. Quei file sono ancora richiesti dai test pertinenti. Quando i test sono richiesti ma il framework selezionato non è disponibile, la configurazione fallisce anziché omettere silenziosamente i test.

Autotools

Per eseguire i test, procedi come segue nella cartella tesseract

autoreconf -fiv
git submodule update --init
git clone https://github.com/egorpugin/tessdata tessdata_unittest --depth 1
cp tessdata_unittest/fonts/* test/testing/
mv tessdata_unittest/* ../
export TESSDATA_PREFIX=/prefix/to/path/to/tessdata
make check