Есть бесчисленное множество Python-пакетов, которые легко добавить в любой проект. Но также есть несколько пакетов, которые вы просто не можете не использовать в любом веб-приложении на Django, потому что они зарекомендовали себя как чрезвычайно полезные и экономящие время.
Мы решили сосредоточиться на тех пакетах, которые в конечном итоге вы будете устанавливать регулярно, и рассказать об установке, а также конфигурациях, необходимых для их приведения в состояние готовности к работе.
В то время как некоторые Python-пакеты предлагают потрясающую функциональность, необходимую для конкретного проекта, пакеты, обсуждаемые ниже, наиболее ходовые из Django-пакетов.
Веб-фреймворк Django
Но мы не можем перейти к Django-пакетам, не поговорив о
веб-фреймворке Django.
Веб-фреймворк состоит из модулей, или пакетов, которые позволяют
разработчикам быстро писать веб-приложения без необходимости иметь
дело с конкретными деталями протокола и с другими особенностями
организации веб-приложения.
Django считается клиент-серверным (прим. пер.: full-stack) веб-фреймворком, в котором база данных, сервер приложения, шаблонизатор, модуль аутентификации и диспетчер аккуратно скомбинированы для создания фреймворка высокого уровня. Эти отдельные компоненты добавляются в момент установки пакета, и зачастую их нужно просто немного настроить, чтобы они правильно функционировали.
Установка Django:
Терминал macOS
(env)User-Macbook:env user$ pip install django
Интерпретатор командной строки Windows
(env)C:\Users\Owner\desktop\env> pip install django
На момент данной статьи последняя версия Django 3.0.8. Все, что вам нужно для установки последней версии это команда pip install django.
Если вы хотите установить другую версию, то укажите ее номер, как показано в команде pip install django==2.1.15. Пожалуйста, обратите внимание, что там два знака равенства после имени пакета, а не один.
После завершения установки вам нужно будет начать конфигурирование своего веб-приложения на Django. Если вы хотите сразу перейти к построению своего веб-приложения на Django, то взгляните на краткие руководства: по установке Django и по его конфигурированию. Или, если вы только начали, и вам нужен пошаговый учебный материал, посмотрите на Руководство по веб-приложениям на Django для начинающих.
Но мы здесь, чтобы поговорить о Python-пакетах, предназначенных для веб-приложений на Django, а не о базовых конфигурациях Django, так что продолжим. Нам нужно многое обсудить.
(1) Django TinyMCE4 Lite
Терминал macOS
(env)User-Macbook:mysite user$ pip install django-tinymce4-lite
Интерпретатор командной строки Windows
(env) C:\Users\Owner\Desktop\Code\env\mysite>pip install django-tinymce4-lite
Как только вы закончили с базовой настройкой своего веб-приложения, вы можете установить замечательный Python-пакет django-tinymce4-lite. Этот пакет, фактически, уменьшенная версия Django-приложения django-tinymce4, которая включает в себя виджет для рендеринга полей Django-формы в виде редакторов TinyMCE.
TinyMCE это текстовый WSIWYG (что видишь, то и получишь) редактор, который конвертирует HTML-элементы в экземпляры редактора или в простой текст. Этот Python-пакет настоятельно рекомендуется, если вы рассчитываете создать блог, так как вы можете легко редактировать текст, который затем форматируется в HTML в соответствии с текущим шаблоном.
env > mysite > mysite > settings.py
INSTALLED_APPS = [ ... ... 'tinymce',]TINYMCE_DEFAULT_CONFIG = { 'height': 400, 'width': 1000, 'cleanup_on_startup': True, 'custom_undo_redo_levels': 20, 'selector': 'textarea', 'browser_spellcheck': 'true', 'theme': 'modern', 'plugins': ''' textcolor save link image media preview codesample contextmenu table code lists fullscreen insertdatetime nonbreaking contextmenu directionality searchreplace wordcount visualblocks visualchars code fullscreen autolink lists charmap print hr anchor pagebreak ''', 'toolbar1': ''' fullscreen preview bold italic underline | fontselect, fontsizeselect | forecolor backcolor | alignleft alignright | aligncenter alignjustify | indent outdent | bullist numlist table | | link image media | codesample ''', 'toolbar2': ''' visualblocks visualchars | charmap hr pagebreak nonbreaking anchor | code | ''', 'contextmenu': 'formats | link image', 'menubar': True, 'statusbar': True,}
После установки вам нужно будет добавить tinymce в список установленных приложений в файле settings.py, а затем ниже добавить настройки по умолчанию. Конфигурации по умолчанию определяют высоту, ширину, панели инструментов и проверку орфографии.
env > mysite > mysite > urls.py
"""mysite URL ConfigurationThe `urlpatterns` list routes URLs to views. For more information please see: https://docs.djangoproject.com/en/2.1/topics/http/urls/Examples:Function views 1. Add an import: from my_app import views 2. Add a URL to urlpatterns: path('', views.home, name='home')Class-based views 1. Add an import: from other_app.views import Home 2. Add a URL to urlpatterns: path('', Home.as_view(), name='home')Including another URLconf 1. Import the include() function: from django.urls import include, path 2. Add a URL to urlpatterns: path('blog/', include('blog.urls'))"""from django.contrib import adminfrom django.urls import path, includeurlpatterns = [ path('admin/', admin.site.urls), path('', include ('main.urls')), path('tinymce/', include('tinymce.urls')), #add this
Затем добавьте путь к tinymce в URL-ы проекта.
env > mysite > main > models.py
from django.db import modelsfrom tinymce import HTMLFieldclass MyModel(models.Model): ... content = HTMLField()
Наконец, вы можете быстро добавить TinyMCE в Django-модель, импортируя HTMLField наверху файла и потом вызывая его в поле модели. Если вы не уверены, как пользоваться Django-моделями, посмотрите статью Как пользоваться Django-моделями для получения более подробной информации.
(1) Pillow
Терминал macOS
(env)User-Macbook:mysite user$ pip install Pillow
Интерпретатор командной строки Windows
(env) C:\Users\Owner\Desktop\Code\env\mysite>pip install Pillow
Да, этот пакет не связан с Django, но он необходим, чтобы выгрузка файлов и изображений на сайт работала корректно в Django-проекте. Если вы планируете использовать поле для выгрузки на сайт медиаданных в своей Django-модели для, скажем, обложки статьи, то вам нужно будет установить Pillow. Это форк библиотеки Python Imaging Library для корректной выгрузки файлов.
env > mysite > mysite > settings.py
MEDIA_URL = '/media/'MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
Сразу после установки вам нужно добавить URL к папке для медиафайлов и корневую директорию в файл settings.py.
env > mysite > mysite > urls.py
from django.contrib import adminfrom django.urls import path, includefrom django.conf import settings # add thisfrom django.conf.urls.static import static # add thisurlpatterns = [ path('admin/', admin.site.urls), path('', include('main.urls')),]if settings.DEBUG: # add this urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
Далее вам нужно добавить необходимые импорты в верхней части файла urls.py вашего проекта и указать URL-шаблон к папке для хранения медиафайлов. Имейте в виду, что выгрузка медиаданных на сайт не будет работать в эксплуатационном режиме с этой условной конструкцией. Вам нужно будет реконфигурировать свое местоположение выгрузки медиаданных, когда вы будете готовы приступить к развертыванию своего проекта.
env > mysite > main > models.py
from django.db import modelsclass MyModel(models.Model): ... image = models.ImageField(upload_to='images/')
Теперь, чтобы выгрузить изображение, перейдите в ваш файл с моделями и добавьте поле класса ImageField с 'images/' в качестве местоположения выгрузки. Выгруженные изображения будут затем добавлены в папку media > images, которая будет автоматически создана при выгрузке.
Для более подробной информации о правильном создании модели, доступе к местоположению выгрузки в админке Django и рендеринге модели в шаблоне обратитесь к материалу Как использовать модели Django.
(3) Django Crispy Forms
Терминал macOS
(env)User-Macbook:mysite user$ pip install django-crispy-forms
Интерпретатор командной строки Windows
(env) C:\Users\Owner\desktop\code\env\mysite>pip install django-crispy-forms
Давайте поговорим о формах Django. У них отличная функциональность, но не самый лучший внешний вид. Вы можете установить в свой проект django-crispy-forms, чтобы быстро решить эту проблему.
env > mysite > mysite > settings.py
INSTALLED_APPS = [ ... 'crispy_forms',]CRISPY_TEMPLATE_PACK = 'uni_form'
Для корректной работы пакета вам нужно будет перейти в файл settings.py и добавить crispy_forms в список установленных приложений. Учтите, что между crispy и forms присутствует нижнее подчеркивание.
Затем вам нужно указать пакет crispy-шаблонов. Тот, что указан ниже (прим. пер.: ниже переменной INSTALLED_APPS), пакет по умолчанию, но если вы используете CSS-фреймворк Bootstrap, посмотрите как интегрировать Bootstrap с django-crispy-forms.
env > mysite > main > templates > main > contact.html
{% load crispy_forms_tags %}<form method="post"> {% csrf_token %} {{form|crispy}} <button type="submit">Submit</button></form>
Пакет django-crispy-forms добавляется в проект в форме фильтра внутри {{form}} языка шаблонов Django. Эта форма не только будет вызывать все поля формы, но и форматировать каждое поле в соответствии с пакетом crispy-шаблонов, заданным в файле settings.py.
Обратитесь к статье Рендерьте формы с помощью Django Crispy Forms для более подробной информации касательно процесса рендеринга форм, и к статье Создавайте контактную Django-форму с бэкендом электронной почты для более общей информации о построении Django-форм.
(4) Django Tables
Терминал macOS
(env)User-Macbook:mysite user$ pip install django-tables2
Интерпретатор командной строки Windows
(env) C:\Users\Owner\desktop\code\env\mysite>pip install django-tables2
Теперь предположим, что вы хотите в своем Django-проекте создать динамическую таблицу, которая связывается с моделью. Установите django-tables2 связанный с Django пакет для рендеринга таблиц.
env > mysite > mysite > settings.py
INSTALLED_APPS = [ ... 'django_tables2',]
Добавьте Django tables в список установленных приложений.
env > mysite > main > models.py
from django.db import modelsclass MyModel(models.Model): name = models.CharField(max_length=100, verbose_name="full name") email = models.EmailField(max_length=200)
Затем создайте модель, которую вы хотите использовать в таблице.
После создания модели вам нужно будет отправить на выполнение команды python manage.py makemigrations и python manage.py migrate, чтобы добавить модель в базу данных и добавить объекты своей модели через админку Django. Посмотрите Как использовать модели Django для более подробной инструкции.
env > mysite > main > (новый файл) tables.py
import django_tables2 as tablesfrom .models import MyModelclass MyTable(tables.Table): class Meta: model = MyModel fields = ("name", "email", )
Теперь создайте новый файл с именем tables.py в папке приложения в main, и в верхней части файла импортируйте django_tables2, например под именем tables. Затем создайте класс, который задает модель и имена полей.
env > mysite > main > views.py (представления-классы)
...from django_tables2 import SingleTableViewfrom .models import MyModelfrom .tables import MyTableclass ListView(SingleTableView): model = MyModel table_class = MyTable template_name = 'main/table.html'
Если вы собираетесь использовать представления-классы, перейдите в файл views.py и добавьте класс представления, задающий модель, таблицу и шаблон. Вам снова нужно будет импортировать необходимые переменные из соответствующих файлов в верхней части файла.
env > mysite > main > urls.py (представления-классы)
from django.urls import pathfrom . import viewsapp_name = "main"urlpatterns = [ path("table", views.ListView.as_view()),]
Затем убедитесь, что в файле urls.py приложения есть URL к таблицам. Если вы планируете узнать больше о представлениях-классах, взгляните на статью Представления-классы Django.
env > mysite > main > views.py (представления-функции)
...from django_tables2 import SingleTableViewfrom .models import MyModelfrom .tables import MyTabledef list(request): model = MyModel.objects.all() table = MyTable(model) return render(request=request, template_name="main/table.html", context={"model":model, "table":table})
Или вы можете создать представления-функции в файле views.py. Любой из двух вариантов работает, но отличается форма их записи.
env > mysite > main > urls.py (представления-функции)
from django.urls import pathfrom . import viewsapp_name = "main" urlpatterns = [ path("table", views.list, name="list"),]
Затем добавьте URL к таблице в файле urls.py приложения.
env > mysite > main > templates > main > (новый файл) table.html
{ % load render_table from django_tables2 % }<div > { % render_table table % }</div >
С настроенными представлениями и адресами вы можете рендерить таблицу в шаблоне, подгружая render_table from django_tables2 в верхней части файла, а затем вызывая render_table с таблицей из контекста, переданной в представлении.
По умолчанию представление-класс передает табличный контекст просто как table, и в представлении-функции мы тоже решили указать контекст таблицы как table.
*Если вы хотите добавить CSS фреймворка Bootstrap в таблицу:
env > mysite > main > tables.py*
import django_tables2 as tablesfrom .models import MyModelclass MyTable(tables.Table): class Meta: model = MyModel template_name = "django_tables2/bootstrap4.html" fields = ("name", "email",)
Добавьте имя шаблона, связанное с шаблоном Bootstrap, в файл tables.py. Этот и другие файлы шаблонов можно найти в папке Lib > site-packages > django_tables2 > templates > django_tables2 вашего проекта.
env > mysite > main > templates > main > (новый файл) table.html
{% extends "main/header.html" %}{% block content %}{% load render_table from django_tables2 %}<div class="container"> {% render_table table %}</div>{% endblock %}
Кроме того, вы можете унаследовать шаблон шапки, который загружает CDN-ы фреймворка Bootstrap. Это самый простой способ добавления Bootstrap во все ваши шаблоны с использованием одного и того же куска кода.
Если вам не понятно, как использовать тег extends с CDN-ми Bootstrap, посмотрите раздел Django extends tag and block content (прим. пер.: Django-тег extends и контент блока) в Руководстве по веб-приложениям на Django для начинающих.
(5) Django Filter
Терминал macOS
(env)User-Macbook:mysite user$ pip install django-filter
Интерпретатор командной строки Windows
(env) C:\Users\Owner\desktop\code\env\mysite> pip install django-filter
Теперь, когда у вас есть таблица, вам, вероятно, захочется иметь возможность искать определенный контент в пределах строк и фильтровать таблицу по результатам поиска. Пакет django-filter можно легко использовать поверх пакета django-tables2, чтобы получить эту возможность.
env > mysite > mysite > settings.py
INSTALLED_APPS = [ ... 'django_filters',]
Добавьте Django-фильтры в установленные приложения. Обратите внимание, что в этом списке они называются django_filters, а не django_filter.
env > mysite > main > (новый файл) filters.py
import django_filtersfrom .models import MyModelclass MyFilter(django_filters.FilterSet): name = django_filters.CharFilter(lookup_expr='icontains') class Meta: model = MyModel fields = {'name', 'email'}
Теперь создайте в папке приложения в main, новый файл с именем filters.py, и импортируйте django_filters. После чего укажите модель и поля модели, по которым вы хотите делать фильтрацию.
Вы решаете добавить django_filters.CharFilter в класс, где в примере выше фильтр отображает любые строки, в которых столбец name содержит указанный запрос.
Также вы можете использовать django_filters.CharFilter(lookup_expr='iexact'), если собираетесь фильтровать только по строгому совпадению с запросом.
env > mysite > main > views.py (представления-классы)
...from django_tables2 import SingleTableMixinfrom django_filters.views import FilterViewfrom .models import MyModelfrom .tables import MyTablefrom .filters import MyFilterclass ListView(SingleTableMixin, FilterView): model = MyModel table_class = MyTable template_name = 'main/table.html' filterset_class = MyFilter
Затем, в случае представления-класса, импортируйте FilterView из django_filters.views в верхней части файла и измените импорт django_tables2 с SingleTableView на SingleTableMixin. Также вам нужно будет импортировать свой кастомный фильтр из файла filter.py.
Представление-класс ListView теперь будет наследоваться от SingleTableMixin и FilterView и содержать атрибут filterset_class, которому присваивается кастомный фильтр.
env > mysite > main > templates > main > table.html
{% load render_table from django_tables2 %}<div> <br> <form action="" method="GET"> {{filter.form}} <button type="submit">Filter</button> </form> <br> {% render_table table %}</div>
С представлениями-классами URL останется тем же, но вам нужно будет добавить HTML-элемент form и использовать язык шаблонов Django, чтобы вызывать фильтр и форму внутри шаблона. Также внутри формы вам нужна кнопка типа submit, чтобы отправлять свои запросы на фильтрацию. В способе рендеринга таблицы нет никаких изменений.
env > mysite > main > views.py (представления-функции)
...from django_tables2.views import SingleTableMixinfrom django_filter import FilterViewfrom .models import MyModelfrom .tables import MyTabledef list(request): model = MyModel.objects.all() filterset_class = MyFilter(request.GET, model) table = MyTable(filterset_class.qs) return render(request=request, template_name="main/table.html", context={"model":model, "table":table, "filterset_class":filterset_class})
При использовании представлений-функций импортируйте те же классы, что и в случае с представлениями-классами, затем создайте экземпляр класса MyFilter и передайте в качестве аргументов атрибут GET запроса и модель. Передайте filterset_class как аргумент, содержащий выборку объектов (прим. пер.: queryset) в таблице, а потом укажите filterset_class в качестве контекста в вызове функции render.
env > mysite > main > templates > main > table.html
{% load render_table from django_tables2 %}<div> <br> <form action="" method="GET"> {{filterset_class.form}} <button type="submit">Filter</button> </form> <br> {% render_table table %}</div>
В случае представлений-функций вам нужно будет указать filterset_class, или имя, указанное в контексте, в качестве фильтра для формы. Все остальное выглядит так же, как и в шаблоне для представления-класса.
Если вы собираетесь стилизовать форму, то либо прокрутите страницу вверх до раздела Django Crispy Forms, либо кликните на упомянутую ранее статью Рендерьте формы с помощью Django Crispy Forms.
(6) Python Decouple
Терминал macOS
(env)User-Macbook:mysite user$ pip install python-decouple
Интерпретатор командной строки Windows
(env) C:\Users\Owner\desktop\code\env\mysite> pip install python-decouple
Последний, и пожалуй, наиболее важный Python-пакет, который мы обсудим это python-decouple. Этот пакет скрывает ваши конфиденциальные ключи конфигурациии информацию от хакеров.
Изначально он был создан для Django, но сейчас рассматривается как типовой инструмент для отделения настроек конфигурации.
env > mysite > (новый файл) .env
SECRET_KEY =sdjioerb43buobnodhioh4i34hgipDEBUG =True
env > mysite > mysite > settings.py
from decouple import configSECRET_KEY = config('SECRET_KEY')DEBUG = config('DEBUG', cast=bool)
Создайте новый файл с именем .env в папке проекта, затем импортируйте config в файле settings.py. После чего перенесите все настройки конфигурации и переменные, которые вы желаете скрыть, в файл .env и вызывайте каждую переменную, используя python-decouple формат config('variable').
Если вам нужна более подробная информация, посетите страницу Обеспечьте безопасность конфиденциальных переменных в Django, используя Python Decouple.