seleniumbase 4.24.11__py3-none-any.whl → 4.33.15__py3-none-any.whl

Sign up to get free protection for your applications and to get access to all the features.
Files changed (78) hide show
  1. sbase/__init__.py +1 -0
  2. sbase/steps.py +7 -0
  3. seleniumbase/__init__.py +16 -7
  4. seleniumbase/__version__.py +1 -1
  5. seleniumbase/behave/behave_sb.py +97 -32
  6. seleniumbase/common/decorators.py +16 -7
  7. seleniumbase/config/proxy_list.py +3 -3
  8. seleniumbase/config/settings.py +4 -0
  9. seleniumbase/console_scripts/logo_helper.py +47 -8
  10. seleniumbase/console_scripts/run.py +345 -335
  11. seleniumbase/console_scripts/sb_behave_gui.py +5 -12
  12. seleniumbase/console_scripts/sb_caseplans.py +6 -13
  13. seleniumbase/console_scripts/sb_commander.py +5 -12
  14. seleniumbase/console_scripts/sb_install.py +62 -54
  15. seleniumbase/console_scripts/sb_mkchart.py +13 -20
  16. seleniumbase/console_scripts/sb_mkdir.py +11 -17
  17. seleniumbase/console_scripts/sb_mkfile.py +69 -43
  18. seleniumbase/console_scripts/sb_mkpres.py +13 -20
  19. seleniumbase/console_scripts/sb_mkrec.py +88 -21
  20. seleniumbase/console_scripts/sb_objectify.py +30 -30
  21. seleniumbase/console_scripts/sb_print.py +5 -12
  22. seleniumbase/console_scripts/sb_recorder.py +16 -11
  23. seleniumbase/core/browser_launcher.py +1658 -221
  24. seleniumbase/core/log_helper.py +42 -27
  25. seleniumbase/core/mysql.py +1 -4
  26. seleniumbase/core/proxy_helper.py +35 -30
  27. seleniumbase/core/recorder_helper.py +24 -5
  28. seleniumbase/core/sb_cdp.py +1951 -0
  29. seleniumbase/core/sb_driver.py +162 -8
  30. seleniumbase/core/settings_parser.py +6 -0
  31. seleniumbase/core/style_sheet.py +10 -0
  32. seleniumbase/extensions/recorder.zip +0 -0
  33. seleniumbase/fixtures/base_case.py +1225 -614
  34. seleniumbase/fixtures/constants.py +10 -1
  35. seleniumbase/fixtures/js_utils.py +171 -144
  36. seleniumbase/fixtures/page_actions.py +177 -13
  37. seleniumbase/fixtures/page_utils.py +25 -53
  38. seleniumbase/fixtures/shared_utils.py +97 -11
  39. seleniumbase/js_code/active_css_js.py +1 -1
  40. seleniumbase/js_code/recorder_js.py +1 -1
  41. seleniumbase/plugins/base_plugin.py +2 -3
  42. seleniumbase/plugins/driver_manager.py +340 -65
  43. seleniumbase/plugins/pytest_plugin.py +276 -47
  44. seleniumbase/plugins/sb_manager.py +412 -99
  45. seleniumbase/plugins/selenium_plugin.py +122 -17
  46. seleniumbase/translate/translator.py +0 -7
  47. seleniumbase/undetected/__init__.py +59 -52
  48. seleniumbase/undetected/cdp.py +0 -1
  49. seleniumbase/undetected/cdp_driver/__init__.py +1 -0
  50. seleniumbase/undetected/cdp_driver/_contradict.py +110 -0
  51. seleniumbase/undetected/cdp_driver/browser.py +829 -0
  52. seleniumbase/undetected/cdp_driver/cdp_util.py +458 -0
  53. seleniumbase/undetected/cdp_driver/config.py +334 -0
  54. seleniumbase/undetected/cdp_driver/connection.py +639 -0
  55. seleniumbase/undetected/cdp_driver/element.py +1168 -0
  56. seleniumbase/undetected/cdp_driver/tab.py +1323 -0
  57. seleniumbase/undetected/dprocess.py +4 -7
  58. seleniumbase/undetected/options.py +6 -8
  59. seleniumbase/undetected/patcher.py +11 -13
  60. seleniumbase/undetected/reactor.py +0 -1
  61. seleniumbase/undetected/webelement.py +16 -3
  62. {seleniumbase-4.24.11.dist-info → seleniumbase-4.33.15.dist-info}/LICENSE +1 -1
  63. {seleniumbase-4.24.11.dist-info → seleniumbase-4.33.15.dist-info}/METADATA +299 -252
  64. {seleniumbase-4.24.11.dist-info → seleniumbase-4.33.15.dist-info}/RECORD +67 -69
  65. {seleniumbase-4.24.11.dist-info → seleniumbase-4.33.15.dist-info}/WHEEL +1 -1
  66. sbase/ReadMe.txt +0 -2
  67. seleniumbase/ReadMe.md +0 -25
  68. seleniumbase/common/ReadMe.md +0 -71
  69. seleniumbase/console_scripts/ReadMe.md +0 -731
  70. seleniumbase/drivers/ReadMe.md +0 -27
  71. seleniumbase/extensions/ReadMe.md +0 -12
  72. seleniumbase/masterqa/ReadMe.md +0 -61
  73. seleniumbase/resources/ReadMe.md +0 -31
  74. seleniumbase/resources/favicon.ico +0 -0
  75. seleniumbase/utilities/selenium_grid/ReadMe.md +0 -84
  76. seleniumbase/utilities/selenium_ide/ReadMe.md +0 -111
  77. {seleniumbase-4.24.11.dist-info → seleniumbase-4.33.15.dist-info}/entry_points.txt +0 -0
  78. {seleniumbase-4.24.11.dist-info → seleniumbase-4.33.15.dist-info}/top_level.txt +0 -0
{seleniumbase-4.24.11.dist-info → seleniumbase-4.33.15.dist-info}/METADATA RENAMED
@@ -1,18 +1,20 @@
1
- Metadata-Version: 2.1
1
+ Metadata-Version: 2.2
2
2
  Name: seleniumbase
3
- Version: 4.24.11
3
+ Version: 4.33.15
4
4
  Summary: A complete web automation framework for end-to-end testing.
5
5
  Home-page: https://github.com/seleniumbase/SeleniumBase
6
6
  Author: Michael Mintz
7
7
  Author-email: mdmintz@gmail.com
8
8
  Maintainer: Michael Mintz
9
9
  License: MIT
10
+ Project-URL: Homepage, https://github.com/seleniumbase/SeleniumBase
10
11
  Project-URL: Changelog, https://github.com/seleniumbase/SeleniumBase/releases
11
12
  Project-URL: Download, https://pypi.org/project/seleniumbase/#files
12
- Project-URL: Gitter, https://gitter.im/seleniumbase/SeleniumBase
13
13
  Project-URL: Blog, https://seleniumbase.com/
14
+ Project-URL: Discord, https://discord.gg/EdhQTn3EyE
14
15
  Project-URL: PyPI, https://pypi.org/project/seleniumbase/
15
16
  Project-URL: Source, https://github.com/seleniumbase/SeleniumBase
17
+ Project-URL: Repository, https://github.com/seleniumbase/SeleniumBase
16
18
  Project-URL: Documentation, https://seleniumbase.io/
17
19
  Keywords: pytest,selenium,framework,automation,browser,testing,webdriver,seleniumbase,sbase,crawling,scraping
18
20
  Platform: Windows
@@ -32,7 +34,6 @@ Classifier: Operating System :: Microsoft :: Windows
32
34
  Classifier: Operating System :: POSIX :: Linux
33
35
  Classifier: Programming Language :: Python
34
36
  Classifier: Programming Language :: Python :: 3
35
- Classifier: Programming Language :: Python :: 3.7
36
37
  Classifier: Programming Language :: Python :: 3.8
37
38
  Classifier: Programming Language :: Python :: 3.9
38
39
  Classifier: Programming Language :: Python :: 3.10
@@ -55,161 +56,185 @@ Classifier: Topic :: Software Development :: Testing
55
56
  Classifier: Topic :: Software Development :: Testing :: Acceptance
