This is a demo project for practicing Django. The idea was to build some basic blogging platform.
It was made using Python 3.11 + Django and database is SQLite. Bootstrap was used for styling. Testing is done using untitest module.
There is a login and registration functionality included.
User has his own blog page, where he can add new blog posts. Every authenticated user can comment on posts made by other users. Home page is paginated list of all posts. Non-authenticated users can see all blog posts, but cannot add new posts or comment.
App is covered with tests.
[Optional] Install virtual environment:
$ python -m virtualenv env[Optional] Activate virtual environment:
On macOS and Linux:
$ source env/bin/activateOn Windows:
$ .\env\Scripts\activateInstall dependencies:
$ pip install -r requirements.txtYou can run the application from the command line with manage.py. Go to the root folder of the application.
Run migrations:
$ python manage.py migrateInitialize data:
$ python manage.py loaddata users posts commentsRun server on port 8000:
$ python manage.py runserver 8000It is possible to run all of the above with helper script:
$ chmod +x scripts/run.sh
$ scripts/run.shIt is also possible to run the blog app using docker:
Build the Docker image:
$ docker build -t reljicd/django-blog -f docker/Dockerfile .Run the Docker container:
$ docker run --rm -i -p 8000:8000 reljicd/django-blogIt is possible to run all of the above with helper script:
$ chmod +x scripts/run_docker.sh
$ scripts/run_docker.shGo to the web browser and visit http://localhost:8000/blog
Admin username: admin
Admin password: adminpassword
User username: dusan
User password: dusanpassword
It is possible to add additional admin user who can login to the admin site. Run the following command:
$ python manage.py createsuperuserEnter your desired username and press enter.
Username: admin_usernameYou will then be prompted for your desired email address:
Email address: admin@example.comThe final step is to enter your password. You will be asked to enter your password twice, the second time as a confirmation of the first.
Password: **********
Password (again): *********
Superuser created successfully.Go to the web browser and visit http://localhost:8000/admin
Activate virtual environment:
On macOS and Linux:
$ source env/bin/activateOn Windows:
$ .\env\Scripts\activateRunning tests:
$ python manage.py test blogIt is also possible to run tests using Docker:
Build the Docker image:
$ docker build -t reljicd/django-blog -f docker/Dockerfile .Run the Docker container:
$ docker run --rm reljicd/django-blog test blog