Настраиваем виртуальную среду
Создаем папку под проект и создаем в ней временный файлик
создаем среду под разработку (желательно через conda), для этого тыкаем внизу версию питона и выбираем вариант создание виртуальной среды
Выбираем вариант с conda
Выбираем версию питона
ждем, снова тыкаем внизу выбор интерпретатора и проверяем что он выбрался
затем удаляем файлик main.py
Создание django проекта
создаем текстовый файл requirements.txt
прописываем туда
затем в консольку (обязательно проверять что она подключилась к виртуальной среде) пишите
pip install -r requirements.txt
когда установка закончится пропишите в requirements.txt версию джанги, которая установилась
теперь можно создать структуру джанго приложения. Выполните команду:
django-admin startproject app
у вас слева появится куча файликов
переместите файлик так чтобы у вас не было вложенной папки app
запустите сервер через
python manage.py runserver
если зайти по указанной ссылке, то увидим базовую страницу джанги
Настраиваем работу с БД
ставим себе плагин для работы с БД
после того как поставили этот плагин можно открывать базу, если нажимать на базу правой кнопкой и выбрать OpenDatabase
Вообще база нам нужна чтобы зайти в админку, в админку можно попасть по адресу
http://localhost:8000/admin
но так как юзера нет, то попасть мы в нее не можем
запускаем команду
тыкаем обновить БД
создаем суперюзера командой
python manage.py createsuperuser
Изучаем админку
идем в админку http://localhost:8000/admin и вводим данные для входа
заходим в юзеров
увидим там список пользователей
Создаем приложение в проекте
приложение – это просто папка со специальной структурой, в которую вынесена некоторая общая логика,
Чтобы его создать пишем команду (у меня будет проект про студентов, поэтому назову папку students)
python manage.py startapp students
Создаем модель
слева появится новая папка с кучей файликов. Нас интересует файлик models.py
создаем в ней класс Student
чтобы наш класс можно было подключать к админке и БД, надо добавить приложение в файлик settings вот сюда
чтобы по классу модели создалась табличка в БД, надо создать миграцию, для этого пишем
python manage.py makemigrations
у нас появится файлик в папке migrations
и теперь пишем еще одну команду чтобы запустить миграцию на БД, слева в списке таблице добавится табличка
Подключаем модель к админке
Идем в файлик students/admin.py и пишем там следующий код
заходим теперь в админку, тыкаем Students, а затем Add Student
там все будет на английском
чтобы поменять название полей на русский пишем в классе моделей:
если теперь обновить страницу админки увидим:
вы можете добавить студента, если заполните поля и нажмете SAVE
увидим что-то такое
чтобы слово Student и Students стали на понятном русскому человеку языку, надо в файле модели прописать
тогда в админке станет так
по умолчанию в списке выводится просто название модели,
если мы хотим, чтобы начали выводится какие-то конкретные поля, надо в файле admin указать выводимые поля в списке через свойство list_display
увидим такое:
чтобы стало понятно кто там все таким выводится, надо сделать следующее
Создаем зависимую таблицу
Попробуем теперь создать таблицу групп, и привяжем ее к таблице студентов через специально поле ForeignKey вот так:
если сейчас зайти в админку то увидим ошибку
это потому что мы создали таблице и новое поле, но не сделали миграцию.
Пишем снова команду
python manage.py makemigrations
и снова вызываем команду
теперь если зайти в админку, то все начнет работать. А при создании нового студента даже появится выпадающий список, через который можно будет выбрать группу:
добавляем теперь админку под группы
добавим пару групп
теперь если зайти в юзера, увидим их в списке, правда опять же в виде названия моделей с id
чтобы выводилось что-то более осознанное, например, название, идем в models.py и добавляем группе, метод __str__
и теперь красота
удаляем поле, название группы у Student
не забываем его также убрать из admin.py
создаем миграцию на удаление поля
python manage.py makemigrations
ну и вызываем ее
добавляем в админку вывод группы, уже через связанное поле
будет работать так же отлично
кстати можно указать конкретно поле которое вы хотите выводить, через двойное подчеркивание
тогда будет так (иногда это удобно)
Простой контроллер для страницы
Чтобы создать простую страницу для вывода данных, надо создать функцию в файлике views.py
и затем привязать эту функцию к роутеру
и тогда главная страница начнет чего-то показывать уже наше
если хочу вывести, например, что-то из базы то могу написать так
и уже выведется что-то поинтереснее:
правда использовать функции для контроллеров, это такое себе. Обычно используют классы. Классы более гибкие, и создавать их не сильно сложнее. Делается вот так:
класс привязывается к роутеру немного по-другому:
Шаблоны
если вы хотите использовать шаблонизатор, то надо создать папку templates и положить в нее файлик с шаблоном. Я создам вложенную папку, то есть внутри templates сделаю еще папку students и в нее уже положу шаблон
загоню туда стандартную разметку через ! и добавлю место под переменную students, которую мне надо будет как-то в шаблон передать
Чтобы джанга понимала где искать шаблоны надо добавить в settings.py
Чтобы подцепить контроллер к шаблону, надо наследовать ваш класс от класса TemplateView, указать путь к шаблону и переопределить функцию get_context, в которую собственно и передать данные для шаблона
Теперь можно чуть скорректировать шаблон
и глянуть как это все выводится
В общем, все это конечно здорово. Но нас интересует создание API для фронта. Поэтому генерация через шаблоны нам не пойдет.
Подключам Django Rest Framework
Для удобства создания api c основными CRUD операциями мы поставим еще одну библиотечку. Называется она Django Rest Framework
добавляем ее в requirements.txt
и пишием
pip install -r requirements.txt
после установки пропишем установленную версию
теперь пойдем в файлик settings.py
создадим файлик api.py в папке students и загоним туда следующий код
теперь добавим в файл app/urls.py
теперь если зайти в по адресу http://localhost:8000/api, увидим такое
чтобы там стало видно наш вьюсет students надо добавить миксин в наш класс
добавим файлик serializers.py и запишем в него
и подключим в api
теперь если зайдем сюда, то там появится такая ссылка
если кликнуть по ссылке увидим, список студентов
кстати если к ссылке добавить json, типа http://localhost:8000/api/students.json, то увидим
добавим группу в сериализатор
теперь увидим такое в списке
мы кстати можем добавить вложенный сериализатор, чтобы выводить инфу по группе.
Для этого добавим его в serializers.py
и явно пропишем поле group в StudentSerialzier
получим такое
если хотим, чтобы объект можно было добавлять надо подмешать еще один миксин
правда для этого надо еще пометить поле group как read_only
попробуйте добавить миксины
и посмотрите, как поведет страница