56
57
  Classifier: Topic :: Software Development :: Testing :: Traffic Generation
57
58
  Classifier: Topic :: Utilities
58
- Requires-Python: >=3.7
59
+ Requires-Python: >=3.8
59
60
  Description-Content-Type: text/markdown
60
61
  License-File: LICENSE
61
- Requires-Dist: pip >=24.0
62
- Requires-Dist: packaging >=24.0
63
- Requires-Dist: attrs >=23.2.0
64
- Requires-Dist: certifi >=2024.2.2
65
- Requires-Dist: parse >=1.20.1
66
- Requires-Dist: parse-type >=0.6.2
67
- Requires-Dist: pyyaml >=6.0.1
68
- Requires-Dist: six ==1.16.0
69
- Requires-Dist: idna ==3.6
70
- Requires-Dist: chardet ==5.2.0
71
- Requires-Dist: charset-normalizer ==3.3.2
72
- Requires-Dist: requests ==2.31.0
73
- Requires-Dist: pynose ==1.5.0
74
- Requires-Dist: sniffio ==1.3.1
75
- Requires-Dist: h11 ==0.14.0
76
- Requires-Dist: outcome ==1.3.0.post0
77
- Requires-Dist: trio-websocket ==0.11.1
78
- Requires-Dist: wsproto ==1.2.0
79
- Requires-Dist: cssselect ==1.2.0
80
- Requires-Dist: sortedcontainers ==2.4.0
81
- Requires-Dist: fasteners ==0.19
82
- Requires-Dist: execnet ==2.0.2
83
- Requires-Dist: iniconfig ==2.0.0
84
- Requires-Dist: py ==1.11.0
85
- Requires-Dist: pytest-html ==2.0.1
86
- Requires-Dist: pytest-ordering ==0.6
87
- Requires-Dist: pytest-xdist ==3.5.0
88
- Requires-Dist: parameterized ==0.9.0
89
- Requires-Dist: sbvirtualdisplay ==1.3.0
90
- Requires-Dist: behave ==1.2.6
91
- Requires-Dist: beautifulsoup4 ==4.12.3
92
- Requires-Dist: pygments ==2.17.2
93
- Requires-Dist: tabcompleter ==1.3.0
94
- Requires-Dist: pdbp ==1.5.0
95
- Requires-Dist: colorama ==0.4.6
96
- Requires-Dist: exceptiongroup ==1.2.0
97
- Requires-Dist: pyotp ==2.9.0
98
- Requires-Dist: mdurl ==0.1.2
99
- Requires-Dist: rich ==13.7.1
100
- Requires-Dist: pyreadline3 ==3.4.1 ; platform_system == "Windows"
101
- Requires-Dist: urllib3 <2,>=1.26.18 ; python_version < "3.10"
102
- Requires-Dist: setuptools >=68.0.0 ; python_version < "3.8"
103
- Requires-Dist: wheel >=0.42.0 ; python_version < "3.8"
104
- Requires-Dist: filelock >=3.12.2 ; python_version < "3.8"
105
- Requires-Dist: platformdirs >=4.0.0 ; python_version < "3.8"
106
- Requires-Dist: trio ==0.22.2 ; python_version < "3.8"
107
- Requires-Dist: selenium ==4.11.2 ; python_version < "3.8"
108
- Requires-Dist: pluggy ==1.2.0 ; python_version < "3.8"
109
- Requires-Dist: pytest ==7.4.4 ; python_version < "3.8"
110
- Requires-Dist: pytest-metadata ==3.0.0 ; python_version < "3.8"
111
- Requires-Dist: pytest-rerunfailures ==13.0 ; python_version < "3.8"
112
- Requires-Dist: soupsieve ==2.4.1 ; python_version < "3.8"
113
- Requires-Dist: markdown-it-py ==2.2.0 ; python_version < "3.8"
114
- Requires-Dist: urllib3 <2.3.0,>=1.26.18 ; python_version >= "3.10"
115
- Requires-Dist: setuptools >=69.2.0 ; python_version >= "3.8"
116
- Requires-Dist: wheel >=0.43.0 ; python_version >= "3.8"
117
- Requires-Dist: filelock >=3.13.1 ; python_version >= "3.8"
118
- Requires-Dist: platformdirs >=4.2.0 ; python_version >= "3.8"
119
- Requires-Dist: typing-extensions >=4.10.0 ; python_version >= "3.8"
120
- Requires-Dist: trio ==0.24.0 ; python_version >= "3.8"
121
- Requires-Dist: selenium ==4.18.1 ; python_version >= "3.8"
122
- Requires-Dist: pluggy ==1.4.0 ; python_version >= "3.8"
123
- Requires-Dist: pytest ==8.1.1 ; python_version >= "3.8"
124
- Requires-Dist: pytest-metadata ==3.1.1 ; python_version >= "3.8"
125
- Requires-Dist: pytest-rerunfailures ==14.0 ; python_version >= "3.8"
126
- Requires-Dist: soupsieve ==2.5 ; python_version >= "3.8"
127
- Requires-Dist: markdown-it-py ==3.0.0 ; python_version >= "3.8"
62
+ Requires-Dist: pip>=24.3.1
63
+ Requires-Dist: packaging>=24.2
64
+ Requires-Dist: setuptools~=70.2; python_version < "3.10"
65
+ Requires-Dist: setuptools>=75.8.0; python_version >= "3.10"
66
+ Requires-Dist: wheel>=0.45.1
67
+ Requires-Dist: attrs>=24.3.0
68
+ Requires-Dist: certifi>=2024.12.14
69
+ Requires-Dist: exceptiongroup>=1.2.2
70
+ Requires-Dist: websockets~=13.1; python_version < "3.9"
71
+ Requires-Dist: websockets>=14.1; python_version >= "3.9"
72
+ Requires-Dist: filelock>=3.16.1
73
+ Requires-Dist: fasteners>=0.19
74
+ Requires-Dist: mycdp>=1.1.0
75
+ Requires-Dist: pynose>=1.5.3
76
+ Requires-Dist: platformdirs>=4.3.6
77
+ Requires-Dist: typing-extensions>=4.12.2
78
+ Requires-Dist: sbvirtualdisplay>=1.4.0
79
+ Requires-Dist: MarkupSafe==2.1.5; python_version < "3.9"
80
+ Requires-Dist: MarkupSafe>=3.0.2; python_version >= "3.9"
81
+ Requires-Dist: Jinja2>=3.1.5
82
+ Requires-Dist: six>=1.17.0
83
+ Requires-Dist: parse>=1.20.2
84
+ Requires-Dist: parse-type>=0.6.4
85
+ Requires-Dist: colorama>=0.4.6
86
+ Requires-Dist: pyyaml>=6.0.2
87
+ Requires-Dist: pygments>=2.19.1
88
+ Requires-Dist: pyreadline3>=3.5.3; platform_system == "Windows"
89
+ Requires-Dist: tabcompleter>=1.4.0
90
+ Requires-Dist: pdbp>=1.6.1
91
+ Requires-Dist: idna==3.10
92
+ Requires-Dist: chardet==5.2.0
93
+ Requires-Dist: charset-normalizer==3.4.1
94
+ Requires-Dist: urllib3<2,>=1.26.20; python_version < "3.10"
95
+ Requires-Dist: urllib3<2.4.0,>=1.26.20; python_version >= "3.10"
96
+ Requires-Dist: requests==2.32.3
97
+ Requires-Dist: sniffio==1.3.1
98
+ Requires-Dist: h11==0.14.0
99
+ Requires-Dist: outcome==1.3.0.post0
100
+ Requires-Dist: trio==0.27.0; python_version < "3.9"
101
+ Requires-Dist: trio==0.28.0; python_version >= "3.9"
102
+ Requires-Dist: trio-websocket==0.11.1
103
+ Requires-Dist: wsproto==1.2.0
104
+ Requires-Dist: websocket-client==1.8.0
105
+ Requires-Dist: selenium==4.27.1
106
+ Requires-Dist: cssselect==1.2.0
107
+ Requires-Dist: sortedcontainers==2.4.0
108
+ Requires-Dist: execnet==2.1.1
109
+ Requires-Dist: iniconfig==2.0.0
110
+ Requires-Dist: pluggy==1.5.0
111
+ Requires-Dist: pytest==8.3.4
112
+ Requires-Dist: pytest-html==4.0.2
113
+ Requires-Dist: pytest-metadata==3.1.1
114
+ Requires-Dist: pytest-ordering==0.6
115
+ Requires-Dist: pytest-rerunfailures==14.0; python_version < "3.9"
116
+ Requires-Dist: pytest-rerunfailures==15.0; python_version >= "3.9"
117
+ Requires-Dist: pytest-xdist==3.6.1
118
+ Requires-Dist: parameterized==0.9.0
119
+ Requires-Dist: behave==1.2.6
120
+ Requires-Dist: soupsieve==2.6
121
+ Requires-Dist: beautifulsoup4==4.12.3
122
+ Requires-Dist: pyotp==2.9.0
123
+ Requires-Dist: python-xlib==0.33; platform_system == "Linux"
124
+ Requires-Dist: markdown-it-py==3.0.0
125
+ Requires-Dist: mdurl==0.1.2
126
+ Requires-Dist: rich==13.9.4
128
127
  Provides-Extra: allure
