You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://pypi.python.org/pypi/seleniumbase)[](https://travis-ci.org/seleniumbase/SeleniumBase)[](https://gitter.im/seleniumbase/SeleniumBase?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)<br />
5
+
SeleniumBase simplifies test automation with [WebDriver](https://docs.microsoft.com/en-us/microsoft-edge/webdriver) & [Pytest](https://github.com/pytest-dev/pytest).
6
6
7
-
SeleniumBase makes it easy to build & run [Selenium-WebDriver](https://github.com/SeleniumHQ/selenium) automation with [Pytest](https://docs.pytest.org/en/latest/).
7
+
#### Quick start in a few steps: (requires [Python](https://www.python.org/downloads/))
8
8
9
-
**Watch [my_first_test.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py) run in [Demo Mode](#seleniumbase_demo_mode):**<br>
9
+
```bash
10
+
python -m pip install seleniumbase --upgrade
11
+
seleniumbase install chromedriver
12
+
seleniumbase mkdir browser_tests
13
+
cd browser_tests
14
+
pytest my_first_test.py --browser=chrome
15
+
```
16
+
17
+
The ``seleniumbase mkdir [NAME]`` command creates a new folder with some sample tests you can run. If you wish to use a different browser, you can use ``seleniumbase install [DRIVER]`` with other drivers such as ``edgedriver`` (Microsoft Edge) or ``geckodriver`` (Firefox). Then use ``--browser=edge`` or ``--browser=firefox`` to run tests on that browser (assuming you already have that web browser installed). ``--browser=chrome`` is the default option if not specified.
18
+
19
+
**Slow-motion demo of [my_first_test.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py) running:**<br>
### [**Get Started**](#seleniumbase_installation), or Learn More:
22
+
There are many more examples to try out from the [SeleniumBase/examples](https://github.com/seleniumbase/SeleniumBase/blob/master/examples) directory, which you can run easily if you clone SeleniumBase.
23
+
24
+
For more detailed steps on getting started, see the [**Detailed Instructions**](#seleniumbase_installation) section.
25
+
26
+
### Learn More:
13
27
14
28
**No more repetitive WebDriver code:**<br />
15
29
SeleniumBase automatically handles common WebDriver actions such as spinning up web browsers, waiting for page objects to load, saving screenshots during test failures, using a proxy server, and more. (<i>[Read about customizing test runs](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/customizing_test_runs.md).</i>)
Python methods that start with ``test_`` will automatically be run when using ``pytest`` or ``nosetests`` on a Python file, (<i>or on folders containing Python files</i>).
47
+
32
48
**No more messy code:**<br />
33
49
This long line of standard WebDriver code,
34
50
```python
@@ -53,15 +69,15 @@ SeleniumBase is compatible with [Selenium Grid](https://github.com/seleniumbase/
53
69
SeleniumBase makes it easy to automate tedious business tasks. (*To learn about businesses using SeleniumBase, [Click Here](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/happy_customers.md).*)
54
70
55
71
**Extensively tested and made with love:**<br />
56
-
SeleniumBase was originally built for [testing HubSpot's platform](https://product.hubspot.com/blog/the-classic-qa-team-is-obsolete) and automating business processes. In 2014, SeleniumBase was open-sourced and spun off as its own independent entity to benefit users everywhere.
72
+
SeleniumBase was originally built for [testing HubSpot's platform](https://product.hubspot.com/blog/bid/88880/Automated-Integration-Testing-with-Selenium-at-HubSpot) and automating business processes. In 2014, SeleniumBase was open-sourced and spun off as its own independent entity to benefit users everywhere.
57
73
58
-
**Contains lots of additional features:**<br />
74
+
**Plenty of features:**<br />
59
75
([Read more about SeleniumBase features here](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/features_list.md))
Before installation, **[install Python](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/install_python_pip_git.md)** and **[install a web driver](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/webdriver_installation.md)**.
67
83
@@ -86,14 +102,14 @@ cd SeleniumBase
86
102
87
103
If you're installing SeleniumBase from a cloned copy on your machine, use:
88
104
```
89
-
pip install -r requirements.txt
105
+
pip install -r requirements.txt --upgrade
90
106
91
107
python setup.py develop
92
108
```
93
109
94
110
If you're installing SeleniumBase from the [Python Package Index](https://pypi.python.org/pypi/seleniumbase), use:
95
111
```bash
96
-
pip install seleniumbase
112
+
pip install seleniumbase --upgrade
97
113
```
98
114
99
115
If you're installing SeleniumBase directly from GitHub, use:
@@ -611,10 +627,10 @@ Now you can parse through the email if you're looking for specific text or want
611
627
612
628
**Congratulations** on learning how to use **SeleniumBase**!
613
629
614
-
<i>**Questions or Comments?**</i><br>
630
+
<i>**Questions or Comments?**</i><br />
615
631
[](https://gitter.im/seleniumbase/SeleniumBase?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)<br>
0 commit comments