jedarden f26f9e3c0f feat(pdftract-uyhq7): scaffold libpdftract cdylib+staticlib crate

Add pdftract-libpdftract as 4th workspace member with dual crate-type
configuration (cdylib + staticlib) for C/C++ SDK flexibility.

Changes:
- Create crates/pdftract-libpdftract/Cargo.toml with cdylib+staticlib
- Create crates/pdftract-libpdftract/src/lib.rs scaffold
- Update root Cargo.toml workspace.members
- Configure [lib] name="pdftract" for correct artifact naming

Artifacts produced:
- target/debug/libpdftract.so (shared, cdylib)
- target/debug/libpdftract.a (static, staticlib)

Acceptance criteria:
- PASS: cargo build -p pdftract-libpdftract produces libpdftract.so/.a
- PASS: Workspace cargo build builds all 4 crates without regression
- PASS: cargo metadata shows pdftract-libpdftract in workspace members
- PASS: nm -D shows no exported symbols (empty API scaffold)

References: pdftract-uyhq7, Phase SDK epic

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-23 07:29:47 -04:00

2.6 KiB

Raw Blame History

pdftract-uyhq7: libpdftract cdylib + staticlib crate scaffold

Summary

Created the pdftract-libpdftract crate as the fourth workspace member of the pdftract repo. This crate provides the FFI surface for C/C++ integrations, compiling to both shared (cdylib) and static (staticlib) libraries.

Files Created

crates/pdftract-libpdftract/Cargo.toml - Crate manifest with:
- crate-type = ["cdylib", "staticlib"]
- name = "pdftract" in [lib] section (ensures libpdftract.so/.a naming)
- Dependencies: pdftract-core, serde_json, libc
- Build dependency: cbindgen 0.27
crates/pdftract-libpdftract/src/lib.rs - Empty scaffold with documentation
Updated Cargo.toml - Added crates/pdftract-libpdftract to workspace.members

Verification Results

PASS: cargo build -p pdftract-libpdftract produces expected artifacts

$ ls -la target/debug/libpdftract.a target/debug/libpdftract.so
-rw-r--r-- 2 coding users 21848552 May 23 07:28 target/debug/libpdftract.a
-rwxr-xr-x 2 coding users  4293504 May 23 07:28 target/debug/libpdftract.so

libpdftract.so (4.3 MB) - shared library (cdylib)
libpdftract.a (21.8 MB) - static library (staticlib)
readelf -h confirms ELF64 shared library format

PASS: Workspace cargo build builds all 4 crates

$ cargo build --workspace
   Compiling pdftract-core v0.1.0
   Compiling pdftract-cli v0.1.0
   Compiling pdftract-py v0.1.0
   Compiling pdftract-libpdftract v0.1.0
   Finished `dev` profile [unoptimized + debuginfo] target(s) in 22.87s

All existing crates build successfully; no regressions.

PASS: cargo metadata shows pdftract-libpdftract in workspace

$ cargo metadata --format-version 1 | python3 -c "import json,sys; w=json.load(sys.stdin); print(len(w['workspace_members']))"
4

Workspace members: pdftract-core, pdftract-cli, pdftract-py, pdftract-libpdftract

PASS: Symbol table shows no exported symbols (expected for empty API)

$ nm -D target/debug/libpdftract.so | grep -E "^[0-9a-f]+ [TW]"
# (no output - no exported text symbols)

This is expected as the acceptance criteria states: "the API is empty in this bead; sibling bead populates"

Artifact Naming Convention

The crate name pdftract-libpdftract produces artifacts named libpdftract.so/.a (not libpdftract-libpdftract) due to the [lib] name = "pdftract" directive in Cargo.toml. This matches the expected naming convention for the C/C++ SDK.

Next Steps

Sibling bead will populate the extern "C" API surface
cbindgen will be configured to generate pdftract.h header
pkg-config file will be added for downstream integrations

2.6 KiB Raw Blame History