Add simple wrapper to extract text from pdf

[igormp]

Description

Added a simple wrapper that allows one to easily extract text from a PDF file.

Fixes #327

How Has This Been Tested?

Erh, gotta work on some actual tests for that. Other than that, I've been using this function everywhere in my projects.

Checklist

• I have added tests that prove my fix is effective or that my feature works
• I have updated the README.md and other documentation, or I am sure that this is not necessary
• I have added a concise human-readable description of the change to CHANGELOG.md
• I have added docstrings to newly created methods and classes
• I have optimized the code at least one time after creating the initial version

[pietermarsman]

As I said on gitter: this will be terribly useful!

I'm sure you are planning on adding it, but I noticed that the test is missing.

[pietermarsman]

I've made some small changes.

[igormp]

For some reason I a word in that last commit message lol
I'll squash everything into a single commit before we merge anyway.

About the docstrings, shouldn't we mention the default values, or is the documentation tool we're using able to infer this from the function signature?

Apart from that, I think the tests are the only missing thing before this PR can be merged, right?

[pietermarsman]

For some reason I a word in that last commit message lol
I'll squash everything into a single commit before we merge anyway.

I can also squash them with github during the merge if you want.

About the docstrings, shouldn't we mention the default values, or is the documentation tool we're using able to infer this from the function signature?

The documentation shows the function signature with default values. Example.

Apart from that, I think the tests are the only missing thing before this PR can be merged, right?

Yep.

[igormp]

I can also squash them with github during the merge if you want.

TIL about this feature, nice

I'll try to get a simple test working today.

[igormp]

Ok, finally added some simple tests.

Travis seems to have failed on python 2.7, and I'm not really sure why. Should I bother with it?

[pietermarsman]

Hhm, I think we should fix that. I've already spend some time on it but I can't find what's going wrong.

[igormp]

I left that options=None parameter for possible test cases where we'd like to change something like the LAParams(), but in hindsight **kwargs would've been better.

I'll try to fix the test strings for the new default value for laparams and try to fix it for python 2.7.

[igormp]

Ok, I managed to fix it, the error was due to StringIO in python3 behaving like BytesIO in python2 or something like that.

[pietermarsman]

I hate python 2 so much, I can't wait to see it dead

😂

[pietermarsman]

Thanks for all the work