changes based on formatter and doc jobs

cmd2/utils.py

@@ -1274,8 +1274,9 @@ def similarity_function(s1: str, s2: str) -> float:
 MIN_SIMIL_TO_CONSIDER = 0.7
 
 
-def suggest_similar(requested_command: str, options: Iterable[str],
-                    similarity_function_to_use: Optional[Callable[[str, str], float]] = None) -> Optional[str]:
+def suggest_similar(
+        requested_command: str, options: Iterable[str], similarity_function_to_use: Optional[Callable[[str, str], float]] = None
+) -> Optional[str]:
     """
     Given a requested command and an iterable of possible options
     returns the most similar (if any is similar)

docs/api/utils.rst

@@ -99,3 +99,4 @@ Miscellaneous
 .. autofunction:: cmd2.utils.natural_sort
 
 .. autofunction:: cmd2.utils.suggest_similar
+

tests/test_utils.py

@@ -889,20 +889,18 @@ def test_similarity_without_good_canididates():
 
 
 def test_similarity_overwrite_function():
-    suggested_command = cu.suggest_similar("test", ["history", "test"])
+    options = ["history", "test"]
+    suggested_command = cu.suggest_similar("test", options)
     assert suggested_command == 'test'
 
     def custom_similarity_function(s1, s2):
         return 1.0 if 'history' in (s1, s2) else 0.0
 
-    suggested_command = cu.suggest_similar("test", ["history", "test"],
-                                           similarity_function_to_use=custom_similarity_function)
+    suggested_command = cu.suggest_similar("test", options, similarity_function_to_use=custom_similarity_function)
     assert suggested_command == 'history'
 
-    suggested_command = cu.suggest_similar("history", ["history", "test"],
-                                           similarity_function_to_use=custom_similarity_function)
+    suggested_command = cu.suggest_similar("history", options, similarity_function_to_use=custom_similarity_function)
     assert suggested_command == 'history'
 
-    suggested_command = cu.suggest_similar("test", ["test"],
-                                           similarity_function_to_use=custom_similarity_function)
+    suggested_command = cu.suggest_similar("test", ["test"], similarity_function_to_use=custom_similarity_function)
     assert suggested_command is None