pdfplumber-rs

High-performance PDF text, table, and geometry extraction for Python — powered by Rust.

pdfplumber-rs is a Rust-native reimplementation of pdfplumber exposed to Python via PyO3. The Rust extension is installed as the private pdfplumber._native submodule so the public package can provide a Python compatibility layer separately.

Installation

pip install pdfplumber-rs

Quick Start

import pdfplumber

# Open a PDF
pdf = pdfplumber.open("document.pdf")

# Access pages
for page in pdf.pages:
    # Extract text
    text = page.extract_text()
    print(text)

    # Extract words with bounding boxes
    words = page.extract_words()
    for w in words:
        print(f"{w['text']} at ({w['x0']}, {w['top']}, {w['x1']}, {w['bottom']})")

    # Extract tables
    tables = page.find_tables()
    for table in tables:
        rows = table.extract()
        for row in rows:
            print(row)

# Open from bytes
from pdfplumber import _native

with open("document.pdf", "rb") as f:
    pdf = _native.PDF.open_bytes(f.read())

The top-level pdfplumber.open alias is available for filesystem paths. Other compatibility-facade work remains in progress; use the private extension explicitly for the native-only API shown above.

Passing laparams={} to pdfplumber.open enables native horizontal layout analysis. The resulting textboxhorizontal and textlinehorizontal lists participate in the same page/document object caches and serialization as ordinary objects, and are also available through .textboxhorizontals and .textlinehorizontals. Horizontal grouping honors line_overlap, char_margin, word_margin, and line_margin; vertical layout and embedded-figure hierarchy support remain in progress.

API Reference

PDF

Method / Property	Description
`PDF.open(path)`	Open a PDF file from a path
`PDF.open_bytes(data)`	Open a PDF from bytes
`.pages`	List of `Page` objects
`.metadata`	Document metadata dict (title, author, etc.)
`.to_dict(object_types=None)`	Document metadata and selected-page dictionaries
`.to_json(...)`	JSON string or text-stream serialization of `.to_dict()`
`.to_csv(...)`	CSV string or text-stream serialization of selected page objects
`.textboxhorizontals` / `.textlinehorizontals`	Aggregated horizontal layout objects when `laparams` is supplied
`.rust`	Explicit namespace for Rust-native document extensions

Page

Method / Property	Description
`.page_number`	1-based compatibility page number
`.width` / `.height`	Page dimensions in points
`.rotation`	Inherited page rotation, normalized to 0 through 359 degrees
`.bbox`	Original-page bounding box in rotation-aware, top-origin coordinates
`.mediabox`	Rotation-aware MediaBox in top-origin page coordinates
`.cropbox`	Inherited rotation-aware CropBox, falling back to MediaBox
`.trimbox`	Direct rotation-aware TrimBox when present; absent otherwise
`.bleedbox`	Direct rotation-aware BleedBox when present; absent otherwise
`.artbox`	Direct rotation-aware ArtBox when present; absent otherwise
`.initial_doctop`	Cumulative height of preceding pages in the current page view
`.point2coord(pt)`	Convert a PDF-space point to top-origin page coordinates
`repr(page)`	Return `<Page:N>` using the 1-based document page number
`.objects`	Cached mutable dictionary of present page objects keyed by type
`.textboxhorizontals` / `.textlinehorizontals`	Cached horizontal layout objects when `laparams` is supplied
`.flush_cache(properties=None)`	Discard all or selected cached page properties
`.close()`	Discard this original or derived page's cached objects
`.to_dict(object_types=None)`	Page geometry and requested object dictionaries
`.to_json(...)`	JSON string or text-stream serialization of `.to_dict()`
`.to_csv(...)`	CSV string or text-stream serialization of page objects
`.extract_text(layout=False)`	Extract all text
`.extract_words(x_tolerance=3.0, y_tolerance=3.0)`	Extract words with bounding boxes, width, height, and doctop
`.chars`	Character-level data with font info and complete bounding-box geometry
`.find_tables()`	Detect tables, returns `Table` objects
`.extract_tables()`	Extract all table content
`.lines` / `.rects` / `.curves` / `.images`	Geometric objects with top- and bottom-origin coordinates
`.crop(bbox)`	Crop to region `(x0, top, x1, bottom)`
`.within_bbox(bbox)` / `.outside_bbox(bbox)`	Spatial filtering
`.search(pattern, regex=True, case=True)`	Search for text

