Fonctions utilitaires django.conf.urls

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]

urlpatterns doit être une liste d’instances url(). Par exemple :

from django.conf.urls import include, url

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

Le paramètre regex devrait être une chaîne ou une valeur ugettext_lazy() (voir Traduction de motifs d’URL) contenant une expression régulière compatible avec le module re de Python. Les chaînes utilisent typiquement la syntaxe des chaînes brutes (r'') afin qu’elles puissent contenir des séquences telles que \d sans devoir échapper la barre oblique inverse avec une autre barre.

Le paramètre view est une fonction de vue ou le résultat de as_view() pour les vues fondées sur des classes. Cela peut aussi être une inclusion include().

Le paramètre kwargs permet de transmettre des paramètres supplémentaires à la fonction ou méthode de vue. Voir Transmission de paramètres supplémentaires à une vue pour un exemple.

Voir Nommage des motifs d’URL pour connaître l’utilité du paramètre 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))

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, un tuple binaire contenant l’objet itérable avec les noms des espaces de noms d’application, ou un tuple ternaire contenant un tel objet itérable accompagné des noms des espaces de noms d’application et d’instance.

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
  • app_name (string) – Espace de noms d’application pour les lignes d’URL à inclure
  • pattern_list – Liste d’instances django.conf.urls.url()
  • app_namespace (string) – Espace de noms d’application pour les lignes d’URL à inclure
  • instance_namespace (string) – Espace de noms d’instance pour les lignes d’URL à inclure

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

Obsolète depuis la version 1.9: La prise en charge du paramètre app_name est obsolète et sera supprimée dans Django 2.0. Indiquez plutôt app_name de la manière présentée dans Espaces de noms d’URL et configurations d’URL incluses.

La possibilité de passer un tuple de 3 éléments est également obsolète et sera supprimée dans Django 2.0. Passez un tuple à 2 éléments contenant la liste des motifs et l’espace de noms d’application, et utilisez à la place le paramètre namespace.

Enfin, la prise en charge d’un espace de noms d’instance sans espace de noms d’application est maintenant obsolète et sera supprimée dans Django 2.0. Indiquez l’espace de noms d’application ou supprimez l’espace de noms d’instance.

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.

Consultez la documentation à propos de la vue 400 (mauvaise requête) pour plus d’informations.

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.

Consultez la documentation à propos de la vue 403 (HTTP interdit) pour plus d’informations.

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.

Consultez la documentation à propos de la vue 404 (HTTP non trouvé) pour plus d’informations.

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.

Consultez la documentation à propos de la vue 500 (HTTP erreur interne de serveur) pour plus d’informations.

Fonctions utilitaires django.urls
Utilitaires Django
Back to Top