Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
ipitio committed Nov 28, 2023
1 parent 7f1cdf5 commit 3762adf
Showing 1 changed file with 14 additions and 16 deletions.
30 changes: 14 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,32 @@
# Sheet2App - CSE 416 Project
# Sheet2App

Team Penguins
Team Penguins presents Sheet2App, a web app that allows users to create web apps with Google Sheets.

## Getting Started
## Prerequisites

### Prerequisites

#### Linux
### Linux

Install Docker and Compose Plugin

* [CLI Only](https://docs.docker.com/compose/install/linux/#install-using-the-repository)
* [Docker Desktop](https://www.docker.com/products/docker-desktop)

#### Windows
### Windows

Install WSL2, Docker Desktop, and VSCode Extensions

1. [WSL2](https://code.visualstudio.com/docs/remote/wsl-tutorial#_install-visual-studio-code)
2. [Docker Desktop](https://learn.microsoft.com/en-us/windows/wsl/tutorials/wsl-containers)

#### Both
### Both

1. Rename your `server/s2a_api/migrations` folder to something else.
2. Set the OAuth Client ID environment variable in `client/Dockerfile`
3. Set the OAuth Client ID and Secret environment variables in `server/Dockerfile`
4. Store your Google Service Account credentials in `server/sheets/credentials.json`
5. Store your Token in `server/token.json` (for testing purposes only)

### Starting
## Starting

docker compose up

Expand All @@ -44,7 +42,7 @@ Please wait a moment for the following to become available:
* The default username is `admin` with password `password`
* The server's health checks at <http://localhost:8000/ht>.

### Stopping
## Stopping

docker compose down

Expand All @@ -54,19 +52,19 @@ This stops everything for you. Add:
* `--rmi all` to remove its images,
* `-t 0` to stop immediately.

### Testing
## Testing

[![status](https://github.com/alexanderleong1/Sheet2App/actions/workflows/tests.yml/badge.svg)](https://github.com/alexanderleong1/Sheet2App/actions/workflows/tests.yml)

#### Frontend
### Frontend

docker exec -it node npm test

This runs the client's tests in interactive mode. Alternatively, run:

docker exec node npm test -- --watchAll=false

#### Backend
### Backend

docker exec django pytest

Expand All @@ -75,15 +73,15 @@ This runs the backend's tests. Add:
* `-n logical` to run the tests in parallel,
* `-v` for verbose output.

##### Database
#### Database

You can start a MySQL shell by executing:

docker exec -it mysql mysql -u root -p Sheet2App

And entering the password `default-password`.

##### Cache
#### Cache

If you started in detached mode, you can monitor Redis with:

Expand All @@ -93,6 +91,6 @@ Clear it with:

docker exec redis redis-cli flushall

> ###### Note
> ##### Note
>
> The cache is not persistent. It will be cleared when you stop the app.

0 comments on commit 3762adf

Please sign in to comment.