Update documentation for set up and testing (#520)

Author: ykevu

documentation/FIRST_TIME_SETUP.md

@@ -14,17 +14,15 @@ If the command fails, install Python with Anaconda by following the installation
 
 ### Create a Python virtual environment
 
-We recommend installing Python dependencies in a virtual environment isolate the project from the rest of your machine. If you're using Anaconda, create a virtual environment named `deepcell-label` with this command: `conda create -n deepcell-label python=3.8`.
+We recommend installing Python dependencies in a virtual environment to isolate the project from the rest of your machine. Create a virtual environment named `deepcell-label-env` with this command: `python -m venv deepcell-label-env`.
 
-Then activate the virtual environment with: `conda activate deepcell-label`.
+Then activate the virtual environment with the activate script in the `deepcell-label/Scripts` or `deepcell-label/bin` folder.
 
 Now when you run `pip install -r requirements.txt`, all the dependencies will be installed in the virtual environment.
 
-You can deactivate the virtual environment with: `source deactivate`.
+You can deactivate the virtual environment with: `deactivate`.
 
-Read more about virtual environments with conda here: https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html.
-
-If you are not using Anaconda, set up a virtual environment with Python's built-in virtual environment manager `venv`: https://docs.python.org/3/tutorial/venv.html.
+Read more about virtual environments with `venv` here: https://docs.python.org/3/tutorial/venv.html.
 
 ## Setup Node.js (Javascript)
 

documentation/LOCAL_USE.md

@@ -38,6 +38,20 @@ flask run
 
 By default, DeepCell Label creates a temporary database in `/tmp`. Change `SQLALCHEMY_DATABASE_URI` in your `.env`, for example `SQLALCHEMY_DATABASE_URI=sqlite:///~/Documents/deepcell_label.db`, to make a persistent database in another location.
 
+### Running the backend tests
+
+Make sure to be in the `/deepcell_label` folder inside of the backend:
+
+```bash
+cd deepcell-label/backend/deepcell_label
+```
+
+Then run the tests using the `-m` flag with pytest:
+
+```bash
+python -m pytest .
+```
+
 ### Run with Docker
 
 The backend can also be containerized with [Docker](https://www.docker.com). To build a production-ready Docker image, run:
@@ -70,3 +84,32 @@ yarn start
 ```
 
 Visit [localhost:3000](http://localhost:3000) to see the DeepCell Label homepage.
+
+### Running the frontend tests
+
+Run the Jest tests with:
+
+```bash
+yarn test
+```
+
+And open the Cypress UI with:
+
+```bash
+npx cypress open
+```
+
+They can also be run from command line with:
+
+```bash
+npx cypress run
+```
+
+## Common Issues (Especially on Windows)
+
+- If SQLAlchemy is giving Operational Errors, it could be because the `/tmp` folder does not exist, which will need to be created (e.g. on C: for Windows)
+- On Windows, after installing Python requirements, you probably have to run
+  ```bash
+  pip uninstall python-magic
+  pip install python-magic-bin==0.4.14
+  ```