This repository is a new cleaned clone of the original course repository. Only the final project (e.g. the flag game) is left. All course exercises and other unnecessary stuff is removed.
current ver 0.2.8 (14.4.2024), latest release of the software source code can be found here.
This is a Flag Quiz Game including all 195 fully recognized independent states listed at state.gov, and Taiwan, Kosovo & Western Sahara. The game has 5 different game modes; Classic, Advanced, Time Trial, One Life, and Free Mode. See the Rule Book for details. The software also records all user activity and played games! Player may look previous games and study their own lifelong statistics, such as total playtime or average streak length!
Software has not been tested in a MacOS or Windows environment. Flag Quiz Game has been built with Python 3.10. Software might not run on other versions. You can find the installation manual here.
The software launching and testing etc. are automated with bash scripts. For non-Linux OS users, more technical know-how is required to get the game going.
Run the tests configured with pytest.ini (ignoring all graphical user interface modules) by executing:
./test.shNavigate to this folder to find all the automated test source files. The tests will take approximately 38 seconds. They are testing e.g. how the points awarding algorithms and statistics calculations work with different round times and scores. See Software Testing for a more complete document detailing the software testing process.
To generate the Coverage report (web browser version) for your local machine, execute:
./coverage.shThe generated report can be found at ./htmlcov/index.html.
To run the automated code review algorithm with parameters defined in pylintrc, execute:
./pylint.shTo read my personal notes about pylint results and other comments regarding software source code quality, check this document.