django.conf.urls служебные функции

static()

static.static(prefix, view=django.views.static.serve, **kwargs)

Вспомогательная функция для возвращения шаблона URL для обработки файлов в режиме отладки:

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ... the rest of your URLconf goes here ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

url()

url(regex, view, kwargs=None, name=None) [source]

urlpatterns должно быть списком url() экземпляров. Например:

from django.conf.urls import include, url

urlpatterns = [
    url(r'^index/$', index_view, name='main-view'),
    url(r'^weblog/', include('blog.urls')),
    ...
]

Параметр regex должен быть строкой или ugettext_lazy() (см. Перевод шаблонов URL), содержащей регулярное выражение, совместимое с модулем Python re. Строки обычно используют синтаксис необработанных строк (r''), чтобы они могли содержать последовательности, такие как \d без необходимости экранирования обратной косой черты ещё одной обратной косой чертой.

Параметр view — это функция представления или результат as_view() для представлений на основе классов. Он также может быть include().

Параметр kwargs позволяет передать дополнительные аргументы в функцию или метод представления. См. Передача дополнительных опций функциям представления для примера.

См. Именование шаблонов URL для того, почему параметр name полезен.

include()

include(module, namespace=None, app_name=None) [source]

include(pattern_list)

include((pattern_list, app_namespace), namespace=None)

include((pattern_list, app_namespace, instance_namespace))

Функция, которая принимает полный путь импорта Python к другому модулю URLconf, который должен быть «включён» в это место. Дополнительно можно указать пространство имён приложения и пространство имён экземпляра, куда будут включены записи.

Обычно пространство имён приложения должно быть указано включаемым модулем. Если пространство имён приложения установлено, аргумент namespace может использоваться для задания другого пространства имён экземпляра.

include() также принимает в качестве аргумента либо итерируемый объект, возвращающий шаблоны URL, либо 2-кортеж, содержащий такой итерируемый объект и имена пространств имён приложения, либо 3-кортеж, содержащий итерируемый объект и имена пространств имён приложения и экземпляра.

Параметры:

module – Модуль URLconf (или имя модуля) namespace (строка) – Пространство имён экземпляра для включаемых записей URL app_name (строка) – Пространство имён приложения для включаемых записей URL pattern_list – Итерируемый объект экземпляров django.conf.urls.url() app_namespace (строка) – Пространство имён приложения для включаемых записей URL instance_namespace (строка) – Пространство имён экземпляра для включаемых записей URL

См. Включение других URLconf и Пространства имён URL и включённые URLconf.

handler400

handler400

Вызываемый объект или строка, представляющая полный путь импорта Python к представлению, которое должно быть вызвано, если HTTP-клиент отправил запрос, вызвавший ошибку состояния и ответ со статусом 400.

По умолчанию это 'django.views.defaults.bad_request'. Если вы реализуете пользовательское представление, убедитесь, что оно возвращает HttpResponseBadRequest.

См. документацию по представлению 400 (ошибка запроса) для получения дополнительной информации.

handler403

handler403

Вызываемый объект или строка, представляющая полный путь импорта Python к представлению, которое должно быть вызвано, если у пользователя нет необходимых разрешений для доступа к ресурсу.

По умолчанию это 'django.views.defaults.permission_denied'. Если вы реализуете пользовательское представление, убедитесь, что оно возвращает HttpResponseForbidden.

См. документацию по представлению 403 (HTTP Запрещено) для получения дополнительной информации.

handler404

handler404

Вызываемый объект или строка, представляющая полный путь импорта Python к представлению, которое должно быть вызвано, если ни один из шаблонов URL не соответствует.

По умолчанию это 'django.views.defaults.page_not_found'. Если вы реализуете пользовательское представление, убедитесь, что оно возвращает HttpResponseNotFound.

См. документацию по представлению 404 (HTTP Не найдено) для получения дополнительной информации.

handler500

handler500

Вызываемый объект или строка, представляющая полный путь импорта Python к представлению, которое должно быть вызвано в случае возникновения ошибок сервера. Ошибки сервера возникают при возникновении ошибок во время выполнения в коде представления.

По умолчанию это 'django.views.defaults.server_error'. Если вы реализуете пользовательское представление, убедитесь, что оно возвращает HttpResponseServerError.

См. документацию по представлению 500 (HTTP Внутренняя ошибка сервера) для получения дополнительной информации.