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

#143 in Images

Download history 455/week @ 2024-10-27 507/week @ 2024-11-03 516/week @ 2024-11-10 623/week @ 2024-11-17 526/week @ 2024-11-24 582/week @ 2024-12-01 713/week @ 2024-12-08 914/week @ 2024-12-15 420/week @ 2024-12-22 683/week @ 2024-12-29 944/week @ 2025-01-05 699/week @ 2025-01-12 827/week @ 2025-01-19 518/week @ 2025-01-26 777/week @ 2025-02-02 1117/week @ 2025-02-09

3,262 downloads per month
Used in 11 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.3–3.5MB
~74K SLoC