129
- Requires-Dist: allure-pytest ==2.13.3 ; extra == 'allure'
130
- Requires-Dist: allure-python-commons ==2.13.3 ; extra == 'allure'
131
- Requires-Dist: allure-behave ==2.13.3 ; extra == 'allure'
128
+ Requires-Dist: allure-pytest>=2.13.5; extra == "allure"
129
+ Requires-Dist: allure-python-commons>=2.13.5; extra == "allure"
130
+ Requires-Dist: allure-behave>=2.13.5; extra == "allure"
132
131
  Provides-Extra: coverage
133
- Requires-Dist: pytest-cov ==4.1.0 ; extra == 'coverage'
134
- Requires-Dist: coverage ==7.2.7 ; (python_version < "3.8") and extra == 'coverage'
135
- Requires-Dist: coverage ==7.4.4 ; (python_version >= "3.8") and extra == 'coverage'
132
+ Requires-Dist: coverage>=7.6.1; python_version < "3.9" and extra == "coverage"
133
+ Requires-Dist: coverage>=7.6.10; python_version >= "3.9" and extra == "coverage"
134
+ Requires-Dist: pytest-cov>=5.0.0; python_version < "3.9" and extra == "coverage"
135
+ Requires-Dist: pytest-cov>=6.0.0; python_version >= "3.9" and extra == "coverage"
136
136
  Provides-Extra: flake8
137
- Requires-Dist: mccabe ==0.7.0 ; extra == 'flake8'
138
- Requires-Dist: flake8 ==5.0.4 ; (python_version < "3.9") and extra == 'flake8'
139
- Requires-Dist: pyflakes ==2.5.0 ; (python_version < "3.9") and extra == 'flake8'
140
- Requires-Dist: pycodestyle ==2.9.1 ; (python_version < "3.9") and extra == 'flake8'
141
- Requires-Dist: flake8 ==7.0.0 ; (python_version >= "3.9") and extra == 'flake8'
142
- Requires-Dist: pyflakes ==3.2.0 ; (python_version >= "3.9") and extra == 'flake8'
143
- Requires-Dist: pycodestyle ==2.11.1 ; (python_version >= "3.9") and extra == 'flake8'
137
+ Requires-Dist: flake8==5.0.4; python_version < "3.9" and extra == "flake8"
138
+ Requires-Dist: flake8==7.1.1; python_version >= "3.9" and extra == "flake8"
139
+ Requires-Dist: mccabe==0.7.0; extra == "flake8"
140
+ Requires-Dist: pyflakes==2.5.0; python_version < "3.9" and extra == "flake8"
141
+ Requires-Dist: pyflakes==3.2.0; python_version >= "3.9" and extra == "flake8"
142
+ Requires-Dist: pycodestyle==2.9.1; python_version < "3.9" and extra == "flake8"
143
+ Requires-Dist: pycodestyle==2.12.1; python_version >= "3.9" and extra == "flake8"
144
144
  Provides-Extra: ipdb
145
- Requires-Dist: ipdb ==0.13.13 ; extra == 'ipdb'
146
- Requires-Dist: ipython ==7.34.0 ; extra == 'ipdb'
145
+ Requires-Dist: ipdb==0.13.13; extra == "ipdb"
146
+ Requires-Dist: ipython==7.34.0; extra == "ipdb"
147
+ Provides-Extra: mss
148
+ Requires-Dist: mss==9.0.2; extra == "mss"
147
149
  Provides-Extra: pdfminer
148
- Requires-Dist: pycparser ==2.21 ; extra == 'pdfminer'
149
- Requires-Dist: pdfminer.six ==20221105 ; (python_version < "3.8") and extra == 'pdfminer'
150
- Requires-Dist: cffi ==1.15.1 ; (python_version < "3.8") and extra == 'pdfminer'
151
- Requires-Dist: cryptography ==39.0.2 ; (python_version < "3.9") and extra == 'pdfminer'
152
- Requires-Dist: pdfminer.six ==20231228 ; (python_version >= "3.8") and extra == 'pdfminer'
153
- Requires-Dist: cffi ==1.16.0 ; (python_version >= "3.8") and extra == 'pdfminer'
154
- Requires-Dist: cryptography ==42.0.5 ; (python_version >= "3.9") and extra == 'pdfminer'
150
+ Requires-Dist: pdfminer.six==20240706; extra == "pdfminer"
151
+ Requires-Dist: cryptography==39.0.2; python_version < "3.9" and extra == "pdfminer"
152
+ Requires-Dist: cryptography==44.0.0; python_version >= "3.9" and extra == "pdfminer"
153
+ Requires-Dist: cffi==1.17.1; extra == "pdfminer"
154
+ Requires-Dist: pycparser==2.22; extra == "pdfminer"
155
155
  Provides-Extra: pillow
156
- Requires-Dist: Pillow ==9.5.0 ; (python_version < "3.8") and extra == 'pillow'
157
- Requires-Dist: Pillow ==10.2.0 ; (python_version >= "3.8") and extra == 'pillow'
156
+ Requires-Dist: Pillow>=10.4.0; python_version < "3.9" and extra == "pillow"
157
+ Requires-Dist: Pillow>=11.1.0; python_version >= "3.9" and extra == "pillow"
158
+ Provides-Extra: pip-system-certs
159
+ Requires-Dist: pip-system-certs==4.0; platform_system == "Windows" and extra == "pip-system-certs"
158
160
  Provides-Extra: proxy
159
- Requires-Dist: proxy.py ==2.4.3 ; extra == 'proxy'
161
+ Requires-Dist: proxy.py==2.4.3; extra == "proxy"
160
162
  Provides-Extra: psutil
161
- Requires-Dist: psutil ==5.9.8 ; extra == 'psutil'
163
+ Requires-Dist: psutil==6.0.0; extra == "psutil"
164
+ Provides-Extra: pyautogui
165
+ Requires-Dist: PyAutoGUI==0.9.54; extra == "pyautogui"
162
166
  Provides-Extra: selenium-stealth
163
- Requires-Dist: selenium-stealth ==1.0.6 ; extra == 'selenium-stealth'
167
+ Requires-Dist: selenium-stealth==1.0.6; extra == "selenium-stealth"
164
168
  Provides-Extra: selenium-wire
