Sequence Patterns Matching Lists and Tuples<\/strong><\/h3>\n\n\n\ndef describe_point(point):\n\nmatch point:\n\n case [0, 0]:\n\n return 'Origin'\n\n case [x, 0]:\n\n return f'On x-axis at {x}'\n\n case [0, y]:\n\n return f'On y-axis at {y}'\n\n case [x, y]:\n\n return f'Point at ({x}, {y})'\n\n case _:\n\n return 'Not a 2D point'\n\nprint(describe_point([3, 0])) # On x-axis at 3\n\nprint(describe_point([2, 5])) # Point at (2, 5)<\/code><\/pre>\n\n\n\nMapping Patterns Matching Dictionaries<\/strong><\/h3>\n\n\n\ndef handle_event(event):\n\nmatch event:\n\n case {'type': 'click', 'button': btn}:\n\n return f'Mouse click: button {btn}'\n\n case {'type': 'keypress', 'key': k}:\n\n return f'Key pressed: {k}'\n\n case {'type': t}:\n\n return f'Unknown event type: {t}'\n\nprint(handle_event({'type': 'click', 'button': 'left'}))\n\n# Mouse click: button left<\/code><\/pre>\n\n\n\nMapping patterns do partial matching a dictionary with extra keys still matches as long as all the keys listed in the pattern are present. This makes them ideal for handling JSON payloads and API responses where additional fields may exist.<\/p>\n\n\n\n
Class Patterns Matching Object Instances<\/strong><\/h3>\n\n\n\nfrom dataclasses import dataclass\n\n@dataclass\n\nclass Point:\n\nx: float\n\ny: float\n\n@dataclass\n\nclass Circle:\n\ncentre: Point\n\nradius: float\n\ndef describe_shape(shape):\n\nmatch shape:\n\n case Circle(centre=Point(x=0, y=0), radius=r):\n\n return f'Circle at origin, radius {r}'\n\n case Circle(centre=Point(x=cx, y=cy), radius=r):\n\n return f'Circle at ({cx},{cy}), radius {r}'\n\n case Point(x=0, y=0):\n\n return 'Origin point'\n\nprint(describe_shape(Circle(Point(0, 0), 5)))\n\n# Circle at origin, radius 5<\/code><\/pre>\n\n\n\nOR Patterns and Guards<\/strong><\/h3>\n\n\n\ndef classify(value):\n\nmatch value:\n\n case 'yes' | 'y' | 'true':\n\n return 'Affirmative'\n\n case 'no' | 'n' | 'false':\n\n return 'Negative'\n\n case int(n) if n > 0: # guard condition\n\n return f'Positive integer: {n}'\n\n case int(n) if n < 0:\n\n return f'Negative integer: {n}'\n\n case _:\n\n return 'Unrecognised'\n\nprint(classify('yes')) # Affirmative\n\nprint(classify(42)) # Positive integer: 42 <\/code><\/pre>\n\n\n\n\n\n
\ud83d\udca1 Did You Know?<\/strong>\n structural pattern matching<\/strong>, introduced in Python 3.10<\/strong>, was inspired by pattern matching features found in languages such as Scala<\/strong>, Haskell<\/strong>, Erlang<\/strong>, and Rust<\/strong>. The feature is specified across three companion Python Enhancement Proposals: PEP 634<\/strong> (Specification), PEP 635<\/strong> (Motivation and Rationale), and PEP 636<\/strong> (Tutorial). Together, they provide one of the most comprehensive documentations ever published for a major Python language feature.\n\n<\/div>\n\n\n\nPython Pattern Types: Quick Reference<\/strong><\/h3>\n\n\n\nPattern Type<\/strong><\/td>Syntax Example<\/strong><\/td>What It Matches<\/strong><\/td><\/tr>Literal<\/strong><\/td>case 42:<\/td> Exact value \u2014 integer, string, bool, None<\/td><\/tr> Capture<\/strong><\/td>case x:<\/td> Any value; binds it to variable x<\/td><\/tr> Wildcard<\/strong><\/td>case _:<\/td> Any value; discards it (default\/else)<\/td><\/tr> Sequence<\/strong><\/td>case [x, y]:<\/td> A list or tuple with exactly two elements<\/td><\/tr> Mapping<\/strong><\/td>case {‘key’: v}:<\/td> A dict containing the given key; binds value to v<\/td><\/tr> Class<\/strong><\/td>case Point(x=a, y=b):<\/td> An instance of Point; binds attributes to a, b<\/td><\/tr> OR pattern<\/strong><\/td>case ‘yes’ | ‘y’:<\/td> Any of the listed literals<\/td><\/tr> Guard<\/strong><\/td>case n if n > 0:<\/td> Matches n and only if the guard condition is true<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nReal-World Use Cases<\/strong><\/h2>\n\n\n\nStructural pattern matching is not just a cleaner switch it shines in scenarios where the shape and content of data varies unpredictably.<\/p>\n\n\n\n
\nAPI and JSON response handling:<\/strong> Match on response dictionaries by key presence to route success, error, and pagination responses without nested isinstance and .get() chains.<\/li>\n\n\n\nCommand-line parsers:<\/strong> Match tokenised command strings like [‘move’, ‘up’, ‘5’] or [‘quit’] to dispatch actions cleanly without lengthy elif blocks.<\/li>\n\n\n\nState machines:<\/strong> Match a (state, event) tuple to transition logic \u2014 the combination of sequence patterns and guards makes state transition tables readable and compact.<\/li>\n\n\n\nAST and compiler tools:<\/strong> Match node types in abstract syntax trees when writing linters, transpilers, or code analysis tools that inspect Python or custom language ASTs.<\/li>\n<\/ul>\n\n\n\nCommon Mistakes with match\/case<\/strong><\/h2>\n\n\n\n1. Treating capture patterns like equality checks: <\/strong>case x: does not check whether the subject equals a variable named x it always matches and binds the subject to x. To compare against an existing variable, use a dotted name (case Status. OK:) or a guard (case n if n == threshold:).<\/p>\n\n\n\n2. Expecting fall-through behaviour: <\/strong>Python match has no fall-through. Each case is independent. If you need to share logic between cases, extract it into a function and call it from multiple case blocks do not rely on sequential execution.<\/p>\n\n\n\n3. Using match\/case below Python 3.10: <\/strong>The match and case keywords are syntax errors in Python 3.9 and below. Check your interpreter version with python –version before deploying code that uses structural pattern matching, especially in shared or containerised environments.<\/p>\n\n\n\nConclusion<\/strong><\/h2>\n\n\n\nStructural pattern matching is one of the most expressive additions to Python in years. It replaces brittle chains of isinstance checks and nested conditionals with a declarative syntax that simultaneously tests the shape of data, extracts its components, and routes execution all in one readable block. Literal patterns handle simple value dispatch. Sequence patterns destructure lists and tuples. Mapping patterns extract dictionary values without .get() boilerplate. Class patterns match object instances by attribute. OR patterns and guards add precision without nesting. <\/p>\n\n\n\n
FAQs<\/strong><\/h2>\n\n\n\n
\n
\n
\u00a01. What is structural pattern matching in Python?<\/strong><\/h3>\n\n\n
Structural pattern matching, introduced in Python 3.10 via PEP 634, is a control-flow feature that lets you match a value against a series of patterns using match and case keywords. Unlike a simple switch statement,<\/p>\n\n<\/div>\n<\/div>\n
\n
2. Is Python match\/case the same as a switch statement?<\/strong><\/h3>\n\n\n
No. A switch statement in languages like Java or C tests a single value for equality against a list of constants. Python’s match tests a subject against structural patterns it can inspect the shape of a list, the keys present in a dictionary, the type and attributes of an object, and apply conditional guards. It is far more powerful than a traditional switch.<\/p>\n\n<\/div>\n<\/div>\n
\n
3. What Python version is required for match\/case?<\/strong><\/h3>\n\n\n
Python 3.10 or higher is required. The match and case keywords are valid syntax only from 3.10 onwards they are syntax errors in 3.9 and earlier. You can check your version with python –version in the terminal. Python 3.10 was released in October 2021.<\/p>\n\n<\/div>\n<\/div>\n
\n
4.What is a wildcard pattern in Python match?<\/strong><\/h3>\n\n\n
The wildcard pattern is written as a single underscore (_). It matches any value without binding it to a variable. Placed as the last case in a match block, it acts as the default catch-all equivalent to the else clause in an if-elif-else chain. Unlike a capture pattern (case x:), the value is discarded.<\/p>\n\n<\/div>\n<\/div>\n
\n
5. What is the difference between a capture pattern and a literal pattern?<\/strong><\/h3>\n\n\n
A literal pattern (case 42: or case ‘error’:) tests the subject for equality against a specific value. A capture pattern (case x:) always matches and binds the subject value to the variable name it never tests equality. This is a common source of bugs: case existing_var: does not compare against existing_var; it shadows it with a new binding.<\/p>\n\n<\/div>\n<\/div>\n
\n
6. How do guard conditions work in Python match?<\/strong><\/h3>\n\n\n
A guard is an if clause appended to a case pattern: case n if n > 0:. The pattern must match first; then the guard condition is evaluated. If the guard is False, Python moves to the next case even though the pattern itself matched. Guards are essential for adding numeric range checks or attribute comparisons that patterns alone cannot express.<\/p>\n\n<\/div>\n<\/div>\n
\n
7. Can I use match\/case with custom classes?<\/strong><\/h3>\n\n\n
Yes. Class patterns match instances of a specific class and extract named attributes. For dataclasses and named tuples, this works automatically. For plain classes, you define a __match_args__ class variable a tuple of attribute names to enable positional pattern matching. Named attribute matching (case Point(x=a, y=b):) works without __match_args__.<\/p>\n\n<\/div>\n<\/div>\n<\/div>\n<\/div>","protected":false},"excerpt":{"rendered":"
Before Python 3.10, complex branching often required nested if-elif-else statements with multiple isinstance() checks and dictionary lookups. Python 3.10 introduced structural pattern matching (match\/case) through PEP 634, allowing code to python match and unpack data structures, dictionaries, and objects in a clean, readable way. It makes complex decision-making logic easier to write and maintain. TL;DR […]<\/p>\n","protected":false},"author":63,"featured_media":122003,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[717],"tags":[],"views":"56","authorinfo":{"name":"Vishalini Devarajan","url":"https:\/\/www.guvi.in\/blog\/author\/vishalini\/"},"thumbnailURL":"https:\/\/www.guvi.in\/blog\/wp-content\/uploads\/2026\/07\/python-match-case-300x120.webp","_links":{"self":[{"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/posts\/120041"}],"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=120041"}],"version-history":[{"count":5,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/posts\/120041\/revisions"}],"predecessor-version":[{"id":122005,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/posts\/120041\/revisions\/122005"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/media\/122003"}],"wp:attachment":[{"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/media?parent=120041"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/categories?post=120041"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.guvi.in\/blog\/wp-json\/wp\/v2\/tags?post=120041"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}