py-pdf/pypdf

14.4

Adjusted Score

14.4

Raw Score

100%

Time Factor

2026-08-28

Last Push

10.2K

Stars

Python

Language

84.9K

Lines of Code

181

Files

1.2K

Pattern Hits

2026-08-29

Scan Date

0.14

HC Hit Rate

What These Metrics Mean

Adjusted Score: Primary synthetic code indicator. Raw score normalised per 1,000 lines of code and multiplied by the temporal discount factor. This is the definitive comparative metric — use it to rank repositories by AI authorship density.
Raw Score: The unmodified sum of all severity-weighted, context-multiplied pattern match scores before temporal discounting. Reflects the absolute signal strength independent of when the repository was last active.
Time Factor: The temporal discount multiplier (0–100%) applied to the raw score. Repositories last updated before ChatGPT's launch (Nov 2022) receive a 5% factor. Full signal is only assigned to repositories active in the post-adoption era (Jan 2024+).
Pattern Hits: Total count of individual pattern matches across all files and categories. A high hit count with a low score may indicate a very large codebase with isolated AI snippets; a low count with a high score indicates dense, concentrated AI signatures.
HC Hit Rate: High+Critical pattern hits per file, averaged across the repository. This orthogonal signal catches repositories where a few files are densely packed with high-severity AI tells — a strong indicator even when the normalised score appears moderate due to codebase size.
Lines of Code / Files: Total lines and files analysed. The scanner examines 94 file extensions. These denominators are used to normalise the score, enabling fair comparison between repositories of vastly different sizes.

Score History

This chart maps the temporal evolution of the adjusted synthetic code score across successive scan runs. An upward trajectory indicates ongoing incorporation of AI-generated code or expanding LLM-assisted scaffolding; a stable or declining trajectory may reflect active human refactoring, code removal, or the adoption of stricter authorship policies. The dashed secondary line (right axis) independently tracks total raw pattern hit count, which can diverge from the normalised score when codebase size changes significantly between scans.

Severity Breakdown

Classifies detected patterns by their diagnostic confidence and structural impact. CRITICAL patterns (coefficient 10) represent definitive synthetic signatures — hallucinated imports, explicit LLM attribution metadata — virtually never produced by human authors. HIGH (5) indicates strong structural tells such as cross-file repetition or cross-linguistic idioms. MEDIUM (2) covers recognisable conversational padding and AI-specific vocabulary. LOW (1) captures subtle indicators like tautological comments and generic boilerplate that require density to carry independent signal.

CRITICAL 0HIGH 25MEDIUM 39LOW 1117

Directory Score Breakdown

This horizontal bar chart decomposes the repository's raw synthetic code score by top-level directory, allowing you to pinpoint precisely which modules or components carry the highest AI authorship density. Directories with disproportionately high scores relative to their size warrant targeted manual review: concentrated AI signatures often trace back to mass-generated configuration layers, auto-ported test suites, LLM-scaffolded boilerplate classes, or entire subsystems authored under heavy copilot assistance. Use this view to prioritise your human code-review effort.

Pattern Findings

The scanner identified 1181 distinct pattern matches across 20 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a statistically significant AI authorship indicator. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.

