…ionBuilder (#1120)

* Add `page.annotations` (getter and setter)
* Add `writer.add_annotation(page_number, annotation_dictionary)`
* Add AnnotationBuilder to generate the `annotation_dictionary` for the different subtypes of annotations. Similarly, we could have an AnnotationsParser.

See #107

Closes #981

…1147)

Adjust `PdfReader._build_outline(...)` and `PdfReader._build_destination(...)` to handle outline items with and without valid destinations

Closes #193 : PdfReadError: Unexpected destination '/__WKANCHOR_2'
Closes #956 : ValueError: Unresolved bookmark

#1059 no longer throws an exception, but the outlines are not extracted either.

Closes #1068 : Skip NameObject when building outline

iaw PDF specifications, page 583

Closes #1145

- Exceptions: User code should handle the issue
- warnings.warn: User should re-write something, e.g. deprecations
- _utils.logger_warning: User might want to know in case of errors / post mortem analysis (or for developing PyPDF2 itself)

Done with https://github.com/py-pdf/pdf-crawler/blob/main/get_coverage_by_pdf.py

Co-authored-by: speedplane <[email protected]>

It seems to be save to ignore the /Perms entry:

Qpdf ignores it:
https://github.com/qpdf/qpdf/blob/main/libqpdf/QPDF_encryption.cc#L1064

pdfbox ignores it:
https://github.com/apache/pdfbox/blob/dc1a75027d5bebf95a3330f6298a533e78e0b99e/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/encryption/StandardSecurityHandler.java#L311

Closes #378

See #1143

Co-authored-by: Martin Thoma <[email protected]>

Closes #434

Co-authored-by: liuzhuoling <[email protected]>

Just move parts in separate functions for easier readability

New Features (ENH):
-  Add writer.add_annotation, page.annotations, and generic.AnnotationBuilder (#1120)

Bug Fixes (BUG):
-  Set /AS for /Btn form fields in writer (#1161)
-  Ignore if /Perms verify failed (#1157)

Robustness (ROB):
-  Cope with utf16 character for space calculation (#1155)
-  Cope with null params for FitH / FitV destination (#1152)
-  Handle outlines without valid destination (#1076)

Developer Experience (DEV):
-  Introduce _utils.logger_warning (#1148)

Maintenance (MAINT):
-  Break up parse_to_unicode (#1162)
-  Add diagnostic output to exception in read_from_stream (#1159)
-  Reduce PdfReader.read complexity (#1151)

Testing (TST):
-  Add workflow tests found by arc testing (#1154)
-  Decrypt file which is not encrypted (#1149)
-  Test CryptRC4 encryption class; test image extraction filters (#1147)

Full Changelog: 2.7.0...2.8.0