########################################################### FOR local INSTALL: # flask -> python web server # sqlalchemy -> provides db-agnostic python objects of db content (and more) # flask-sqlachemy combines/wraps this to provide a db.* set of objects based on the 'app' that flask creates # marshmallow-sqlachemy provides a way to create a 'schema' of your class, then serialize an object to it # flask-wtf -> 'what the form' allows form consistency/validation based on defining attributes in a class for each form # flask-bootstrap -> allows me to format that wtf form with boostrap markup - yet to test if it also means I don't need to include it exlicitly in head, etc. # install needed binaries (maybe I could have done this instead of pip below too -- when I docker this shit, sort it out?) sudo apt install python3-pip python3-psycopg2 libpq-dev ### LEARN: supposedly could use virtualenv instead of pip3 install --user? OR even apt to install direct? # --user sticks python libs in ~/.local/[bin|lib|share] pip3 install --user flask sqlalchemy flask-sqlalchemy flask-marshmallow SQLAlchemy-serializer flask-wtf flask-bootstrap marshmallow-sqlalchemy ########################################################### FOR local RUN: # run a DEV version by: python3 main.py ### to make a new PROD copy.. sudo docker-compose -f /srv/docker/config/docker-compose.yml stop bookdb_web sudo docker-compose -f /srv/docker/config/docker-compose.yml rm bookdb_web sudo docker-compose -f /srv/docker/config/docker-compose.yml build bookdb_web sudo docker-compose -f /srv/docker/config/docker-compose.yml up bookdb_web ########################################################## Remember: MUST use form.errors when we have a validator that is fancier than not empty (year_published in book and num_books in series SO FAR) ########################################################### TODOS (next 29): Validation: TODO-17: view list of possible duplicate books by title TODO-18: consider which of the 'books maybe not valid' reports make sense still - can you even have an N/A publisher now for example? - but the genre one is interesting TODO-19: icons on wish list, etc.? (not sure I really want them, but if so) - wishlist: search-dollar OR https://www.flaticon.com/free-icon/wishlist_868517 - save: https://www.flaticon.com/free-icon/sold_463255?term=sold&page=1&position=6&related_item_id=463255 Maybe: TODO-20: ORM all books load is slow - should I lazy load all books (ajax the 2nd->last pages in, or not use ORM, and do a quick db.execute()....) TODO-21: allow a way to add a book as a child of another existing book (opposite of rem_sub_book) TODO-26: gunicorn and/or more modern non-flask???