Table

Method / Property	Description
`.bbox`	Bounding box as `(x0, top, x1, bottom)`
`.rows`	Cell data organized by row
`.accuracy`	Fraction of non-empty cells
`.extract()`	Table content as `list[list[str \| None]]`

CroppedPage

Supports the same content surface as Page: chars, lines, rects, curves, images, extract_text(), extract_words(), find_tables(), extract_tables(), and point2coord(), plus further crop(), within_bbox(), and outside_bbox().

Rust-Native Extensions

Python pdfplumber v0.11.10 does not define high-level document APIs for bookmarks, forms, signatures, structural validation, or image-byte extraction. pdfplumber-rs exposes these only through document.rust, so they cannot be mistaken for compatibility behavior or silently collide with future upstream methods. Page indexes and bookmark destinations in this namespace retain the Rust API's 0-based convention.

Method	Description
`document.rust.bookmarks()`	Outline entries and 0-based destinations
`document.rust.form_fields()`	AcroForm fields and 0-based page indexes
`document.rust.signatures()`	Signature-field metadata; no cryptographic verification
`document.rust.validate()`	Native structural validation issues
`document.rust.extract_images(page_index)`	Image metadata and raw bytes for a 0-based page index

Comparison with Python pdfplumber

Feature	pdfplumber (Python)	pdfplumber-rs
Language	Pure Python	Rust + PyO3
Text extraction	Yes	Yes
Table detection	Yes	Yes
Word extraction	Yes	Yes
Geometry (lines, rects, curves)	Yes	Yes
Spatial filtering (crop, within_bbox)	Yes	Yes
Text search	Yes	Yes
Type stubs	No	Yes (.pyi)

Performance

pdfplumber-rs benefits from Rust's zero-cost abstractions and compiled performance:

Text extraction: Typically 5-20x faster than Python pdfplumber
Table detection: Typically 3-10x faster for lattice-based tables
Memory usage: Lower memory footprint due to Rust's ownership model

Actual speedups depend on document complexity and system configuration.

License

Dual-licensed under MIT or Apache 2.0 at your option.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pdfplumber_rs-0.3.0.tar.gz (935.4 kB view details)

Uploaded Aug 22, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pdfplumber_rs-0.3.0-cp313-cp313-win_amd64.whl (2.2 MB view details)

Uploaded Aug 22, 2026 CPython 3.13Windows x86-64

pdfplumber_rs-0.3.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

pdfplumber_rs-0.3.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

pdfplumber_rs-0.3.0-cp313-cp313-macosx_11_0_arm64.whl (2.3 MB view details)

Uploaded Aug 22, 2026 CPython 3.13macOS 11.0+ ARM64

pdfplumber_rs-0.3.0-cp313-cp313-macosx_10_12_x86_64.whl (2.4 MB view details)

Uploaded Aug 22, 2026 CPython 3.13macOS 10.12+ x86-64

pdfplumber_rs-0.3.0-cp312-cp312-win_amd64.whl (2.2 MB view details)

Uploaded Aug 22, 2026 CPython 3.12Windows x86-64

pdfplumber_rs-0.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

pdfplumber_rs-0.3.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

pdfplumber_rs-0.3.0-cp312-cp312-macosx_11_0_arm64.whl (2.3 MB view details)

Uploaded Aug 22, 2026 CPython 3.12macOS 11.0+ ARM64

pdfplumber_rs-0.3.0-cp312-cp312-macosx_10_12_x86_64.whl (2.4 MB view details)

Uploaded Aug 22, 2026 CPython 3.12macOS 10.12+ x86-64

