Add precise values for enum members where possible (#11299)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Alex Waygood <alex.waygood@gmail.com>

stubs/fpdf2/fpdf/enums.pyi

@@ -5,8 +5,8 @@ from typing_extensions import Self
 from .syntax import Name
 
 class SignatureFlag(IntEnum):
-    SIGNATURES_EXIST: int
-    APPEND_ONLY: int
+    SIGNATURES_EXIST = 1
+    APPEND_ONLY = 2
 
 class CoerciveEnum(Enum):
     @classmethod
@@ -21,55 +21,55 @@ class CoerciveIntFlag(IntFlag):
     def coerce(cls, value: Self | str | int) -> Self: ...
 
 class WrapMode(CoerciveEnum):
-    WORD: str
-    CHAR: str
+    WORD = "WORD"
+    CHAR = "CHAR"
 
 class CharVPos(CoerciveEnum):
-    SUP: str
-    SUB: str
-    NOM: str
-    DENOM: str
-    LINE: str
+    SUP = "SUP"
+    SUB = "SUB"
+    NOM = "NOM"
+    DENOM = "DENOM"
+    LINE = "LINE"
 
 class Align(CoerciveEnum):
-    C: str
-    X: str
-    L: str
-    R: str
-    J: str
+    C = "CENTER"
+    X = "X_CENTER"
+    L = "LEFT"
+    R = "RIGHT"
+    J = "JUSTIFY"
 
 class VAlign(CoerciveEnum):
-    M: str
-    T: str
-    B: str
+    M = "MIDDLE"
+    T = "TOP"
+    B = "BOTTOM"
 
 class TextEmphasis(CoerciveIntFlag):
-    B: int
-    I: int
-    U: int
+    B = 1
+    I = 2
+    U = 4
 
     @property
     def style(self) -> str: ...
 
 class MethodReturnValue(CoerciveIntFlag):
-    PAGE_BREAK: int
-    LINES: int
-    HEIGHT: int
+    PAGE_BREAK = 1
+    LINES = 2
+    HEIGHT = 4
 
 class TableBordersLayout(CoerciveEnum):
-    ALL: str
-    NONE: str
-    INTERNAL: str
-    MINIMAL: str
-    HORIZONTAL_LINES: str
-    NO_HORIZONTAL_LINES: str
-    SINGLE_TOP_LINE: str
+    ALL = "ALL"
+    NONE = "NONE"
+    INTERNAL = "INTERNAL"
+    MINIMAL = "MINIMAL"
+    HORIZONTAL_LINES = "HORIZONTAL_LINES"
+    NO_HORIZONTAL_LINES = "NO_HORIZONTAL_LINES"
+    SINGLE_TOP_LINE = "SINGLE_TOP_LINE"
 
 class TableCellFillMode(CoerciveEnum):
-    NONE: str
-    ALL: str
-    ROWS: str
-    COLUMNS: str
+    NONE = "NONE"
+    ALL = "ALL"
+    ROWS = "ROWS"
+    COLUMNS = "COLUMNS"
 
     def should_fill_cell(self, i: int, j: int) -> bool: ...
 
@@ -78,9 +78,9 @@ class TableSpan(CoerciveEnum):
     COL: Literal["COL"]
 
 class RenderStyle(CoerciveEnum):
-    D: str
-    F: str
-    DF: str
+    D = "DRAW"
+    F = "FILL"
+    DF = "DRAW_FILL"
     @property
     def operator(self) -> str: ...
     @property
@@ -89,173 +89,173 @@ class RenderStyle(CoerciveEnum):
     def is_fill(self) -> bool: ...
 
 class TextMode(CoerciveIntEnum):
-    FILL: int
-    STROKE: int
-    FILL_STROKE: int
-    INVISIBLE: int
-    FILL_CLIP: int
-    STROKE_CLIP: int
-    FILL_STROKE_CLIP: int
-    CLIP: int
+    FILL = 0
+    STROKE = 1
+    FILL_STROKE = 2
+    INVISIBLE = 3
+    FILL_CLIP = 4
+    STROKE_CLIP = 5
+    FILL_STROKE_CLIP = 6
+    CLIP = 7
 
 class XPos(CoerciveEnum):
-    LEFT: str
-    RIGHT: str
-    START: str
-    END: str
-    WCONT: str
-    CENTER: str
-    LMARGIN: str
-    RMARGIN: str
+    LEFT = "LEFT"
+    RIGHT = "RIGHT"
+    START = "START"
+    END = "END"
+    WCONT = "WCONT"
+    CENTER = "CENTER"
+    LMARGIN = "LMARGIN"
+    RMARGIN = "RMARGIN"
 
 class YPos(CoerciveEnum):
-    TOP: str
-    LAST: str
-    NEXT: str
-    TMARGIN: str
-    BMARGIN: str
+    TOP = "TOP"
+    LAST = "LAST"
+    NEXT = "NEXT"
+    TMARGIN = "TMARGIN"
+    BMARGIN = "BMARGIN"
 
 class Angle(CoerciveIntEnum):
-    NORTH: int
-    EAST: int
-    SOUTH: int
-    WEST: int
-    NORTHEAST: int
-    SOUTHEAST: int
-    SOUTHWEST: int
-    NORTHWEST: int
+    NORTH = 90
+    EAST = 0
+    SOUTH = 270
+    WEST = 180
+    NORTHEAST = 45
+    SOUTHEAST = 315
+    SOUTHWEST = 225
+    NORTHWEST = 135
 
 class PageLayout(CoerciveEnum):
-    SINGLE_PAGE: Name
-    ONE_COLUMN: Name
-    TWO_COLUMN_LEFT: Name
-    TWO_COLUMN_RIGHT: Name
-    TWO_PAGE_LEFT: Name
-    TWO_PAGE_RIGHT: Name
+    SINGLE_PAGE = Name("SinglePage")
+    ONE_COLUMN = Name("OneColumn")
+    TWO_COLUMN_LEFT = Name("TwoColumnLeft")
+    TWO_COLUMN_RIGHT = Name("TwoColumnRight")
+    TWO_PAGE_LEFT = Name("TwoPageLeft")
+    TWO_PAGE_RIGHT = Name("TwoPageRight")
 
 class PageMode(CoerciveEnum):
-    USE_NONE: Name
-    USE_OUTLINES: Name
-    USE_THUMBS: Name
-    FULL_SCREEN: Name
-    USE_OC: Name
-    USE_ATTACHMENTS: Name
+    USE_NONE = Name("UseNone")
+    USE_OUTLINES = Name("UseOutlines")
+    USE_THUMBS = Name("UseThumbs")
+    FULL_SCREEN = Name("FullScreen")
+    USE_OC = Name("UseOC")
+    USE_ATTACHMENTS = Name("UseAttachments")
 
 class TextMarkupType(CoerciveEnum):
-    HIGHLIGHT: Name
-    UNDERLINE: Name
-    SQUIGGLY: Name
-    STRIKE_OUT: Name
+    HIGHLIGHT = Name("Highlight")
+    UNDERLINE = Name("Underline")
+    SQUIGGLY = Name("Squiggly")
+    STRIKE_OUT = Name("StrikeOut")
 
 class BlendMode(CoerciveEnum):
-    NORMAL: Name
-    MULTIPLY: Name
-    SCREEN: Name
-    OVERLAY: Name
-    DARKEN: Name
-    LIGHTEN: Name
-    COLOR_DODGE: Name
-    COLOR_BURN: Name
-    HARD_LIGHT: Name
-    SOFT_LIGHT: Name
-    DIFFERENCE: Name
-    EXCLUSION: Name
-    HUE: Name
-    SATURATION: Name
-    COLOR: Name
-    LUMINOSITY: Name
+    NORMAL = Name("Normal")
+    MULTIPLY = Name("Multiply")
+    SCREEN = Name("Screen")
+    OVERLAY = Name("Overlay")
+    DARKEN = Name("Darken")
+    LIGHTEN = Name("Lighten")
+    COLOR_DODGE = Name("ColorDodge")
+    COLOR_BURN = Name("ColorBurn")
+    HARD_LIGHT = Name("HardLight")
+    SOFT_LIGHT = Name("SoftLight")
+    DIFFERENCE = Name("Difference")
+    EXCLUSION = Name("Exclusion")
+    HUE = Name("Hue")
+    SATURATION = Name("Saturation")
+    COLOR = Name("Color")
+    LUMINOSITY = Name("Luminosity")
 
 class AnnotationFlag(CoerciveIntEnum):
-    INVISIBLE: int
-    HIDDEN: int
-    PRINT: int
-    NO_ZOOM: int
-    NO_ROTATE: int
-    NO_VIEW: int
-    READ_ONLY: int
-    LOCKED: int
-    TOGGLE_NO_VIEW: int
-    LOCKED_CONTENTS: int
+    INVISIBLE = 1
+    HIDDEN = 2
+    PRINT = 4
+    NO_ZOOM = 8
+    NO_ROTATE = 16
+    NO_VIEW = 32
+    READ_ONLY = 64
+    LOCKED = 128
+    TOGGLE_NO_VIEW = 256
+    LOCKED_CONTENTS = 512
 
 class AnnotationName(CoerciveEnum):
-    NOTE: Name
-    COMMENT: Name
-    HELP: Name
-    PARAGRAPH: Name
-    NEW_PARAGRAPH: Name
-    INSERT: Name
+    NOTE = Name("Note")
+    COMMENT = Name("Comment")
+    HELP = Name("Help")
+    PARAGRAPH = Name("Paragraph")
+    NEW_PARAGRAPH = Name("NewParagraph")
+    INSERT = Name("Insert")
 
 class FileAttachmentAnnotationName(CoerciveEnum):
-    PUSH_PIN: Name
-    GRAPH_PUSH_PIN: Name
-    PAPERCLIP_TAG: Name
+    PUSH_PIN = Name("PushPin")
+    GRAPH_PUSH_PIN = Name("GraphPushPin")
+    PAPERCLIP_TAG = Name("PaperclipTag")
 
 class IntersectionRule(CoerciveEnum):
-    NONZERO: str
-    EVENODD: str
+    NONZERO = "nonzero"
+    EVENODD = "evenodd"
 
 class PathPaintRule(CoerciveEnum):
-    STROKE: str
-    FILL_NONZERO: str
-    FILL_EVENODD: str
-    STROKE_FILL_NONZERO: str
-    STROKE_FILL_EVENODD: str
-    DONT_PAINT: str
-    AUTO: str
+    STROKE = "S"
+    FILL_NONZERO = "f"
+    FILL_EVENODD = "f*"
+    STROKE_FILL_NONZERO = "B"
+    STROKE_FILL_EVENODD = "B*"
+    DONT_PAINT = "n"
+    AUTO = "auto"
 
 class ClippingPathIntersectionRule(CoerciveEnum):
-    NONZERO: str
-    EVENODD: str
+    NONZERO = "W"
+    EVENODD = "W*"
 
 class StrokeCapStyle(CoerciveIntEnum):
-    BUTT: int
-    ROUND: int
-    SQUARE: int
+    BUTT = 0
+    ROUND = 1
+    SQUARE = 2
 
 class StrokeJoinStyle(CoerciveIntEnum):
-    MITER: int
-    ROUND: int
-    BEVEL: int
+    MITER = 0
+    ROUND = 1
+    BEVEL = 2
 
 class PDFStyleKeys(Enum):
-    FILL_ALPHA: Name
-    BLEND_MODE: Name
-    STROKE_ALPHA: Name
-    STROKE_ADJUSTMENT: Name
-    STROKE_WIDTH: Name
-    STROKE_CAP_STYLE: Name
-    STROKE_JOIN_STYLE: Name
-    STROKE_MITER_LIMIT: Name
-    STROKE_DASH_PATTERN: Name
+    FILL_ALPHA = Name("ca")
+    BLEND_MODE = Name("BM")
+    STROKE_ALPHA = Name("CA")
+    STROKE_ADJUSTMENT = Name("SA")
+    STROKE_WIDTH = Name("LW")
+    STROKE_CAP_STYLE = Name("LC")
+    STROKE_JOIN_STYLE = Name("LJ")
+    STROKE_MITER_LIMIT = Name("ML")
+    STROKE_DASH_PATTERN = Name("D")
 
 class Corner(CoerciveEnum):
-    TOP_RIGHT: str
-    TOP_LEFT: str
-    BOTTOM_RIGHT: str
-    BOTTOM_LEFT: str
+    TOP_RIGHT = "TOP_RIGHT"
+    TOP_LEFT = "TOP_LEFT"
+    BOTTOM_RIGHT = "BOTTOM_RIGHT"
+    BOTTOM_LEFT = "BOTTOM_LEFT"
 
 class FontDescriptorFlags(Flag):
-    FIXED_PITCH: int
-    SYMBOLIC: int
-    ITALIC: int
-    FORCE_BOLD: int
+    FIXED_PITCH = 1
+    SYMBOLIC = 4
+    ITALIC = 64
+    FORCE_BOLD = 262144
 
 class AccessPermission(IntFlag):
-    PRINT_LOW_RES: int
-    MODIFY: int
-    COPY: int
-    ANNOTATION: int
-    FILL_FORMS: int
-    COPY_FOR_ACCESSIBILITY: int
-    ASSEMBLE: int
-    PRINT_HIGH_RES: int
+    PRINT_LOW_RES = 4
+    MODIFY = 8
+    COPY = 16
+    ANNOTATION = 32
+    FILL_FORMS = 256
+    COPY_FOR_ACCESSIBILITY = 512
+    ASSEMBLE = 1024
+    PRINT_HIGH_RES = 2048
     @classmethod
     def all(cls) -> int: ...
     @classmethod
     def none(cls) -> Literal[0]: ...
 
 class EncryptionMethod(Enum):
-    NO_ENCRYPTION: int
-    RC4: int
-    AES_128: int
-    AES_256: int
+    NO_ENCRYPTION = 0
+    RC4 = 1
+    AES_128 = 2
+    AES_256 = 3