Replace references to override_parser.py example with ones to custom_parser.py

Also:
- Delete unused chunk from plugin pyproject.toml
- Upgrade version of ruff used by pre-commit

Author: tleonhardt

.pre-commit-config.yaml

@@ -9,7 +9,7 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.12.1"
+    rev: "v0.12.2"
     hooks:
       - id: ruff-format
         args: [--config=pyproject.toml]

CHANGELOG.md

@@ -699,7 +699,7 @@
     - Added `read_input()` function that is used to read from stdin. Unlike the Python built-in
       `input()`, it also has an argument to disable tab completion while input is being entered.
     - Added capability to override the argument parser class used by cmd2 built-in commands. See
-      override_parser.py example for more details.
+      custom_parser.py example for more details.
     - Added `end` argument to `pfeedback()` to be consistent with the other print functions like
       `poutput()`.
     - Added `apply_style` to `pwarning()`.

cmd2/argparse_custom.py

@@ -6,7 +6,7 @@
 parser that inherits from it. This will give a consistent look-and-feel between
 the help/error output of built-in cmd2 commands and the app-specific commands.
 If you wish to override the parser used by cmd2's built-in commands, see
-override_parser.py example.
+custom_parser.py example.
 
 Since the new capabilities are added by patching at the argparse API level,
 they are available whether or not Cmd2ArgumentParser is used. However, the help

examples/README.md

@@ -35,8 +35,7 @@ each:
 - [colors.py](https://github.com/python-cmd2/cmd2/blob/main/examples/colors.py)
     - Show various ways of using colorized output within a cmd2 application
 - [custom_parser.py](https://github.com/python-cmd2/cmd2/blob/main/examples/custom_parser.py)
-    - Demonstrates how to create your own customer `Cmd2ArgumentParser`; used by the
-      `override_parser.py` example
+    - Demonstrates how to create your own customer `Cmd2ArgumentParser`
 - [decorator_example.py](https://github.com/python-cmd2/cmd2/blob/main/examples/decorator_example.py)
     - Shows how to use cmd2's various argparse decorators to processes command-line arguments
 - [default_categories.py](https://github.com/python-cmd2/cmd2/blob/main/examples/default_categories.py)
@@ -78,8 +77,6 @@ each:
       command decorators
 - [modular_subcommands.py](https://github.com/python-cmd2/cmd2/blob/main/examples/modular_subcommands.py)
     - Shows how to dynamically add and remove subcommands at runtime using `CommandSets`
-- [override-parser.py](https://github.com/python-cmd2/cmd2/blob/main/examples/override_parser.py)
-    - Shows how to override cmd2's default `Cmd2ArgumentParser` with your own customer parser class
 - [paged_output.py](https://github.com/python-cmd2/cmd2/blob/main/examples/paged_output.py)
     - Shows how to use output pagination within `cmd2` apps via the `ppaged` method
 - [persistent_history.py](https://github.com/python-cmd2/cmd2/blob/main/examples/persistent_history.py)

plugins/ext_test/pyproject.toml

@@ -6,11 +6,11 @@ disallow_incomplete_defs = true
 disallow_untyped_calls = true
 disallow_untyped_defs = true
 exclude = [
-    "^examples/", # examples directory
+    "^examples/",     # examples directory
     "^noxfile\\.py$", # nox config file
-    "setup\\.py$", # any files named setup.py
-    "^tasks\\.py$", # tasks.py invoke config file
-    "^tests/", # tests directory
+    "setup\\.py$",    # any files named setup.py
+    "^tasks\\.py$",   # tasks.py invoke config file
+    "^tests/",        # tests directory
 ]
 show_column_numbers = true
 show_error_codes = true
@@ -82,7 +82,7 @@ select = [
     #    "EM", # flake8-errmsg
     #    "ERA",  # eradicate
     #    "EXE", # flake8-executable
-    "F", # Pyflakes
+    "F",  # Pyflakes
     "FA", # flake8-future-annotations
     #    "FBT",  # flake8-boolean-trap
     "G", # flake8-logging-format
@@ -93,7 +93,7 @@ select = [
     #    "ISC", # flake8-implicit-str-concat
     #    "N", # pep8-naming
     "NPY", # NumPy-specific rules
-    "PD", # pandas-vet
+    "PD",  # pandas-vet
     #    "PGH", # pygrep-hooks
     #    "PIE", # flake8-pie
     #    "PL", # Pylint
@@ -119,21 +119,21 @@ select = [
 ]
 ignore = [
     # `ruff rule S101` for a description of that rule
-    "B904", # Within an `except` clause, raise exceptions with `raise ... from err` -- FIX ME
-    "B905", # `zip()` without an explicit `strict=` parameter -- FIX ME
-    "E501", # Line too long
-    "EM101", # Exception must not use a string literal, assign to variable first
-    "EXE001", # Shebang is present but file is not executable -- DO NOT FIX
-    "G004", # Logging statement uses f-string
+    "B904",    # Within an `except` clause, raise exceptions with `raise ... from err` -- FIX ME
+    "B905",    # `zip()` without an explicit `strict=` parameter -- FIX ME
+    "E501",    # Line too long
+    "EM101",   # Exception must not use a string literal, assign to variable first
+    "EXE001",  # Shebang is present but file is not executable -- DO NOT FIX
+    "G004",    # Logging statement uses f-string
     "PLC1901", # `{}` can be simplified to `{}` as an empty string is falsey
-    "PLW060", # Using global for `{name}` but no assignment is done -- DO NOT FIX
+    "PLW060",  # Using global for `{name}` but no assignment is done -- DO NOT FIX
     "PLW2901", # PLW2901: Redefined loop variable -- FIX ME
-    "PT011", # `pytest.raises(Exception)` is too broad, set the `match` parameter or use a more specific exception
-    "PT018", # Assertion should be broken down into multiple parts
-    "S101", # Use of `assert` detected -- DO NOT FIX
-    "S311", # Standard pseudo-random generators are not suitable for cryptographic purposes -- FIX ME
-    "SLF001", # Private member accessed: `_Iterator` -- FIX ME
-    "UP038", # Use `X | Y` in `{}` call instead of `(X, Y)` -- DO NOT FIX
+    "PT011",   # `pytest.raises(Exception)` is too broad, set the `match` parameter or use a more specific exception
+    "PT018",   # Assertion should be broken down into multiple parts
+    "S101",    # Use of `assert` detected -- DO NOT FIX
+    "S311",    # Standard pseudo-random generators are not suitable for cryptographic purposes -- FIX ME
+    "SLF001",  # Private member accessed: `_Iterator` -- FIX ME
+    "UP038",   # Use `X | Y` in `{}` call instead of `(X, Y)` -- DO NOT FIX
 ]
 
 # Allow fix for all enabled rules (when `--fix`) is provided.
@@ -145,10 +145,6 @@ dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
 
 mccabe.max-complexity = 49
 
-per-file-ignores."docs/conf.py" = [
-    "F401", # Unused import
-]
-
 per-file-ignores."examples/scripts/*.py" = [
     "F821", # Undefined name `app`
 ]