Welcome

OCEAN BOOKS

About the project

This project is an online library and was created for people who love to read books and save their time. People can bookmark, like and rate, when people bookmark, they can read these books after a while, because these books will be bookmarked. Moreover, people can rate so that others can see how good, high quality and interesting the book is. They can leave feedback at any time and help in the development of our project. People who like our work, website, can make a donation to support us and our work. In addition, they can follow our social networks.

About the BackEnd

This project was created in MVC (Model, View, Controller) architecture. In addition, the project works in PostgreSQL. We have used AbstractBaseUser to create a user and the user has its own user manager, also we are using a Token to generate tokens for secure our user. There are many libraries and packages that support our project, such as Django-Rest-Framework for creating APIs, Pillow for photo processing, psycopg2-binary for PostgreSQL, and others.

---

Tech

• Django - is a high-level Python Web framework
• Django REST framework - Django REST Framework is a powerful and flexible toolkit for building Web APIs
• PostgreSQL - open source object-relational database system

And many other libraries.

Dillinger requires Python v3.4+.

$ git clone https://gitlab.com/Abduraxmonnn/chehol_api.git
$ cd chat_api

---

Setting project

• Linux

$ virtualenv -p /usr/bin/python3 .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt
$ python manage.py migrate

• Windows

$ python -m venv ./venv
$ venv\Scripts\activate
$ pip install -r requirements.txt
$ python manage.py migrate

• MacBook

$ python3 -m venv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ python manage.py migrate

---

Development

Configure PostgreSQL

Create clear database named ocean_db.

Create ocean_user db user with password ocean_123 and grand privileges to him.

If you want to create a database with a different name, user and password, you can change the initial configuration to your own configuration.

$ sudo -u postgres psql
postgres=# ...
CREATE DATABASE ocean_db;
CREATE USER ocean_user WITH PASSWORD 'ocean_123';
ALTER ROLE ocean_user SET client_encoding TO 'utf8';
ALTER ROLE ocean_user SET default_transaction_isolation TO 'read committed';
ALTER ROLE ocean_user SET timezone TO 'UTC';
GRANT ALL PRIVILEGES ON DATABASE ocean_db TO ocean_user;
\q

Migrate to database and run project.

$ python manage.py makemigrations
$ python manage.py migrate
$ python manage.py runserver

Output

System check identified no issues (0 silenced).
Month date, year - hh:mm:ss
Django version 3.2.15, using settings 'ocean.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Open http://127.0.0.1:8000 in your browser for see result.