breakpoint() is the recommended debugging tool

Author: mdmintz

README.md

@@ -617,8 +617,6 @@ import time; time.sleep(3)  # Do nothing for 3 seconds.
 🔵 **Debug Mode** with Python's built-in **[pdb](https://docs.python.org/3/library/pdb.html)** library helps you debug tests:
 
 ```python
-import pdb; pdb.set_trace()
-import pytest; pytest.set_trace()
 breakpoint()  # Shortcut for "import pdb; pdb.set_trace()"
 ```
 

help_docs/customizing_test_runs.md

@@ -294,12 +294,10 @@ pytest --reruns=1 --reruns-delay=1
 
 <h3><img src="https://seleniumbase.github.io/img/green_logo.png" title="SeleniumBase" width="32" /> Debugging tests:</h3>
 
-🔵 You can use the following calls in your scripts to help you debug issues:
+🔵 Use `breakpoint()` in your scripts to help you debug issues:
 
 ```python
-import time; time.sleep(5)  # Makes the test wait and do nothing for 5 seconds.
-import pdb; pdb.set_trace()  # Debug Mode. n: next, c: continue, s: step, u: up, d: down.
-import pytest; pytest.set_trace()  # Debug Mode. n: next, c: continue, s: step, u: up, d: down.
+breakpoint()  # Debug Mode. n: next, c: continue, s: step, u: up, d: down.
 ```
 
 🔵 To pause an active test that throws an exception or error, (*and keep the browser window open while **Debug Mode** begins in the console*), add **`--pdb`** as a `pytest` option:

help_docs/recorder_mode.md

@@ -36,7 +36,7 @@ pytest new_test.py --rec -q -s --url=wikipedia.org
    6             if self.recorder_ext:
    7                 # When done recording actions,
    8                 # type "c", and press [Enter].
-   9  ->             import pdb; pdb.set_trace()
+   9  ->             breakpoint()
  return None
 (Pdb+) c
 
@@ -80,7 +80,7 @@ The first command creates a boilerplate test with a breakpoint; the second comma
 ⏺️ You can also use the Recorder to add code to an existing test. To do that, you'll first need to create a breakpoint in your code to insert manual browser actions:
 
 ```python
-import pdb; pdb.set_trace()
+breakpoint()
 ```
 
 Now you'll be able to run your test with ``pytest``, and it will stop at the breakpoint for you to add in actions: (Press ``c`` and ``ENTER`` on the command-line to continue from the breakpoint.)

seleniumbase/console_scripts/sb_mkfile.py

@@ -277,7 +277,7 @@ def main():
         data.append('        self.open("%s")' % url)
     else:
         data.append("        if self.recorder_ext and not self.xvfb:")
-        data.append("            import pdb; pdb.set_trace()")
+        data.append("            breakpoint()")
     if not basic and not recorder:
         data.append(
             '        self.type("input", "%s")' "  # selector, text" % goodbye

seleniumbase/console_scripts/sb_mkrec.py

@@ -216,7 +216,7 @@ def main():
     data.append("        if self.recorder_ext:")
     data.append("            # When done recording actions,")
     data.append('            # type "c", and press [Enter].')
-    data.append("            import pdb; pdb.set_trace()")
+    data.append("            breakpoint()")
     data.append("")
 
     if esc_end:

seleniumbase/plugins/sb_manager.py

@@ -1408,9 +1408,7 @@ def SB(
     test_passed = True  # This can change later
     teardown_exception = None
     if "--trace" in sys_argv:
-        import pdb
-
-        pdb.set_trace()  # Debug Mode
+        breakpoint()  # Debug Mode
         # Type "s" and press [Enter] to step into "yield sb".
     try:
         yield sb