165
- Requires-Dist: selenium-wire ==5.1.0 ; extra == 'selenium-wire'
166
- Requires-Dist: Brotli ==1.1.0 ; extra == 'selenium-wire'
167
- Requires-Dist: blinker ==1.7.0 ; extra == 'selenium-wire'
168
- Requires-Dist: h2 ==4.1.0 ; extra == 'selenium-wire'
169
- Requires-Dist: hpack ==4.0.0 ; extra == 'selenium-wire'
170
- Requires-Dist: hyperframe ==6.0.1 ; extra == 'selenium-wire'
171
- Requires-Dist: kaitaistruct ==0.10 ; extra == 'selenium-wire'
172
- Requires-Dist: pyasn1 ==0.5.1 ; extra == 'selenium-wire'
173
- Requires-Dist: zstandard ==0.22.0 ; extra == 'selenium-wire'
169
+ Requires-Dist: selenium-wire==5.1.0; extra == "selenium-wire"
170
+ Requires-Dist: pyOpenSSL==24.2.1; extra == "selenium-wire"
171
+ Requires-Dist: pyparsing>=3.1.4; extra == "selenium-wire"
172
+ Requires-Dist: Brotli==1.1.0; extra == "selenium-wire"
173
+ Requires-Dist: blinker==1.7.0; extra == "selenium-wire"
174
+ Requires-Dist: h2==4.1.0; extra == "selenium-wire"
175
+ Requires-Dist: hpack==4.0.0; extra == "selenium-wire"
176
+ Requires-Dist: hyperframe==6.0.1; extra == "selenium-wire"
177
+ Requires-Dist: kaitaistruct==0.10; extra == "selenium-wire"
178
+ Requires-Dist: pyasn1==0.6.1; extra == "selenium-wire"
179
+ Requires-Dist: zstandard==0.23.0; extra == "selenium-wire"
180
+ Dynamic: author
181
+ Dynamic: author-email
182
+ Dynamic: classifier
183
+ Dynamic: home-page
184
+ Dynamic: keywords
185
+ Dynamic: license
186
+ Dynamic: maintainer
187
+ Dynamic: platform
188
+ Dynamic: provides-extra
189
+ Dynamic: requires-dist
190
+ Dynamic: requires-python
191
+ Dynamic: summary
174
192
 
175
193
  <!-- SeleniumBase Docs -->
176
194
 
195
+ <meta property="og:site_name" content="SeleniumBase">
196
+ <meta property="og:title" content="SeleniumBase: Python Web Automation and E2E Testing" />
197
+ <meta property="og:description" content="Fast, easy, and reliable Web/UI testing with Python." />
198
+ <meta property="og:keywords" content="Python, pytest, selenium, webdriver, testing, automation, seleniumbase, framework, dashboard, recorder, reports, screenshots">
199
+ <meta property="og:image" content="https://seleniumbase.github.io/cdn/img/mac_sb_logo_5b.png" />
200
+ <link rel="icon" href="https://seleniumbase.github.io/img/logo7.png" />
177
201
 
178
202
  <h1>SeleniumBase</h1>
179
203
 
180
- <p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/sb_logo_10t.png" alt="SeleniumBase" title="SeleniumBase" width="266" /></a></p>
204
+ <p align="center"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" alt="SeleniumBase" title="SeleniumBase" width="350" /></a></p>
181
205
 
182
- <p align="center" class="hero__title"><b>All-in-one Browser Automation Framework:<br />Web Crawling / Scraping / Testing / Reporting</b></p>
183
206
 
184
- <p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/releases" target="_blank"><img src="https://img.shields.io/github/v/release/seleniumbase/SeleniumBase.svg?color=22AAEE" alt="GitHub version" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/CI%20build/badge.svg" alt="SeleniumBase GitHub Actions" /></a> <a href="https://gitter.im/seleniumbase/SeleniumBase" target="_blank"><img src="https://img.shields.io/gitter/room/seleniumbase/SeleniumBase.svg" alt="Gitter chat"/></a></p>
207
+ <p align="center" class="hero__title"><b>All-in-one Browser Automation Framework:<br />Web Crawling / Testing / Scraping / Stealth</b></p>
208
+
209
+ <p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/releases" target="_blank"><img src="https://img.shields.io/github/v/release/seleniumbase/SeleniumBase.svg?color=22AAEE" alt="GitHub version" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/CI%20build/badge.svg" alt="SeleniumBase GitHub Actions" /></a> <a href="https://discord.gg/EdhQTn3EyE" target="_blank"><img src="https://img.shields.io/badge/join-discord-infomational" alt="Join the SeleniumBase chat on Discord"/></a></p>
185
210
 
186
211
  <p align="center">
187
212
  <a href="#python_installation">🚀 Start</a> |
188
213
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/features_list.md">🏰 Features</a> |
189
- <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">📚 Examples</a> |
190
214
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/customizing_test_runs.md">🎛️ Options</a> |
215
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/ReadMe.md">📚 Examples</a> |
191
216
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/console_scripts/ReadMe.md">🌠 Scripts</a> |
192
217
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/mobile_testing.md">📱 Mobile</a>
193
218
  <br />
194
219
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/method_summary.md">📘 APIs</a> |
195
- <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔡 Formats</a> |
196
- <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">📊 Dashboard</a> |
220
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md"> 🔠 Formats</a> |
197
221
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/recorder_mode.md">🔴 Recorder</a> |
222
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/example_logs/ReadMe.md">📊 Dashboard</a> |
198
223
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/locale_codes.md">🗾 Locales</a> |
199
- <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_grid/ReadMe.md">🌐 Grid</a>
224
+ <a href="https://seleniumbase.io/devices/?url=seleniumbase.com">💻 Farm</a>
200
225
  <br />
201
226
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/commander.md">🎖️ GUI</a> |
202
227
  <a href="https://seleniumbase.io/demo_page">📰 TestPage</a> |
203
- <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">🗂️ CasePlans</a> |
204
228
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md">👤 UC Mode</a> |
205
- <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/ReadMe.md">🧬 Hybrid</a> |
206
- <a href="https://seleniumbase.io/devices/?url=seleniumbase.com">💻 Farm</a>
229
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">🐙 CDP Mode</a> |
230
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
231
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_grid/ReadMe.md">🌐 Grid</a>
207
232
  <br />
208
233
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/how_it_works.md">👁️ How</a> |
209
234
  <a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/migration/raw_selenium">🚝 Migrate</a> |
210
- <a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Templates</a> |
211
- <a href="https://github.com/seleniumbase/SeleniumBase/tree/master/integrations/node_js">🚉 NodeGUI</a> |
212
- <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
235
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/case_plans.md">🗂️ CasePlans</a> |
236
+ <a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Template</a> |
237
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/master_qa/ReadMe.md">🧬 Hybrid</a> |
213
238
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/ReadMe.md">🚎 Tours</a>
214
239
  <br />
215
240
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/integrations/github/workflows/ReadMe.md">🤖 CI/CD</a> |
@@ -221,19 +246,82 @@ Requires-Dist: zstandard ==0.22.0 ; extra == 'selenium-wire'
221
246
  <br />
222
247
  </p>
223
248
 
249
+ <p>SeleniumBase is the professional toolkit for web automation activities. Built for testing websites, bypassing CAPTCHAs, enhancing productivity, completing tasks, and scaling your business.</p>
250
+
224
251
  --------
225
252
 
