https://github.com/9d4/goquiz
Simple quiz!
https://github.com/9d4/goquiz
Last synced: about 1 year ago
JSON representation
Simple quiz!
- Host: GitHub
- URL: https://github.com/9d4/goquiz
- Owner: 9d4
- Created: 2023-06-04T13:55:57.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-07-03T13:41:50.000Z (almost 3 years ago)
- Last Synced: 2025-01-29T22:46:13.700Z (over 1 year ago)
- Language: Go
- Size: 315 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GoQuiz
GoQuiz is a straightforward quiz application that has been ported from [BayuDC's quiz](https://github.com/bayudc/quiz) and completely rewritten using the Go programming language. It has been developed with a focus on simplicity, efficiency, and self-contained functionality. The front-end still the same.
## Run
The required seeder is `quiz.xlsx` copy it from example [here](https://raw.githubusercontent.com/9d4/goquiz/main/quiz.example.xlsx). Rename it to `quiz.xlsx` then run the app with `-s` flag.
- Download binary for your platform in [Release page](https://github.com/9d4/goquiz/releases).
- Place the quiz.xlsx in the same directory as the binary, then run
**First Run** with seeder. This is first time only run.
> **Note:** since version 0.2.0 the app is able to detect first time run,
so when there is no config file in the directory the app will run the seeder,
just put your `quiz.xlsx` in the same directory where you start the goquiz binary.
Windows user can just double click, it's fine.
```shell
# unix/linux
$ ./goquiz --seed # to run the seeder, or "-s" for short. Run once only!
# windows. Open cmd in your directory where binary stored.
C:\Users\dimanda\where-you-store-binary> goquiz.exe --seed
```
**Normal Run**, where you have ran with seeder before.
```shell
# unix/linux
$ ./goquiz
# windows
goquiz.exe # or just double click from explorer.exe is fine
```
On the first run the app will automatically create the config `goquiz.yml`. Configure it if needed.
To clean up the app, just delete the `goquiz.db` file.
## Development
Build and run from Source:
```bash
go run -tags=dev .
```
### Build with these in mind:
- Single Binary: GoQuiz is designed to be compiled into a single binary file, making it easy to distribute and run on various systems without any additional dependencies or installations.
- No Third-Party Database: GoQuiz eliminates the need for external databases. All quiz questions and answers are stored directly within the application itself, ensuring a seamless and self-contained experience.
- Run and Go: With GoQuiz, you can simply run the binary file and start using the application immediately. There's no need for complex setup or configuration processes.
**Credit to:**
- [BayuDC](https://github.com/bayudc)
- [Dimanda](https://github.com/9d4)