Update dependency PyPDF2 to v3
This MR contains the following updates:
Package | Update | Change |
---|---|---|
PyPDF2 (changelog) | major |
==1.26.0 -> ==3.0.1
|
Release Notes
py-pdf/PyPDF2
v3.0.0
⚠ ️
BREAKING CHANGES
New Features (ENH)
Documentation (DOC)
- How to read PDFs from S3 (#1509)
- Make MyST parse all links as simple hyperlinks (#1506)
- Changed 'latest' for 'stable' generated docs (#1495)
- Adjust deprecation procedure (#1487)
Maintenance (MAINT)
- Use typing.IO for file streams (#1498)
v2.12.1
Documentation (DOC)
Maintenance (MAINT)
Consistency changes:
- indirect_ref/ido ➔ indirect_reference, dest➔ page_destination (#1467)
- owner_pwd/user_pwd ➔ owner_password/user_password (#1483)
- position ➜ page_number in Merger.merge (#1482)
- indirect_ref ➜ indirect_reference (#1484)
v2.12.0
New Features (ENH)
- Add support to extract gray scale images (#1460)
- Add 'threads' property to PdfWriter (#1458)
- Add 'open_destination' property to PdfWriter (#1431)
- Make PdfReader.get_object accept integer arguments (#1459)
Bug Fixes (BUG)
- Scale PDF annotations (#1479)
Robustness (ROB)
Documentation (DOC)
- Add module documentation the PaperSize class (#1447)
Maintenance (MAINT)
Testing (TST)
- Cleanup temporary files (#1454)
- Mark test_tounicode_is_identity as external (#1449)
- Use Ubuntu 20.04 for running CI test suite (#1452)
v2.11.2
New Features (ENH)
Bug Fixes (BUG)
- JavaScript executed twice (#1439)
- ToUnicode stores /Identity-H instead of stream (#1433)
- Declare Pillow as optional dependency (#1392)
Developer Experience (DEV)
- Link 'Full Changelog' automatically
- Modify read_string_from_stream to a benchmark (#1415)
- Improve error reporting of read_object (#1412)
- Test Python 3.11 (#1404)
- Extend Flake8 ignore list (#1410)
- Use correct pytest markers (#1407)
- Move project configuration to pyproject.toml (#1382)
v2.11.1
Bug Fixes (BUG)
Robustness (ROB)
- Cope with str returned from get_data in cmap (#1380)
v2.11.0
New Features (ENH)
- Addition of optional visitor-functions in extract_text() (#1252)
- Add metadata.creation_date and modification_date (#1364)
- Add PageObject.images attribute (#1330)
Bug Fixes (BUG)
- Lookup index in _xobj_to_image can be ByteStringObject (#1366)
- 'IndexError: index out of range' when using extract_text (#1361)
- Errors in transfer_rotation_to_content() (#1356)
Robustness (ROB)
- Ensure update_page_form_field_values does not fail if no fields (#1346)
v2.10.9
New Features (ENH)
- Add rotation property and transfer_rotate_to_content (#1348)
Performance Improvements (PI)
- Avoid string concatenation with large embedded base64-encoded images (#1350)
Bug Fixes (BUG)
- Format floats using their intrinsic decimal precision (#1267)
Robustness (ROB)
- Fix merge_page for pages without resources (#1349)
v2.10.8
New Features (ENH)
- Add PageObject.user_unit property (#1336)
Robustness (ROB)
- Improve NameObject reading/writing (#1345)
v2.10.7
Bug Fixes (BUG)
Testing (TST)
- Use pytest.warns() for warnings, and .raises() for exceptions (#1325)
v2.10.6
Robustness (ROB)
- Fix infinite loop due to Invalid object (#1331)
- Fix image extraction issue with superfluous whitespaces (#1327)
v2.10.5
New Features (ENH)
Bug Fixes (BUG)
- Avoid scaling cropbox twice (#1314)
Robustness (ROB)
- Fix offset correction in revised PDF (#1318)
- Crop data of /U and /O in encryption dictionary to 48 bytes (#1317)
- MultiLine bfrange in cmap (#1299)
- Cope with 2 digit codes in bfchar (#1310)
- Accept '/annn' charset as ASCII code (#1316)
- Log errors during Float / NumberObject initialization (#1315)
- Cope with corrupted entries in xref table (#1300)
Documentation (DOC)
- Migration guide (PyPDF2 1.x ➔ 2.x) (#1324)
- Creating a coverage report (#1319)
- Fix AnnotationBuilder.free_text example (#1311)
- Fix usage of page.scale by replacing it with page.scale_by (#1313)
Maintenance (MAINT)
- PdfReaderProtocol (#1303)
- Throw PdfReadError if Trailer can't be read (#1298)
- Remove catching OverflowException (#1302)
v2.10.4
Robustness (ROB)
- Fix errors/warnings on no /Resources within extract_text (#1276)
- Add required line separators in ContentStream ArrayObjects (#1281)
Maintenance (MAINT)
- Use NameObject idempotency (#1290)
Testing (TST)
Packaging (PKG)
- Add minimum version for typing_extensions requirement (#1277)
v2.10.3
Robustness (ROB)
- Decrypt returns empty bytestring (#1258)
Developer Experience (DEV)
- Modify CI to better verify built package contents (#1244)
Maintenance (MAINT)
- Remove 'mine' as PdfMerger always creates the stream (#1261)
- Let PdfMerger._create_stream raise NotImplemented (#1251)
- password param of _security._alg32(...) is only a string, not bytes (#1259)
- Remove unreachable code in read_block_backwards (#1250) and sign function in _extract_text (#1262)
Testing (TST)
- Delete annotations (#1263)
- Close PdfMerger in tests (#1260)
- PdfReader.xmp_metadata workflow (#1257)
- Various PdfWriter (Layout, Bookmark deprecation) (#1249)
v2.10.2
BUG: Add PyPDF2.generic to PyPI distribution
v2.10.1
Bug Fixes (BUG)
- TreeObject.remove_child had a non-PdfObject assignment for Count (#1233, #1234)
- Fix stream truncated prematurely (#1223)
Documentation (DOC)
- Fix docstring formatting (#1228)
Maintenance (MAINT)
- Split generic.py (#1229)
Testing (TST)
- Decrypt AlgV4 with owner password (#1239)
- AlgV5.generate_values (#1238)
- TreeObject.remove_child / empty_tree (#1235, #1236)
- create_string_object (#1232)
- Free-Text annotations (#1231)
- generic._base (#1230)
- Strict get fonts (#1226)
- Increase PdfReader coverage (#1219, #1225)
- Increase PdfWriter coverage (#1237)
- 100% coverage for utils.py (#1217)
- PdfWriter exception non-binary stream (#1218)
- Don't check coverage for deprecated code (#1216)
v2.10.0
New Features (ENH)
- "with" support for PdfMerger and PdfWriter (#1193)
- Add AnnotationBuilder.text(...) to build text annotations (#1202)
Bug Fixes (BUG)
- Allow IndirectObjects as stream filters (#1211)
Documentation (DOC)
- Font scrambling
- Page vs Content scaling (#1208)
- Example for orientation parameter of extract_text (#1206)
- Fix AnnotationBuilder parameter formatting (#1204)
Developer Experience (DEV)
- Add flake8-print (#1203)
Maintenance (MAINT)
- Introduce WrongPasswordError / FileNotDecryptedError / EmptyFileError (#1201)
v2.9.0
New Features (ENH)
- Add ability to add hex encoded colors to outline items (#1186)
- Add support for pathlib.Path in PdfMerger.merge (#1190)
- Add link annotation (#1189)
- Add capability to filter text extraction by orientation (#1175)
Bug Fixes (BUG)
Documentation (DOC)
- Update changelog url in package metadata (#1180)
- Mantion camelot for table extraction (#1179)
- Mention pyHanko for signing PDF documents (#1178)
- Weow have CMAP support since a while (#1177)
Maintenance (MAINT)
- Consistant usage of warnings / log messages (#1164)
- Consistent terminology for outline items (#1156)
v2.8.1
Bug Fixes (BUG)
- u_hash in AlgV4.compute_key (#1170)
Robustness (ROB)
Documentation (DOC)
- Typo in merger deprecation warning message (#1166)
Maintenance (MAINT)
- Package updates; solve mypy strict remarks (#1163)
Testing (TST)
v2.8.0
New Features (ENH)
- Add writer.add_annotation, page.annotations, and generic.AnnotationBuilder (#1120)
Bug Fixes (BUG)
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)
v2.7.0
New Features (ENH)
- Add
outline_count
property (#1129)
Bug Fixes (BUG)
- Make reader.get_fields also return dropdowns with options (#1114)
- Add deprecated EncodedStreamObject functions back until PyPDF2==3.0.0 (#1139)
Robustness (ROB)
Documentation (DOC)
Developer Experience (DEV)
- Add .git-blame-ignore-revs (#1141)
Code Style (STY)
v2.6.0
New Features (ENH)
- Add color and font_format to PdfReader.outlines[i] (#1104)
- Extract Text Enhancement (whitespaces) (#1084)
Bug Fixes (BUG)
- Use
build_destination
for named destination outlines (#1128) - Avoid a crash when a ToUnicode CMap has an empty dstString in beginbfchar (#1118)
- Prevent deduplication of PageObject (#1105)
- None-check in DictionaryObject.read_from_stream (#1113)
- Avoid IndexError in _cmap.parse_to_unicode (#1110)
Documentation (DOC)
- Explanation for git submodule
- Watermark and stamp (#1095)
Maintenance (MAINT)
- Text extraction improvements (#1126)
- Destination.color returns ArrayObject instead of tuple as fallback (#1119)
- Use add_bookmark_destination in add_bookmark (#1100)
- Use add_bookmark_destination in add_bookmark_dict (#1099)
Testing (TST)
- Add test for arab text (#1127)
- Add xfail for decryption fail (#1125)
- Add xfail test for IndexError when extracting text (#1124)
- Add MCVE showing outline title issue (#1123)
Code Style (STY)
v2.5.0
New Features (ENH)
- Add support for indexed color spaces / BitsPerComponent for decoding PNGs (#1067)
- Add PageObject._get_fonts (#1083)
Performance Improvements (PI)
- Use iterative DFS in PdfWriter._sweep_indirect_references (#1072)
Bug Fixes (BUG)
- Let Page.scale also scale the crop-/trim-/bleed-/artbox (#1066)
- Column default for CCITTFaxDecode (#1079)
Robustness (ROB)
- Guard against None-value in _get_outlines (#1060)
Documentation (DOC)
- Stamps and watermarks (#1082)
- OCR vs PDF text extraction (#1081)
- Python Version support
- Formatting of CHANGELOG
Developer Experience (DEV)
Maintenance (MAINT)
Testing (TST)
Code Style (STY)
- Apply black
- Typo in Changelog
v2.4.2
New Features (ENH)
- Add PdfReader.xfa attribute (#1026)
Bug Fixes (BUG)
- Wrong page inserted when PdfMerger.merge is done (#1063)
- Resolve IndirectObject when it refers to a free entry (#1054)
Developer Experience (DEV)
- Added {posargs} to tox.ini (#1055)
Maintenance (MAINT)
- Remove PyPDF2._utils.bytes_type (#1053)
Testing (TST)
- Scale page (indirect rect object) (#1057)
- Simplify pathlib PdfReader test (#1056)
- IndexError of VirtualList (#1052)
- Invalid XML in xmp information (#1051)
- No pycryptodome (#1050)
- Increase test coverage (#1045)
Code Style (STY)
v2.4.1
New Features (ENH)
- Add writer.pdf_header property (getter and setter) (#1038)
Performance Improvements (PI)
- Remove b_ call in FloatObject.write_to_stream (#1044)
- Check duplicate objects in writer._sweep_indirect_references (#207)
Documentation (DOC)
- How to surppress exceptions/warnings/log messages (#1037)
- Remove hyphen from lossless (#1041)
- Compression of content streams (#1040)
- Fix inconsistent variable names in add-watermark.md (#1039)
- File size reduction
- Add CHANGELOG to the rendered docs (#1023)
Maintenance (MAINT)
Code Style (STY)
v2.4.0
New Features (ENH):
Performance Improvements (PI):
- Remove ord_ calls (#1014)
Bug Fixes (BUG):
- Fix missing page for bookmark (#1016)
Robustness (ROB):
- Deal with invalid Destinations (#1028)
Documentation (DOC):
- get_form_text_fields does not extract dropdown data (#1029)
- Adjust PdfWriter.add_uri docstring
- Mention crypto extra_requires for installation (#1017)
Developer Experience (DEV):
- Use /n line endings everywhere (#1027)
- Adjust string formatting to be able to use mutmut (#1020)
- Update Bug report template
v2.3.1
BUG: Forgot to add the interal _codecs
subpackage.
v2.3.0
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
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)
v2.2.1
Performance Improvements (PI)
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)
v2.2.0
The 2.2.0 release improves text extraction again via (#969):
- 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.
v2.1.1
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)
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)
v2.1.0
The highlight of the 2.1.0 release is the most massive improvement to the
text extraction capabilities of PyPDF2 since 2016 🥳
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 MRs / issues. pubpub-zz was the most comprehensive MR 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)
🕺 - 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)
- Exceptions / missing spaces in extract_text() method (#17)
- Update glyphlist (#947) - inspired by #464
- Allow adding PageRange objects (#948)
Bug Fixes (BUG)
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)
v2.0.0
The 2.0.0 release of PyPDF2 includes three core changes:
- Dropping support for Python 3.5 and older.
- Introducing type annotations.
- 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 isoverwriteWarnings=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)
: Useinstance(obj, int)
instead -
u_(s)
: Uses
directly -
chr_(c)
: Usechr(c)
instead -
barray(b)
: Usebytearray(b)
instead -
isBytes(b)
: Useinstance(b, type(bytes()))
instead -
xrange_fn
: Userange
instead -
string_type
: Usestr
instead -
isString(s)
: Useinstance(s, str)
instead -
_basestring
: Usestr
instead - All Exceptions are now in
PyPDF2.errors
:- PageSizeNotDefinedError
- PdfReadError
- PdfReadWarning
- PyPdfError
-
-
PyPDF2.pdf
(thepdf
module) no longer exists. The contents were moved with the library. You should most likely import directly fromPyPDF2
instead. TheRectangleObject
is inPyPDF2.generic
. - The
Resources
,Scripts
, andTests
will no longer be part of the distribution files on PyPI. This should have little to no impact on most people. TheTests
are renamed totests
, theResources
are renamed toresources
. Both are still in the git repository. TheScripts
are now in cpdf.Sample_Code
was moved to thedocs
.
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)
Developer Experience (DEV)
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)
v1.28.6
: Version 1.28.6, 2022-09-08
This is a bugfix for the old 1.x branch of PyPDF2 that still supports Python 2. Please try to update to the latest PyPDF2 > 2.0.0
version to get way better text extraction, support for modern encryption, and much more.
What's Changed
- BUG: Adjust 'super' calls for Python 2 by @omit66 in https://github.com/py-pdf/PyPDF2/pull/1335
New Contributors
- @omit66 made their first contribution in https://github.com/py-pdf/PyPDF2/pull/1335
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.28.5...1.28.6
v1.28.5
: Version 1.28.5, 2022-07-21
What's Changed
- BUG: Add missing deprecated EncodedStreamObject functions by @MasterOdin in https://github.com/py-pdf/PyPDF2/pull/1140
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.28.4...1.28.5
v1.28.4
: Version 1.28.4, 2022-05-29
What's Changed
Bug Fixes (BUG):
- XmpInformation._converter_date was unusable (#921)
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.28.3...1.28.4
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.28.3...1.28.4
v1.28.3
: Version 1.28.3, 2022-05-28
What's Changed
Deprecations (DEP)
- PEP8 renaming (#905)
Bug Fixes (BUG)
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.28.2...1.28.3
v1.28.2
: Version 1.28.2, 2022-05-23
What's Changed
Bug Fixes (BUG)
- PendingDeprecationWarning for getContents (#893)
- PendingDeprecationWarning on using PdfMerger (#891)
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.28.1...1.28.2
v1.28.1
: Version 1.28.1, 2022-05-22
What's Changed
Bug Fixes (BUG)
- Incorrectly show deprecation warnings on internal usage (#887)
Maintenance (MAINT)
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.28.0...1.28.1
v1.28.0
: Version 1.28.0, 2022-05-22
Version 1.28.0, 2022-05-22
This release adds a lot of deprecation warnings in preparation of the PyPDF2 2.0.0 release. The changes are mostly using snake_case function-, method-, and variable-names as well as using properties instead of getter-methods.
Maintenance (MAINT):
- Remove IronPython Fallback for zlib (#868)
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.12...1.27.13
Deprecations (DEP)
- Make the
PyPDF2.utils
module private - Rename of core classes:
- PdfFileReader ➔ PdfReader
- PdfFileWriter ➔ PdfWriter
- PdfFileMerger ➔ PdfMerger
- Use PEP8 conventions for function names and parameters
- If a property and a getter-method are both present, use the property
Details
In many places:
- getObject ➔ get_object
- writeToStream ➔ write_to_stream
- readFromStream ➔ read_from_stream
PyPDF2.generic
- readObject ➔ read_object
- convertToInt ➔ convert_to_int
- DocumentInformation.getText ➔ DocumentInformation._get_text : This method should typically not be used; please let me know if you need it.
PdfReader class:
-
reader.getPage(pageNumber)
➔reader.pages[page_number]
-
reader.getNumPages()
/reader.numPages
➔len(reader.pages)
- getDocumentInfo ➔ metadata
- flattenedPages attribute ➔ flattened_pages
- resolvedObjects attribute ➔ resolved_objects
- xrefIndex attribute ➔ xref_index
- getNamedDestinations / namedDestinations attribute ➔ named_destinations
- getPageLayout / pageLayout ➔ page_layout attribute
- getPageMode / pageMode ➔ page_mode attribute
- getIsEncrypted / isEncrypted ➔ is_encrypted attribute
- getOutlines ➔ get_outlines
- readObjectHeader ➔ read_object_header (TODO: read vs get?)
- cacheGetIndirectObject ➔ cache_get_indirect_object (TODO: public vs private?)
- cacheIndirectObject ➔ cache_indirect_object (TODO: public vs private?)
- getDestinationPageNumber ➔ get_destination_page_number
- readNextEndLine ➔ read_next_end_line
- _zeroXref ➔ _zero_xref
- _authenticateUserPassword ➔ _authenticate_user_password
- _pageId2Num attribute ➔ _page_id2num
- _buildDestination ➔ _build_destination
- _buildOutline ➔ _build_outline
- _getPageNumberByIndirect(indirectRef) ➔ _get_page_number_by_indirect(indirect_ref)
- _getObjectFromStream ➔ _get_object_from_stream
- _decryptObject ➔ _decrypt_object
- _flatten(..., indirectRef) ➔ _flatten(..., indirect_ref)
- _buildField ➔ _build_field
- _checkKids ➔ _check_kids
- _writeField ➔ _write_field
- _write_field(..., fieldAttributes) ➔ _write_field(..., field_attributes)
- _read_xref_subsections(..., getEntry, ...) ➔ _read_xref_subsections(..., get_entry, ...)
PdfWriter class:
-
writer.getPage(pageNumber)
➔writer.pages[page_number]
-
writer.getNumPages()
➔len(writer.pages)
- addMetadata ➔ add_metadata
- addPage ➔ add_page
- addBlankPage ➔ add_blank_page
- addAttachment(fname, fdata) ➔ add_attachment(filename, data)
- insertPage ➔ insert_page
- insertBlankPage ➔ insert_blank_page
- appendPagesFromReader ➔ append_pages_from_reader
- updatePageFormFieldValues ➔ update_page_form_field_values
- cloneReaderDocumentRoot ➔ clone_reader_document_root
- cloneDocumentFromReader ➔ clone_document_from_reader
- getReference ➔ get_reference
- getOutlineRoot ➔ get_outline_root
- getNamedDestRoot ➔ get_named_dest_root
- addBookmarkDestination ➔ add_bookmark_destination
- addBookmarkDict ➔ add_bookmark_dict
- addBookmark ➔ add_bookmark
- addNamedDestinationObject ➔ add_named_destination_object
- addNamedDestination ➔ add_named_destination
- removeLinks ➔ remove_links
- removeImages(ignoreByteStringObject) ➔ remove_images(ignore_byte_string_object)
- removeText(ignoreByteStringObject) ➔ remove_text(ignore_byte_string_object)
- addURI ➔ add_uri
- addLink ➔ add_link
- getPage(pageNumber) ➔ get_page(page_number)
- getPageLayout / setPageLayout / pageLayout ➔ page_layout attribute
- getPageMode / setPageMode / pageMode ➔ page_mode attribute
- _addObject ➔ _add_object
- _addPage ➔ _add_page
- _sweepIndirectReferences ➔ _sweep_indirect_references
PdfMerger class
-
__init__
parameter: strict=True ➔ strict=False (the PdfFileMerger still has the old default) - addMetadata ➔ add_metadata
- addNamedDestination ➔ add_named_destination
- setPageLayout ➔ set_page_layout
- setPageMode ➔ set_page_mode
Page class:
- artBox / bleedBox/ cropBox/ mediaBox / trimBox ➔ artbox / bleedbox/ cropbox/ mediabox / trimbox
- getWidth, getHeight ➔ width / height
- getLowerLeft_x / getUpperLeft_x ➔ left
- getUpperRight_x / getLowerRight_x ➔ right
- getLowerLeft_y / getLowerRight_y ➔ bottom
- getUpperRight_y / getUpperLeft_y ➔ top
- getLowerLeft / setLowerLeft ➔ lower_left property
- upperRight ➔ upper_right
- mergePage ➔ merge_page
- rotateClockwise / rotateCounterClockwise ➔ rotate_clockwise
- _mergeResources ➔ _merge_resources
- _contentStreamRename ➔ _content_stream_rename
- _pushPopGS ➔ _push_pop_gs
- _addTransformationMatrix ➔ _add_transformation_matrix
- _mergePage ➔ _merge_page
XmpInformation class:
- getElement(..., aboutUri, ...) ➔ get_element(..., about_uri, ...)
- getNodesInNamespace(..., aboutUri, ...) ➔ get_nodes_in_namespace(..., aboutUri, ...)
- _getText ➔ _get_text
utils.py:
- matrixMultiply ➔ matrix_multiply
- RC4_encrypt is moved to the security module
What's Changed
- MAINT: Remove IronPython Fallback for zlib by @MartinThoma in https://github.com/py-pdf/PyPDF2/pull/868
- DEP: Class, variable, and module names by @MartinThoma in https://github.com/py-pdf/PyPDF2/pull/867
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.12...1.28.0
v1.27.12
: Version 1.27.12, 2022-05-02
What's Changed
Bug Fixes (BUG)
- _rebuild_xref_table expects trailer to be a dict (#857)
Documentation (DOC)
- Security Policy
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.11...1.27.12
v1.27.11
: Version 1.27.11, 2022-05-02
What's Changed
Bug Fixes (BUG)
- Incorrectly issued xref warning/exception (#855)
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.10...1.27.11
v1.27.10
: Version 1.27.10, 2022-05-01
What's Changed
Robustness (ROB)
- Handle missing destinations in reader (#840)
- warn-only in readStringFromStream (#837)
- Fix corruption in startxref or xref table (#788 and #830)
Documentation (DOC)
- Project Governance (#799)
- History of PyPDF2
- PDF feature/version support (#816)
- More details on text parsing issues (#815)
Developer Experience (DEV)
- Add benchmark command to Makefile
- Ignore IronPython parts for code coverage (#826)
Maintenance (MAINT)
- Split pdf module (#836)
- Separated CCITTFax param parsing/decoding (#841)
- Update requirements files
Testing (TST)
- Use external repository for larger/more PDFs for testing (#820)
- Swap incorrect test names (#838)
- Add test for PdfFileReader and page properties (#835)
- Add tests for PyPDF2.generic (#831)
- Add tests for utils, form fields, PageRange (#827)
- Add test for ASCII85Decode (#825)
- Add test for FlateDecode (#823)
- Add test for filters.ASCIIHexDecode (#822)
Code Style (STY)
- Apply pre-commit (black, isort) + use snake_case variables (#832)
- Remove debug code (#828)
- Documentation, Variable names (#839)
New Contributors
- @pubpub-zz made their first contribution in https://github.com/py-pdf/PyPDF2/pull/788
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.9...1.27.10
v1.27.9
: Version 1.27.9, 2022-04-24
What's Changed
A change I would like to highlight is the performance improvement for large PDF files (#808 by @dsk7)
New Features (ENH)
- Add papersizes (#800)
- Allow setting permission flags when encrypting (#803)
- Allow setting form field flags (#802)
Bug Fixes (BUG)
- TypeError in xmp._converter_date (#813)
- Improve spacing for text extraction (#806)
- Fix PDFDocEncoding Character Set (#809)
Robustness (ROB)
Documentation (DOC)
Developer Experience (DEV)
- Add Benchmark for Performance Testing (#781)
Maintenance (MAINT)
- Validate PDF magic byte in strict mode (#814)
- Make PdfFileMerger.addBookmark() behave life PdfFileWriters' (#339)
- Quadratic runtime while parsing reduced to linear (#808)
Testing (TST)
- Newlines in text extraction (#807)
New Contributors
- @dsk7 made their first contribution in https://github.com/py-pdf/PyPDF2/pull/808
- @khalida made their first contribution in https://github.com/py-pdf/PyPDF2/pull/339
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.8...1.27.9
v1.27.8
: Version 1.27.8, 2022-04-21
What's Changed
Bug Fixes (BUG)
- Use 1MB as offset for readNextEndLine (#321)
- 'PdfFileWriter' object has no attribute 'stream' (#787)
Robustness (ROB)
- Invalid float object; use 0 as fallback (#782)
Documentation (DOC)
- Robustness (#785)
New Contributors
- @akolpakov made their first contribution in https://github.com/py-pdf/PyPDF2/pull/321
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.7...1.27.8
v1.27.7
: Version 1.27.7, 2022-04-19
What's Changed
Bug Fixes (BUG)
- Import exceptions from PyPDF2.errors in PyPDF2.utils (#780)
Code Style (STY)
- Naming in 'make_changelog.py'
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.6...1.27.7
v1.27.6
: Version 1.27.6, 2022-04-18
What changed
Deprecations (DEP)
- Remove support for Python 2.6 and older (#776)
New Features (ENH)
- Extract document permissions (#320)
Bug Fixes (BUG)
- Clip by trimBox when merging pages, which would otherwise be ignored (#240)
- Add overwriteWarnings parameter PdfFileMerger (#243)
- IndexError for getPage() of decryped file (#359)
- Handle cases where decodeParms is an ArrayObject (#405)
- Updated PDF fields don't show up when page is written (#412)
- Set Linked Form Value (#414)
- Fix zlib -5 error for corrupt files (#603)
- Fix reading more than last1K for EOF (#642)
- Acciental import
Robustness (ROB)
- Allow extra whitespace before "obj" in readObjectHeader (#567)
Documentation (DOC)
Developer Experience (DEV)
- Add issue templates (#765)
- Add tool to generate changelog
Maintenance (MAINT)
- Use grouped constants instead of string literals (#745)
- Add error module (#768)
- Use decorators for @staticmethod (#775)
- Split long functions (#777)
Testing (TST)
- Run tests in CI once with -OO Flags (#770)
- Filling out forms (#771)
- Add tests for Writer (#772)
- Error cases (#773)
- Check Error messages (#769)
- Regression test for issue #88
- Regression test for issue #327
Code Style (STY)
- Make variable naming more consistent in tests
New Contributors
- @denis-osipov made their first contribution in https://github.com/py-pdf/PyPDF2/pull/359
- @malthejorgensen made their first contribution in https://github.com/py-pdf/PyPDF2/pull/567
- @forrestv made their first contribution in https://github.com/py-pdf/PyPDF2/pull/240
- @andrecp made their first contribution in https://github.com/py-pdf/PyPDF2/pull/243
- @jc275 made their first contribution in https://github.com/py-pdf/PyPDF2/pull/405
- @rltpoa made their first contribution in https://github.com/py-pdf/PyPDF2/pull/642
- @vb64 made their first contribution in https://github.com/py-pdf/PyPDF2/pull/628
- @thijsbrouwers made their first contribution in https://github.com/py-pdf/PyPDF2/pull/603
- @malvidin made their first contribution in https://github.com/py-pdf/PyPDF2/pull/414
- @mwhit74 made their first contribution in https://github.com/py-pdf/PyPDF2/pull/412
Full Changelog: https://github.com/py-pdf/PyPDF2/compare/1.27.5...1.27.6
v1.27.5
: Version 1.27.5, 2022-04-15
Security (SEC)
- ContentStream_readInlineImage had potential infinite loop (#740)
Bug fixes (BUG)
Robustness improvements (ROBUST)
- title sometimes None (#744)
Documentation (DOC)
- Adjust short description of the package
Tests and Test setup (TST)
- Rewrite JS tests from unittest to pytest (#746)
- Increase Test coverage, mainly with filters (#756)
- Add test for inline images (#758)
Developer Experience Improvements (DEV)
Miscellaneous
- STY: Closing file handles, explicit exports, ... (#743)
All changes: https://github.com/py-pdf/PyPDF2/compare/1.27.4...1.27.5
v1.27.4
v1.27.3
v1.27.2
v1.27.1
v1.27.0
: Version 1.27.0
Features
- Add alpha channel support for png files in Script (#614)
Bug fixes (BUG)
- Fix formatWarning for filename without slash (#612)
- Add whitespace between words for extractText() (#569, #334)
- "invalid escape sequence" SyntaxError (#522)
- Avoid error when printing warning in pythonw (#486)
- Stream operations can be List or Dict (#665)
Documentation (DOC)
Tests and Test setup (TST)
- Add Github Action which automatically run unit tests via pytest and static code analysis with Flake8 (#660)
- Add several unit tests (#661, #663)
- Add .coveragerc to create coverage reports
Developer Experience Improvements (DEV)
- Pre commit: Developers can now
pre-commit install
to avoid tiny issues like trailing whitespaces
Miscallenious
- Add the LICENSE file to the distributed packages (#288)
- Use setuptools instead of distutils (#599)
- Improvements for the PyPI page (#644)
- Python 3 changes (#504, #366)
You can see the full changelog at: https://github.com/mstamy2/PyPDF2/compare/1.26.0...1.27.0
Configuration
-
If you want to rebase/retry this MR, check this box
This MR has been generated by Renovate Bot.