excalibur-py 0.1.1

A web interface for Camelot (PDF Table Extraction for Humans).

Excalibur: A web interface for Camelot

(PDF Table Extraction for Humans)

Excalibur is a web interface to extract data tables from PDFs, written in Python 3! It is powered by Camelot.

Note: Excalibur only works with text-based PDFs and not scanned documents. (As Tabula explains, "If you can click and drag to select text in your table in a PDF viewer, then your PDF is text-based".)

Using Excalibur

After installation with pip, you can start the webserver using:

$ excalibur webserver

That's it! Now you can go to http://localhost:5000 and extract data tables from your PDFs using the web interface! Check out the usage section of the documentation for step-by-step instructions.

Note: You can also download executables for Windows and Linux from the releases page!

Why Excalibur?

• Excalibur gives you complete control over your data. All file storage and processing happens on your own local or remote machine.
• Table extraction rules can be saved as presets which can then be applied on different PDFs to extract tables with similar structures. (in v0.2.0)
• Extract tables from multiple PDFs in one go using an extraction rule, by starting jobs. (in v0.2.0)
• Excalibur can be configured with MySQL and Celery for parallel and distributed workloads. (in v0.2.0) By default, sqlite and multiprocessing are used for sequential workloads.
• Job scheduling and incoming/outgoing webhooks. (in v0.3.0)

Excalibur uses Camelot under the hood. You can check out its comparison with other PDF table extraction libraries and tools.

Support us on Patreon

If Excalibur solves your PDF table extraction needs, please consider supporting its development by becoming a patron!

Installation

Using pip

After installing the dependencies for Camelot (tk and ghostscript), you can simply use pip to install Excalibur:

$ pip install excalibur-py

From the source code

After installing the dependencies for Camelot, clone the repo using:

$ git clone https://www.github.com/camelot-dev/excalibur

and install Excalibur using pip:

$ cd excalibur
$ pip install .

Documentation

Great documentation is available at http://excalibur-py.readthedocs.io/.

Development

The Contributor's Guide has detailed information about contributing code, documentation, tests and more. We've included some basic information in this README.

Source code

You can check the latest sources with:

$ git clone https://www.github.com/camelot-dev/excalibur

Setting up a development environment

You can install the development dependencies easily, using pip:

$ pip install excalibur-py[dev]

Testing (soon)

After installation, you can run tests using:

$ python setup.py test

Versioning

Camelot uses Semantic Versioning. For the available versions, see the tags on this repository. For the changelog, you can check out HISTORY.md.

License

This project is licensed under the MIT License, see the LICENSE file for details.