Add ruff fast linter and formatter in preparation for using it to rep…

…lace black, isort, and flake8

.gitignore

@@ -43,3 +43,6 @@ Pipfile.lock
 
 # pyenv version file
 .python-version
+
+# uv
+uv.lock

cmd2/ansi.py

@@ -2,7 +2,8 @@
 """
 Support for ANSI escape sequences which are used for things like applying style to text,
 setting the window title, and asynchronous alerts.
- """
+"""
+
 import functools
 import re
 from enum import (
@@ -62,25 +63,25 @@ def __repr__(self) -> str:
 """
 
 # Regular expression to match ANSI style sequence
-ANSI_STYLE_RE = re.compile(fr'{ESC}\[[^m]*m')
+ANSI_STYLE_RE = re.compile(rf'{ESC}\[[^m]*m')
 
 # Matches standard foreground colors: CSI(30-37|90-97|39)m
-STD_FG_RE = re.compile(fr'{ESC}\[(?:[39][0-7]|39)m')
+STD_FG_RE = re.compile(rf'{ESC}\[(?:[39][0-7]|39)m')
 
 # Matches standard background colors: CSI(40-47|100-107|49)m
-STD_BG_RE = re.compile(fr'{ESC}\[(?:(?:4|10)[0-7]|49)m')
+STD_BG_RE = re.compile(rf'{ESC}\[(?:(?:4|10)[0-7]|49)m')
 
 # Matches eight-bit foreground colors: CSI38;5;(0-255)m
-EIGHT_BIT_FG_RE = re.compile(fr'{ESC}\[38;5;(?:1?[0-9]?[0-9]?|2[0-4][0-9]|25[0-5])m')
+EIGHT_BIT_FG_RE = re.compile(rf'{ESC}\[38;5;(?:1?[0-9]?[0-9]?|2[0-4][0-9]|25[0-5])m')
 
 # Matches eight-bit background colors: CSI48;5;(0-255)m
-EIGHT_BIT_BG_RE = re.compile(fr'{ESC}\[48;5;(?:1?[0-9]?[0-9]?|2[0-4][0-9]|25[0-5])m')
+EIGHT_BIT_BG_RE = re.compile(rf'{ESC}\[48;5;(?:1?[0-9]?[0-9]?|2[0-4][0-9]|25[0-5])m')
 
 # Matches RGB foreground colors: CSI38;2;(0-255);(0-255);(0-255)m
-RGB_FG_RE = re.compile(fr'{ESC}\[38;2(?:;(?:1?[0-9]?[0-9]?|2[0-4][0-9]|25[0-5])){{3}}m')
+RGB_FG_RE = re.compile(rf'{ESC}\[38;2(?:;(?:1?[0-9]?[0-9]?|2[0-4][0-9]|25[0-5])){{3}}m')
 
 # Matches RGB background colors: CSI48;2;(0-255);(0-255);(0-255)m
-RGB_BG_RE = re.compile(fr'{ESC}\[48;2(?:;(?:1?[0-9]?[0-9]?|2[0-4][0-9]|25[0-5])){{3}}m')
+RGB_BG_RE = re.compile(rf'{ESC}\[48;2(?:;(?:1?[0-9]?[0-9]?|2[0-4][0-9]|25[0-5])){{3}}m')
 
 
 def strip_style(text: str) -> str:

cmd2/argparse_completer.py

@@ -92,7 +92,7 @@ def _looks_like_flag(token: str, parser: argparse.ArgumentParser) -> bool:
         return False
 
     # Flags have to start with a prefix character
-    if not token[0] in parser.prefix_chars:
+    if token[0] not in parser.prefix_chars:
         return False
 
     # If it looks like a negative number, it is not a flag unless there are negative-number-like flags

cmd2/clipboard.py

@@ -2,6 +2,7 @@
 """
 This module provides basic ability to copy from and paste to the clipboard/pastebuffer.
 """
+
 import typing
 
 import pyperclip  # type: ignore[import]

cmd2/cmd2.py

@@ -21,6 +21,7 @@
 
 Git repository on GitHub at https://github.com/python-cmd2/cmd2
 """
+
 # This module has many imports, quite a few of which are only
 # infrequently utilized. To reduce the initial overhead of
 # import this module, many of these imports are lazy-loaded
@@ -2019,9 +2020,7 @@ def _determine_ap_completer_type(parser: argparse.ArgumentParser) -> Type[argpar
         :param parser: the parser to examine
         :return: type of ArgparseCompleter
         """
-        completer_type: Optional[
-            Type[argparse_completer.ArgparseCompleter]
-        ] = parser.get_ap_completer_type()  # type: ignore[attr-defined]
+        completer_type: Optional[Type[argparse_completer.ArgparseCompleter]] = parser.get_ap_completer_type()
 
         if completer_type is None:
             completer_type = argparse_completer.DEFAULT_AP_COMPLETER
