Adify

Link to the webapp: Adify System

To setup

Make sure you're in the project directory:

cd /path/to/adify

It's important to specify your version number! Or go one level lower to source the activate function. Set up your environment to have python-3.10. At the time of writing this python-3.12 is out and Python anywhere only has 3.10 available. So ideally your environment should also reflect that. I would recommend that you just install a seperate version of python on your system because you might break something on your system.

path/to/python-3.10 -m venv venv

then run the env: For Linux:

source ./venv/bin/activate 

For Windows:

venv\Scripts\activate.bat

if you want to turn it off you can run:

deactivate

You can then install all the required files with:

# Assuming python env is on & in root folder
pip install -r requirements.txt

Create/Acquire the .env file which houses all the GLOBAL variables which contains the following variables that you need.

DEBUG=                  <your-value>
SECRET_KEY=             <your-value>

DATABASE_ENGINE=        <your-value>
DATABASE_NAME=          <your-value>
DATABASE_USER=          <your-value>
DATABASE_PASS=          <your-value>
DATABASE_HOST=          <your-value>
DATABASE_PORT=          <your-value>

EMAIL_BACKEND=          <your-value>
EMAIL_HOST=             <your-value>
EMAIL_USE_TLS=          <your-value>
EMAIL_PORT=             <your-value>
EMAIL_HOST_USER=        <your-value>
EMAIL_HOST_PASSWORD=    <your-value>
DEFAULT_FROM_EMAIL=     <your-value>

PAYPAL_RECEIVER_EMAIL=  <your-value>

Ideally, you should set up the database env to be MySQL. PythonAnywhere Free tier only allows mysql database connection.

Make sure you have mysqlclient binary installed Here is a resource.

mysqlclient required the system to already have mysql-client installed and available on the path, the same goes for pkg-config. Don't forget to refresh or resouce the exported variables.

Alternately you can also run it using sqlite3 default configuation. For development purposes. Check the Django Docs for more information. You're pretty much just changeing DATABASES variable in Jba/settings.py to the default.

Thereafter, you can run the project:

# For Dev 
# If it's the first time you're running 
python manage.py makemigrations
python manage.py migrate
# then run the dev server
python manage.py runserver

---

For Deployment

Please define these inside the .env file

PYTHONANYWHERE_USER=    <your-value>
PYTHONANYWHERE_API_KEY= <your-value>
PYTHONANYWHERE_HOST=    <your-value>
PYTHONANYWHERE_DOMAIN=  <your-value>

run the deploy.py file to pull the latest main branch from github. Pythonanywhere free-tier doesn't allow for free ssh access; The workaround is to use their api to make the requests from a console on their servers. As the script currently stands, it requires manually triggering but I will reformat the code to run at the end of the CI/CD workflow on github.

---

Future Helpful Links

Migrating to postgres: https://help.pythonanywhere.com/pages/PostgresGettingStarted Local Development Version of used Postgres: https://www.postgresql.org/docs/16/release-16-2.html

---