Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/douglashalse/snackattacktrack

Snack Attack Track is a kiosk management software for small, trust based stores
https://github.com/douglashalse/snackattacktrack

kiosk kivy python raspberry-pi selling-platform store trust-based-interaction

Last synced: 14 days ago
JSON representation

Snack Attack Track is a kiosk management software for small, trust based stores

Awesome Lists containing this project

README

        

# Snack Attack Track

Snack Attack Track is a subscription/membership management software meant to run on a raspberry pi with a touchscreen.

## Setup development environment

(If you are trying to follow these steps for the first time, PLEASE let us know if you run into any problems so we can update the setup process)

### Windows

#### Prerequisites

1. Python 3.9 (preferably installed from the Microsoft store)
2. git ()

#### Recommended dev-tools

1. GitHub Desktop if you prefer GUI for git ()
2. Visual Studio Code ()

#### Installation

1. Clone this repository to your Windows machine using git
2. Run setupDevEnvironmentWindows.bat

#### Start GUI with debugging (with Visual Studio Code)

1. In Visual Studio Code: Select 'Open Folder...' and select the cloned repository
2. Hit Ctrl + Shift + P and write 'select interpreter' and click 'Python: Select Interpreter'
3. Select the Python executable found in \/venv/Scripts/python.exe
4. Hit F5 to start debugging with the preset "Python: Run Snack Attack Track GUI" defined in \/.vscode/launch.json

#### Start GUI without debugging

1. Run runGuiWindows.bat

### Ubuntu

#### Prerequisites

1. Python 3.9 or Python 3.10

#### Recommended dev-tools

1. GitKraken Client if you prefer GUI for git ()
2. Visual Studio Code ()

#### Installation

[//]: <> (-tag to escape hyper-link creation)

1. Clone this repository to your Ubuntu machine using git
2. Run 'bash setupDevEnvironmentUbuntu.sh'

#### Start GUI with debugging (with Visual Studio Code)

1. In Visual Studio Code: Select 'Open Folder...' and select the cloned repository
2. Hit Ctrl + Shift + P and write 'select interpreter' and click 'Python: Select Interpreter'
3. Select the Python executable found in \/venv/Scripts/python
4. Hit F5 to start debugging with the preset "Python: Run Snack Attack Track GUI" defined in \/.vscode/launch.json

#### Start GUI without debugging

[//]: <> (-tag to escape hyper-link creation)

1. Run 'bash runGuiUbuntu.sh'

### Debugging gui layouts
1. Press Ctrl + e to start kivy inspector

### Pre-commit
This will run pylint and black to format the code and check for any violations of the PEP 8 Python coding standards.

1. pip install black pylint pre-commit or pip install -r requirements.txt
2. pre-commit install
3. pre-commit run -a