@@ -5537,7 +5536,7 @@ def cmdloop(self, intro: Optional[str] = None) -> int:  # type: ignore[override]
         """
         # cmdloop() expects to be run in the main thread to support extensive use of KeyboardInterrupts throughout the
         # other built-in functions. You are free to override cmdloop, but much of cmd2's features will be limited.
-        if not threading.current_thread() is threading.main_thread():
+        if threading.current_thread() is not threading.main_thread():
             raise RuntimeError("cmdloop must be run in the main thread")
 
         # Register signal handlers

cmd2/command_definition.py

@@ -2,6 +2,7 @@
 """
 Supports the definition of commands in separate classes to be composed into cmd2.Cmd
 """
+
 from typing import (
     TYPE_CHECKING,
     Callable,

cmd2/decorators.py

@@ -1,5 +1,6 @@
 # coding=utf-8
 """Decorators for ``cmd2`` commands"""
+
 import argparse
 from typing import (
     TYPE_CHECKING,

cmd2/plugin.py

@@ -1,6 +1,7 @@
 #
 # coding=utf-8
 """Classes for the cmd2 plugin system"""
+
 from dataclasses import (
     dataclass,
 )

cmd2/rl_utils.py

@@ -2,6 +2,7 @@
 """
 Imports the proper Readline for the platform and provides utility functions for it
 """
+
 import sys
 from enum import (
     Enum,

cmd2/table_creator.py

@@ -5,6 +5,7 @@
 The general use case is to inherit from TableCreator to create a table class with custom formatting options.
 There are already implemented and ready-to-use examples of this below TableCreator's code.
 """
+
 import copy
 import io
 from collections import (

cmd2/transcript.py

@@ -9,6 +9,7 @@
 This file contains the class necessary to make that work. This
 class is used in cmd2.py::run_transcript_tests()
 """
+
 import re
 import unittest
 from typing import (

cmd2/utils.py

@@ -1,5 +1,6 @@
 # coding=utf-8
 """Shared utility functions"""
+
 import argparse
 import collections
 import functools
@@ -157,7 +158,7 @@ def __init__(
         :param choices_provider: function that provides choices for this argument
         :param completer: tab completion function that provides choices for this argument
         """
-        if val_type == bool:
+        if val_type is bool:
 
             def get_bool_choices(_) -> List[str]:  # type: ignore[no-untyped-def]
                 """Used to tab complete lowercase boolean values"""
@@ -1189,9 +1190,7 @@ def get_defining_class(meth: Callable[..., Any]) -> Optional[Type[Any]]:
     if isinstance(meth, functools.partial):
         return get_defining_class(meth.func)
     if inspect.ismethod(meth) or (
-        inspect.isbuiltin(meth)
-        and getattr(meth, '__self__') is not None
-        and getattr(meth.__self__, '__class__')  # type: ignore[attr-defined]
+        inspect.isbuiltin(meth) and getattr(meth, '__self__') is not None and getattr(meth.__self__, '__class__')
     ):
         for cls in inspect.getmro(meth.__self__.__class__):  # type: ignore[attr-defined]
             if meth.__name__ in cls.__dict__:

examples/alias_startup.py

@@ -1,9 +1,10 @@
 #!/usr/bin/env python
 # coding=utf-8
 """A simple example demonstrating the following:
-    1) How to add custom command aliases using the alias command
-    2) How to run an initialization script at startup
+1) How to add custom command aliases using the alias command
+2) How to run an initialization script at startup
 """
+
 import os
 
 import cmd2

examples/arg_decorators.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # coding=utf-8
 """An example demonstrating how use one of cmd2's argument parsing decorators"""
+
 import argparse
 import os
 

examples/argparse_completion.py

@@ -3,6 +3,7 @@
 """
 A simple example demonstrating how to integrate tab completion with argparse-based commands.
 """
+
 import argparse
 from typing import (
     Dict,

examples/async_printing.py

@@ -4,6 +4,7 @@
 A simple example demonstrating an application that asynchronously prints alerts, updates the prompt
 and changes the window title
 """
+
 import random
 import threading
 import time

examples/basic.py

@@ -1,13 +1,14 @@
 #!/usr/bin/env python3
 # coding=utf-8
 """A simple example demonstrating the following:
-    1) How to add a command
-    2) How to add help for that command
-    3) Persistent history
-    4) How to run an initialization script at startup
-    5) How to add custom command aliases using the alias command
-    6) Shell-like capabilities
+1) How to add a command
+2) How to add help for that command
+3) Persistent history
+4) How to run an initialization script at startup
+5) How to add custom command aliases using the alias command
+6) Shell-like capabilities
 """
+
 import cmd2
 from cmd2 import (
     Bg,

examples/basic_completion.py

@@ -12,6 +12,7 @@
 familiar with argparse. The recommended approach for tab completing positional tokens and flags is to use
 argparse-based completion. For an example integrating tab completion with argparse, see argparse_completion.py
 """
