TAROT JUICER
This is a rudimentary Django-based CMS which dynamically presents tarot-related content placed onto unconventional but familiar contexts such as hollywood film and historical biography. Our purpose is to overturn and reform the audience's perspective beyond all recognition. The author endeavours to reach out (or "appeal") to the broadest audience possible.
DJANGO APPS
Here are Django apps I've created and what their purpose is:
-
generators: When a web user clicks the 'random' button, it serves one of twenty two tarot keys arbitrarily. Each tarot card webpage includes:
- A picture of the tarot key
- The name of the key
- Astrological Attribute
- Alchemical Attribute
- Intelligence
- Hebrew Letter
- Letter Meaning
- Description of the symbolic meaning
- The description applied to:
- Galileo
- FLOSS
- St Paul the Apostle
This app houses the most dynamic functionality of my whole website
-
landings: Serves the landing/home page (the
portal.html
template) showing the extraordinary 'global initiation' message. This app also serves the 'about' template which is a webpage which explains the basic who, what, when, why (or purpose) of the website in general (similar to the preface to a book) -
essays: Serves the
article.html
template which captures a curated list of the most high impact tarot cards and their application to Galileo and FLOSS (bound together simultaneously) along with a curated list of tart cards applied to St. Paul. This essays app also serves up static articles (without dynamic functionality) similar to a blog post - - for essays by the author on tarot applied to Forrest Gump and the war of ideas. This essays app even includes an 'objections' page for content involving anticipated rebuttals from my various audiences. This essays app also refers to a basic content_changelog.html template which enables the author to document changes made to essays or other content over time. -
accounts: This feature gives website visitors who land on the 'gateway' landing page to enter a passphrase to gain access the rest of the site.
BUILD INSTRUCTIONS
For *nix:
$ virtualenv --python=python3.9 venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ python manage.py runserver
You will also need to install postgresql v12.3. On Manjaro/Arch, you may use this:
$ sudo pacman -S postgresql postgresql-libs
USAGE NOTES
#1. Swapping lorem ipsum db out with real prod db content
The official Heroku docs cover provisioning Postgres, designating a primary database, sharing Postgres db's between applications, and more. This doc explains how to juggle/change/swap out one db instance for another.
#2. Postgres and cultivating an archive of backups
This note to self I moved into it's own (private - hidden) gist titled Guide to backing up Postgres on Friday 9 April 2021. More work needs to be done. My next step will involve either (a) learning AWS S3 or (b) writing a custom Python script using multiple symlinks to automate the download of Postgres instances and mirror them up to my Digital Ocean droplet.
#3. Handling db remote instances but locally
It's possible to run a remote AWS Postgres db locally. It's as straightforward as running:
(local venv) $ export DATABASE_URL='postgres://USER:PASSWORD@HOST:PORT/NAME'
whose DATABASE_URL
you can source from the Heroku Dashboard. If you are havinng trouble determining the right 'colored' DB you can use:
(local venv) $ heroku addons --app tarot-prod
You can also use:
(local venv) $ heroku pg:info --app tarot-prod
These commands should reveal the name of the add-on to distinguish the db with 'lorem' content from the db with 'real' content.
It's also very important to note that when exporting a db locally, you need to do it inside the same terminal that the local dev server is running in. For this to work, you'll need to exit the currnet local dev server, unset the existing db, export the db, and then finally run the server again.
You can view the current db configuration (probably db.sqlite3 default) with:
(local venv) $ echo $DATABASE_URL
To remove or backout from using a remote Postgres instance and reintroduce db.sqlite3, this is the command you need:
(local venv) $ unset DATABASE_URL
PLEASE NOTE and to emphasize once more: It's important that you handle all of the above commands in the same terminal emulator. If you run export $DATABASE_URL
in one terminal, and then have the server running in a different terminal, it won't work. Use all of the above commands in the same terminal that you are running the local server in.
#4. Config variables
In the Heroku Dashboard, here are some of the variables you need to change for it to work in the production enviornment:
DJANGO_DEBUG
: This config variable in production needs to be set to False to run the app, this will also resolve the check deploy issuesALLOWED_HOSTS
: Set its value by adding multiple hosts as ( separating each host by a space)host1 host2 host3
ADMIN_PATH
: Set its value to make the admin path as secure as you prefer the best.HEROKU_POSTGRESQL_
:_URL postgres://USER:PASSWORD@HOST:PORT/NAME
you can reset thePASSWORD
variable on the fly by using:(local venv) $ heroku pg:credentials:rotate
postgres://USER:PASSWORD@HOST:PORT/NAME
in the Heroku dashboard before and after redunning the Heroku 'rotate' command, most of the variables remain the same however the USER and PASSWORD will be different. This protects keys that I may have previously referred to publiclly in the Issues section of this repo. More details can be gleaned from this Heroku help doc titled, How do I make sure my Heroku Postgres database credentials are correct? which I found by Googling: 'how to update postgresql credentials in heroku'.
#5. Resolving empty thumbnails (tarot card album) static files
If you accidentally upload duplicate tumbnails (generator app), Django will append a small hash to the .jpg and it won't parse when Django serves the tarot_key template. It's kind of a bug. The problem should only happen remotely on Heroku. If that happens (and it doesn't happen all the time), then the recourse is to use this command on Heroku: (local venv) $ heroku run python manage.py collectstatic -a tarot-testing --noinput --clear --no-post-process
. Be sure to specify the right app (whether tarot-testing
or tarot-prod
). That will purge all static files with hashes. I don't completely understand why, but UmarGit and I went back forth on Upwork on June 14th, 2021.
This was an issue (#92) resolved on 9 April 2021 but which became an issue again on 14 May.
There seems to be three staticfiles directories declared inside settings.py
. The one inside tarot_juicer/tarot_juicer/static
is for development locally. The directroy tarot_juicer/staticfiles
houses the static files on Heroku which will be intialized and created with the pgbounce buildpack in the cloud - - so there is no need for this directory locally. I'm not sure what tarot_juicer/static
is for.
#6. heroku-cli x2
There are two heroku-cli app interfaces. The first heroku-cli app is installed locally for interacting between the local development environment and the remote server. The second heroku-cli app is installed remotely for interacting with itself. To install, you just navigate in Heroku settings for the app and click: “Add buildpack” and enter: https://buildpack-registry.s3.amazonaws.com/buildpacks/heroku-community/cli.tgz
. Next go to Manage Account (settings - - top right corner of avatar icon). Then scroll down and select: “Regenerate API Key”. Next time you push changes and Heroku rebuilds everything, then heroku-cli should be installed. For future reference, you may use the official Heroku doc for managing authentication and API token storage.
TO DO:
- There are 5 ways to make my Django project more secure. https://hackernoon.com/5-ways-to-make-django-admin-safer-eb7753698ac8
- One of them is to: "Visual disntinguish environemnts". It's a great suggestion by color coding the Django admin panel. I should implement a color coded banner at the top of every web page when the Django Admin user is logged in but the "Nuclear" option (in
accounts
app) is toggled on blocking all other web vistors out because right now, if the Nuclear option is triggered, the the 'logout' link on the/portal
page appears but clicking on it does nothing. This is because the ADmin User has access. To help elinate confusion, there should be a colour coded banner at the top of/portal
and all the other pages on the website whent he Admin user is browsing and the Nuclear option is toggled.
- One of them is to: "Visual disntinguish environemnts". It's a great suggestion by color coding the Django admin panel. I should implement a color coded banner at the top of every web page when the Django Admin user is logged in but the "Nuclear" option (in
- Use this guide to populate my README.md with 'badges': https://github.com/Naereen/badges/blob/master/README.md
- e.g, correc this:
- See Google Chrome bookmarks named: "GitHub "Badges" readme rst md icons build passing RESEARCH" in April directory
PURPOSE
"In a world where men do battle over whose version of God is most accurate, I cannot adequately express the deep respect and admiration I feel toward an organization in which men of differing faiths are able to break bread together in a bond of comradery, brotherhood, and friendship," - - On Freemasonry courtesy of Dan Brown in a 2009 interview as quoted on page 48-49 in Mark E Koltko-Rivera's (2011) Freemasonry: An Introduction (London England: Penguin Group)