Skip to content

Latest commit

 

History

History
101 lines (76 loc) · 2.72 KB

README.md

File metadata and controls

101 lines (76 loc) · 2.72 KB

api_yamdb by "Python 74"

Brief Description

The project YaMDb collects users recalls on publications. The publications do not store in YaMDb, there is no option to see movie or listen to music. The publications categorized such as "Books", "Movies", "Music". For example in "Books" category there may be publications as "Vinnie-Pukh and all-all-all", "Martian chronicle", and "Davecha" song of "Bugs"-banda and Bakh second suite. Categories list might be expanded (for example, it can be added category "Art" or "Jeweler"). It could be committed pre-set genre as "Fairy tale", "Rock" or "Arthouse" to publication.

Adding of Titles, Categories or Genres may be done by Administrator only. Grateful or indignant Users leave text Reviews for the works and Score/Rate the work in the range from 1 to 10 (an integer); from User Score, an Average Score of the Title is applied - Rating (integer). A User can leave only one Review per a Title. Users can leave Comments on Review. Only Authenticated Users can add Reviews, Comments and Score.

Anonym — could read Titles descriptions, Reviews and Comments. Authenticated User (user) — could, as Anonym, additionally he could POST Reviews and put Score to Titles (Movies/Books/Songs), could Comment on foreign Reviews; Could edit and delete own Reviews and Comments. This role applied by default to any new User. Moderator (moderator) — same rights, as for Authenticated User with rights addition to remove any Reviews and Comments. Administrator (admin) — all rights to control all pproject content. Could create and delete Titles, Categories & Genres. Can adjust Roles to Users. Django Superusers — poses Administrator rights (Admin).

The project has endpoints sections (with -requests | endpoints):

AUTH
(POST | http://127.0.0.1:8000/api/v1/auth/signup/),
***Request:***
{
  "email": "[email protected]",
  "username": "string"
}
***Response:***
{
  "email": "string",
  "username": "string"
}
(POST | http://127.0.0.1:8000/api/v1/auth/token/);
***Request:***
{
  "username": "string",
  "confirmation_code": "string"
}
***Response:***
{
  "token": "string"
}

For further details please refer: http://127.0.0.1:8000/redoc/

How to lauch the project:

Clone repository:
git clone [email protected]:smart2004/api_yamdb.git
Switch to the folder:
cd api_yamdb
Create and activate virtual environment:
py -3.9 -m venv venv
source venv/scripts/activate
Setup dependencies from requirements.txt file:
python -m pip install --upgrade pip
pip install -r requirements.txt
Apply migrations:
python manage.py makemigrations
python manage.py migrate
Launch server:
python manage.py runserver