DEP: Unify naming in constants
Author: stefan6419846Created Aug 24, 2026Updated Aug 24, 2026
Labelsbreaking-change
The following names in constants.py do not match the usual scheme and should be migrated to their proper names with a deprecation process:
FileSpecificationDictionaryEntries.(Type|Mac|Unix|Cl)TypArguments(why notTypeArgumentsor an alignment-related name?)TypFitArguments(why notFitTypesor similar?)AnnotationDictionaryAttributes.(Type|Subtype|Rect|Contents|Border|StructParent)InteractiveFormDictEntries.(Fields|NeedAppearances|SigFlags)FieldDictionaryAttributes.(Parent|Kids|Ff|Opt)FieldDictionaryAttributes.FfBits(all values should be constant names)CheckboxRadioButtonAttributes.OptOutlineFontFlag(all values should be constant names)
Please note that this list might be incomplete.
Before migrating them, we should ensure to check whether renaming them to the usual pattern for constants might cause conflicts due to possible duplicate names (see GraphicsStateParameters with OP vs. op for example). If there can be a conflict, these ideally should be documented properly.
Source: py-pdf/pypdf