camelot-py/camelot/parsers
Jose Vargas 52adbbd796 [parsers.stream] - Use fall back column coordinates.
The Stream class would raise an IndexError when the 'columns' argument was specified
and the number of tables identified was larger than the number of items in the
'columns' argument.

This IndexError makes extracting tables from a PDF comprised mainly of known,
consistent table structures of interest to the caller, but that may be variable in
height, starting position, or number, rather cumbersome with the Stream parser.
This is especially true within an automated or programmatic context.
Either the caller must call 'camelot.read_pdf' once per page, or
manipulate the 'columns' argument so as to avoid the IndexError. The former
isn't guaranteed to work, as a single page can contain multiple tables,
and therefore, in such a situation, the caller must resort to the latter even if
extracting tables from a single page.

The Stream class continues to function exactly the same when the 'table_areas'
argument is provided; this commit only changes the behavior of the Stream parser
when 'table_areas' is not provided.

This commit allows all tables to be easily extracted by specifying 'pages=all'
and providing the appropriate 'columns' argument value to
'camelot.read_pdf'.

Extracting all tables from such a PDF is already possible with the
Lattice parser, this commit makes this possible with the Stream
parser as well.

Callers are responsible for filtering out any extraneous tables.
2020-01-31 20:29:26 -05:00
..
__init__.py [MRG + 1] Make pep8 (#125) 2018-10-05 16:55:43 +05:30
base.py Blacken code 2019-07-03 23:47:42 +05:30
lattice.py Blacken code 2019-07-03 23:47:42 +05:30
stream.py [parsers.stream] - Use fall back column coordinates. 2020-01-31 20:29:26 -05:00