summaryrefslogtreecommitdiff
path: root/BUILD.md
diff options
context:
space:
mode:
authorMicah Lee <micah@micahflee.com>2018-11-18 17:04:20 -0800
committerMicah Lee <micah@micahflee.com>2018-11-18 17:04:20 -0800
commite29c0e7b69b7f9c5fcdf8489f97c8dfd8554311d (patch)
tree6be516838fd1c06546a2c69da8706a9547122f4a /BUILD.md
parent12180f08dc117ce1dbd72017b8af97cc77891c9a (diff)
parenta39cd08083f4443e498611bbc1c086a05f5cffde (diff)
downloadonionshare-e29c0e7b69b7f9c5fcdf8489f97c8dfd8554311d.tar.gz
onionshare-e29c0e7b69b7f9c5fcdf8489f97c8dfd8554311d.zip
Merge branch 'develop' into v3-revisited
Diffstat (limited to 'BUILD.md')
-rw-r--r--BUILD.md22
1 files changed, 7 insertions, 15 deletions
diff --git a/BUILD.md b/BUILD.md
index d8150799..7663ec23 100644
--- a/BUILD.md
+++ b/BUILD.md
@@ -149,30 +149,22 @@ OnionShare includes PyTest unit tests. To run the tests, first install some depe
pip3 install -r install/requirements-tests.txt
```
-You must have `pytest` in your path point to python 3's pytest. If necessary, you might need to make a symlink, like:
-
-```sh
-ln -s /usr/bin/pytest-3 /usr/local/bin/pytest
-```
-
-If you'd like to run the CLI-based tests that Travis runs:
+Then you can run `pytest` against the `tests/` directory.
```sh
pytest tests/
```
-If you would like to run the GUI unit tests in 'local only mode':
+If you would like to also run the GUI unit tests in 'tor' mode, start Tor Browser in the background, then run:
```sh
-cd tests_gui_local/
-./run_unit_tests.sh
+pytest --runtor tests/
```
-If you would like to run the GUI unit tests in 'tor' (bundled) mode:
+Keep in mind that the Tor tests take a lot longer to run than local mode, but they are also more comprehensive.
+
+You can also choose to wrap the tests in `xvfb-run` so that a ton of OnionShare windows don't pop up on your desktop (you may need to install the `xorg-x11-server-Xvfb` package), like this:
```sh
-cd tests_gui_tor/
-./run_unit_tests.sh
+xvfb-run pytest tests/
```
-
-Keep in mind that the Tor tests take a lot longer to run than local mode, but they are also more comprehensive.