pdfplumber_rs-0.3.0-cp311-cp311-win_amd64.whl (2.2 MB view details)

Uploaded Aug 22, 2026 CPython 3.11Windows x86-64

pdfplumber_rs-0.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

pdfplumber_rs-0.3.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

pdfplumber_rs-0.3.0-cp311-cp311-macosx_11_0_arm64.whl (2.3 MB view details)

Uploaded Aug 22, 2026 CPython 3.11macOS 11.0+ ARM64

pdfplumber_rs-0.3.0-cp311-cp311-macosx_10_12_x86_64.whl (2.4 MB view details)

Uploaded Aug 22, 2026 CPython 3.11macOS 10.12+ x86-64

pdfplumber_rs-0.3.0-cp310-cp310-win_amd64.whl (2.2 MB view details)

Uploaded Aug 22, 2026 CPython 3.10Windows x86-64

pdfplumber_rs-0.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

pdfplumber_rs-0.3.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64

pdfplumber_rs-0.3.0-cp310-cp310-macosx_11_0_arm64.whl (2.3 MB view details)

Uploaded Aug 22, 2026 CPython 3.10macOS 11.0+ ARM64

pdfplumber_rs-0.3.0-cp310-cp310-macosx_10_12_x86_64.whl (2.4 MB view details)

Uploaded Aug 22, 2026 CPython 3.10macOS 10.12+ x86-64

pdfplumber_rs-0.3.0-cp39-cp39-win_amd64.whl (2.2 MB view details)

Uploaded Aug 22, 2026 CPython 3.9Windows x86-64

pdfplumber_rs-0.3.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64

pdfplumber_rs-0.3.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded Aug 22, 2026 CPython 3.9manylinux: glibc 2.17+ ARM64

pdfplumber_rs-0.3.0-cp39-cp39-macosx_11_0_arm64.whl (2.3 MB view details)

Uploaded Aug 22, 2026 CPython 3.9macOS 11.0+ ARM64

pdfplumber_rs-0.3.0-cp39-cp39-macosx_10_12_x86_64.whl (2.4 MB view details)

Uploaded Aug 22, 2026 CPython 3.9macOS 10.12+ x86-64

File details

Details for the file pdfplumber_rs-0.3.0.tar.gz.

File metadata

Download URL: pdfplumber_rs-0.3.0.tar.gz
Upload date: Aug 22, 2026
Size: 935.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pdfplumber_rs-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`778cc618ac0e157c4c9af192401c770b89c230861c078e1625deee111aac108a`
MD5	`823e46bfc35fecec08493a52957c1f62`
BLAKE2b-256	`eda17275756a67570df9e6fdd7452a3e8fd33a3800eddf8fe17c2801c328a913`

Algorithm	Hash digest
SHA256	`249e9f0265433a2c6de01b87ebdcdd6a620a4d0ec8448bc26e0ee08a819efb10`
MD5	`802c47bd45ab2392c04d524d0a78436f`
BLAKE2b-256	`c67ece5e32ec1a897026948d43c031e821de5d7e1e27a300b606193905745cfb`

Algorithm	Hash digest
SHA256	`46a624f483107ebf43508c20bdb25c9c1df9c83e89711b045d4483c80306c663`
MD5	`ff60a2df5f91023754f69d78acd6bd6f`
BLAKE2b-256	`068b9987b50a36f6b3e0434b87ee2154383cdbcbccf39a1ccd23d6fb8572554f`

Algorithm	Hash digest
SHA256	`26c80d63e20c8136accdc7ee6a814c7aa34f9dbf0c86a341a8397786072bba7b`
MD5	`225d91736486e99aa79190279527edd0`
BLAKE2b-256	`a70ed0f24ac19070e31986c94dca36141d2ddb54706be02b7704a88da5d54fc9`

Algorithm	Hash digest
SHA256	`cfa5cab639b9faa80545db3da66bb5964153639d5dafb719e14866918d71bbe8`
MD5	`fc209d79706e5059e1731b2da6bf031e`
BLAKE2b-256	`edf55eba9968531b562d2b7d88fa09076d6433642792ae163311bd91e50cd8b8`