+
 import functools
 from typing import (
     List,

examples/custom_parser.py

@@ -2,6 +2,7 @@
 """
 Defines the CustomParser used with override_parser.py example
 """
+
 import sys
 
 from cmd2 import (

examples/decorator_example.py

@@ -10,6 +10,7 @@
 all the commands in the transcript against decorator_example.py,
 verifying that the output produced matches the transcript.
 """
+
 import argparse
 from typing import (
     List,

examples/dynamic_commands.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # coding=utf-8
-"""A simple example demonstrating how do_* commands can be created in a loop.
-"""
+"""A simple example demonstrating how do_* commands can be created in a loop."""
+
 import functools
 
 import cmd2

examples/environment.py

@@ -3,6 +3,7 @@
 """
 A sample application for cmd2 demonstrating customized environment parameters
 """
+
 import cmd2
 
 

examples/event_loops.py

@@ -6,6 +6,7 @@
 
 This opens up the possibility of registering cmd2 input with event loops, like asyncio, without occupying the main loop.
 """
+
 import cmd2
 
 

examples/example.py

@@ -10,6 +10,7 @@
 the transcript against example.py, verifying that the output produced matches
 the transcript.
 """
+
 import random
 
 import cmd2

examples/exit_code.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # coding=utf-8
-"""A simple example demonstrating the following how to emit a non-zero exit code in your cmd2 application.
-"""
+"""A simple example demonstrating the following how to emit a non-zero exit code in your cmd2 application."""
+
 from typing import (
     List,
 )

examples/hello_cmd2.py

@@ -3,6 +3,7 @@
 """
 This is intended to be a completely bare-bones cmd2 application suitable for rapid testing and debugging.
 """
+
 from cmd2 import (
     cmd2,
 )

examples/help_categories.py

@@ -5,6 +5,7 @@
 
 It also demonstrates the effects of decorator order when it comes to argparse errors occurring.
 """
+
 import functools
 
 import cmd2

examples/initialization.py

@@ -1,17 +1,18 @@
 #!/usr/bin/env python3
 # coding=utf-8
 """A simple example cmd2 application demonstrating the following:
-     1) Colorizing/stylizing output
-     2) Using multiline commands
-     3) Persistent history
-     4) How to run an initialization script at startup
-     5) How to group and categorize commands when displaying them in help
-     6) Opting-in to using the ipy command to run an IPython shell
-     7) Allowing access to your application in py and ipy
-     8) Displaying an intro banner upon starting your application
-     9) Using a custom prompt
-    10) How to make custom attributes settable at runtime
+ 1) Colorizing/stylizing output
+ 2) Using multiline commands
+ 3) Persistent history
+ 4) How to run an initialization script at startup
+ 5) How to group and categorize commands when displaying them in help
+ 6) Opting-in to using the ipy command to run an IPython shell
+ 7) Allowing access to your application in py and ipy
+ 8) Displaying an intro banner upon starting your application
+ 9) Using a custom prompt
+10) How to make custom attributes settable at runtime
 """
+
 import cmd2
 from cmd2 import (
     Bg,

examples/migrating.py

@@ -3,6 +3,7 @@
 """
 A sample application for cmd which can be used to show how to migrate to cmd2.
 """
+
 import cmd
 import random
 

examples/modular_commands/commandset_basic.py

@@ -2,6 +2,7 @@
 """
 A simple example demonstrating a loadable command set
 """
+
 from typing import (
     List,
 )

examples/modular_commands/commandset_custominit.py

@@ -2,6 +2,7 @@
 """
 A simple example demonstrating a loadable command set
 """
+
 from cmd2 import (
     Cmd,
     CommandSet,

examples/modular_commands_main.py

@@ -4,6 +4,7 @@
 A complex example demonstrating a variety of methods to load CommandSets using a mix of command decorators
 with examples of how to integrate tab completion with argparse-based commands.
 """
+
 import argparse
 from typing import (
     Iterable,

examples/modular_subcommands.py

@@ -10,6 +10,7 @@
 The `load` and `unload` command will load and unload the CommandSets. The available top level commands as well as
 subcommands to the `cut` command will change depending on which CommandSets are loaded.
 """
+
 import argparse
 
 import cmd2

examples/paged_output.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # coding=utf-8
-"""A simple example demonstrating the using paged output via the ppaged() method.
-"""
+"""A simple example demonstrating the using paged output via the ppaged() method."""
+
 import os
 from typing import (
     List,

examples/persistent_history.py

@@ -5,6 +5,7 @@
 This will allow end users of your cmd2-based application to use the arrow keys and Ctrl+r in a manner which persists
 across invocations of your cmd2 application.  This can make it much easier for them to use your application.
 """
+
 import cmd2