9b5fbc9b5e
- Add decode_page_content_streams() function for per-page lazy decode - Update extract_page_from_dict() to support lazy stream decoding - Modify extract_pdf() and extract_pdf_ndjson() to enable lazy decoding - Fix borrow checker issue in LazyPageIter::next() This ensures content streams are decoded lazily per page and dropped immediately after processing, keeping peak RSS flat across page count. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
32 lines
1.3 KiB
Markdown
32 lines
1.3 KiB
Markdown
# ADR-001: MPL-2.0 License Exception for cbindgen
|
|
|
|
## Status
|
|
Accepted
|
|
|
|
## Context
|
|
pdftract-libpdftract uses cbindgen (v0.27) as a build dependency to generate C header
|
|
files for the C FFI library. cbindgen is licensed under MPL-2.0, which is a copyleft
|
|
license not in the default allow list.
|
|
|
|
## Decision
|
|
MPL-2.0 is explicitly allowed for cbindgen as a build-only dependency.
|
|
|
|
## Rationale
|
|
- cbindgen is a **build dependency only** - it is not linked into the final binary
|
|
- Build dependencies are compiled and executed during the build process, then discarded
|
|
- The MPL-2.0 copyleft terms do not apply to the final pdftract binary or library
|
|
- No viable alternative exists for generating C headers from Rust source
|
|
- cbindgen is the de-facto standard tool for Rust C FFI (used by Firefox, Servo, etc.)
|
|
|
|
## Alternatives Considered
|
|
- **Manual header maintenance**: Impractical - would diverge from actual FFI signatures
|
|
- **Other code generators**: None support Rust's type system adequately for FFI
|
|
|
|
## Consequences
|
|
- pdftract can use cbindgen for C FFI without violating license policy
|
|
- The MPL-2.0 license does not affect downstream users of pdftract
|
|
- This exception applies to cbindgen as a build dependency only
|
|
|
|
## References
|
|
- cbindgen repository: https://github.com/mozilla/cbindgen
|
|
- MPL-2.0 license: https://www.mozilla.org/en-US/MPL/2.0/
|