Skip to content

Commit 1d2c5eb

Browse files
authored
Update TESTING.md
explicitly creating the database + clarification about dummy data
1 parent b9e3ef8 commit 1d2c5eb

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

TESTING.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,10 @@ For Mac users, try this link and let me know how that goes: https://www.geeksfor
1010

1111
Generally, they'll ask you to setup a username and password. Since we're testing locally, security doesn't matter _that_ much. I chose the username as `root` and the password as `root`.
1212

13-
In our codebase, we've specified that our database be called _celesta_data_, so we don't need to manually set up our own database now.
13+
In our codebase, we've specified that our database be called _celesta_data_, but you'll still need to explicitly create your own database using MySQL. I used HeidiSQL (see below) to set up for the first time, but if you're on Mac or you don't want to use HeidiSQL, simply open up a MySQL terminal and type in:
14+
```
15+
mysql> CREATE DATABASE celesta_data;
16+
```
1417

1518
#### (Optional) Installing MariaDB and HeidiSQL
1619

@@ -23,7 +26,7 @@ If you're on Windows and want to perform a deep-dive into the database, you can
2326

2427
### Testing Both the Backend and the Frontend
2528

26-
If you're testing for the very first time, then you'll be starting off with an empty database. As you add to the database, they'll get saved in the MySQL server to be used again and again!
29+
If you're testing for the very first time, then you'll be starting off with an empty database. As you add to the database, they'll get saved in the MySQL server to be used again and again! We each have our own copy of the server on our computer, so at this point we are not sharing data.
2730

2831
#### Starting the Django backend
2932

@@ -33,7 +36,7 @@ Within VSCode, make sure your virtual environment is up and running (see the REA
3336
python manage.py runserver
3437
```
3538

36-
Once the server is up and running, navigate to `http://127.0.0.1:8000/api/students/`. This is where the database entries are stored. I have a few dummy data listed already (see below), but you might want to add your own using the UI in the bottom half of the screen. In the future, a complete dummy database will likely be created.
39+
Once the server is up and running, navigate to `http://127.0.0.1:8000/api/students/`. This is where the database entries are stored. I have a few dummy data in my own local server already (see below), but you can add your own using the UI in the bottom half of the screen. In the future, a complete dummy database will likely be created for all of us to use and test.
3740

3841
If you want to view a particular entry, just navigate to `http://127.0.0.1:8000/api/students/{id}`. For example, Heidi's entry would be `http://127.0.0.1:8000/api/students/1`
3942

@@ -46,4 +49,4 @@ In VSCode, open a new terminal (while keeping the first terminal running!). You
4649

4750
Note: I'm currently using the Axios package for the HTTP requests. You'll need to type in the terminal `npm i axios` to install that package.
4851

49-
As we have done before, navigate to the frontend folder `cd frontend` and run `npm start`. Once the frontend is built (it'll take a while), you can navigate to `http://localhost:3000/` and view the beautiful results.
52+
As we have done before, navigate to the frontend folder `cd frontend` and run `npm start`. Once the frontend is built (it'll take a few moments), you can navigate to `http://localhost:3000/` and view the beautiful results.

0 commit comments

Comments
 (0)