Metadata-Version: 2.1
Name: tabula-py
Version: 2.0.0
Summary: Simple wrapper for tabula-java, read tables from PDF into DataFrame
Home-page: https://github.com/chezou/tabula-py
Author: Aki Ariga
Author-email: chezou@gmail.com
Maintainer: Aki Ariga
Maintainer-email: chezou@gmail.com
License: MIT License
Description: # tabula-py
        
        [![Build Status](https://travis-ci.org/chezou/tabula-py.svg?branch=master)](https://travis-ci.org/chezou/tabula-py)
        [![PyPI version](https://badge.fury.io/py/tabula-py.svg)](https://badge.fury.io/py/tabula-py)
        [![Documentation Status](https://readthedocs.org/projects/tabula-py/badge/?version=latest)](https://tabula-py.readthedocs.io/en/latest/?badge=latest)
        [![Patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://www.patreon.com/chezou)
        
        
        `tabula-py` is a simple Python wrapper of [tabula-java](https://github.com/tabulapdf/tabula-java), which can read table of PDF.
        You can read tables from PDF and convert into pandas's DataFrame. tabula-py also enables you to convert a PDF file into CSV/TSV/JSON file.
        
        You can see [the example notebook](https://nbviewer.jupyter.org/github/chezou/tabula-py/blob/master/examples/tabula_example.ipynb) and try it on Google Colab, or we highly recommend to read [our document](https://tabula-py.readthedocs.io/en/latest/) especially for FAQ.
        
        ![](./example.png)
        
        
        # Requirements
        
        - Java 8+
        - Python 3.5+
        
        ## OS
        
        I confirmed working on macOS and Ubuntu. But some people confirm it works on Windows 10. See also [the document for the detailed installation for Windows 10](https://tabula-py.readthedocs.io/en/latest/getting_started.html#get-tabula-py-working-windows-10).
        
        # Usage
        
        - [Documentation](https://tabula-py.readthedocs.io/en/latest/)
          - [FAQ](https://tabula-py.readthedocs.io/en/latest/faq.html) would be helpful if you have issue
        - [Example notebook on Google Colaboratory](https://colab.research.google.com/github/chezou/tabula-py/blob/master/examples/tabula_example.ipynb)
        
        ## Install
        
        Ensure you have Java runtime and set PATH for it.
        
        ```bash
        pip install tabula-py
        ```
        
        ## Example
        
        tabula-py enables you to extract table from PDF into DataFrame and JSON. It also can extract tables from PDF and save file as CSV, TSV or JSON.
        
        ```py
        import tabula
        
        # Read pdf into list of DataFrame
        df = tabula.read_pdf("test.pdf", pages='all')
        
        # Read remote pdf into list of DataFrame
        df2 = tabula.read_pdf("https://github.com/tabulapdf/tabula-java/raw/master/src/test/resources/technology/tabula/arabic.pdf")
        
        # convert PDF into CSV file
        tabula.convert_into("test.pdf", "output.csv", output_format="csv", pages='all')
        
        # convert all PDFs in a directory
        tabula.convert_into_by_batch("input_directory", output_format='csv', pages='all)
        ```
        
        See [example notebook](./examples/tabula_example.ipynb) for more detail. I also recommend to read [the tutorial article](https://aegis4048.github.io/parse-pdf-files-while-retaining-structure-with-tabula-py) written by [@aegis4048](https://github.com/aegis4048).
        
        
        ## Contributing
        
        Interested in helping out? I'd love to have your help!
        
        You can help by:
        
        - [Reporting a bug](https://github.com/tabulapdf/tabula-py/issues).
        - Adding or editing documentation.
        - Contributing code via a Pull Request. See also [for the contribution](docs/contributing.rst)
        - Write a blog post or spreading the word about `tabula-py` to people who might be able to benefit from using it.
        
        
        ### Contributors
        
        - [@lahoffm](https://github.com/lahoffm)
        - [@jakekara](https://github.com/jakekara)
        - [@lcd1232](https://github.com/lcd1232)
        - [@kirkholloway](https://github.com/kirkholloway)
        - [@CurtLH](https://github.com/CurtLH)
        - [@nikhilgk](https://github.com/nikhilgk)
        - [@krassowski](https://github.com/krassowski)
        - [@alexandreio](https://github.com/alexandreio)
        - [@rmnevesLH](https://github.com/rmnevesLH)
        - [@red-bin](https://github.com/red-bin)
        - [@Gallaecio](https://github.com/Gallaecio)
        - [@red-bin](https://github.com/red-bin)
        - [@alexandreio](https://github.com/alexandreio)
        - [@bpben](https://github.com/bpben)
        
        ### Another support
        
        You can also support our continued work on `tabula-py` with a donation [on Patreon](https://www.patreon.com/chezou).
        
Keywords: data frame,pdf,table
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Text Processing :: General
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.5
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: test
Provides-Extra: doc
