Написание вашего первого приложения Django, часть 1 ¶

Создание приложения "Опросы" ¶

Теперь, когда ваша среда - «проект» - настроена, вы готовы приступить к работе.

Каждое приложение, которое вы пишете в Django, состоит из пакета Python, который следует определенному соглашению. Django поставляется с утилитой, которая автоматически генерирует базовую структуру каталогов приложения, поэтому вы можете сосредоточиться на написании кода, а не на создании каталогов.

Ваши приложения могут жить где угодно на вашем пути Python . В этом руководстве мы создадим наше приложение для опроса в том же каталоге, что и ваш manage.pyфайл, чтобы его можно было импортировать как собственный модуль верхнего уровня, а не как подмодуль mysite.

Чтобы создать приложение, убедитесь, что вы находитесь в том же каталоге, что manage.py и, и введите эту команду:

$ python manage.py startapp polls

... \> py manage.py startapp опросы

Это создаст каталог polls, который выглядит следующим образом:

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

В этой структуре каталогов будет размещено приложение опроса.

Напишите свой первый взгляд ¶

Напишем первое представление. Откройте файл polls/views.py и поместите в него следующий код Python:

from django.http import HttpResponse


def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

Это самый простой вид из возможных в Django. Чтобы вызвать представление, нам нужно сопоставить его с URL-адресом - и для этого нам понадобится URLconf.

Чтобы создать URLconf в каталоге опросов, создайте файл с именем urls.py. Каталог вашего приложения теперь должен выглядеть так:

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

В polls/urls.pyфайл включаем следующий код:

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

Следующим шагом является указание корневого URLconf на polls.urlsмодуль. В mysite/urls.pyдобавьте импорт для django.urls.includeи вставьте include()в urlpatternsсписок, чтобы у вас было:

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('polls/', include('polls.urls')),
    path('admin/', admin.site.urls),
]

include()Функция позволяет ссылку других URLconfs. Всякий раз, когда встречается Django include(), он отрезает любую часть URL-адреса, совпадающую до этого момента, и отправляет оставшуюся строку во включенный URLconf для дальнейшей обработки.

Идея include()состоит в том, чтобы упростить подключение URL-адресов по принципу plug-and-play. Поскольку опросы находятся в собственном URLconf ( polls/urls.py), их можно разместить в «/ polls /», «/ fun_polls /», «/ content / polls /» или любом другом корневом пути, и приложение все равно будет Работа.

Теперь вы подключили indexпредставление к URLconf. Убедитесь, что он работает, с помощью следующей команды:

$ python manage.py runserver

... \> сервер запуска py manage.py

Перейдите по адресу http: // localhost: 8000 / polls / в своем браузере, и вы должны увидеть текст « Hello, world. Вы попали в индекс опросов. », Который вы определили в indexпредставлении.

path()Функции передаются четыре аргумента, два необходимо: routeи viewи два опциональные: kwargsи name. На этом этапе стоит рассмотреть, для чего нужны эти аргументы.