Есть бесчисленное множество 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 Configuration
The `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 admin
from django.urls import path, include
urlpatterns = [
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 models
from tinymce import HTMLField
class 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 admin
from django.urls import path, include
from django.conf import settings # add this
from django.conf.urls.static import static # add this
urlpatterns = [
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 models
class 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 models
class 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 tables
from .models import MyModel
class 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 SingleTableView
from .models import MyModel
from .tables import MyTable
class ListView(SingleTableView):
model = MyModel
table_class = MyTable
template_name = 'main/table.html'Если вы собираетесь использовать представления-классы, перейдите в файл views.py и добавьте класс представления, задающий модель, таблицу и шаблон. Вам снова нужно будет импортировать необходимые переменные из соответствующих файлов в верхней части файла.
env > mysite > main > urls.py (представления-классы)
from django.urls import path
from . import views
app_name = "main"
urlpatterns = [
path("table", views.ListView.as_view()),
]Затем убедитесь, что в файле urls.py приложения есть URL к таблицам. Если вы планируете узнать больше о представлениях-классах, взгляните на статью «Представления-классы Django».
env > mysite > main > views.py (представления-функции)
...
from django_tables2 import SingleTableView
from .models import MyModel
from .tables import MyTable
def 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 path
from . import views
app_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 tables
from .models import MyModel
class 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_filters
from .models import MyModel
class 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 SingleTableMixin
from django_filters.views import FilterView
from .models import MyModel
from .tables import MyTable
from .filters import MyFilter
class 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 SingleTableMixin
from django_filter import FilterView
from .models import MyModel
from .tables import MyTable
def 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 =sdjioerb43buobnodhioh4i34hgip
DEBUG =Trueenv > mysite > mysite > settings.py
from decouple import config
SECRET_KEY = config('SECRET_KEY')
DEBUG = config('DEBUG', cast=bool)Создайте новый файл с именем .env в папке проекта, затем импортируйте config в файле settings.py. После чего перенесите все настройки конфигурации и переменные, которые вы желаете скрыть, в файл .env и вызывайте каждую переменную, используя python-decouple формат config('variable').
Если вам нужна более подробная информация, посетите страницу «Обеспечьте безопасность конфиденциальных переменных в Django, используя Python Decouple».
