Fonctions django.urls à utiliser dans les configurations d’URL

path()

path(route, view, kwargs=None, name=None)
New in Django 2.0.

Renvoie un élément à inclure dans urlpatterns. Par exemple

from django.urls import include, path

urlpatterns = [
    path('index/', views.index, name='main-view'),
    path('bio/<username>/', views.bio, name='bio'),
    path('articles/<slug:title>/', views.article, name='article-detail'),
    path('articles/<slug:title>/<int:section>/', views.section, name='article-section'),
    path('weblog/', include('blog.urls')),
    ...
]

The route argument should be a string or gettext_lazy() (see Traduction de motifs d’URL) that contains a URL pattern. The string may contain angle brackets (like <username> above) to capture part of the URL and send it as a keyword argument to the view. The angle brackets may include a converter specification (like the int part of <int:section>) which limits the characters matched and may also change the type of the variable passed to the view. For example, <int:section> matches a string of decimal digits and converts the value to an int. See Processus de traitement des requêtes par Django for more details.

The view argument is a view function or the result of as_view() for class-based views. It can also be an django.urls.include().

The kwargs argument allows you to pass additional arguments to the view function or method. See Transmission de paramètres supplémentaires à une vue for an example.

Voir Nommage des motifs d’URL pour connaître l’utilité du paramètre name.

re_path()

re_path(route, view, kwargs=None, name=None)
New in Django 2.0.

Renvoie un élément à inclure dans urlpatterns. Par exemple

from django.urls import include, re_path

urlpatterns = [
    re_path(r'^index/$', views.index, name='index'),
    re_path(r'^bio/(?P<username>\w+)/$', views.bio, name='bio'),
    re_path(r'^weblog/', include('blog.urls')),
    ...
]

The route argument should be a string or gettext_lazy() (see Traduction de motifs d’URL) that contains a regular expression compatible with Python’s re module. Strings typically use raw string syntax (r'') so that they can contain sequences like \d without the need to escape the backslash with another backslash. When a match is made, captured groups from the regular expression are passed to the view – as named arguments if the groups are named, and as positional arguments otherwise. The values are passed as strings, without any type conversion.

The view, kwargs and name arguments are the same as for path().

include()

include(module, namespace=None)[source]
include(pattern_list)
include((pattern_list, app_namespace), namespace=None)

Une fonction acceptant un chemin d’importation Python complet vers un autre module de configuration d’URL devant être « inclus » à cet endroit. Il est possible d’indiquer aussi l”espace de noms d’application et l”espace de noms d’instance dans lesquels les éléments seront inclus.

Habituellement, l’espace de noms d’application doit être défini par le module inclus. Si un espace de noms d’application est défini, le paramètre namespace peut être utilisé pour définir un espace de noms d’instance différent.

include() accepte aussi en paramètre soit un objet itérable renvoyant des motifs d’URL ou un tuple binaire contenant un tel objet itérable accompagné des noms des espaces de noms d’application.

Paramètres:
  • module – Module de configuration d’URL (ou nom de module)
  • namespace (string) – Espace de noms d’instance pour les lignes d’URL à inclure
  • pattern_list – Iterable of path() and/or re_path() instances.
  • app_namespace (string) – Espace de noms d’application pour les lignes d’URL à inclure

Voir Inclusion d’autres URLconfs et Espaces de noms d’URL et configurations d’URL incluses.

Changed in Django 2.0:

In older versions, this function is located in django.conf.urls. The old location still works for backwards compatibility.

register_converter()

register_converter(converter, type_name)[source]
New in Django 2.0.

The function for registering a converter for use in path() routes.

The converter argument is a converter class, and type_name is the converter name to use in path patterns. See Inscription de convertisseurs de chemin personnalisés for an example.

Fonctions django.conf.urls à utiliser dans les configurations d’URL

static()

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

Fonction utilitaire qui renvoie un motif d’URL pour servir les fichiers en mode débogage :

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]

This function is an alias to django.urls.re_path(). It’s likely to be deprecated in a future release.

handler400

handler400

Un objet exécutable ou une chaîne représentant le chemin d’importation Python complet vers la vue devant être appelée si le client HTTP a envoyé une requête qui a provoqué une condition d’erreur et une réponse avec un code de statut 400.

Par défaut, il s’agit de django.views.defaults.bad_request(). Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse HttpResponseBadRequest.

handler403

handler403

Un objet exécutable ou une chaîne représentant le chemin d’importation Python complet vers la vue devant être appelée si l’utilisateur n’a pas les droits nécessaires pour accéder à une ressource.

Par défaut, il s’agit de django.views.defaults.permission_denied(). Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse HttpResponseForbidden.

handler404

handler404

Un objet exécutable ou une chaîne représentant le chemin d’importation Python complet vers la vue devant être appelée si aucun des motifs d’URL ne correspond.

Par défaut, il s’agit de django.views.defaults.page_not_found(). Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse HttpResponseNotFound.

handler500

handler500

Un objet exécutable ou une chaîne représentant le chemin d’importation Python complet vers la vue devant être appelée en cas d’erreur de serveur. Les erreurs de serveur se produisent lorsque des erreurs d’exécution apparaissent dans le code des vues.

Par défaut, il s’agit de django.views.defaults.server_error(). Si vous implémentez une vue personnalisée, prenez soin de renvoyer une réponse HttpResponseServerError.

Back to Top