13 releases (6 stable)

1.4.0 Apr 12, 2024
1.3.0 Jan 19, 2024
1.1.0 Nov 4, 2023
1.0.1 Feb 26, 2023
0.1.0 Mar 10, 2021

#77 in Images

Download history 889/week @ 2024-03-13 880/week @ 2024-03-20 835/week @ 2024-03-27 734/week @ 2024-04-03 724/week @ 2024-04-10 670/week @ 2024-04-17 803/week @ 2024-04-24 611/week @ 2024-05-01 894/week @ 2024-05-08 678/week @ 2024-05-15 964/week @ 2024-05-22 596/week @ 2024-05-29 671/week @ 2024-06-05 755/week @ 2024-06-12 868/week @ 2024-06-19 775/week @ 2024-06-26

3,256 downloads per month
Used in 9 crates (via tesseract-plumbing)

MIT license

28KB
560 lines

leptonica-plumbing

Crate to expose a safe version of the leptonica-sys api.

This is designed to expose the C API of leptonica in a safe manner.

Adding value by deviating from the API is a non-goal. That is left to libraries that build on top of leptonica-plumbing.

Motivation

I'm a maintainer of both leptess and tesseract-rs.

I noticed that there was a lot of duplication in how they interact with both leptonica-sys and tesseract-sys. Having multiple layers of abstraction in leptess and tesseract-rs made it hard to reason about their memory safety.

Having a safety layer that stays simple improves the correctness and maintainability of the above libraries.

Testing

To test for memory leaks, test with valgrind.

cargo test --release && valgrind --leak-check=yes --error-exitcode=1 --leak-check=full --show-leak-kinds=all "$(find target/*/deps/ -executable -name 'leptonica_plumbing-*')"

You may find that leptonica always leaks 16B of memory.

To test with a manually compiled Leptonica, test with additional environment variables

LD_LIBRARY_PATH="$(pwd)/../../DanBloomberg/leptonica/local/lib" PKG_CONFIG_PATH="$(pwd)/../../DanBloomberg/leptonica/local/lib/pkgconfig" cargo test

The two can be combined

LD_LIBRARY_PATH="$(pwd)/../../DanBloomberg/leptonica/local/lib" PKG_CONFIG_PATH="$(pwd)/../../DanBloomberg/leptonica/local/lib/pkgconfig" bash -c 'cargo test --release && valgrind --leak-check=yes --error-exitcode=1 --leak-check=full --show-leak-kinds=all "$(find target/*/deps/ -executable -name 'leptonica_plumbing-*')"'

Dependencies

~1.2–3MB
~70K SLoC