Proposal
Historic background
- pyPdf is the original project. It was developed from 2005 - 2010. It didn't receive updates from 2010 - December 2022.
- PyPDF2 was developed from 2011 - 2016. It didn't receive updates from 2016-2022. I (Martin Thoma) became the maintainer in April 2022. A few months later I also became the maintainer of pypdf.
- In December 2022 I released PyPDF2==3.0.0 and pypdf==3.1.0. Both versions are essentially the same, just
Proof that I'm the maintainer:
- pypdf on PyPI: Look at the side-bar on the left side
- PyPDF2 on PyPI: Look at the side-bar on the left side
- Linked documentation of pypdf: This is linked on PyPI. In the contributors section you can see a link to my Stackoverflow profile
- Linked documentation of PyPDF2: This is essentially the same as the docs above.
My plans:
pypdf
will get active developmentPyPDF2
will only receive critical bugfixes (and likely also only if somebody makes a good PR / if the fix is rather small). I will leave it as-is on PyPI so that people who version-pinned it can keep using it.
The migration from PyPDF2==1.x to PyPDF2==2.x is mainly renaming some classes / methods. The main differentce to PyPDF2==3.x is that DeprecationWarnings were changed to Exceptions.
Here are some indications on how much work the various version upgrades are for users:
- Much:
pypdf==1.x
→PyPDF2==2.x
/PyPDF2==3.x
- Very Little:
pypdf==1.x
→PyPDF2==1.x
- Very Little:
PyPDF2==2.x
→PyPDF2==3.x
- Very Little:
PyPDF2==3.x
→pypdf==3.x
Reasons for the switch
- The two projects are one again
- Users regularly confused the two tags already. Many questions have both tags already, although I tried to ensure they are used distinct before.