Update commands: "sbase methods" & "sbase options"

Author: mdmintz

seleniumbase/console_scripts/run.py

@@ -717,15 +717,18 @@ def show_methods():
     sbm += "*.type(selector, text) => Update the field with the text.\n"
     sbm += "*.click(selector) => Click the element with the selector.\n"
     sbm += "*.click_link(link_text) => Click the link containing text.\n"
-    sbm += "*.go_back() => Navigate back to the previous URL.\n"
+    sbm += "*.check_if_unchecked(selector) => Check checkbox if unchecked.\n"
+    sbm += "*.uncheck_if_checked(selector) => Uncheck checkbox if checked.\n"
     sbm += "*.select_option_by_text(dropdown_selector, option)\n"
     sbm += "*.hover_and_click(hover_selector, click_selector)\n"
     sbm += "*.drag_and_drop(drag_selector, drop_selector)\n"
+    sbm += "*.choose_file(selector, file_path) => Choose a file to upload.\n"
     sbm += "*.get_text(selector) => Get the text from the element.\n"
     sbm += "*.get_current_url() => Get the URL of the current page.\n"
     sbm += "*.get_page_source() => Get the HTML of the current page.\n"
     sbm += "*.get_attribute(selector, attribute) => Get element attribute.\n"
     sbm += "*.get_title() => Get the title of the current page.\n"
+    sbm += "*.go_back() => Navigate to the previous page in history.\n"
     sbm += "*.switch_to_frame(frame) => Switch into the iframe container.\n"
     sbm += "*.switch_to_default_content() => Exit all iframe containers.\n"
     sbm += "*.switch_to_parent_frame() => Exit from the current iframe.\n"
@@ -736,13 +739,20 @@ def show_methods():
     sbm += "*.switch_to_driver(driver) => Switch to the browser driver.\n"
     sbm += "*.switch_to_default_driver() => Switch to the original driver.\n"
     sbm += "*.wait_for_element(selector) => Wait until element is visible.\n"
+    sbm += "*.wait_for_element_present(selector) => Until element in HTML.\n"
     sbm += "*.is_element_visible(selector) => Return element visibility.\n"
+    sbm += "*.is_element_present(selector) => Return element is in HTML.\n"
     sbm += "*.is_text_visible(text, selector) => Return text visibility.\n"
+    sbm += "*.is_checked(selector) => Return whether the box is checked.\n"
     sbm += "*.sleep(seconds) => Do nothing for the given amount of time.\n"
     sbm += "*.save_screenshot(name) => Save a screenshot in .png format.\n"
     sbm += "*.assert_element(selector) => Verify the element is visible.\n"
     sbm += "*.assert_text(text, selector) => Verify text in the element.\n"
+    sbm += "*.assert_exact_text(text, selector) => Verify text is exact.\n"
+    sbm += "*.assert_url(url) => Verify that the current URL is the URL.\n"
+    sbm += "*.assert_url_contains(substring) => Verify substring in URL.\n"
     sbm += "*.assert_title(title) => Verify the title of the web page.\n"
+    sbm += "*.assert_title_contains(substring) => Verify STR in title.\n"
     sbm += "*.assert_downloaded_file(file) => Verify file was downloaded.\n"
     sbm += "*.assert_no_404_errors() => Verify there are no broken links.\n"
     sbm += "*.assert_no_js_errors() => Verify there are no JS errors.\n"
@@ -769,15 +779,17 @@ def show_options():
     line = '(Some options are Chromium-specific, e.g. "--guest --mobile")'
     print(line)
     op = "\n"
-    op += '--browser=BROWSER  (The web browser to use. Default is "chrome")\n'
-    op += "--headless  (Run tests headlessly. Default mode on Linux OS.)\n"
+    op += '--browser=BROWSER  (Choice of web browser. Default is "chrome".)\n'
+    op += "--edge / --firefox / --safari  (Shortcut for browser selection.)\n"
+    op += "--headless  (Run tests headlessly. Default setting on Linux OS.)\n"
     op += "--demo  (Slow down and visually see test actions as they occur.)\n"
     op += "--slow  (Slow down the automation. Faster than using Demo Mode.)\n"
     op += "--reuse-session / --rs  (Reuse browser session between tests.)\n"
+    op += "--reuse-class-session / --rcs  (RS, but for class tests only.)\n"
     op += "--crumbs  (Clear all cookies between tests reusing a session.)\n"
     op += "--maximize  (Start tests with the web browser window maximized.)\n"
     op += "--dashboard  (Enable SeleniumBase's Dashboard at dashboard.html)\n"
-    op += "--uc  (Enable undetected-chromedriver to evade bot-detection.)\n"
+    op += "--uc  (Use undetected-chromedriver mode to evade bot-detection.)\n"
     op += "--incognito  (Enable Chromium's Incognito mode.)\n"
     op += "--guest  (Enable Chromium's Guest mode.)\n"
     op += "-m=MARKER  (Run tests with the specified pytest marker.)\n"
@@ -794,10 +806,12 @@ def show_options():
     op += "      |  return / r: Run until method returns. j: Jump to line. |\n"
     op += "      | where / w: Show stack spot. u: Up stack. d: Down stack. |\n"
     op += "      | longlist / ll: See code. dir(): List namespace objects. |\n"
+    op += "--help / -h  (Display list of all available pytest options.)\n"
     op += "--final-debug  (Enter Final Debug Mode after each test ends.)\n"
-    op += "--recorder  (Record browser actions to generate test scripts.)\n"
+    op += "--recorder / --rec  (Save browser actions as Python scripts.)\n"
+    op += "--rec-behave / --rec-gherkin  (Save actions as Gherkin code.)\n"
     op += "--save-screenshot  (Save a screenshot at the end of each test.)\n"
-    op += "--archive-logs  (Archive old log files instead of deleting them.)\n"
+    op += "--archive-logs  (Archive logs after tests to prevent deletion.)\n"
     op += "--check-js  (Check for JavaScript errors after page loads.)\n"
     op += "--start-page=URL  (The browser start page when tests begin.)\n"
     op += "--agent=STRING  (Modify the web browser's User-Agent string.)\n"