Prototypes some ideas for a Yoruba language quiz game to help Yoruba language learners.
# yoruba-language-quiz-prototype
## About this Project
Just for the fun and the challenge of it. You can read the origin story of this project on my GitHub Pages site, so I won't repeat it here.
This program has so far been tested only on 64-bit Ubuntu (20.04) Linux and with its' default, built-in BASH interpreter.
## Files
- yoruba-quiz-main.sh - the main script file.
- includes/helper.inc.sh - functions to assist user with correct program use.
- includes/build-quiz.inc.sh - included functions in which JSON data gets parsed through jq filters.
- includes/dev-quiz-data.inc.sh - included file containing URLs of transport-safe, unicode encoded, development only data files.
- includes/get-quiz-data.inc.sh - functions to download and decode JSON files for the program.
- includes/run-quiz.inc.sh - functions executed during actual quiz play.
- shared-functions-library/shared-bash-constants.inc.sh - common module.
- shared-functions-library/shared-bash-functions.inc.sh - common module.
- data/ - directory created in the project root for the downloaded development data.
## Purpose
The main purpose of this project is to demonstrate one way to reliably transfer remote, JSON structured, Unicode encoded data to a bash shell program application, which then decodes it before use.
Additionally, the quiz game demonstrates how an application can reliably interpret characters for which no unicode code-points currently exist.
This project sets up the following scenario...
1. Your user is running an application that uses data that may not have unicode code-points, so it's handling during transport may not be reliable.
2. The data is actually located on a remote server, to which the client application knows how to make requests.
- This program uses an AWS S3 bucket for that remote storage of application data as JSON structured text files. The program uses cURL to make HTTPS requests to that remote storage.
3. When requested, the data must arrive uncorrupted by it's journey acro …