ENH: Add orientation param for text_extraction (# 1071)

[pubpub-zz]

add new capability to filter text extraction on orientation

Deprecations: PageObject.extract_text no longer uses the Tj_sep and TJ_sep parameters.

cf #1071

[codecov]

Codecov Report

Merging #1175 (03057ac) into main (8c532a0) will increase coverage by 0.02%.
The diff coverage is 97.77%.

@@            Coverage Diff             @@
##             main    #1175      +/-   ##
==========================================
+ Coverage   92.08%   92.11%   +0.02%     
==========================================
  Files          24       24              
  Lines        4866     4897      +31     
  Branches      996     1011      +15     
==========================================
+ Hits         4481     4511      +30     
  Misses        242      242              
- Partials      143      144       +1     

Impacted Files	Coverage Δ
PyPDF2/_page.py	92.81% <97.77%> (+0.24%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 8c532a0...03057ac. Read the comment docs.

[MartinThoma]

Very nice!

It looks good to me - I will merge it tomorrow if the text extraction benchmark looks fine as well. So it should get into the release on Sunday :-)

[MartinThoma]

For 2201.00029 the score increased from 96.7% to 97.7%, the rest stayed the same 👍

Interestingly, it seems to have killed a lot of newlines:

I think I need to design a new benchmark which measures how well newlines are captured. At the moment, this is completely ignored for calculating the score.

[MartinThoma]

However, getting the spaces in / between words right is way more important. And there was the improvement 👍