ENH: Add transform method to Transformation

[rrthomas]

I am the maintainer of PSUtils. I am adding PDF support, and rewriting the code in Python. pyPDF was a significant motivation for the choice of language, so thanks for that!

I need to express vertical and horizontal page flips, and the simplest way to achieve this seemed to be to add a general transform method to Transformation (I need all the different sorts of transformations to be applied repeatedly to the same page, so it's easier to change a Transformation than to make multiple copies of a page and transform that.) I have done this in the simplest way I could; it might be desired for the method to take a CompressedTransformationMatrix too.

If you agree to add an API something like this, I'll happily add some tests. (At the moment I just tested it with my experimental PSUtils code.)

[codecov]

Codecov Report

Patch coverage: 100.00% and no project coverage change.

Comparison is base (6836174) 92.99% compared to head (2a6494d) 92.99%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1765   +/-   ##
=======================================
  Coverage   92.99%   92.99%           
=======================================
  Files          34       34           
  Lines        6609     6612    +3     
  Branches     1302     1302           
=======================================
+ Hits         6146     6149    +3     
  Misses        302      302           
  Partials      161      161           

Impacted Files	Coverage Δ
pypdf/_page.py	91.26% <100.00%> (+0.03%)	⬆️

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[MartinThoma]

I'm open to adding this 👍

What do you think @pubpub-zz ?

[pubpub-zz]

sounds good to me too.
A good example may be required to show users the way to use it

[pubpub-zz]

@rrthomas
👍 ❤️

[rrthomas]

tox.ini seems to be missing a dependency, pytest-socket.

[MartinThoma]

Thank you for your contribution @rrthomas! If you want, I'll also add you to https://pypdf.readthedocs.io/en/latest/meta/CONTRIBUTORS.html

[MartinThoma]

The PR was just merged to main. It will be part of the release this weekend (pypdf==3.8.0)

[rrthomas]

Thanks very much, I'd be delighted to be added to the contributors list, and I look forward to using the release!