Reading the findings table: The Severity column indicates the diagnostic confidence level (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — comment-context matches receive a ×1.5 weight because LLMs systematically over-annotate. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier as dense clusters constitute far stronger evidence of synthetic authorship than isolated hits.

Hyper-Verbose Identifiers741 hits · 622 pts

Severity	File	Line	Snippet	Context
LOW	make_release.py	332	def get_git_commits_since_tag(git_tag: str) -> list[Change]:	CODE
LOW	tests/test_forms.py	12	def test_form_button__v_value_should_be_name_object():	CODE
LOW	tests/test_workflows.py	116	def test_pdfreader_jpeg_image():	CODE
LOW⚡	tests/test_workflows.py	154	def test_text_extraction_encrypted():	CODE
LOW	tests/test_workflows.py	267	def test_transform_compress_identical_objects():	CODE
LOW	tests/test_workflows.py	572	def test_get_fields_no_warning(tmp_path, url, name):	CODE
LOW	tests/test_workflows.py	583	def test_scale_rectangle_indirect_object():	CODE
LOW	tests/test_workflows.py	694	def test_image_extraction_strict():	CODE
LOW	tests/test_workflows.py	887	def test_tounicode_is_identity():	CODE
LOW	tests/test_workflows.py	951	def test_fields_returning_stream():	CODE
LOW	tests/test_workflows.py	1070	def test_cr_with_cm_operation():	CODE
LOW	tests/test_workflows.py	1087	def remove_trailing_whitespace(text: str) -> str:	CODE
LOW	tests/test_workflows.py	1106	def test_text_extraction_layout_mode(pdf_path, expected_path):	CODE
LOW	tests/test_workflows.py	1115	def test_layout_mode_space_vertically():	CODE
LOW	tests/test_workflows.py	1130	def test_layout_mode_rotations(rotation, strip_rotated):	CODE
LOW	tests/test_workflows.py	1148	def test_text_extraction_invalid_mode():	CODE
LOW	tests/test_workflows.py	1156	def test_get_page_showing_field():	CODE
LOW⚡	tests/test_reader.py	1517	def test_outline_with_missing_named_destination():	CODE
LOW⚡	tests/test_reader.py	1526	def test_outline_with_empty_action():	CODE
LOW⚡	tests/test_reader.py	1535	def test_outline_with_invalid_destinations():	CODE
LOW⚡	tests/test_reader.py	1543	def test_pdfreader_multiple_definitions(caplog):	CODE
LOW⚡	tests/test_reader.py	1554	def test_wrong_password_error():	CODE
LOW⚡	tests/test_reader.py	1563	def test_get_page_number_by_indirect():	CODE
LOW⚡	tests/test_reader.py	1569	def test_corrupted_xref_table():	CODE
LOW	tests/test_reader.py	379	def test_startxref_corrupt_trailing_pointer(caplog):	CODE
LOW	tests/test_reader.py	433	def test_find_previous_startxref_pos_recovery_variants():	CODE
LOW	tests/test_reader.py	473	def test_duplicate_eof_markers(caplog, suffix, duplicates, strict):	CODE
LOW	tests/test_reader.py	501	def test_duplicate_eof_markers_without_startxref(pdf_data):	CODE
LOW	tests/test_reader.py	516	def test_get_page_of_encrypted_file(pdffile, password, should_fail):	CODE
LOW	tests/test_reader.py	584	def test_reading_choice_field_without_opt_key():	CODE
LOW	tests/test_reader.py	642	def test_read_malformed_header(caplog):	CODE
LOW	tests/test_reader.py	699	def test_circular_xref_prev_reference(caplog):	CODE
LOW	tests/test_reader.py	1033	def test_user_access_permissions():	CODE
LOW	tests/test_reader.py	1098	def test_convert_to_int_error():	CODE
LOW	tests/test_reader.py	1124	def test_extract_text_hello_world():	CODE
LOW	tests/test_reader.py	1149	def test_read_not_binary_mode(caplog):	CODE
LOW	tests/test_reader.py	1171	def test_form_topname_with_and_without_acroform(caplog):	CODE
LOW	tests/test_reader.py	1259	def test_get_full_qualified_fields():	CODE
LOW	tests/test_reader.py	1280	def test_get_fields_read_else_block():	CODE
LOW	tests/test_reader.py	1313	def test_get_fields_read_write_report(txt_file_path):	CODE
LOW	tests/test_reader.py	1481	def test_outline_missing_title(caplog):	CODE
LOW	tests/test_reader.py	1788	def test_xyz_with_missing_param():	CODE
LOW	tests/test_reader.py	1856	def test_context_manager_with_stream():	CODE
LOW	tests/test_reader.py	1953	def test_space_in_names_to_continue_processing(caplog):	CODE
LOW	tests/test_reader.py	1999	def test_unbalanced_brackets_in_dictionary_object(caplog):	CODE
LOW	tests/test_reader.py	2110	def test_infinite_loop_for_length_value():	CODE
LOW	tests/test_reader.py	2123	def test_trailer_cannot_be_read():	CODE
LOW	tests/test_reader.py	2147	def test_read_standard_xref_table__two_whitespace_characters_between_offset_and_generation():	CODE
LOW	tests/test_reader.py	2157	def test_read_standard_xref_table__entry_invalid_but_object_found(caplog):	CODE
LOW	tests/test_reader.py	2184	def test_root_object_recovery_limit(caplog):	CODE
LOW	tests/test_reader.py	2227	def test_rebuild_xref_table__speed():	CODE
LOW	tests/test_reader.py	2241	def test_rebuild_xref_table_with_cross_reference_stream(caplog, strict):	CODE
LOW	tests/test_reader.py	2338	def test_cache_indirect_object_strict_overwrite_error():	CODE
LOW	tests/test_reader.py	2346	def test_objstm_batch_parse_caches_all_objects():	CODE
LOW	tests/test_reader.py	2360	def test_objstm_cache_hit_returns_target():	CODE
LOW	tests/test_reader.py	2375	def test_objstm_skips_cache_for_overridden_objects():	CODE
LOW	tests/test_reader.py	2394	def test_objstm_does_not_cache_stale_objects_from_non_authoritative_stream():	CODE
LOW	tests/test_reader.py	2483	def test_xref_table_with_comments_before_trailer():	CODE
LOW	tests/test_reader.py	2573	def test_get_object_from_stream__size_limit(caplog):	CODE
LOW	tests/test_reader.py	2623	def test_named_destinations_cache():	CODE
681 more matches not shown…

Unused Imports105 hits · 91 pts

Severity	File	Line	Context
LOW	pypdf/__init__.py	11	CODE
LOW	pypdf/__init__.py	12	CODE
LOW	pypdf/__init__.py	13	CODE
LOW	pypdf/__init__.py	13	CODE
LOW	pypdf/__init__.py	14	CODE
LOW	pypdf/__init__.py	15	CODE
LOW	pypdf/__init__.py	17	CODE
LOW	pypdf/__init__.py	17	CODE
LOW	pypdf/__init__.py	18	CODE
LOW	pypdf/__init__.py	19	CODE
LOW	pypdf/__init__.py	19	CODE
LOW	pypdf/__init__.py	20	CODE
LOW	pypdf/_font.py	1	CODE
LOW	pypdf/_crypt_providers/__init__.py	28	CODE
LOW	pypdf/_crypt_providers/__init__.py	28	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	31	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	44	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/_crypt_providers/__init__.py	56	CODE
LOW	pypdf/annotations/__init__.py	14	CODE
LOW	pypdf/annotations/__init__.py	14	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	15	CODE
LOW	pypdf/annotations/__init__.py	26	CODE
LOW	pypdf/annotations/__init__.py	26	CODE
LOW	pypdf/_text_extraction/_layout_mode/__init__.py	2	CODE
LOW	pypdf/_text_extraction/_layout_mode/__init__.py	3	CODE
LOW	pypdf/_text_extraction/_layout_mode/__init__.py	3	CODE
LOW	pypdf/_text_extraction/_layout_mode/__init__.py	3	CODE
LOW	pypdf/_text_extraction/_layout_mode/__init__.py	3	CODE
45 more matches not shown…

Deep Nesting87 hits · 73 pts

Severity	File	Line	Context
LOW	resources/afm_to_dataclass.py	23	CODE
LOW	resources/afm_to_dataclass.py	50	CODE
LOW	tests/test_workflows.py	668	CODE
LOW	tests/test_reader.py	171	CODE
LOW	tests/test_reader.py	188	CODE
LOW	tests/test_font.py	139	CODE
LOW	tests/utils.py	111	CODE
LOW	pypdf/_page_labels.py	190	CODE
LOW	pypdf/_encryption.py	73	CODE
LOW	pypdf/_encryption.py	96	CODE
LOW	pypdf/_encryption.py	1045	CODE
LOW	pypdf/_writer.py	763	CODE
LOW	pypdf/_writer.py	951	CODE
LOW	pypdf/_writer.py	1450	CODE
LOW	pypdf/_writer.py	1838	CODE
LOW	pypdf/_writer.py	2000	CODE
LOW	pypdf/_writer.py	2126	CODE
LOW	pypdf/_writer.py	2233	CODE
LOW	pypdf/_writer.py	2572	CODE
LOW	pypdf/_writer.py	2694	CODE
LOW	pypdf/_writer.py	2850	CODE
LOW	pypdf/_writer.py	3022	CODE
LOW	pypdf/_writer.py	3221	CODE
LOW	pypdf/_reader.py	454	CODE
LOW	pypdf/_reader.py	673	CODE
LOW	pypdf/_reader.py	906	CODE
LOW	pypdf/_reader.py	1040	CODE
LOW	pypdf/_reader.py	1175	CODE
LOW	pypdf/_reader.py	1364	CODE
LOW	pypdf/_reader.py	1439	CODE
LOW	pypdf/xmp.py	273	CODE
LOW	pypdf/xmp.py	357	CODE
LOW	pypdf/xmp.py	631	CODE
LOW	pypdf/_page.py	830	CODE
LOW	pypdf/_page.py	976	CODE
LOW	pypdf/_page.py	1058	CODE
LOW	pypdf/_page.py	1658	CODE
LOW	pypdf/_page.py	1815	CODE
LOW	pypdf/_page.py	2134	CODE
LOW	pypdf/_doc_common.py	465	CODE
LOW	pypdf/_doc_common.py	658	CODE
LOW	pypdf/_doc_common.py	723	CODE
LOW	pypdf/_doc_common.py	798	CODE
LOW	pypdf/_doc_common.py	1069	CODE
LOW	pypdf/_doc_common.py	1241	CODE
LOW	pypdf/_doc_common.py	1490	CODE
LOW	pypdf/_doc_common.py	1548	CODE
LOW	pypdf/_font.py	367	CODE
LOW	pypdf/_font.py	513	CODE
LOW	pypdf/_font.py	634	CODE
LOW	pypdf/_cmap.py	63	CODE
LOW	pypdf/_cmap.py	205	CODE
LOW	pypdf/_cmap.py	278	CODE
LOW	pypdf/_cmap.py	372	CODE
LOW	pypdf/filters.py	101	CODE
LOW	pypdf/filters.py	812	CODE
LOW	pypdf/filters.py	174	CODE
LOW	pypdf/filters.py	268	CODE
LOW	pypdf/filters.py	420	CODE
LOW	pypdf/filters.py	646	CODE
27 more matches not shown…

Docstring Block Structure14 hits · 70 pts

Severity	File	Line	Snippet	Context
HIGH	make_release.py	364	Parse the first line of a git commit message. Args: line: The first line of a git commit message.	STRING
HIGH	docs/dev/documentation.md	48	Example function with PEP 484 type annotations. Args: param1: The first parameter. param2: The sec	STRING
HIGH	pypdf/_encryption.py	788	Apply the SASLprep profile (RFC 4013) of stringprep (RFC 3454). This normalizes Unicode passwords for PDF 2.0	STRING
HIGH	pypdf/_writer.py	694	Append a blank page to this PDF file and return it. If no page size is specified, use the size of the	STRING
HIGH	pypdf/_writer.py	722	Insert a blank page to this PDF file and return it. If no page size is specified for a dimension, use	STRING
HIGH	pypdf/_page.py	594	Return a new blank page. If ``width`` or ``height`` is ``None``, try to get the page size from	STRING
HIGH	pypdf/filters.py	179	Decode data which is flate-encoded. Args: data: Flate-encoded data. decode_parms:	STRING
HIGH	pypdf/filters.py	359	Decode an ASCII-Hex encoded data stream. Args: data: a str sequence of hexadecimal-encoded v	STRING
HIGH	pypdf/filters.py	425	Decode a run length encoded data stream. Args: data: a bytes sequence of length/data	STRING
HIGH	pypdf/filters.py	813	Decode the stream data based on the specified filters. This function decodes the stream data using the filters	STRING
HIGH	…f/_text_extraction/_layout_mode/_text_state_manager.py	80	Create a TextStateParams instance to display a text string. Type[bytes] values will be decoded implicit	STRING
HIGH	pypdf/generic/_image_xobject.py	567	Users need to have the pillow package installed. It's unclear if pypdf will keep this function here, hence it'	STRING
HIGH	pypdf/generic/_data_structures.py	1114	Try to decode the stream object as an image Args: pillow_parameters: parameters provided t	STRING
HIGH	pypdf/generic/_utils.py	134	Create a ByteStringObject or a TextStringObject from a string to represent the string. Args: string: T	STRING

Self-Referential Comments22 hits · 66 pts

Severity	File	Line	Snippet	Context
MEDIUM	resources/afm_to_dataclass.py	39	"# This file is based upon the 14 core AFM files provided by Adobe/Macromedia at\n# " +	CODE
MEDIUM	tests/test_generic.py	999	# Create a weak reference to the underlying object to test later	COMMENT
MEDIUM	tests/test_generic.py	1027	# Create a weak reference to the underlying object to test later	COMMENT
MEDIUM	tests/generic/test_data_structures.py	146	# Create a single child A as the /First (and /Last)	COMMENT
MEDIUM	.github/workflows/release.yaml	30	contents: write # Create the actual release.	CODE
MEDIUM	pypdf/_writer.py	892	# Create a new StreamObject for the new_content_data	COMMENT
MEDIUM	pypdf/_writer.py	905	# Create a new StreamObject in a new /Contents entry.	COMMENT
MEDIUM	pypdf/_writer.py	2736	# Create a new PdfReader instance using the stream	COMMENT
MEDIUM	pypdf/_font.py	766	# Create the descendant font object	COMMENT
MEDIUM	pypdf/_font.py	782	# Create the Type 0 font object	COMMENT
MEDIUM	pypdf/filters.py	631	# Create an alias for the old class name	COMMENT
MEDIUM	pypdf/_utils.py	547	# The following class has been copied from Django:	COMMENT
MEDIUM	pypdf/generic/_files.py	80	# Create the file entry (the actual embedded file stream)	COMMENT
MEDIUM	pypdf/generic/_files.py	89	# Create the filespec dictionary	COMMENT
MEDIUM	pypdf/generic/_appearance_stream.py	96	# Define the rotation matrix	COMMENT
MEDIUM	pypdf/generic/_appearance_stream.py	689	# Create a default appearance if none was found in the annotation	COMMENT
MEDIUM	pypdf/generic/_appearance_stream.py	766	# Create the TextStreamAppearance instance	COMMENT
MEDIUM	pypdf/generic/_link.py	28	# This module contains code used by _writer.py to track links in pages	COMMENT
MEDIUM⚡	pypdf/_codecs/core_font_metrics.py	1	# This file is based upon the 14 core AFM files provided by Adobe/Macromedia at	COMMENT
MEDIUM	pypdf/_codecs/symbol.py	10	# This file is provided as-is by Unicode, Inc. (The Unicode Consortium). No	COMMENT
MEDIUM	pypdf/_codecs/_codecs.py	180	# The following method has been converted to Python from PDFsharp:	COMMENT
MEDIUM	pypdf/_codecs/zapfding.py	10	# This file is provided as-is by Unicode, Inc. (The Unicode Consortium). No	COMMENT

Excessive Try-Catch Wrapping56 hits · 54 pts

Severity	File	Line	Snippet	Context
LOW	make_release.py	104	except Exception:	CODE
LOW	tests/test_reader.py	649	except Exception:	CODE
LOW	tests/test_page.py	67	except Exception:	CODE
LOW	docs/user/suppress-warnings.md	45	except Exception as exc:	CODE
LOW	docs/user/extract-images.md	69	except Exception as exception:	CODE
LOW	.github/scripts/check_urls.py	52	except Exception as exception:	CODE
LOW	.github/scripts/check_gh_pages_updates.py	66	except Exception as e:	CODE
LOW	.github/scripts/check_gh_pages_updates.py	82	except Exception as e:	CODE
LOW	pypdf/_encryption.py	1068	except Exception:	CODE
MEDIUM	pypdf/_writer.py	2367	def _get_page_layout(self) -> Optional[LayoutType]:	CODE
LOW	pypdf/_writer.py	531	except Exception:	CODE
LOW	pypdf/_writer.py	599	except Exception as exc: # pragma: no cover	CODE
LOW	pypdf/_writer.py	3019	except Exception:	CODE
LOW	pypdf/_writer.py	3239	except Exception:	CODE
LOW	pypdf/_writer.py	3244	except Exception:	CODE
LOW	pypdf/_reader.py	243	except Exception: # to be sure to capture all errors	CODE
LOW	pypdf/_reader.py	486	except Exception:	CODE
LOW	pypdf/_reader.py	970	except Exception:	CODE
LOW	pypdf/_reader.py	1014	except Exception:	CODE
LOW	pypdf/_reader.py	1018	except Exception:	CODE
LOW	pypdf/_reader.py	1070	except Exception:	CODE
LOW	pypdf/_reader.py	1075	except Exception as e:	CODE
LOW	pypdf/_reader.py	1123	except Exception:	CODE
LOW	pypdf/_reader.py	1171	except Exception:	CODE
LOW	pypdf/_reader.py	1426	except Exception: # could be multiple causes	CODE
LOW	pypdf/_page.py	1797	except Exception:	CODE
LOW	pypdf/_page.py	1808	except Exception:	CODE
LOW	pypdf/_page.py	1960	except Exception as exception:	CODE
LOW	pypdf/_page.py	2497	except Exception: # pragma: no cover	CODE
LOW	pypdf/_doc_common.py	823	except Exception as exc:	CODE
LOW	pypdf/_doc_common.py	883	except Exception as exc:	CODE
LOW	pypdf/_cmap.py	97	except Exception:	CODE
LOW	pypdf/_cmap.py	103	except Exception:	CODE
LOW	pypdf/_cmap.py	121	except Exception:	CODE
LOW	pypdf/_text_extraction/__init__.py	164	except Exception:	CODE
LOW	pypdf/_text_extraction/__init__.py	196	except Exception:	CODE
LOW	pypdf/_text_extraction/_text_extractor.py	250	except Exception:	CODE
LOW	pypdf/_text_extraction/_text_extractor.py	261	except Exception:	CODE
LOW	pypdf/_text_extraction/_text_extractor.py	306	except Exception:	CODE
LOW	pypdf/generic/_base.py	162	except Exception:	CODE
LOW	pypdf/generic/_base.py	496	except Exception as e:	CODE
LOW	pypdf/generic/_base.py	921	except Exception:	CODE
LOW	pypdf/generic/_image_xobject.py	723	except Exception as exception:	CODE
LOW⚡	pypdf/generic/_data_structures.py	1786	except Exception:	CODE
LOW⚡	pypdf/generic/_data_structures.py	1791	except Exception:	CODE
LOW	pypdf/generic/_data_structures.py	127	except Exception:	CODE
LOW	pypdf/generic/_data_structures.py	300	except Exception:	CODE
LOW	pypdf/generic/_data_structures.py	405	except Exception:	CODE
LOW	pypdf/generic/_data_structures.py	625	except Exception as exc:	CODE
LOW	pypdf/generic/_data_structures.py	843	except Exception: # it means we are inserting in first position	CODE
LOW	pypdf/generic/_data_structures.py	989	except Exception:	CODE
LOW	pypdf/generic/_data_structures.py	1025	except Exception:	CODE
LOW	pypdf/generic/_data_structures.py	1291	except Exception:	CODE
LOW	pypdf/generic/_data_structures.py	1325	except Exception:	CODE
LOW	pypdf/generic/_utils.py	156	except Exception:	CODE
LOW	pypdf/_codecs/__init__.py	13	except Exception:	CODE

Over-Commented Block53 hits · 52 pts

Severity	File	Line	Snippet	Context
LOW	tests/test_text_extraction.py	821	NameObject("/Type"): NameObject("/Font"),	COMMENT
LOW	tests/test_encryption.py	41	# qpdf --encrypt "" "asdfzxcv" 40 -- unencrypted.pdf r2-owner-password.pdf	COMMENT
LOW	requirements/dev.txt	1	#	COMMENT
LOW	requirements/dev.txt	41	packaging==24.1	COMMENT
LOW	requirements/dev.txt	61	# via pytest-cov	COMMENT
LOW	requirements/dev.txt	81	# via pre-commit	COMMENT
LOW	requirements/ci.txt	1	#	COMMENT
LOW	requirements/ci.txt	21	fonttools==4.60.2	COMMENT
LOW	requirements/ci.txt	41	pycparser==2.22	COMMENT
LOW	requirements/ci.txt	61	pytest-xdist==3.6.1	COMMENT
LOW	requirements/ci-3.11.txt	1	#	COMMENT
LOW	requirements/ci-3.11.txt	21	execnet==2.1.1	COMMENT
LOW	requirements/ci-3.11.txt	41	pluggy==1.5.0	COMMENT
LOW	requirements/ci-3.11.txt	61	pytest-socket==0.7.0	COMMENT
LOW	requirements/ci-3.11.txt	81	# via -r requirements/ci.in	COMMENT
LOW	requirements/docs.txt	1	#	COMMENT
LOW	requirements/docs.txt	21	# via requests	COMMENT
LOW	requirements/docs.txt	41	# via sphinx	COMMENT
LOW	docs/conf.py	141	# To execute these examples real files need to be read and written.	COMMENT
LOW	pypdf/_encryption.py	1	# Copyright (c) 2022, exiledkingcc	COMMENT
LOW	pypdf/_writer.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/_reader.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/_reader.py	941	while cnt < size:	COMMENT
LOW	pypdf/xmp.py	41	# It's documented here: https://github.com/adobe/xmp-docs/raw/master/XMPSpecifications/XMPSpecificationPart3.pdf	COMMENT
LOW	pypdf/_page.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/_doc_common.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/filters.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/filters.py	121	"""	COMMENT
LOW	pypdf/_utils.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/_utils.py	541	return f"{bytes / 10**3:.1f} kB"	COMMENT
LOW	pypdf/_utils.py	561	# this list of conditions and the following disclaimer.	COMMENT
LOW	pypdf/_crypt_providers/_base.py	1	# Copyright (c) 2023, exiledkingcc	COMMENT
LOW	pypdf/_crypt_providers/_cryptography.py	1	# Copyright (c) 2023, exiledkingcc	COMMENT
LOW	pypdf/_crypt_providers/__init__.py	1	# Copyright (c) 2023, exiledkingcc	COMMENT
LOW	pypdf/_crypt_providers/_pycryptodome.py	1	# Copyright (c) 2023, exiledkingcc	COMMENT
LOW	pypdf/_crypt_providers/_fallback.py	1	# Copyright (c) 2023, exiledkingcc	COMMENT
LOW	pypdf/_text_extraction/_text_extractor.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/generic/_base.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/generic/_viewerpref.py	1	# Copyright (c) 2023, Pubpub-ZZ	COMMENT
LOW	pypdf/generic/__init__.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/generic/_image_inline.py	1	# Copyright (c) 2024, pypdf contributors	COMMENT
LOW	pypdf/generic/_data_structures.py	1	# Copyright (c) 2006, Mathieu Fenniak	COMMENT
LOW	pypdf/generic/_link.py	1	# All rights reserved.	COMMENT
LOW	pypdf/_codecs/adobe_glyphs.py	1	# Generated from https://github.com/adobe-type-tools/agl-aglfn/blob/4036a9ca80a62f64f9de4f7321a9a045ad0ecfd6/glyphlist.t	COMMENT
LOW	pypdf/_codecs/adobe_glyphs.py	21	# provided with the distribution.	COMMENT
LOW	pypdf/_codecs/adobe_glyphs.py	41	# -----------------------------------------------------------------------------	COMMENT
LOW	pypdf/_codecs/adobe_glyphs.py	61	# 2. Redistributions in binary form must reproduce the above copyright notice,	COMMENT
LOW	pypdf/_codecs/adobe_glyphs.py	81	#	COMMENT
LOW	pypdf/_codecs/adobe_glyphs.py	101	# the rights to use, copy, modify, merge, publish, distribute, and/or sell	COMMENT
LOW	pypdf/_codecs/core_font_metrics.py	1	# This file is based upon the 14 core AFM files provided by Adobe/Macromedia at	COMMENT
LOW	pypdf/_codecs/symbol.py	1	# Generated from https://www.unicode.org/Public/MAPPINGS/VENDORS/ADOBE/symbol.txt	COMMENT
LOW	pypdf/_codecs/_codecs.py	181	# https://github.com/empira/PDFsharp/blob/5fbf6ed14740bc4e16786816882d32e43af3ff5d/src/foundation/src/PDFsharp/src/P	COMMENT
LOW	pypdf/_codecs/zapfding.py	1	# Generated from https://www.unicode.org/Public/MAPPINGS/VENDORS/ADOBE/zdingbat.txt	COMMENT

Fake / Example Data29 hits · 40 pts

Severity	File	Line	Snippet	Context
LOW	resources/multicolumn-lorem-ipsum.txt	1	Two-Column Document with Lorem Ipsum	CODE
LOW	resources/multicolumn-lorem-ipsum.txt	9	with Lorem Ipsum text. nas lacinia. Nam ipsum ligula, eleifend at, accum	CODE
LOW	resources/multicolumn-lorem-ipsum.txt	20	placerat. Integer sapien est, iaculis in, pretium quis, ipsum dolor sit amet, consectetuer adipiscing elit	CODE
LOW⚡	tests/test_workflows.py	163	.startswith("Lorem ipsum dolor sit amet")	CODE
LOW⚡	tests/test_workflows.py	163	.startswith("Lorem ipsum dolor sit amet")	CODE
LOW⚡	tests/test_cmap.py	302	assert "Lorem ipsum dolor sit amet" in reader.pages[0].extract_text()	CODE
LOW⚡	tests/test_cmap.py	302	assert "Lorem ipsum dolor sit amet" in reader.pages[0].extract_text()	CODE
LOW	tests/test_cmap.py	328	assert page.extract_text() == "Lorem ipsum"	CODE
LOW⚡	tests/test_writer.py	462	assert "Lorem ipsum dolor sit amet" in extracted_text	CODE
LOW⚡	tests/test_writer.py	462	assert "Lorem ipsum dolor sit amet" in extracted_text	CODE
LOW	tests/test_xmp.py	29	assert xmp.dc_creator == ["John Doe"]	CODE
LOW	tests/test_xmp.py	47	assert xmp.dc_creator == ["John Doe"]	CODE
LOW⚡	tests/generic/test_data_structures.py	216	assert ContentStream(stream=array2, pdf=None).get_data() == b"Lorem ipsum!\nShared stream 0\nShared stream 2\n"	CODE
LOW⚡	tests/generic/test_data_structures.py	223	b"Lorem ipsum!\nShared stream 0\nShared stream 1\nShared stream 2\n"	CODE
LOW	tests/generic/test_data_structures.py	189	stream2.set_data(b"Lorem ipsum!")	CODE
LOW⚡	tests/generic/test_files.py	114	assert attachment.content.startswith(b"Hello World!\n\nLorem ipsum dolor sit amet, ")	CODE
LOW⚡	tests/generic/test_files.py	114	assert attachment.content.startswith(b"Hello World!\n\nLorem ipsum dolor sit amet, ")	CODE
LOW⚡	tests/generic/test_files.py	115	assert attachment.content.endswith(b"\ntakimata sanctus est Lorem ipsum dolor sit amet.\n")	CODE
LOW⚡	tests/generic/test_files.py	115	assert attachment.content.endswith(b"\ntakimata sanctus est Lorem ipsum dolor sit amet.\n")	CODE
LOW⚡	tests/generic/test_files.py	294	embedded_file.content = "Lorem ipsum dolor sit amet"	CODE
LOW⚡	tests/generic/test_files.py	294	embedded_file.content = "Lorem ipsum dolor sit amet"	CODE
LOW⚡	tests/generic/test_files.py	295	assert embedded_file.content == b"Lorem ipsum dolor sit amet"	CODE
LOW⚡	tests/generic/test_files.py	295	assert embedded_file.content == b"Lorem ipsum dolor sit amet"	CODE
LOW⚡	tests/generic/test_files.py	478	b"Hello World!\n\nLorem ipsum dolor sit amet, consetetur sad"	CODE
LOW⚡	tests/generic/test_files.py	478	b"Hello World!\n\nLorem ipsum dolor sit amet, consetetur sad"	CODE
LOW⚡	tests/generic/test_files.py	483	b"t Lorem\nipsum dolor sit amet. Lorem ipsum dolor sit amet"	CODE
LOW⚡	tests/generic/test_files.py	483	b"t Lorem\nipsum dolor sit amet. Lorem ipsum dolor sit amet"	CODE
LOW⚡	tests/generic/test_files.py	488	b"imata sanctus est Lorem ipsum dolor sit amet.\n"	CODE
LOW⚡	tests/generic/test_files.py	488	b"imata sanctus est Lorem ipsum dolor sit amet.\n"	CODE

Cross-File Repetition6 hits · 30 pts

Severity	File	Snippet	Context
HIGH	pypdf/_writer.py	read-only boolean property showing whether this pdf file is encrypted. note that this property, if true, will remain tru	STRING
HIGH	pypdf/_reader.py	read-only boolean property showing whether this pdf file is encrypted. note that this property, if true, will remain tru	STRING
HIGH	pypdf/_doc_common.py	read-only boolean property showing whether this pdf file is encrypted. note that this property, if true, will remain tru	STRING
HIGH	pypdf/_writer.py	integration into jupyter notebooks. this method returns a dictionary that maps a mime-type to its representation. .. see	STRING
HIGH	pypdf/_reader.py	integration into jupyter notebooks. this method returns a dictionary that maps a mime-type to its representation. .. see	STRING
HIGH	pypdf/_doc_common.py	integration into jupyter notebooks. this method returns a dictionary that maps a mime-type to its representation. .. see	STRING

Decorative Section Separators8 hits · 27 pts

Severity	File	Line	Snippet	Context
MEDIUM	pypdf/_utils.py	553	# ---------------------------------------------------------------------------------	COMMENT
MEDIUM	pypdf/_utils.py	581	# ---------------------------------------------------------------------------------	COMMENT
MEDIUM	pypdf/_codecs/adobe_glyphs.py	41	# -----------------------------------------------------------------------------	COMMENT
MEDIUM	pypdf/_codecs/adobe_glyphs.py	80	# -----------------------------------------------------------------------------	COMMENT
MEDIUM⚡	pypdf/_codecs/core_font_metrics.py	5	# -----------------------------------------------------------------------------------------------	COMMENT
MEDIUM⚡	pypdf/_codecs/core_font_metrics.py	14	# -----------------------------------------------------------------------------------------------	COMMENT
MEDIUM	pypdf/_codecs/_codecs.py	185	# -------------------------------------------------------------------------	COMMENT
MEDIUM	pypdf/_codecs/_codecs.py	210	# --------------------------------------------------------------------------	COMMENT

Modern Structural Boilerplate27 hits · 26 pts

Severity	File	Line	Snippet	Context
LOW	pypdf/_writer.py	571	def set_need_appearances_writer(self, state: bool = True) -> None:	CODE
LOW	pypdf/_writer.py	2373	def _set_page_layout(self, layout: Union[NameObject, LayoutType]) -> None:	CODE
LOW	pypdf/_writer.py	2409	def set_page_layout(self, layout: LayoutType) -> None:	CODE
LOW	pypdf/__init__.py	33	__all__ = [	CODE
LOW	pypdf/xmp.py	685	def _set_single_value(self, namespace: str, name: str, value: Optional[str]) -> None:	CODE
LOW	pypdf/xmp.py	709	def _set_bag_values(self, namespace: str, name: str, values: Optional[list[str]]) -> None:	CODE
LOW	pypdf/xmp.py	737	def _set_seq_values(self, namespace: str, name: str, values: Optional[list[str]]) -> None:	CODE
LOW	pypdf/xmp.py	765	def _set_langalt_values(self, namespace: str, name: str, values: Optional[dict[str, str]]) -> None:	CODE
LOW	pypdf/xmp.py	798	def _update_stream(self) -> None:	CODE
LOW	pypdf/_page.py	136	def _set_rectangle(self: Any, name: str, value: Union[RectangleObject, float]) -> None:	CODE
LOW	pypdf/_crypt_providers/__init__.py	68	__all__ = [	CODE
LOW	pypdf/annotations/__init__.py	28	__all__ = [	CODE
LOW	pypdf/_text_extraction/_layout_mode/__init__.py	10	__all__ = [	CODE
LOW	…f/_text_extraction/_layout_mode/_text_state_manager.py	52	def set_state_param(self, op: bytes, value: Union[float, list[Any]]) -> None:	CODE
LOW	…f/_text_extraction/_layout_mode/_text_state_manager.py	67	def set_font(self, font: Font, size: float) -> None:	CODE
LOW	pypdf/actions/__init__.py	13	__all__ = [	CODE
LOW⚡	pypdf/generic/_viewerpref.py	65	def _set_bool(self, key: str, v: bool) -> None:	CODE
LOW⚡	pypdf/generic/_viewerpref.py	71	def _set_name(self, key: str, lst: list[str], v: NameObject) -> None:	CODE
LOW⚡	pypdf/generic/_viewerpref.py	81	def _set_arr(self, key: str, v: Optional[ArrayObject]) -> None:	CODE
LOW	pypdf/generic/_viewerpref.py	101	def _set_int(self, key: str, v: int) -> None:	CODE
LOW	pypdf/generic/__init__.py	75	__all__ = [	CODE
LOW	pypdf/generic/_image_inline.py	42	logger = logging.getLogger(__name__)	CODE
LOW	pypdf/generic/_data_structures.py	96	logger = logging.getLogger(__name__)	CODE
LOW	pypdf/generic/_data_structures.py	1043	def set_data(self, data: bytes) -> None:	CODE
LOW	pypdf/generic/_data_structures.py	1176	def set_data(self, data: bytes) -> None:	CODE
LOW	pypdf/generic/_data_structures.py	1517	def set_data(self, data: bytes) -> None:	CODE
LOW	pypdf/_codecs/__init__.py	49	__all__ = [	CODE

Cross-Language Confusion5 hits · 20 pts

Severity	File	Line	Snippet	Context
HIGH	make_release.py	114	git commit -eF RELEASE_COMMIT_MSG.md && git push	STRING
HIGH	make_release.py	130	git tag -eF RELEASE_TAG_MSG.md && git push	STRING
HIGH	tests/test_writer.py	1963	# "I DO NOT Agree": null,	COMMENT
HIGH	tests/test_filters.py	715	b"/DecodeParms [ null ]"	CODE
HIGH	pypdf/_page.py	2539	that is called 'FontFilex' (where x is null, 2, or 3), then that fontname is	STRING

AI Slop Vocabulary4 hits · 12 pts

Severity	File	Line	Snippet	Context
MEDIUM⚡	tests/test_reader.py	1530	# outline items (entitled Tables and Figures) utilize an empty action (/A)	COMMENT
LOW	pypdf/generic/_image_inline.py	136	# Ideally, we could just use plain run-length decoding here, where 80_16 = 128_10	COMMENT
MEDIUM⚡	pypdf/generic/_data_structures.py	1784	try: # Prefer to be more robust not only to null parameters	CODE
MEDIUM⚡	pypdf/generic/_data_structures.py	1789	try: # Prefer to be more robust not only to null parameters	CODE

Redundant / Tautological Comments7 hits · 10 pts

Severity	File	Line	Snippet	Context
LOW	tests/test_images.py	69	# Check if the images have the same dimensions	COMMENT
LOW	tests/test_images.py	73	# Check if the color modes are the same	COMMENT
LOW	tests/test_writer.py	589	# Check if the title was set	COMMENT
LOW	tests/test_merger.py	129	# Check if outline is correct	COMMENT
LOW	tests/bench.py	100	# Check if outline is correct	COMMENT
LOW	pypdf/_page.py	729	# Check if displayed (in content stream)	COMMENT
LOW	pypdf/generic/_data_structures.py	345	# Check if this is a chain list, we need to loop to prevent recur	COMMENT

Dead Code5 hits · 10 pts

Severity	File	Line	Context
MEDIUM	pypdf/generic/_data_structures.py	1298	CODE
MEDIUM	pypdf/generic/_data_structures.py	1299	CODE
MEDIUM	pypdf/generic/_data_structures.py	1300	CODE
MEDIUM	pypdf/generic/_data_structures.py	1301	CODE
MEDIUM	pypdf/generic/_data_structures.py	1302	CODE

Verbosity Indicators3 hits · 4 pts

Severity	File	Line	Snippet	Context
LOW	tests/utils.py	127	# Step 1: Count number of x- and y-coordinates of rectangles.	COMMENT
LOW	tests/utils.py	150	# Step 2: Look for texts in rectangles.	COMMENT
LOW	tests/utils.py	164	# Step 3: Build the list of rows containing list of cell-texts.	COMMENT

Structural Annotation Overuse3 hits · 4 pts

Severity	File	Line	Snippet	Context
LOW	tests/utils.py	127	# Step 1: Count number of x- and y-coordinates of rectangles.	COMMENT
LOW	tests/utils.py	150	# Step 2: Look for texts in rectangles.	COMMENT
LOW	tests/utils.py	164	# Step 3: Build the list of rows containing list of cell-texts.	COMMENT

AI Structural Patterns4 hits · 4 pts

Severity	File	Line	Context
LOW	pypdf/_writer.py	177	CODE
LOW	pypdf/_page.py	1815	CODE
LOW	…f/_text_extraction/_layout_mode/_text_state_manager.py	123	CODE
LOW	pypdf/generic/_appearance_stream.py	449	CODE

Slop Phrases1 hit · 2 pts

Severity	File	Line	Snippet	Context
LOW	pypdf/_page_labels.py	245	# When there are no kids, make sure to exit the `while` loop directly	COMMENT

TODO Padding1 hit · 2 pts

Severity	File	Line	Snippet	Context
LOW	pypdf/generic/_image_xobject.py	543	# TODO: implement mask	COMMENT

Analysis Overview

What These Metrics Mean

Score History

Severity Breakdown

Directory Score Breakdown

Pattern Findings