Algorithm	Hash digest
SHA256	`582a1a26af86a79fd6bb988f81f7852b452aa8dbe182a6e37fadd587004d4689`
MD5	`36583749d9bf8774895830a6149ba02d`
BLAKE2b-256	`9e304765c8f2a3210ab4c9cabb5d1084087641ce81f5019d0273feb521716409`

Algorithm	Hash digest
SHA256	`15c52e74b75176cbadf811e51bd6e1b11e198b3017775a74a4d25c9ae7ab8269`
MD5	`6e782afe99c80d442dff233003824e08`
BLAKE2b-256	`d1216acee72fcd615873d68d21e351fb844ed1b8ab4d6211e715065300123cb2`

Algorithm	Hash digest
SHA256	`5b609b32198ca596a856a3c5b91fd9c72070028bc213ced2f1f6eeace7ca748f`
MD5	`e86c730ebe08e3f9e9579ed65978f6bd`
BLAKE2b-256	`f21623ae9e641c5815ca748547d0b7d6550dd3b7be51f6b93a89bc5e00a57779`

Algorithm	Hash digest
SHA256	`00216d61fb2600e5172521c4aace93a34c7fb8d7ff966241593b7a67a38c0bb4`
MD5	`85475380dfabc2c312c98ddf0f6575a5`
BLAKE2b-256	`1a88d0a3a32973711caa4bd056048909a90089a0091977357e1d929c4714fdc8`

Algorithm	Hash digest
SHA256	`9443564e7ac8a726dae2e4b78bec1b7b835324fdf259b1c980001af6ce4145c3`
MD5	`537ab73153361d20d7e941fc5987a731`
BLAKE2b-256	`76749fba89fcbf807a190890535bc21b578ee5860f7823b7a605e54aa5361df6`

Algorithm	Hash digest
SHA256	`cf3a033c3aeaae7d1b59cc60ee80b32b41a4807239d63f1b9df0a24f21d56856`
MD5	`7f6d82b7555058527f98e3aa3b24b019`
BLAKE2b-256	`d1e0e2e9176ebaeab13fe679ee95403ebe7c52b6eb8d2bbf4174aa949493d498`

Algorithm	Hash digest
SHA256	`7fd2de4c6f0a6dafe430abe6c82912fc74bf2c7579c9b5ba5bcfed45541ac3f1`
MD5	`82b8f7a5f48fb0763330f28928eb264e`
BLAKE2b-256	`fb73d357bac0a82a99d6f9d8187898338a32f7f23f2b06b518a2667208594cc5`

Algorithm	Hash digest
SHA256	`acd1c578586c483678c6547c6a64b7fa89efc116cdf19fbd8be477a6bb0f515a`
MD5	`2986895a133288157c25e2948a3def38`
BLAKE2b-256	`e1a3d05870a0c9aff847e55680755c4b6912cff98c9ed1ad342e42a91d0dd8c3`

Algorithm	Hash digest
SHA256	`b726f3231cb84ac960ddbaf01b288878f647e7eff602c5e7af37fb7c14cc8721`
MD5	`0325f1de85020213a639deb281615227`
BLAKE2b-256	`5d939f451963b5ba2c3a1a9aca4f772a6c1240ffddf3856a2a43946fd2776ec0`

Algorithm	Hash digest
SHA256	`ad4ac3f273f8164b3db61910921dfecd2d881e27f824dfe65c10d624260d279c`
MD5	`1a7f00461a9a68809610c834d2934789`
BLAKE2b-256	`36b205aa00905615d7c841b0219d20edcd3a357b5fabc0cf41434d379faf0430`

Algorithm	Hash digest
SHA256	`b4f028c0e52703464565ad4f7bce6c2a760822bafbea80d6c0be9367dec6bbd4`
MD5	`40db452d50077b810d088834748216f4`
BLAKE2b-256	`937c228d739ef758ec68049dff381d5c7ac6e813e30c4f5929360bfd161dd8bd`

