Roadmap for pypdf==4.0.0

[MartinThoma]

Hey :-)

I want to release pypdf==4.0.0 in 2024 (but not earlier). This is a check-list for me. Please let me know if I should add anything.

I want to do the following with pypdf==4.0.0 (but not earlier):

• Cryptography: Set the default algorithm to be something we consider secure, e.g. AES-256 (see encryption-decryption.md). That is a breaking change as it means the cryptography package will be required.
• ✔️ DEP: Remove deprecated code #2367 - Deprecations: Get rid of a lot of deprecated code 🎉
  • Search for deprecate_with_replacement(removed_in="4.0.0") : All of those function calls need to be replaced by deprecation_with_replacement.
  • Search for deprecate_no_replacement(removed_in="4.0.0"): All of those function calls need to be replaced with deprecation_no_replacement
  • Search for deprecation_with_replacement(removed_in="3.0.0"): All of those functions / modules can be completely removed. Remove the default value of the function itself.
  • Search for deprecation_no_replacement(removed_in="3.0.0"): All of those functions / modules can be completely removed. Remove the default value of the function itself.
• ✔️ MAINT: Return None instead of -1 when page is not attached #2376 - Clarify Switch to None or Exception for page_number / get_page_number / get_destination_page_number #2010
• ✔️ DEP: Drop Python 3.6 support #2369 - Drop Python 3.6 support #2005 - we don't want major version changes that often. The PIL issues and lacking crytpography support are a good reason for me to drop 3.6 support.
• Go through all breaking-change A planned breaking change issues / discussions

[MartinThoma]

We could update the Sphinx theme as a signal that we're getting more modern. My requirements would be:

• Makes use of an free software license (MIT, BSD, Apache 2, ...)
• Autosphinx generated stuff must look good
• Code blocks have to be still syntax highlighted / easy to read
• Search results must look good
• A light-ish mode must be the default, a dark mode can exist
• It should work with Desktop and mobile devices
• If you have indications that something is better for vision-impaired people, let me know (e.g. easier for screen readers)

I know that "must look good" is very subjective. I'm open to suggestions and community upvotes 👍 / downovtes 👎 certainly influence me, but I will make the final decision.

What I found:

• https://sphinxawesome.xyz/
• https://sphinxthemes.com/themes/guzzle
• https://sphinxthemes.com/themes/furo - I like the search + it has a dark mode

[stefan6419846]

In my personal opinion, the default RTD template we currently use is completely fine for most of my use cases, so this does not really have any real priority for me.

[MartinThoma]

@pubpub-zz @stefan6419846 On first or second of January 2024 I'll add bigger PRs to do the deprecations. I will go through the open PRs beforehand and try to merge as many as possible.

This is just a heads-up. Doing the deprecations will likely give several merge conflicts. I don't want to annoy you / cause unnecessary work for you.

I'm looking forward to those cleanup-changes xD

[pubpub-zz]

I will try to #2197 around Christmas : It should be better to have it in 4.0.0 as some changes should occur in the interface

[stefan6419846]

I have been a bit confused at first why I am mentioned here, but I assume that this is due to being one of the continuous contributors here as well, although mostly related to smaller stuff ;)

For me, this is completely fine. (Most of my issues are work-related and thus actual contribution activity tends to be less on holidays anyway.)