Loading repository data…
danricho / repository
A simple Python Flask web application which helps keep track of your stored items.
A simple Python Flask web application which helps keep track of your stored items.
Does anyone know a quick way to generate this type of demo image?
See this page for example screenshots.
These steps describe how I set it up. I use a linux terminal so under Windows there may be minor step inaccuracies.
Clone repo to a local directory.
eg: git clone https://github.com/danricho/where_the.git where_the
Create a Python Virtual Environment (venv).
eg: python3 -m venv venv
Install dependencies via pip into your venv.
eg: venv/bin/pip install -r requirements.txt or activate venv then pip install -r requirements.txt
Create config.yml and update according it to your setup - see the Configuration section.
Run main.py in your venv.
eg: venv/bin/python main.py or activate venv then python main.py
NOTE:
If running the script as root (or sudo), the directory ownership may need to be changed to root using chown -R root .. This is due to a new ownership check in newer versions of git and Where The checks for new versions when it starts.
Running in Docker is a quick way to get this to run as a service (launches on boot etc).
Clone repo to a local directory.
eg: git clone https://github.com/danricho/where_the.git where_the
Create config.yml and update according to the Configuration section. This file is mounted within the docker image but saved here outside it (to keep data between docker sessions)
Create data.json and set the content to {}. This file is mounted within the docker image but saved here outside it (to keep data between docker sessions)
Run the docker container using the command docker-compose up -d.
To troubleshoot the container it may help to see it's logs: docker logs where_the
NOTE: Networking settings are more complicated when using docker, so check the following:
config.yml:
FLASK.HOST - 0.0.0.0FLASK.PORT - 5000SITE.BASE_URL - usually host's IP or hostnamedocker-compose.yml:
services.web-app.ports - 80:5000 - second number needs to match above, first is the port that docker will use. Note: 80 may require special permission.An alternative to building the docker image is now provided thanks to @LukeEvansTech. Each push to this repo now re-builds a 'package' which is GitHub's name for pre-made Docker Images and can be used as follows:
docker pull ghcr.io/danricho/where_the:mainimage: ghcr.io/danricho/where_the:maindocker-compose.yml for more information.To update, all that should be needed is to run the command git pull in your Where The ?!? directory.
If you get a message about local file changes which would be overwritten by merge, this means you have modified one of the tracked files. The config and data files (as made during installation) are not the files git is talking about.
The command git diff will tell you what is different about the files. Running git reset --hard HEAD will reset the uncommited file changes, but NOTE THAT you may lose work if you do this. Only do this if you understand what you are doing. And once your Repo is clean, the git pull should work.
There are many resources available online to learn more about Git operations.
After updating, the docker image needs to be rebuilt as the app files (other than those mapped in docker-compose.yml) are cached inside the docker image. This automatically happens the first time you bring Where The ?!? up.
This can be done by running docker-compose with a few extra commands:
docker-compose up -d --force-recreate --build
If using the pre-built image, ensure that you freshly pull the latest image.
# DO NOT ADD COMMENTS YOU WANT KEPT TO THIS YML AS IT IS REWRITTEN BY THE APP AND COMMENTS ARE LOST.
SITE:
BASE_URL: http://localhost # THIS IS YOUR DOMAIN OR START OF YOUR URL - USED IN QR CODE
PATH_PREFIX: / # THIS IS USEFUL IF YOU WANT A PREFIX ON THE URL PATH - USED IN QR CODE AND FLASK
# THE MAIN COLOR.
# THE DEFAULT #C0A890 IS BASED ON A CARBOARD BOX COLOR :)
# CAN BE IN ONE OF THE FOLLOWING FORMATS:
# - rgb(192, 168, 144)
# - hsl(30, 28%, 66%)
# - #C0A890
# NOTE: ALPHA VALUES WILL BE IGNORED
PRIMARY-COLOR: '#C0A890'
#-------------------------------------
# THESE ARE FLASK CONFIGURATION SETTINGS
FLASK:
HOST: 0.0.0.0
PORT: '5000'
SECRET: abcd1234
DEBUG: false
TEMPLATES_AUTO_RELOAD: true
USE_RELOADER: false
#-------------------------------------
# CAN BE ONE OF: 'NO-AUTH', 'FLASK-LOGIN', 'AUTHELIA'
AUTHENTICATION: FLASK-LOGIN
# NEXT, ADD ONE OF THE FOLLOWING TO MATCH
# USERS FOR NO AUTHENTICATION (NO-AUTH)
# THIS WILL STORE THE SETTINGS CHANGES (COMMON FOR EVERYONE)
USERS: {}
# SETTING UP USERS FOR FLASK-LOGIN AUTHENTICATION (FLASK-LOGIN)
USERS:
user:
password: pass
user2:
password: pass
# USERS FOR AUTHELIA AUTHENTICATION (AUTHELIA)
# THIS WILL BE POPULATED FROM AUTHELIA AUTHENTICATION HEADERS
USERS: {}
# FOR INFORMATION:
# AUTHELIA IS AN AUTHENTICATION MIDDLEWARE USEFUL WHEN USING TRAEFIK FOR ROUTING
# 'WHERE THE ?!?' READS THE AUTHENTICATION HEADERS AUTHELIA PROVIDES ONCE LOGGED
# IN TO KEEP TRACK OF WHO IS LOGGED IN. ACCESS CONTROL IS HANDLED PRIOR TO
# ACCESSING 'WHERE THE ?!?' WHEN USING AUTHELIA.
AUTHELIA-LOGOUT: https://auth.SAMPLE-DOMAIN.org # IF SET, HOMEPAGE WILL HAVE A LOGOUT BUTTON IN AUTHELIA MODE
#-------------------------------------
PRINT_TEMPLATE:
ADD_DESCRIPTION_TO_LABEL: true # WHEN USING THIS, BE AWARE OF DESCRIPTION LENGTH.
ADD_LOGO_TO_QR: true # REMOVES THE LOGO IN THE CENTRE OF THE QR CODE.
COLORED_BACKGROUNDS: true # USE PRIMARY COLOR FOR BACKGROUND OF DESCRIPTION AND ID (DARK GREY IF FALSE)
# BELOW ARE USED TO LAYOUT THE QR CODE LABELS. THE DEFAULT IS SHOWN
IDENTIFIER: AVERY L7164 # JUST A NAME FOR THIS LABEL LAYOUT - CAN BE ANYTHING
PAGE:
WIDTH: 21cm # A4 PAGE WIDTH
X_MARGIN: 0.7214cm # L7164 (MEASURED FROM LEFT PAGEEDGE TO FIRST LABEL)
Y_MARGIN: 0.457cm # L7164 (MEASURED FROM TOP PAGE EDGE TO FIRST LABEL)
LABELS_PER_PAGE: 12 # USED TO INSERT CORRECT PAGE BREAKS
LABEL:
HEIGHT: 7.2cm # L7164 (MEASURED HEIGHT OF THE LABELS)
WIDTH: 6.353cm # L7164 (MEASURED WIDTH OF THE LABELS)
X_GUTTER: 0.25cm # L7164 (SPACE BETWEEN THE LABELS HORIZONTALLY)
Y_GUTTER: 0cm # L7164 (SPACE BETWEEN THE LABELS VERTICALLY)
X_PADDING: 0.25cm # SPACE TO LEAVE ON SIDES OF LABEL (TOLERANCE FOR INACCURACIES WHEN PRINTING)
Y_PADDING: 0.1cm # SPACE TO LEAVE ON TOP AND BOTTOM OF LABEL (TOLERANCE FOR INACCURACIES WHEN PRINTING)
# USE THESE ONCE THE LABEL AND PAGE ARE SETUP TO MAKE SURE THEY FIT ON THE LABELS
ID_FONT_SIZE: 0.8cm # HEIGHT OF ID STRING FONT
DESCRIPTION_FONT_SIZE: 0.35cm # HEIGHT OF DESCRIPTION STRING FONT (IF ENABLED)
QR_HEIGHT: 4.3cm # HEIGHT OF THE QR CODE
I plan to start using it more to identify the holes I haven't found yet!
I do have a few ideas that I'd like to add while maintaining the current simplicity as much as possible.
Please propose and discuss ideas here!
I would welcome any contributions to these with pull requests!
See changelog for a history of changes.
Selected from shared topics, language and repository description—not editorial ratings.
verohavagrecha444-hash /
Built with Django (Python) and HTML/CSS, this full-stack e-commerce web app features secure user authentication, a dynamic product catalog, session-based shopping carts, and complete order processing. An SQLite database seamlessly manages inventory and user data via a secure admin dashboard.