Click 8.2.0 incompatibility causing exception in _print_options_panel

[infused-kim]

First Check

• I added a very descriptive title here.
• I used the GitHub search to find a similar question and didn't find it.
• I searched the Typer documentation, with the integrated search.
• I already searched in Google "How to X in Typer" and didn't find any information.
• I already read and followed all the tutorials in the docs and didn't find an answer.
• I already checked if it is not related to Typer but to Click.

Commit to Help

• I commit to help with one of those options 👆

Example Code

#! /usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.11"
# dependencies = [
#   "typer==0.15.3",
#   "click==8.2.0",
# ]
# ///

import typer

app = typer.Typer(no_args_is_help=True)


@app.command()
def first_command() -> None:
    print("Hello from typer-example.py!")


@app.command()
def second_command() -> None:
    print("Hello from typer-example.py!")


if __name__ == "__main__":
    app()

Description

Click 8.2.0 was released 1h ago and seems to be incompatible with the latest typer release.

The issue is in _print_options_panel, which calls Parameter.make_metavar() without passing the ctx parameter.

The exception is: TypeError: Parameter.make_metavar() missing 1 required positional argument: 'ctx'

Typer automatically installs the latest 8.x release:

dependencies = [
    "click >= 8.0.0",
    "typing-extensions >= 3.7.4.3",
]

Workaround

In the meantime the issue can be mitigating by pinning click to click==8.1.8 in our projects.

Stack Trace

❯ ./typer-example.py 
 Usage: typer-example.py [OPTIONS] COMMAND [ARGS]...

╭────────────────────────────────────────────── Traceback (most recent call last) ───────────────────────────────────────────────╮
│ /Users/Kim/Workspace/tmp/./typer-example.py:26 in <module>                                                                     │
│                                                                                                                                │
│   23                                                                                                                           │
│   24                                                                                                                           │
│   25 if __name__ == "__main__":                                                                                                │
│ ❱ 26 │   app()                                                                                                                 │
│   27                                                                                                                           │
│                                                                                                                                │
│ ╭────────────────────────────────────────────────────────── locals ──────────────────────────────────────────────────────────╮ │
│ │   app = <typer.main.Typer object at 0x102643fd0>                                                                           │ │
│ │ typer = <module 'typer' from                                                                                               │ │
│ │         '/Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/typer/__init__.… │ │
│ ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/typer/main.py:340 in __call__ │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/typer/main.py:323 in __call__ │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/click/core.py:1442 in         │
│ __call__                                                                                                                       │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/typer/core.py:740 in main     │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/typer/core.py:194 in _main    │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/click/core.py:1186 in         │
│ make_context                                                                                                                   │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/click/core.py:1784 in         │
│ parse_args                                                                                                                     │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/click/exceptions.py:271 in    │
│ __init__                                                                                                                       │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/click/core.py:730 in get_help │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/click/core.py:1064 in         │
│ get_help                                                                                                                       │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/typer/core.py:754 in          │
│ format_help                                                                                                                    │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/typer/rich_utils.py:614 in    │
│ rich_format_help                                                                                                               │
│                                                                                                                                │
│ /Users/Kim/.cache/uv/environments-v2/typer-example-c630495964039582/lib/python3.11/site-packages/typer/rich_utils.py:373 in    │
│ _print_options_panel                                                                                                           │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
TypeError: Parameter.make_metavar() missing 1 required positional argument: 'ctx'

Operating System

macOS

Operating System Details

No response

Typer Version

0.15.3

Python Version

3.11.9

Additional Context

No response

[fervand1]

Observing the same error in the pipelines. Pinning to click <8.2.0 resolves

[nathanneibauer]

I have observed the same behavior too

[mhxion]

Yup, the new click 8.2.0 release totally broke our app using Typer as well. I would also like to bring up that click dropped support for Python 3.7, 3.8 and 3.9 with this release, and Typer is still supporting Python >= 3.7. Not sure how that will affect Typer.

[sbellon]

The required patch to make the above work again would be this one:

--- typer/rich_utils.py.old 2025-05-11 23:26:44.218001227 +0200
+++ typer/rich_utils.py.new 2025-05-11 23:24:46.288897856 +0200
@@ -370,7 +370,7 @@
 
         # Column for a metavar, if we have one
         metavar = Text(style=STYLE_METAVAR, overflow="fold")
-        metavar_str = param.make_metavar()
+        metavar_str = param.make_metavar(ctx)
 
         # Do it ourselves if this is a positional argument
         if (

Not sure however what else the upgrade broke.

The change apparently is due to new line 300 in src/click/types.py of pallets/click@4ece17a?diff=split#diff-dcb534e6a7591b92836537d4655ddbd2f18e3b293c3420144c30a9ca08f65c4eR300

[dusktreader]

Can confirm that this restored my app to working order.

[automet]

I think the solution would be to pin click < 8.2.0 in pyproject.toml as the PR to support click 8.2.0 is still open: #1145

[sbellon]

😅 I didn't even notice that there is already a PR for click 8.2.0 compatibility the whole time.

[lpsinger]

By the way, the Click PR that changed the signature of make_metavar was pallets/click#2796.

[lpsinger]

My attempt at a fix: #1218

[bckohan]

PR #1145 updates for general click 8.2 compatibility including this issue and has been open since February.

[lpsinger]

Oops, sorry!

[devinnasar]

@tiangolo, drawing your attention to this discussion. This issue is affecting a number of CLI projects now that Click 8.2.0 has been released and it appears that we have a PR meant to address it dating back to February. Can we get an update on this? Thanks!

[mrfroggg]

This should be converted from a Discussion to an Issue!

I'm also facing the issue with click 8.2.0 in our 3 internal apps!

[infused-kim]

Typer 0.15.4 was released today that pins click to < 8.2.0. So, manual pinning isn't necessary anymore...

https://github.com/fastapi/typer/releases/tag/0.15.4