A Django project this week will be to develop a personal gallery application that you display your photos for others to see.
As a user of the application I should be able to:
- View different photos that interest me. ✔️
- Click on a single photo to expand it and also view the details of the photo. The photo details must appear on a modal within the same route as the main page. ✔️
- Search for different categories of photos. (ie. Travel, Food). ✔️
- Copy a link to the photo to share with my friends. ✔️
- View photos based on the location they were taken. ✔️
Home page
Category Search results
Images by Location
Image details Modal
- Python and pip (I am currently using 3.9.6) Any version above 3.7 should work.
- Git installed on your machine
- Code editor/ IDE
-
Clone GitHub repository
git clone https://github.com/KenMwaura1/zoo_pictures
-
Change into the folder
cd zoo_pictures
-
Create a virtual environment
python3 -m venv venv
- Activate the virtual environment
source ./bin/activate
-
If you are using pyenv:
3a. Create a virtualenv
pyenv virtualenv zoo_pictures
3b. Activate the virtualenv
pyenv activate zoo_pictures
-
Create a
.env
file and add your credentialstouch .env
OR Copy the included example
cp .env-example .env
-
Add your credentials to the
.env
file -
Migrate your database
python manage.py migrate
-
Install the required dependencies
pip install -r requirements.txt
-
Make the shell script executable
chmod a+x ./run.sh
-
Run the app
./run.sh
OR run with python
python manage.py runserver
-
To run the tests:
python manage.py test
- Python-3.9.6
- Django web framework
- Bootstrap(Material Bootstrap 4)
- HTML5
- CSS3
MIT License
Copyright (c) 2021 Kennedy Ngugi Mwaura
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so.