Moved color setting to conf.py

Author: RobertoRoos

docs/misc.rst

@@ -32,11 +32,3 @@ Linking to action groups
 ------------------------
 
 As of version 0.2.0, action groups (e.g., "Optional arguments", "Required arguments", and subcommands) can be included in tables of contents and external links. The anchor name is the same as the title name (e.g., "Optional arguments"). In cases where titles are duplicated, as is often the case when subcommands are used, ``_repeatX``, where ``X`` is a number, is prepended to duplicate anchor names to ensure that they can all be uniquely linked.
-
-
-Argparse color
---------------
-
-Since Python 3.14, ``argparse`` uses `colors <https://docs.python.org/3/library/argparse.html#color>`__ in the output by default.
-These ANSI color sequences won't show right at all in the Sphinx output, so this extension will disable colors first in your ``ArgumentParser`` instance before producing the output.
-You can override this default behaviour by passing the ``:color:`` flag to your ``.. argparse`` directive, in this case the color setting of the argument parser is enabled.

docs/usage.rst

@@ -95,9 +95,10 @@ The next sections will describe the options in more detail.
    sphinxarg_commands_by_group_index_file_suffix = "by-group"
    sphinxarg_commands_by_group_index_title = "Commands by Group"
 
+   sphinxarg_ansi_colors = False
 
-.. _about-subcommands:
 
+.. _about-subcommands:
 
 About Sub-Commands
 ==================
@@ -251,3 +252,11 @@ You can configure Sphinx to use the additional template for an index by modifyin
        app.connect('html-page-context', page_template)
 
 For more information, refer to the Sphinx documentation for :ref:`sphinx:templating` and the :doc:`sphinx:extdev/appapi`.
+
+
+Argparse color
+==============
+
+Since Python 3.14, ``argparse`` uses `colors <https://docs.python.org/3/library/argparse.html#color>`__ in the output by default.
+These ANSI color sequences won't show right at all in the Sphinx output, so this extension will disable colors first in your ``ArgumentParser`` instance before producing the output.
+You can override this default behaviour by adding ``sphinxarg_ansi_colors = False`` to your Sphinx ``conf.py``, now the color setting of the argument parser is enabled.

sphinxarg/ext.py

@@ -322,7 +322,6 @@ class ArgParseDirective(SphinxDirective):
         'markdown': flag,
         'markdownhelp': flag,
         'index-groups': unchanged,
-        'color': flag,
     }
     index_groups: Sequence[str] = ()
 
@@ -766,8 +765,8 @@ def run(self):
 
         # Argparse in Python 3.14 uses ANSI color codes by default (#72)
         if hasattr(parser, 'color'):
-            parser.color = 'color' in self.options
-            # Disable colors, unless a flag is present in the user-settings
+            parser.color = self.env.config.sphinxarg_ansi_colors
+            # Disable colors, unless a flag is present in the config
 
         result = parse_parser(
             parser,
@@ -1030,6 +1029,8 @@ def setup(app: Sphinx):
         'sphinxarg_commands_by_group_index_title', CommandsByGroupIndex.localname, 'html', str
     )
 
+    app.add_config_value('sphinxarg_ansi_colors', False, 'html', bool)
+
     app.connect('builder-inited', configure_ext)
     app.connect('build-finished', _delete_temporary_files)
     return {