ENH: Add Jupyter Notebook integration for PdfReader

[MartinThoma]

See

• https://ipython.readthedocs.io/en/stable/config/integrating.html#MyObject._repr_mimebundle_
• https://discourse.jupyter.org/t/what-are-include-exclude-parameter-in-repr-mimebundle-for/23125

Without this PR

With this PR

[MartinThoma]

I could not find any documentation regarding the include / exclude parameters, but ChatGPT thinks it should be used like this (which sounds reasonable):

def _repr_mimebundle_(self, include=None, exclude=None):
    data = {
        'text/plain': 'This is a plain text representation.',
        'text/html': '<strong>This is an HTML representation.</strong>',
        'application/json': '{"key": "value"}'
    }

    if include is not None:
        # Filter representations based on include list
        data = {k: v for k, v in data.items() if k in include}

    if exclude is not None:
        # Remove representations based on exclude list
        data = {k: v for k, v in data.items() if k not in exclude}

    return data

[MartinThoma]

We could add something similar for PdfWriter and PageObject. Maybe even for annotations (creating a reader and a blank page + adding the annotation + rendering it)

[codecov]

Codecov Report

Attention: 8 lines in your changes are missing coverage. Please review.

Comparison is base (195d82e) 94.45% compared to head (33a627d) 94.35%.

Files	Patch %	Lines
pypdf/_reader.py	11.11%	8 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2375      +/-   ##
==========================================
- Coverage   94.45%   94.35%   -0.10%     
==========================================
  Files          43       43              
  Lines        7575     7584       +9     
  Branches     1515     1519       +4     
==========================================
+ Hits         7155     7156       +1     
- Misses        257      265       +8     
  Partials      163      163              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[stefan6419846]

Upstream implementation of includes/excludes: https://github.com/ipython/ipython/blob/d0e254420445c2204a2b39d28948cd6127717fb1/IPython/core/formatters.py#L151-L157

[MartinThoma]

Thanks! Then the ChatGPT code is perfect 🎉