TypeError: ArgParser.__init__() got an unexpected keyword argument color on Python 3.14

[hair-splitter]

Running latexminted under Python 3.14.0 raises TypeError: ArgParser.__init__() got an unexpected keyword argument 'color', preventing minted usage from LaTeX.

Environment

OS: Windows 11
TeX: TeX Live 2025
Python: 3.14.0

Reproduce

Run latexminted --version (or run pdflatex file.tex that uses minted).

Expected result

latexminted runs and prints version/help, or the LaTeX file highlights normally.

Actual result

latexminted fails with TypeError (traceback excerpt below).

Traceback (most recent call last):
  File "c:\texlive\2025\texmf-dist\scripts\minted\latexminted.py", line 372, in <module>
    main()
    ~~~~^^
  File "C:\texlive\2025\texmf-dist\scripts\minted\latexminted-0.6.0-py3-none-any.whl\latexminted\cmdline.py", line 148, in main
    parser.add_command('batch', help='Batch process highlight, styledef, and clean', func=batch)
    ~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\texlive\2025\texmf-dist\scripts\minted\latexminted-0.6.0-py3-none-any.whl\latexminted\cmdline.py", line 41, in add_command
    parser = self._command_subparsers.add_parser(name, help=help)
  File "C:\Users\EKKE\AppData\Local\Programs\Python\Python314\Lib\argparse.py", line 1271, in add_parser
    parser = self._parser_class(**kwargs)
TypeError: ArgParser.__init__() got an unexpected keyword argument 'color'
C:\texlive\2025\bin\windows\runscript.tlu:933: command failed with exit code 1:
python.exe c:\texlive\2025\texmf-dist\scripts\minted\latexminted.py --version

[muzimuzhi]

In Python 3.14, argparse.ArgumentParser() learnt two new optional keyword arguments, suggest_on_error and color

• https://docs.python.org/3/whatsnew/3.14.html#argparse
• https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser

But in cmdline.py, the __init__() of class ArgParser is not ready to accept newly added thus unknown arguments.

minted/python/latexminted/cmdline.py

Lines 24 to 33 in 19ea6fc

	class ArgParser(argparse.ArgumentParser):
	def __init__(self, *, prog: str):
	super().__init__(
	prog=prog,
	allow_abbrev=False,
	formatter_class=argparse.RawTextHelpFormatter
	)
	self._prog = prog
	self._command_subparsers = None
	self._command_help_dict = None

[muzimuzhi]

With the help of GitHub Copilot, the following patch seems to fix the error for both latexminted --version and LaTeX example using minted.

diff --git a/python/latexminted/cmdline.py b/python/latexminted/cmdline.py
index a3d03e6..ae4e8e3 100644
--- a/python/latexminted/cmdline.py
+++ b/python/latexminted/cmdline.py
@@ -22,11 +22,14 @@ from typing import Callable
 
 
 class ArgParser(argparse.ArgumentParser):
-    def __init__(self, *, prog: str):
+    def __init__(self, *, prog: str, **kwargs):
+        kwargs.update(
+            allow_abbrev=False,
+            formatter_class=argparse.RawTextHelpFormatter,
+        )
         super().__init__(
             prog=prog,
-            allow_abbrev=False,
-            formatter_class=argparse.RawTextHelpFormatter
+            **kwargs,
         )
         self._prog = prog
         self._command_subparsers = None

Steps I used to check (on macOS):

# prereq: `uv`, a modern Python package and project manager
#         (https://docs.astral.sh/uv/getting-started/installation/)

# clone minted repo and cd into subdir
git clone --depth=1 git@github.com:gpoore/minted.git
cd minted/python

# install python3.14 and `latexminted` deps
uv python install python@3.14
uv sync

# repro error
uv run latexminted --version

# apply changes to `cmdline.py`


# check if `latexminted --version` is fixed
uv run latexminted --version

# install `latexminted` in editable mode
uv tool install -e .

# prepare a tex file using `minted`
cat << EOF > minted-gh463-python314.tex
\documentclass{article}
\usepackage{minted}

\begin{document}
\begin{minted}{latex}
\texttt{latexminted}
\end{minted}
\end{document}
EOF

# check if LaTeX usage is fixed
# (`PATH` modified to ensure the `latexminted` installed by `uv` is picked)
PATH="$(uv tool dir --bin):$PATH" pdflatex minted-gh463-python314.tex

[ZhongRuoyu]

I encountered this problem as well, so I submitted a fix: #464

[T-F-S]

I stumbled over the same thing after updating to Python 3.14 and later compiling a document using minted.

De facto, minted is currently broken with Python 3.14. I am glad to read that a fix is found and hopefully coming to users soon.

Meanwhile, if rolling back to Python 3.13 is not an option, replacing minted by the old minted2 works (for me). So, for other users with the same problem, this might help until the fix is in place:

% \usepackage{minted}   % deactivated until the fix is in place
\usepackage{minted2}     % remove after the fix is in place

[FedericoBruzzone]

Using minted2 temporarily solves the problem. From my perspective, it seems that this issue is causing more difficulties than expected, especially when working on shared projects.

As pointed out by @T-F-S, minted3 does not work with python3.14.

[gvsem]

Temporary fix with downgrading Python, if applicable (for macOS):

1. Make sure Python 3.11 is installed and retrieve if
   brew install python@3.11

2. Add to ~/.zshrc: export PATH="/opt/homebrew/opt/python@3.11/libexec/bin:$PATH"

[szw0407]

Could the maintainer @gpoore please look at this PR: #464 ?