Package: qwazzock
qwazzockAn app for hosting quizes remotely.Installingpip install qwazzockUsageStart an instance of the app using:qwazzockCreate a route to localhost:5000 using a hostname included in the SSL certificate.Instruct players to navigate to the site's root address (e.g.http://127.0.0.1:5000). They can then enter their name, team name and buzz when they know the answer. Note that players to be on the same team, their team names must match exactly (including case).As a host, you can then navigate to the/hostpath (e.g.http://127.0.0.1:5000/host) in order to see who has buzzed first and to mark their answer. You can respond with the following:passcan be used when no one wants to buzz in who still can, as they don't know the answer. It clears the hotseat if occupied (e.g if someone buzzed accidentally), and any locked out teams become unlocked.rightclears the hotseat, any locked out teams and awards the team a point.wrongplaces the team who answered onto a "locked out" list, preventing them from buzzing in until the current question completed.You can also useresetto wipe all data for the in progress game and start a new one.Clicking on the team's button will lock out that team until the end of the round. This can be useful for managing elimitator rounds and the like.Question TypesThere are two "question types" you can select,standardorpicture.StandardThis is the default question type. It allows you to ask any question and decide if the answer is right or wrong.PictureWhen this quesiton type is selected, all players are presnted with a randomly selected image from thequestionsfolder in the content directory (see below) as their buzzer image. You will be presented with the name of the image they are seeing.The ordering of the images is random. Once you selectpass,rightorwrong, the next image in the list will be presented. This will continue until you change question type, or you run out of question images. If the latter occurs, the question type will automatically revery back tostandard.Should you not provide a content directory, the content directory does not contain aquestionsfolder, or thequestionsfolder is empty, then the question type will automatically revert back tostandard.Environment variablesBehaviour of the application can be tweaked by setting the following environment variables:NameOptionsDefaultDescriptionQWAZZOCK_CONTENT_PATHA valid absolute path.Not setIf set, additional content is loaded into qwazzock from this directory.QWAZZOCK_LOG_LEVELDEBUG,INFO,WARNING,ERRORINFOLog application events at this level and above.QWAZZOCK_SOCKETIO_DEBUG_MODEAnyNot setIf set, access logs from socketio will be output.Content DirectoryFor a more interactive experience, you can load custom content into a "content directory" and provide this to qwazzock using theQWAZZOCK_CONTENT_PATHenvironment variable.Currently, the only supported custom content is images for use with thepicturequestion type. These must be loaded into aquestionsfolder within the content directory. The file name should be the answer as you wish it to appear to the host.DevelopmentInitialise development environmentmake initStandup a local dev servermake devThe server will be accessible athttps://127.0.0.1:5000.Run all testsmake testThis includes:unit tests (make unit_test).static code analysis (make bandit).dependency vulnerability analysis (make safety).Build artefactsmake buildThis includes:pip wheel (make build_wheel).docker image (make build_image).Standup a local containermake runStop local containersmake stopRelease versionTag the repository with the project version and publish the distributables toPyPI.Local repo must be clean.poetry config pypi-token.pypi ${your-pypi-token}
make release