Pattern 3: IntFlag for Combinable Permissions<\/strong><\/h2>\n\n\n\nWhen you need to represent combinations of options like file permissions or feature toggles, IntFlag lets you combine enum members using bitwise operators while keeping them readable and type-safe.<\/p>\n\n\n\n
from enum import IntFlag, auto\n\nclass Permission(IntFlag):\n\n READ = auto() # 1\n\n WRITE = auto() # 2\n\n EXECUTE = auto() # 4\n\nuser_perms = Permission.READ | Permission.WRITE\n\nprint(user_perms) # Permission.READ|WRITE\n\nprint(Permission.WRITE in user_perms) # True\n\nprint(Permission.EXECUTE in user_perms) # False\n\n# Grant execute permission\n\nuser_perms |= Permission.EXECUTE\n\nprint(user_perms) # Permission.READ|WRITE|EXECUTE<\/code><\/pre>\n\n\n\nThis is exactly how the os and stat modules represent file permission bits internally. IntFlag gives you the same compact, bitwise representation with a readable, type-checked API on top.<\/p>\n\n\n\n
Pattern 4: Enums with match Statements<\/strong><\/h2>\n\n\n\nPython 3.10’s match statement pairs naturally with enums, replacing long if\/elif chains with clean, exhaustive-looking pattern matching.<\/p>\n\n\n\n
def handle_order(status: OrderStatus):\n\n match status:\n\n case OrderStatus.PENDING:\n\n return 'Awaiting confirmation'\n\n case OrderStatus.SHIPPED | OrderStatus.PROCESSING:\n\n return 'In progress'\n\n case OrderStatus.DELIVERED:\n\n return 'Complete'\n\n case OrderStatus.CANCELLED:\n\n return 'Order was cancelled'\n\nprint(handle_order(OrderStatus.SHIPPED)) # 'In progress'<\/code><\/pre>\n\n\n\nUsing | inside a case pattern lets you group multiple enum members under one branch \u2014 concise and readable compared to equivalent if\/elif logic<\/p>\n\n\n\n
Python Enum Patterns: Quick Reference<\/strong><\/h2>\n\n\n\nPattern<\/strong><\/td>Tool<\/strong><\/td>Use Case<\/strong><\/td><\/tr>Basic enum<\/strong><\/td>Enum<\/td> Replace magic strings\/numbers with named constants<\/td><\/tr> Methods on enums<\/strong><\/td>def \/ @property<\/td> Attach behaviour directly to enum members<\/td><\/tr> Auto values<\/strong><\/td>auto()<\/td> Self-documenting members when value doesn’t matter<\/td><\/tr> Combinable flags<\/strong><\/td>IntFlag<\/td> Permissions, feature toggles, bitwise combinations<\/td><\/tr> Unique values<\/strong><\/td>@unique<\/td> Prevent accidental duplicate values for members<\/td><\/tr> Pattern matching<\/strong><\/td>match\/case<\/td> Clean branching logic based on enum member<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nCommon Mistakes When Using Python Enums<\/strong><\/h2>\n\n\n\n1. Comparing enum values instead of members: <\/strong>Writing if status.value == ‘shipped’ defeats the purpose of using an enum. Compare the member directly: if status == OrderStatus.SHIPPED. This keeps type safety and avoids string typos entirely.<\/p>\n\n\n\n2. Allowing accidental duplicate values: <\/strong>By default, Enum allows two members to share the same value, creating aliases that can cause confusing behaviour. Add the @unique decorator from the enum module to raise an error if duplicate values are accidentally defined.<\/p>\n\n\n\n3. Using plain Enum for combinable options: <\/strong>If you find yourself wanting to represent ‘READ and WRITE’ as a single value, a plain Enum cannot express this cleanly. Use IntFlag, which supports bitwise OR, AND, and membership checks for combinations. <\/p>\n\n\n\nConclusion<\/strong><\/h2>\n\n\n\nPython enums are far more capable than the basic Enum.MEMBER = ‘value’ pattern most developers stop at. Adding methods and properties keeps related logic together, auto() removes the burden of manually managing values, IntFlag enables clean combinable options, and match statements pair beautifully with enums for readable branching. The next time you catch yourself writing a string constant, a magic number, or a long if\/elif chain checking a status field, consider whether an enum with a method or two attached would make that code clearer and safer. <\/p>\n\n\n\n
FAQs<\/strong><\/h2>\n\n\n\n
\n
\n
1.\u00a0 \u00a0 What are Python enums used for? <\/strong><\/h3>\n\n\n
Python enums, from the enum module, group a fixed set of related named constants under one type. They replace magic strings and numbers with type-safe, self-documenting values, catching typos and invalid values at development time rather than at runtime.<\/p>\n\n<\/div>\n<\/div>\n
\n
2.\u00a0 \u00a0 Can Python enums have methods? <\/strong><\/h3>\n\n\n
Yes. Enums are classes, so you can define regular methods and properties on them just like any other class. This lets you attach behaviour such as is_terminal() or a display_label property directly to enum members instead of writing separate utility functions.<\/p>\n\n<\/div>\n<\/div>\n
\n
3.\u00a0 \u00a0 What does auto() do in Python enums? <\/strong><\/h3>\n\n\n
auto() automatically assigns a value to an enum member when the specific value does not matter, only the member’s identity does. By default, it assigns sequential integers starting from 1, and can be customised by overriding _generate_next_value_.<\/p>\n\n<\/div>\n<\/div>\n
\n
4.\u00a0 \u00a0 What is the difference between Enum and IntFlag in Python? <\/strong><\/h3>\n\n\n
Enum represents a single choice from a fixed set of options. IntFlag represents combinable options using bitwise operators (|, &, ^) useful for permissions, feature toggles, or any scenario where multiple flags can be active simultaneously.<\/p>\n\n<\/div>\n<\/div>\n
\n
5.\u00a0 \u00a0 How do you prevent duplicate values in a Python enum? <\/strong><\/h3>\n\n\n
Add the @unique decorator from the enum module above an Enum class definition. This raises a ValueError at class definition time if two members are accidentally assigned the same value, preventing silent aliasing bugs.<\/p>\n\n<\/div>\n<\/div>\n
\n
6.\u00a0 \u00a0 Should I compare enum members with == or is? <\/strong><\/h3>\n\n\n
Both work correctly because enum members are singletons, but == is the conventional choice and works identically. The key practice is comparing the member itself (status == OrderStatus.SHIPPED), not its .value, to retain type safety.<\/p>\n\n<\/div>\n<\/div>\n
\n
7.\u00a0 \u00a0 How do Python enums work with match statements? <\/strong><\/h3>\n\n\n
Enum members work naturally as patterns in match\/case statements introduced in Python 3.10. You can match individual members, or use the | operator inside a case to group multiple members under one branch, replacing long if\/elif chains.<\/p>\n\n<\/div>\n<\/div>\n<\/div>\n<\/div>","protected":false},"excerpt":{"rendered":"
If your codebase has constants like STATUS_PENDING = ‘pending’ and STATUS_ACTIVE = ‘active’ scattered across files, or functions that accept a mode string and silently do nothing when someone passes ‘Active’ instead of ‘active’, you have a problem that Python enums were built to solve. Most developers know the basic enum. Enum syntax, but the […]<\/p>\n","protected":false},"author":63,"featured_media":121991,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[717],"tags":[],"views":"246","authorinfo":{"name":"Vishalini Devarajan","url":"https:\/\/www.guvi.in\/blog\/author\/vishalini\/"},"thumbnailURL":"https:\/\/www.guvi.in\/blog\/wp-content\/uploads\/2026\/07\/python-enums-300x118.webp","_links":{"self":[{"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/posts\/120040"}],"collection":[{"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/users\/63"}],"replies":[{"embeddable":true,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/comments?post=120040"}],"version-history":[{"count":3,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/posts\/120040\/revisions"}],"predecessor-version":[{"id":121989,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/posts\/120040\/revisions\/121989"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/media\/121991"}],"wp:attachment":[{"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/media?parent=120040"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/categories?post=120040"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/tags?post=120040"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}