226
- 📚 Learn from [**over 200 examples** in the **SeleniumBase/examples/**](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder.
253
+ 📚 Learn from [**over 200 examples** in the **SeleniumBase/examples/** folder](https://github.com/seleniumbase/SeleniumBase/tree/master/examples).
227
254
 
228
- <p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>, which covers login, shopping, and checkout:</p>
255
+ 🐙 Note that <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/uc_mode.md"><b>UC Mode</b></a> / <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md"><b>CDP Mode</b></a> (Stealth Mode) have their own ReadMe files.
229
256
 
230
- ```bash
231
- pytest my_first_test.py
257
+ ℹ️ Most scripts run with raw <code translate="no"><b>python</b></code>, although some scripts use <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md">Syntax Formats</a> that expect <a href="https://docs.pytest.org/en/latest/how-to/usage.html" translate="no"><b>pytest</b></a> (a Python unit-testing framework included with SeleniumBase that can discover, collect, and run tests automatically).
258
+
259
+ --------
260
+
261
+ <p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_google.py">raw_google.py</a>, which performs a Google search:</p>
262
+
263
+ ```python
264
+ from seleniumbase import SB
265
+
266
+ with SB(test=True) as sb:
267
+ sb.open("https://google.com/ncr")
268
+ sb.type('[title="Search"]', "SeleniumBase GitHub page\n")
269
+ sb.click('[href*="github.com/seleniumbase/"]')
270
+ sb.save_screenshot_to_logs() # ./latest_logs/
271
+ print(sb.get_page_title())
232
272
  ```
233
273
 
234
- <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="480" /></a>
274
+ > `python raw_google.py`
275
+
276
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_google.py"><img src="https://seleniumbase.github.io/cdn/gif/google_search.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="420" /></a>
277
+
278
+ --------
279
+
280
+ <p align="left">📗 Here's an example of bypassing Cloudflare's challenge page: <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/raw_gitlab.py">SeleniumBase/examples/cdp_mode/raw_gitlab.py</a></p>
235
281
 
236
- > ``pytest`` uses ``--chrome`` by default unless set differently.
282
+ ```python
283
+ from seleniumbase import SB
284
+
285
+ with SB(uc=True, test=True, locale_code="en") as sb:
286
+ url = "https://gitlab.com/users/sign_in"
287
+ sb.activate_cdp_mode(url)
288
+ sb.uc_gui_click_captcha()
289
+ sb.sleep(2)
290
+ ```
291
+
292
+ <img src="https://seleniumbase.github.io/other/cf_sec.jpg" title="SeleniumBase" width="332"> <img src="https://seleniumbase.github.io/other/gitlab_bypass.png" title="SeleniumBase" width="288">
293
+
294
+ --------
295
+
296
+ <p align="left">📗 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py">test_get_swag.py</a>, which tests an e-commerce site:</p>
297
+
298
+ ```python
299
+ from seleniumbase import BaseCase
300
+ BaseCase.main(__name__, __file__) # Call pytest
301
+
302
+ class MyTestClass(BaseCase):
303
+ def test_swag_labs(self):
304
+ self.open("https://www.saucedemo.com")
305
+ self.type("#user-name", "standard_user")
306
+ self.type("#password", "secret_sauce\n")
307
+ self.assert_element("div.inventory_list")
308
+ self.click('button[name*="backpack"]')
309
+ self.click("#shopping_cart_container a")
310
+ self.assert_text("Backpack", "div.cart_item")
311
+ self.click("button#checkout")
312
+ self.type("input#first-name", "SeleniumBase")
313
+ self.type("input#last-name", "Automation")
314
+ self.type("input#postal-code", "77123")
315
+ self.click("input#continue")
316
+ self.click("button#finish")
317
+ self.assert_text("Thank you for your order!")
318
+ ```
319
+
320
+ > `pytest test_get_swag.py`
321
+
322
+ <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_get_swag.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="480" /></a>
323
+
324
+ > (The default browser is ``--chrome`` if not set.)
237
325
 
238
326
  --------
239
327
 
@@ -265,7 +353,7 @@ pytest test_demo_site.py
265
353
 
266
354
  --------
267
355
 
268
- <p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb2.png" alt="SeleniumBase" title="SeleniumBase" width="232" /></a></p>
356
+ <p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" alt="SeleniumBase" title="SeleniumBase" width="232" /></a></p>
269
357
 
270
358
  <blockquote>
271
359
  <p dir="auto"><strong>Explore the README:</strong></p>
@@ -327,7 +415,7 @@ With raw Selenium, that requires more code:<br />
327
415
 
328
416
  <p>📚 <b>Learn about different ways of writing tests:</b></p>
329
417
 
330
- <p align="left">📘📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_simple_login.py">test_simple_login.py</a>, which uses <code translate="no"><a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/fixtures/base_case.py">BaseCase</a></code> class inheritance, and runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a> or <a href="https://github.com/mdmintz/pynose">pynose</a>. (Use <code translate="no">self.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
418
+ <p align="left">📗📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_simple_login.py">test_simple_login.py</a>, which uses <code translate="no"><a href="https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/fixtures/base_case.py">BaseCase</a></code> class inheritance, and runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a> or <a href="https://github.com/mdmintz/pynose">pynose</a>. (Use <code translate="no">self.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
331
419
 
332
420
  ```python
333
421
  from seleniumbase import BaseCase
@@ -346,22 +434,7 @@ class TestSimpleLogin(BaseCase):
346
434
  self.assert_text("signed out", "#top_message")
347
435
  ```
348
436
 
349
- <p align="left">📗📝 Here's a test from <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/sb_fixture_tests.py">sb_fixture_tests.py</a>, which uses the <b><code translate="no">sb</code></b> <code translate="no">pytest</code> fixture. Runs with <a href="https://docs.pytest.org/en/latest/how-to/usage.html">pytest</a>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
350
-
351
- ```python
352
- def test_sb_fixture_with_no_class(sb):
353
- sb.open("seleniumbase.io/simple/login")
354
- sb.type("#username", "demo_user")
355
- sb.type("#password", "secret_pass")
356
- sb.click('a:contains("Sign in")')
357
- sb.assert_exact_text("Welcome!", "h1")
358
- sb.assert_element("img#image1")
359
- sb.highlight("#image1")
360
- sb.click_link("Sign out")
361
- sb.assert_text("signed out", "#top_message")
362
- ```
363
-
364
- <p align="left">📙📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_sb.py">raw_login_sb.py</a>, which uses the <b><code translate="no">SB</code></b> Context Manager. Runs with pure <code translate="no">python</code>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
437
+ <p align="left">📘📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_sb.py">raw_login_sb.py</a>, which uses the <b><code translate="no">SB</code></b> Context Manager. Runs with pure <code translate="no">python</code>. (Use <code translate="no">sb.driver</code> to access Selenium's raw <code translate="no">driver</code>.)</p>
365
438
 
366
439
  ```python
367
440
  from seleniumbase import SB
@@ -378,24 +451,7 @@ with SB() as sb:
378
451
  sb.assert_text("signed out", "#top_message")
379
452
  ```
380
453
 
381
- <p align="left">📔📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_context.py">raw_login_context.py</a>, which uses the <b><code translate="no">DriverContext</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code translate="no">driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
382
-
383
- ```python
384
- from seleniumbase import DriverContext
385
-
386
- with DriverContext() as driver:
387
- driver.open("seleniumbase.io/simple/login")
388
- driver.type("#username", "demo_user")
389
- driver.type("#password", "secret_pass")
390
- driver.click('a:contains("Sign in")')
391
- driver.assert_exact_text("Welcome!", "h1")
392
- driver.assert_element("img#image1")
393
- driver.highlight("#image1")
394
- driver.click_link("Sign out")
395
- driver.assert_text("signed out", "#top_message")
396
- ```
397
-
398
- <p align="left">📔📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_driver.py">raw_login_driver.py</a>, which uses the <b><code translate="no">Driver</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code>driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
454
+ <p align="left">📙📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/raw_login_driver.py">raw_login_driver.py</a>, which uses the <b><code translate="no">Driver</code></b> Manager. Runs with pure <code translate="no">python</code>. (The <code>driver</code> is an improved version of Selenium's raw <code translate="no">driver</code>, with more methods.)</p>
399
455
 
400
456
  ```python
401
457
  from seleniumbase import Driver
@@ -415,23 +471,6 @@ finally:
415
471
  driver.quit()
416
472
  ```
417
473
 
418
- <p align="left">📕📝 Here's <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/behave_bdd/features/login_app.feature">login_app.feature</a>, which uses <a translate="no" href="https://behave.readthedocs.io/en/stable/gherkin.html#features" target="_blank">behave-BDD Gherkin</a> syntax. Runs with <code translate="no">behave</code>. (<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/behave_bdd/ReadMe.md">Learn about the <b>SeleniumBase behave-BDD</b> integration</a>)</p>
419
-
420
- ```gherkin
421
- Feature: SeleniumBase scenarios for the Simple App
422
-
423
- Scenario: Verify the Simple App (Login / Logout)
424
- Given Open "seleniumbase.io/simple/login"
425
- And Type "demo_user" into "#username"
426
- And Type "secret_pass" into "#password"
427
- And Click 'a:contains("Sign in")'
428
- And Assert exact text "Welcome!" in "h1"
429
- And Assert element "img#image1"
430
- And Highlight "#image1"
431
- And Click link "Sign out"
432
- And Assert text "signed out" in "#top_message"
433
- ```
434
-
435
474
  --------
436
475
 
437
476
  <a id="python_installation"></a>
@@ -476,48 +515,49 @@ pip install -e .
476
515
  🔵 **Type ``seleniumbase`` or ``sbase`` to verify that SeleniumBase was installed successfully:**
477
516
 
478
517
  ```bash
479
- ______ __ _ ____
480
- / ____/__ / /__ ____ (_)_ ______ ___ / _ \____ ________
481
- \__ \/ _ \/ / _ \/ __ \/ / / / / __ `__ \ / /_) / __ \/ ___/ _ \
482
- ___/ / __/ / __/ / / / / /_/ / / / / / // /_) / (_/ /__ / __/
483
- /____/\___/_/\___/_/ /_/_/\__,_/_/ /_/ /_//_____/\__,_/____/\___/
484
- ------------------------------------------------------------------
485
-
486
- * USAGE: "seleniumbase [COMMAND] [PARAMETERS]"
487
- * OR: "sbase [COMMAND] [PARAMETERS]"
488
-
489
- COMMANDS:
490
- get / install [DRIVER] [OPTIONS]
491
- methods (List common Python methods)
492
- options (List common pytest options)
493
- behave-options (List common behave options)
494
- gui / commander [OPTIONAL PATH or TEST FILE]
495
- behave-gui (SBase Commander for Behave)
496
- caseplans [OPTIONAL PATH or TEST FILE]
497
- mkdir [DIRECTORY] [OPTIONS]
498
- mkfile [FILE.py] [OPTIONS]
499
- mkrec / codegen [FILE.py] [OPTIONS]
500
- recorder (Open Recorder Desktop App.)
501
- record (If args: mkrec. Else: App.)
502
- mkpres [FILE.py] [LANG]
503
- mkchart [FILE.py] [LANG]
504
- print [FILE] [OPTIONS]
505
- translate [SB_FILE.py] [LANG] [ACTION]
506
- convert [WEBDRIVER_UNITTEST_FILE.py]
507
- extract-objects [SB_FILE.py]
508
- inject-objects [SB_FILE.py] [OPTIONS]
509
- objectify [SB_FILE.py] [OPTIONS]
510
- revert-objects [SB_FILE.py] [OPTIONS]
511
- encrypt / obfuscate
512
- decrypt / unobfuscate
513
- download server (Get Selenium Grid JAR file)
514
- grid-hub [start|stop] [OPTIONS]
515
- grid-node [start|stop] --hub=[HOST/IP]
516
- * (EXAMPLE: "sbase get chromedriver latest") *
517
-
518
- Type "sbase help [COMMAND]" for specific command info.
519
- For info on all commands, type: "seleniumbase --help".
520
- Use "pytest" for running tests.
518
+ ___ _ _ ___
519
+ / __| ___| |___ _ _ (_)_ _ _ __ | _ ) __ _ ______
520
+ \__ \/ -_) / -_) ' \| | \| | ' \ | _ \/ _` (_-< -_)
521
+ |___/\___|_\___|_||_|_|\_,_|_|_|_\|___/\__,_/__|___|
522
+ ----------------------------------------------------
523
+
524
+ ╭──────────────────────────────────────────────────╮
525
+ │ * USAGE: "seleniumbase [COMMAND] [PARAMETERS]" │
526
+ │ * OR: "sbase [COMMAND] [PARAMETERS]" │
527
+ │ │
528
+ │ COMMANDS: PARAMETERS / DESCRIPTIONS: │
529
+ │ get / install [DRIVER_NAME] [OPTIONS] │
530
+ │ methods (List common Python methods) │
531
+ │ options (List common pytest options) │
532
+ │ behave-options (List common behave options) │
533
+ │ gui / commander [OPTIONAL PATH or TEST FILE] │
534
+ │ behave-gui (SBase Commander for Behave) │
535
+ │ caseplans [OPTIONAL PATH or TEST FILE] │
536
+ │ mkdir [DIRECTORY] [OPTIONS] │
537
+ │ mkfile [FILE.py] [OPTIONS] │
538
+ │ mkrec / codegen [FILE.py] [OPTIONS] │
539
+ │ recorder (Open Recorder Desktop App.) │
540
+ │ record (If args: mkrec. Else: App.) │
541
+ │ mkpres [FILE.py] [LANG] │
542
+ │ mkchart [FILE.py] [LANG] │
543
+ │ print [FILE] [OPTIONS] │
544
+ │ translate [SB_FILE.py] [LANG] [ACTION] │
545
+ │ convert [WEBDRIVER_UNITTEST_FILE.py] │
546
+ │ extract-objects [SB_FILE.py] │
547
+ │ inject-objects [SB_FILE.py] [OPTIONS] │
548
+ │ objectify [SB_FILE.py] [OPTIONS] │
549
+ │ revert-objects [SB_FILE.py] [OPTIONS] │
550
+ │ encrypt / obfuscate │
551
+ │ decrypt / unobfuscate │
552
+ │ proxy (Start a basic proxy server) │
553
+ │ download server (Get Selenium Grid JAR file) │
554
+ │ grid-hub [start|stop] [OPTIONS] │
555
+ │ grid-node [start|stop] --hub=[HOST/IP] │
556
+ │ │
557
+ │ * EXAMPLE => "sbase get chromedriver stable" │
558
+ │ * For command info => "sbase help [COMMAND]" │
559
+ │ * For info on all commands => "sbase --help" │
560
+ ╰──────────────────────────────────────────────────╯
521
561
  ```
522
562
 
523
563
  <h3>🔵 Downloading webdrivers:</h3>
@@ -529,20 +569,21 @@ COMMANDS:
529
569
  <summary> ▶️ Here's sample output from a chromedriver download. (<b>click to expand</b>)</summary>
530
570
 
531
571
  ```bash
532
- *** chromedriver to download = 121.0.6167.85 (Latest Stable)
572
+ *** chromedriver to download = 131.0.6778.108 (Latest Stable)
533
573
 
534
574
  Downloading chromedriver-mac-arm64.zip from:
535
- https://storage.googleapis.com/chrome-for-testing-public/121.0.6167.85/mac-arm64/chromedriver-mac-arm64.zip ...
575
+ https://storage.googleapis.com/chrome-for-testing-public/131.0.6778.108/mac-arm64/chromedriver-mac-arm64.zip ...
536
576
  Download Complete!
537
577
 
538
578
  Extracting ['chromedriver'] from chromedriver-mac-arm64.zip ...
539
579
  Unzip Complete!
540
580
 
541
581
  The file [chromedriver] was saved to:
542
- /Users/michael/github/SeleniumBase/seleniumbase/drivers/chromedriver
582
+ ~/github/SeleniumBase/seleniumbase/drivers/
583
+ chromedriver
543
584
 
544
- Making [chromedriver 121.0.6167.85] executable ...
545
- [chromedriver 121.0.6167.85] is now ready for use!
585
+ Making [chromedriver 131.0.6778.108] executable ...
586
+ [chromedriver 131.0.6778.108] is now ready for use!
546
587
  ```
547
588
 
548
589
  </details>
@@ -562,7 +603,7 @@ pytest my_first_test.py
562
603
 
563
604
  <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py"><img src="https://seleniumbase.github.io/cdn/gif/fast_swag_2.gif" alt="SeleniumBase Test" title="SeleniumBase Test" width="480" /></a>
564
605
 
565
- <p align="left"><b>Here's the code for <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>:</b></p>
606
+ <p align="left"><b>Here's the full code for <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py">my_first_test.py</a>:</b></p>
566
607
 
567
608
  ```python
568
609
  from seleniumbase import BaseCase
@@ -812,11 +853,14 @@ pytest test_coffee_cart.py --trace
812
853
  --binary-location=PATH # (Set path of the Chromium browser binary to use.)
813
854
  --driver-version=VER # (Set the chromedriver or uc_driver version to use.)
814
855
  --sjw # (Skip JS Waits for readyState to be "complete" or Angular to load.)
856
+ --wfa # (Wait for AngularJS to be done loading after specific web actions.)
815
857
  --pls=PLS # (Set pageLoadStrategy on Chrome: "normal", "eager", or "none".)
816
- --headless # (Run tests in headless mode. The default arg on Linux OS.)
817
- --headless2 # (Use the new headless mode, which supports extensions.)
858
+ --headless # (The default headless mode. Linux uses this mode by default.)
859
+ --headless1 # (Use Chrome's old headless mode. Fast, but has limitations.)
860
+ --headless2 # (Use Chrome's new headless mode, which supports extensions.)
818
861
  --headed # (Run tests in headed/GUI mode on Linux OS, where not default.)
819
862
  --xvfb # (Run tests using the Xvfb virtual display server on Linux OS.)
863
+ --xvfb-metrics=STRING # (Set Xvfb display size on Linux: "Width,Height".)
820
864
  --locale=LOCALE_CODE # (Set the Language Locale Code for the web browser.)
821
865
  --interval=SECONDS # (The autoplay interval for presentations & tour steps)
822
866
  --start-page=URL # (The starting URL for the web browser when tests begin.)
@@ -834,10 +878,12 @@ pytest test_coffee_cart.py --trace
834
878
  --block-images # (Block images from loading during tests.)
835
879
  --do-not-track # (Indicate to websites that you don't want to be tracked.)
836
880
  --verify-delay=SECONDS # (The delay before MasterQA verification checks.)
881
+ --ee | --esc-end # (Lets the user end the current test via the ESC key.)
837
882
  --recorder # (Enables the Recorder for turning browser actions into code.)
838
883
  --rec-behave # (Same as Recorder Mode, but also generates behave-gherkin.)
839
884
  --rec-sleep # (If the Recorder is enabled, also records self.sleep calls.)
840
885
  --rec-print # (If the Recorder is enabled, prints output after tests end.)
886
+ --disable-cookies # (Disable Cookies on websites. Pages might break!)
841
887
  --disable-js # (Disable JavaScript on websites. Pages might break!)
842
888
  --disable-csp # (Disable the Content Security Policy of websites.)
843
889
  --disable-ws # (Disable Web Security on Chromium-based browsers.)
@@ -860,6 +906,7 @@ pytest test_coffee_cart.py --trace
860
906
  --rcs | --reuse-class-session # (Reuse session for tests in class.)
861
907
  --crumbs # (Delete all cookies between tests reusing a session.)
862
908
  --disable-beforeunload # (Disable the "beforeunload" event on Chrome.)
909
+ --window-position=X,Y # (Set the browser's starting window position.)
863
910
  --window-size=WIDTH,HEIGHT # (Set the browser's starting window size.)
864
911
  --maximize # (Start tests with the browser window maximized.)
865
912
  --screenshot # (Save a screenshot at the end of each test.)
@@ -972,7 +1019,7 @@ You can run it from the ``examples/`` folder like this:
972
1019
  pytest test_fail.py
973
1020
  ```
974
1021
 
975
- 🔵 You'll notice that a logs folder, "latest_logs", was created to hold information about the failing test, and screenshots. During test runs, past results get moved to the archived_logs folder if you have ARCHIVE_EXISTING_LOGS set to True in [settings.py](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/config/settings.py), or if your run tests with ``--archive-logs``. If you choose not to archive existing logs, they will be deleted and replaced by the logs of the latest test run.
1022
+ 🔵 You'll notice that a logs folder, ``./latest_logs/``, was created to hold information (and screenshots) about the failing test. During test runs, past results get moved to the archived_logs folder if you have ARCHIVE_EXISTING_LOGS set to True in [settings.py](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/config/settings.py), or if your run tests with ``--archive-logs``. If you choose not to archive existing logs, they will be deleted and replaced by the logs of the latest test run.
976
1023
 
977
1024
  --------
978
1025
 
@@ -1001,14 +1048,14 @@ python -m http.server 1948
1001
1048
  pytest test_suite.py test_image_saving.py --dashboard --rs --headless
1002
1049
  ```
1003
1050
 
1004
- <img src="https://seleniumbase.github.io/cdn/img/dashboard_2.png" alt="The SeleniumBase Dashboard" title="The SeleniumBase Dashboard" width="480" />
1051
+ <img src="https://seleniumbase.github.io/cdn/img/dashboard_2.png" alt="The SeleniumBase Dashboard" title="The SeleniumBase Dashboard" width="520" />
1005
1052
 
1006
1053
  --------
1007
1054
 
1008
1055
  <a id="creating_visual_reports"></a>
1009
1056
  <h2><img src="https://seleniumbase.github.io/img/logo7.png" title="SeleniumBase" width="32" /> Generating Test Reports:</h2>
1010
1057
 
1011
- <h3>🔵 Pytest Reports:</h3>
1058
+ <h3>🔵 <code>pytest</code> HTML Reports:</h3>
1012
1059
 
1013
1060
  ✅ Using ``--html=report.html`` gives you a fancy report of the name specified after your test suite completes.
1014
1061
 
@@ -1028,7 +1075,7 @@ pytest test_suite.py --dashboard --html=report.html
1028
1075
 
1029
1076
  <img src="https://seleniumbase.github.io/cdn/img/dash_report.jpg" alt="Dashboard Pytest HTML Report" title="Dashboard Pytest HTML Report" width="520" />
1030
1077
 
1031
- If viewing pytest html reports in [Jenkins](https://www.jenkins.io/), you may need to [configure Jenkins settings](https://stackoverflow.com/a/46197356) for the html to render correctly. This is due to [Jenkins CSP changes](https://www.jenkins.io/doc/book/system-administration/security/configuring-content-security-policy/).
1078
+ If viewing pytest html reports in [Jenkins](https://www.jenkins.io/), you may need to [configure Jenkins settings](https://stackoverflow.com/a/46197356/7058266) for the html to render correctly. This is due to [Jenkins CSP changes](https://www.jenkins.io/doc/book/system-administration/security/configuring-content-security-policy/).
1032
1079
 
1033
1080
  You can also use ``--junit-xml=report.xml`` to get an xml report instead. Jenkins can use this file to display better reporting for your tests.
1034
1081
 
@@ -1036,7 +1083,7 @@ You can also use ``--junit-xml=report.xml`` to get an xml report instead. Jenkin
1036
1083
  pytest test_suite.py --junit-xml=report.xml
1037
1084
  ```
1038
1085
 
1039
- <h3>🔵 pynose Reports:</h3>
1086
+ <h3>🔵 <code>pynose</code> Reports:</h3>
1040
1087
 
1041
1088
  The ``--report`` option gives you a fancy report after your test suite completes.
1042
1089
 
@@ -1048,7 +1095,7 @@ pynose test_suite.py --report
1048
1095
 
1049
1096
  (NOTE: You can add ``--show-report`` to immediately display pynose reports after the test suite completes. Only use ``--show-report`` when running tests locally because it pauses the test run.)
1050
1097
 
1051
- <h3>🔵 Behave Dashboard & Reports:</h3>
1098
+ <h3>🔵 <code>behave</code> Dashboard & Reports:</h3>
1052
1099
 
1053
1100
  (The [behave_bdd/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples/behave_bdd) folder can be found in the [examples/](https://github.com/seleniumbase/SeleniumBase/tree/master/examples) folder.)
1054
1101
 
@@ -1056,7 +1103,7 @@ pynose test_suite.py --report
1056
1103
  behave behave_bdd/features/ -D dashboard -D headless
1057
1104
  ```
1058
1105
 
1059
- <img src="https://seleniumbase.github.io/cdn/img/sb_behave_dashboard.png" title="SeleniumBase" width="500">
1106
+ <img src="https://seleniumbase.github.io/cdn/img/sb_behave_dashboard.png" title="SeleniumBase" width="520">
1060
1107
 
1061
1108
  You can also use ``--junit`` to get ``.xml`` reports for each <code translate="no">behave</code> feature. Jenkins can use these files to display better reporting for your tests.
1062
1109
 
@@ -1120,7 +1167,7 @@ pytest user_agent_test.py --agent="Mozilla/5.0 (Nintendo 3DS; U; ; en) Version/1
1120
1167
  ```
1121
1168
 
1122
1169
 
1123
- <h3><img src="https://seleniumbase.github.io/img/logo7.png" title="SeleniumBase" width="32" /> Handling Pop-Up / Pop Up Alerts:</h3>
1170
+ <h3><img src="https://seleniumbase.github.io/img/logo7.png" title="SeleniumBase" width="32" /> Handling Pop-Up Alerts:</h3>
1124
1171
 
1125
1172
  🔵 <code translate="no">self.accept_alert()</code> automatically waits for and accepts alert pop-ups. <code translate="no">self.dismiss_alert()</code> automatically waits for and dismisses alert pop-ups. On occasion, some methods like <code translate="no">self.click(SELECTOR)</code> might dismiss a pop-up on its own because they call JavaScript to make sure that the <code translate="no">readyState</code> of the page is <code translate="no">complete</code> before advancing. If you're trying to accept a pop-up that got dismissed this way, use this workaround: Call <code translate="no">self.find_element(SELECTOR).click()</code> instead, (which will let the pop-up remain on the screen), and then use <code translate="no">self.accept_alert()</code> to accept the pop-up (<a href="https://github.com/seleniumbase/SeleniumBase/issues/600#issuecomment-647270426">more on that here</a>). If pop-ups are intermittent, wrap code in a try/except block.
1126
1173
 
@@ -1518,25 +1565,25 @@ pytest --reruns=1 --reruns-delay=1
1518
1565
 
1519
1566
  <p>
1520
1567
  <div><b>If you see something, say something!</b></div>
1521
- <div><a href="https://github.com/seleniumbase/SeleniumBase/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed-raw/seleniumbase/SeleniumBase.svg?color=22BB88" title="Closed Issues" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/pulls?q=is%3Apr+is%3Aclosed"><img src="https://img.shields.io/github/issues-pr-closed/seleniumbase/SeleniumBase.svg?logo=github&logoColor=white&color=22BB99" title="Closed Pull Requests" /></a></div>
1568
+ <div><a href="https://github.com/seleniumbase/SeleniumBase/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed-raw/seleniumbase/SeleniumBase.svg?color=22BB88" title="Closed Issues" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/pulls?q=is%3Apr+is%3Aclosed"><img src="https://img.shields.io/github/issues-pr-closed/seleniumbase/SeleniumBase.svg?logo=github&logoColor=white&color=22BB99" title="Closed Pull Requests" /></a></div>
1522
1569
  </p>
1523
1570
 
1524
- <p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/sb_logo_10t.png" alt="SeleniumBase" title="SeleniumBase" width="266" /></a></p>
1571
+ <p align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/sb_logo_10t.png" alt="SeleniumBase" title="SeleniumBase" width="274" /></a></p>
1572
+
1573
+ <a href="https://pypi.org/project/seleniumbase/" target="_blank"><img src="https://img.shields.io/pypi/pyversions/seleniumbase.svg?color=22AAEE&logo=python&logoColor=FEDC54" title="Supported Python Versions" /></a>
1525
1574
 
1526
1575
  <p><div>
1527
- <span><a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m"><img src="https://seleniumbase.github.io/cdn/img/youtube.png" title="SeleniumBase Playlist on YouTube" alt="SeleniumBase Playlist on YouTube" width="68" /></a></span>
1528
- <span><a href="https://github.com/seleniumbase/SeleniumBase"><img src="https://seleniumbase.github.io/img/social/share_github.svg" title="SeleniumBase on GitHub" alt="SeleniumBase on GitHub" width="62" /></a></span>
1529
- <span><a href="https://www.facebook.com/SeleniumBase"><img src="https://seleniumbase.io/img/social/share_facebook.svg" title="SeleniumBase on Facebook" alt="SeleniumBase on Facebook" width="64" /></a></span>
1530
- <span><a href="https://gitter.im/seleniumbase/SeleniumBase" target="_blank"><img src="https://seleniumbase.github.io/img/social/share_gitter.svg" title="SeleniumBase on Gitter" alt="SeleniumBase on Gitter" width="50" /></a></span>
1576
+ <span><a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m"><img src="https://seleniumbase.github.io/cdn/img/youtube.png" title="SeleniumBase Playlist on YouTube" alt="SeleniumBase Playlist on YouTube" width="70" /></a></span>
1577
+ <span><a href="https://github.com/seleniumbase/SeleniumBase"><img src="https://seleniumbase.github.io/img/social/share_github.svg" title="SeleniumBase on GitHub" alt="SeleniumBase on GitHub" width="64" /></a></span>
1578
+ <span><a href="https://discord.gg/EdhQTn3EyE"><img src="https://seleniumbase.github.io/other/discord_icon.png" title="SeleniumBase on Discord" alt="SeleniumBase on Discord" width="66" /></a></span>
1579
+ <span><a href="https://www.facebook.com/SeleniumBase"><img src="https://seleniumbase.io/img/social/share_facebook.svg" title="SeleniumBase on Facebook" alt="SeleniumBase on Facebook" width="62" /></a></span>
1531
1580
  </div></p>
1532
1581
 
1533
1582
  <p><div><b><a href="https://github.com/mdmintz">https://github.com/mdmintz</a></b></div></p>
1534
1583
 
1535
- <div><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/fancy_logo_14.png" title="SeleniumBase" width="240" /></a></div> <div><a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a></div> <div><a href="https://github.com/seleniumbase/SeleniumBase"><img src="https://img.shields.io/badge/tested%20with-SeleniumBase-04C38E.svg" alt="Tested with SeleniumBase" /></a></div> <div><a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" /></a> <a href="https://gitter.im/seleniumbase/SeleniumBase" target="_blank"><img src="https://img.shields.io/gitter/room/seleniumbase/SeleniumBase.svg" alt="Gitter chat"/></a></div>
1536
- <div><a href="https://pepy.tech/project/seleniumbase" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" /></a></div>
1537
- <div><a href="https://github.com/seleniumbase/SeleniumBase/stargazers"><img src="https://img.shields.io/github/stars/seleniumbase/seleniumbase.svg?color=19A57B" title="Stargazers" /></a></div>
1538
-
1539
- --------
1540
-
1541
- <p><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb.png" alt="SeleniumBase" title="SeleniumBase" width="300" /></a></p>
1542
- <p><a href="https://pypi.org/project/seleniumbase/" target="_blank"><img src="https://img.shields.io/pypi/pyversions/seleniumbase.svg?color=22AAEE&logo=python&logoColor=FEDC54" title="Supported Python Versions" /></a></p>
1584
+ <div><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.github.io/cdn/img/super_logo_sb3.png" title="SeleniumBase" width="274" /></a></div>
1585
+ <div><a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" /></a></div>
1586
+ <div><a href="https://github.com/seleniumbase/SeleniumBase"><img src="https://img.shields.io/badge/tested%20with-SeleniumBase-04C38E.svg" alt="Tested with SeleniumBase" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/stargazers"><img src="https://img.shields.io/github/stars/seleniumbase/seleniumbase.svg?color=19A57B" title="Stargazers" /></a></div>
1587
+ <div><a href="https://hellogithub.com/repository/c6be2d0f1969448697683d11a4ff915e" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=c6be2d0f1969448697683d11a4ff915e&claim_uid=xcrm4p9j3d6JCO5&theme=small" alt="Featured｜HelloGitHub" /></a> <a href="https://discord.gg/EdhQTn3EyE" target="_blank"><img src="https://img.shields.io/badge/join-discord-infomational" alt="Join the SeleniumBase chat on Discord"/></a> <a href="https://gitter.im/seleniumbase/SeleniumBase" target="_blank"><img src="https://img.shields.io/gitter/room/seleniumbase/SeleniumBase.svg" alt="Gitter chat"/></a></div>
1588
+ <div><a href="https://pepy.tech/project/seleniumbase" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" /></a> <img src="https://views.whatilearened.today/views/github/seleniumbase/SeleniumBase.svg" width="98px" height="20px" alt="Views" /></div>
1589
+ <div align="left"></div>