KioskTUI

An application to track purchased items in the Online Kiosk. Uses NCurses and Zettle API to display the information with python helper scripts.

Dependencies

To use the TUI, you should have installed and assured that the following are working:

1. gcc
2. g++
3. NCurses
4. Sqllite
5. python

The software has not been tested on windows, as the windows terminal emulator infrastructure has really bad graphical protocols/compatibility. MacOS should work (UNIX based, iTERM's graphical protocol etc). It has also been tested on server configurations with no DE or compositor, and everything runs properly, though the graphical borders get converted to true ascii characters instead.

Use

To use the TUI:

The database must be initialized before synchronization can work

make db

When db init is successful, you can sync it (this requires Zettle API keys placed in the .env)

make sync

The script keeps running until interruption, so it is recommended to use tmux or another type of terminal multiplexer to the sync script in a different pane, and use another for the tui itself.

Finally the binaries can be built and the application launched in the terminal

make && ./leaderboard

Testing

Run the testing framework using:

make test

The tests written emulate Zettle transactions and are meant to test response time of the tui as well as edge cases (such as how it responds to max items in a transaction). All the injected test data can be removed after observation with a prompt after test finish.