Version 2.3.1, 2022-06-19

What's Changed

Bug Fixes (BUG)

• Forgot to add the interal _codecs subpackage.

Full Changelog: 2.3.0...2.3.1

2.3.0

What's Changed

The highlight of this release is improved support for file encryption
(AES-128 and AES-256, R5 only). See #749 for the amazing work of
@exiledkingcc 🎊 Thank you 🤗

Deprecations (DEP)

• Rename names to be PEP8-compliant (#967)
• PdfWriter.get_page: the pageNumber parameter is renamed to page_number
• PyPDF2.filters:
  • For all classes, a parameter rename: decodeParms ➔ decode_parms
  • decodeStreamData ➔ decode_stream_data
• PyPDF2.xmp:
  • XmpInformation.rdfRoot ➔ XmpInformation.rdf_root
  • XmpInformation.xmp_createDate ➔ XmpInformation.xmp_create_date
  • XmpInformation.xmp_creatorTool ➔ XmpInformation.xmp_creator_tool
  • XmpInformation.xmp_metadataDate ➔ XmpInformation.xmp_metadata_date
  • XmpInformation.xmp_modifyDate ➔ XmpInformation.xmp_modify_date
  • XmpInformation.xmpMetadata ➔ XmpInformation.xmp_metadata
  • XmpInformation.xmpmm_documentId ➔ XmpInformation.xmpmm_document_id
  • XmpInformation.xmpmm_instanceId ➔ XmpInformation.xmpmm_instance_id
• PyPDF2.generic:
  • readHexStringFromStream ➔ read_hex_string_from_stream
  • initializeFromDictionary ➔ initialize_from_dictionary
  • createStringObject ➔ create_string_object
  • TreeObject.hasChildren ➔ TreeObject.has_children
  • TreeObject.emptyTree ➔ TreeObject.empty_tree

New Features (ENH)

• Add decrypt support for V5 and AES-128, AES-256 (R5 only) (#749)

Robustness (ROB)

• Fix corrupted (wrongly) linear PDF (#1008)

Maintenance (MAINT)

• Move PDF_Samples folder into ressources
• Fix typos (#1007)

Testing (TST)

• Improve encryption/decryption test (#1009)
• Add merger test cases with real PDFs (#1006)
• Add mutmut config

Code Style (STY)

• Put pure data mappings in separate files (#1005)
• Make encryption module private, apply pre-commit (#1010)

New Contributors

• @kianmeng made their first contribution in #1007

Full Changelog: 2.2.1...2.3.0

Version 2.2.1, 2022-06-17

What's Changed

Performance Improvements (PI)

• Remove b_ calls (#992, #986)
• Apply improvements to _utils suggested by perflint (#993)

Robustness (ROB)

• utf-16-be' codec can't decode (...) (#995)

Documentation (DOC)

• Remove reference to Scripts (#987)

Developer Experience (DEV)

• Fix type annotations for add_bookmarks (#1000)

Testing (TST)

• Add test for PdfMerger (#1001)
• Add tests for XMP information (#996)
• reader.get_fields / zlib issue / LZW decode issue (#1004)
• reader.get_fields with report generation (#1002)
• Improve test coverage by extracting texts (#998)

Code Style (STY)

• Apply fixes suggested by pylint (#999)

Full Changelog: 2.2.0...2.2.1

Version 2.2.0, 2022-06-13

What's Changed

The 2.2.0 release improves text extraction (#969 - again by @pubpub-zz 🙏):

• Improvements around /Encoding / /ToUnicode
• Extraction of CMaps improved
• Fallback for font def missing
• Support for /Identity-H and /Identity-V: utf-16-be
• Support for /GB-EUC-H / /GB-EUC-V / GBp/c-EUC-H / /GBpc-EUC-V (beta release for evaluation)
• Arabic (for evaluation)
• Whitespace extraction improvements

Those changes should mainly improve the text extraction for non-ASCII alphabets,
e.g. Russian / Chinese / Japanese / Korean / Arabic.

Full Changelog: 2.1.1...2.2.0

Version 2.1.1, 2022-06-12

What's Changed

New Features (ENH)

• Add support for pathlib as input for PdfReader (#979)

Performance Improvements (PI)

• Optimize read_next_end_line (#646)

Bug Fixes (BUG)

• Adobe Acrobat 'Would you like to save this file?' (#970)

Documentation (DOC)

• Notes on annotations (#982)
• Who uses PyPDF2
• intendet \xe2\x9e\x94 in robustness page (#958)

Maintenance (MAINT)

• pre-commit / requirements.txt updates (#977)
• Mark read_next_end_line as deprecated (#965)
• Export PageObject in PyPDF2 root (#960)

Testing (TST)

• Add MCVE of issue #416 (#980)
• FlateDecode.decode decodeParms (#964)
• Xmp module (#962)
• utils.paeth_predictor (#959)

Code Style (STY)

• Use more tuples and list/dict comprehensions (#976)

New Contributors

• @Kreusada made their first contribution in #958
• @xilopaint made their first contribution in #960
• @ztravis made their first contribution in #646

Full Changelog: 2.1.0...2.1.1

Version 2.1.0, 2022-06-06

What's Changed

The highlight of the 2.1.0 release is the most massive improvement to the
text extraction capabilities of PyPDF2 since 2016 🥳🎊 A very big thank you goes
to pubpub-zz who took a lot of time and
knowledge about the PDF format to finally get those improvements into PyPDF2.
Thank you 🤗💚

In case the new function causes any issues, you can use _extract_text_old
for the old functionality. Please also open a bug ticket in that case.

There were several people who have attempted to bring similar improvements to
PyPDF2. All of those were valuable. The main reason why they didn't get merged
is the big amount of open PRs / issues. pubpub-zz was the most comprehensive
PR which also incorporated the latest changes of PyPDF2 2.0.0.

Thank you to VictorCarlquist for #858 and
asabramo for #464 🤗

New Features (ENH)

• Massive text extraction improvement (#924). Closed many open issues:
  • Exceptions / missing spaces in extract_text() method (#17) 🕺
    • Whitespace issues in extract_text() (#42) 💃
    • pypdf2 reads the hifenated words in a new line (#246)
  • PyPDF2 failing to read unicode character (#37)
    • Unable to read bullets (#230)
  • ExtractText yields nothing for apparently good PDF (#168) 🎉
  • Encoding issue in extract_text() (#235)
  • extractText() doesn't work on Chinese PDF (#252)
  • encoding error (#260)
  • Trouble with apostophes in names in text "O'Doul" (#384)
  • extract_text works for some PDF files, but not the others (#437)
  • Euro sign not being recognized by extractText (#443)
  • Failed extracting text from French texts (#524)
  • extract_text doesn't extract ligatures correctly (#598)
  • reading spanish text - mark convert issue (#635)
  • Read PDF changed from text to random symbols (#654)
  • .extractText() reads / as 1. (#789)
• Update glyphlist (#947) - inspired by #464
• Allow adding PageRange objects (#948)

Bug Fixes (BUG)

• Delete .python-version file (#944)
• Compare StreamObject.decoded_self with None (#931)

Robustness (ROB)

• Fix some conversion errors on non conform PDF (#932)

Documentation (DOC)

• Elaborate on PDF text extraction difficulties (#939)
• Add logo (#942)
• rotate vs Transformation().rotate (#937)
• Example how to use PyPDF2 with AWS S3 (#938)
• How to deprecate (#930)
• Fix typos on robustness page (#935)
• Remove scripts (pdfcat) from docs (#934)

Developer Experience (DEV)

• Ignore .python-version file
• Mark deprecated code with no-cover (#943)
• Automatically create Github releases from tags (#870)

Testing (TST)

• Text extraction for non-latin alphabets (#954)
• Ignore PdfReadWarning in benchmark (#949)
• writer.remove_text (#946)
• Add test for Tree and _security (#945)

Code Style (STY)

• black, isort, Flake8, splitting buildCharMap (#950)

Full Changelog: 2.0.0...2.1.0

New Contributors

• @chrisdonlan made their first contribution in #931
• @2e0byo made their first contribution in #870
• @HarHarLinks made their first contribution in #944

Full Changelog: 2.0.0...2.1.0

Version 2.0.0, 2022-06-01

What's Changed

The 2.0.0 release of PyPDF2 includes three core changes:

1. Dropping support for Python 3.5 and older.
2. Introducing type annotations.
3. Interface changes, mostly to have PEP8-compliant names

We introduced a deprecation process
that hopefully helps users to avoid unexpected breaking changes.

Breaking Changes (DEP)

• PyPDF2 2.0 requires Python 3.6+. Python 2.7 and 3.5 support were dropped.
• PdfFileReader: The "warndest" parameter was removed
• PdfFileReader and PdfFileMerger no longer have the overwriteWarnings
  parameter. The new behavior is overwriteWarnings=False.
• merger: OutlinesObject was removed without replacement.
• merger.py ➔ _merger.py: You must import PdfFileMerger from PyPDF2 directly.
• utils:
  • ConvertFunctionsToVirtualList was removed
  • formatWarning was removed
  • isInt(obj): Use instance(obj, int) instead
  • u_(s): Use s directly
  • chr_(c): Use chr(c) instead
  • barray(b): Use bytearray(b) instead
  • isBytes(b): Use instance(b, type(bytes())) instead
  • xrange_fn: Use range instead
  • string_type: Use str instead
  • isString(s): Use instance(s, str) instead
  • _basestring: Use str instead
  • All Exceptions are now in PyPDF2.errors:
    • PageSizeNotDefinedError
    • PdfReadError
    • PdfReadWarning
    • PyPdfError
• PyPDF2.pdf (the pdf module) no longer exists. The contents were moved with
  the library. You should most likely import directly from PyPDF2 instead.
  The RectangleObject is in PyPDF2.generic.
• The Resources, Scripts, and Tests will no longer be part of the distribution
  files on PyPI. This should have little to no impact on most people. The
  Tests are renamed to tests, the Resources are renamed to resources.
  Both are still in the git repository. The Scripts are now in
  https://github.com/py-pdf/cpdf. Sample_Code was moved to the docs.

For a full list of deprecated functions, please see the changelog of version
1.28.0.

New Features (ENH)

• Improve space setting for text extraction (#922)
• Allow setting the decryption password in PdfReader.init (#920)
• Add Page.add_transformation (#883)

Bug Fixes (BUG)

• Fix error adding transformation to page without /Contents (#908)

Robustness (ROB)

• Cope with invalid length in streams (#861)

Documentation (DOC)

• Fix style of 1.25 and 1.27 patch notes (#927)
• Transformation (#907)

Developer Experience (DEV)

• Create flake8 config file (#916)
• Use relative imports (#875)

Maintenance (MAINT)

• Use Python 3.6 language features (#849)
• Add wrapper function for PendingDeprecationWarnings (#928)
• Use new PEP8 compliant names (#884)
• Explicitly represent transformation matrix (#878)
• Inline PAGE_RANGE_HELP string (#874)
• Remove unnecessary generics imports (#873)
• Remove star imports (#865)
• merger.py ➔ _merger.py (#864)
• Type annotations for all functions/methods (#854)
• Add initial type support with mypy (#853)

Testing (TST)

• Regression test for xmp_metadata converter (#923)
• Checkout submodule sample-files for benchmark
• Add text extracting performance benchmark
• Use new PyPDF2 API in benchmark (#902)
• Make test suite fail for uncaught warnings (#892)
• Remove -OO testrun from CI (#901)
• Improve tests for convert_to_int (#899)

Full Changelog: 1.28.4...2.0.0

Version 1.28.4, 2022-05-29

What's Changed

Bug Fixes (BUG):

• XmpInformation._converter_date was unusable (#921)

Full Changelog: 1.28.3...1.28.4

Full Changelog: 1.28.3...1.28.4

Version 1.28.3, 2022-05-28

What's Changed

Deprecations (DEP)

• PEP8 renaming (#905)

Bug Fixes (BUG)

• XmpInformation missing method _getText (#917)
• Fix PendingDeprecationWarning on _merge_page (#904)

Full Changelog: 1.28.2...1.28.3

Version 1.28.2, 2022-05-23

What's Changed

Bug Fixes (BUG)

• PendingDeprecationWarning for getContents (#893)
• PendingDeprecationWarning on using PdfMerger (#891)

Full Changelog: 1.28.1...1.28.2