Algorithm	Hash digest
SHA256	`a8bf83ee44cfdf942f206991480c092c9ec9fe33a6b746389628ccb7f56f9d64`
MD5	`78807923655a968934a8845e05a22b63`
BLAKE2b-256	`1b7c42e971bb77f56023d083e59840d7ff964571a549c04058cd93afbbc50804`

Algorithm	Hash digest
SHA256	`121263b3bfd40a83b17b9c33d6f4a8357e1a4c17f0dce1d3fa1dacd06e5301d6`
MD5	`5e59ca7152f777259b8c183ffaa9a9da`
BLAKE2b-256	`971441f57121f9ef3e888e723a7a5b3ad7f9617faf458e81ed6f0f3baac5c59f`

Algorithm	Hash digest
SHA256	`deafee6f6eb7fc63bb8ae7cc5f0bdff1b0951381257ec0ae634353b31a8450af`
MD5	`5972a86623aeed8cd4d3f92235aa60dc`
BLAKE2b-256	`cf9fbf174a96b5253abde3d703a37b31f7ab0010563d1a2047827587047ac0f1`

Algorithm	Hash digest
SHA256	`74d7831a63014125df6e807fcf087323b17e0a686d4eee047feefcd117562e58`
MD5	`cdb0aacf1dd54b4e008ed03f41d1639c`
BLAKE2b-256	`35da1657a62d29d8ef2f56c2cd4c096345f4bed4b9f928f9847d4ed22ebdd81b`

Algorithm	Hash digest
SHA256	`155eaaa13b393dee75125286e9465d8fa2fb84f0d3f9f7e7b7005ab150f4f140`
MD5	`bab6f3193a92794441150939d2d1631a`
BLAKE2b-256	`4011c98aba388625b76d395ceedd553c37b695adc6924b8638887f976f3b51cc`

pdfplumber-rs 0.3.0

pdfplumber-rs

Installation

Quick Start

API Reference

PDF

Page

Table

CroppedPage

Rust-Native Extensions

Comparison with Python pdfplumber

Performance

License

Project links

Key dates

1 maintainer

Credits

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

Algorithm	Hash digest
SHA256	`eda1648e3ce06cc0e3eaf201eac0e55dc3ffaad00f69663cf95f8f4a1c07da43`
MD5	`818c32a04794934d1fd0eb256db3ded7`
BLAKE2b-256	`8fde47b65fb54ef7f5e8286403b65e1af07c337c4d2e6e2ed9f4dc20e41fe5df`

Algorithm	Hash digest
SHA256	`71a744babcc8800f897a77c5e65e8ce3eb1de544ec6b9542312160e410b508b0`
MD5	`6e7f772360e0aa8c9ed14dbfa13a4439`
BLAKE2b-256	`22a60531b8a4c1e1f9be3d2e2857bc214adec27254f58e7fc4f96af947c669cb`

Algorithm	Hash digest
SHA256	`af2d6e671c4623d8eb5c18d3fd0a0bb093ef58cb4d5d4bfba51b934e3d99f74a`
MD5	`421bba162e5a95afe2efff53fe4167fe`
BLAKE2b-256	`df0d51dd0269ff968376301aa2718ffb896e63da91b8a53999f5dfe25a425fc0`

Algorithm	Hash digest
SHA256	`a6d003fed3f6532f6e337eb5fbf312bd0a1728664e8b7a55e66e003c39cf3829`
MD5	`dcc69641ad9a51c8fbaaa874a0eff96b`
BLAKE2b-256	`54fd1f973527a5ce8259d4a0511d985f8d31133a697c5d81e235fc50d15ec456`

Algorithm	Hash digest
SHA256	`84176dab5869a44d0d7cf56501c7e1e91dcb30fbcc3baff48d0fdd09f6ce2b8c`
MD5	`0e331a0ba82d5bb6ec6a09d898d6619c`
BLAKE2b-256	`78b41a5664c7291857bc698365c8b9a1310619baa16eca0a0c7b78746137d154`