Skip to content

Compatible with python 3.14 #112

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
likeelli wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Compatible with python 3.14 #112

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7c610b6
--story=129997172 【L3】tccli在python 3.14环境下运行报错badly formed help string优化
likeelli Feb 24, 2026
5603603
fix: escape % in help strings for Python 3.14 argparse compatibility
likeelli Mar 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 19 additions & 2 deletions tccli/argument.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,23 @@
from tccli.loaders import CLI_BASE_TYPE


def _escape_help_string(text):
"""Escape '%' characters in help strings for argparse compatibility.

Python 3.14 changed argparse to raise a ValueError ("badly formed help
string") when help strings contain bare '%' characters that are not valid
'%(name)s' format specifiers. API documentation often contains literal
percent signs (e.g. "100%", URL-encoded strings like "%3A").

We replace every '%' with '%%' so that argparse's HelpFormatter renders
the original text unchanged, while no longer tripping over unrecognized
format specifiers.
"""
if not text:
return text
return text.replace('%', '%%')


def str_to_bool(value):
if isinstance(value, bool):
return value
Expand Down Expand Up @@ -143,7 +160,7 @@ def required(self, value):

@property
def documentation(self):
return self._help
return _escape_help_string(self._help)

@property
def cli_type(self):
Expand Down Expand Up @@ -205,7 +222,7 @@ def required(self, value):

@property
def documentation(self):
return self._documentation
return _escape_help_string(self._documentation)

@documentation.setter
def documentation(self, value):
Expand Down