Update URL dispatching to new path method in django >= 2.0 #2596

New Issue

adam · 2025-12-29T18:20:15+01:00

adam commented

2025-12-29 18:20:15 +01:00

Originally created by @Grokzen on GitHub (May 8, 2019).

Proposed Changes

In django >= 2.0 there is a simpler form of url routing syntax that was introduced in 2.0 and expanded in 2.1. The basic example and changelog item can be found here https://docs.djangoproject.com/en/2.0/releases/2.0/#simplified-url-routing-syntax

The basic example of the change is

The new django.urls.path() function allows a simpler, more readable URL routing syntax. For example, this example from previous Django releases:

url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),

could be written as:

path('articles/<int:year>/', views.year_archive),

It simplifies the syntax some and removes a few things that is not needed in this simpler form.

But the main advantage is the simpler format of getting out simple variables from the URL. In the old way you needed to provide a regex for all types. But in this new format you get 5 built-in common types str, int, slug, uuid, path see https://docs.djangoproject.com/en/2.1/topics/http/urls/#path-converters And you can also build your own path converters if you have some custom format or need a new type like FourDigitYearConverter as shown in the example.

For all other cases you have access to a new method re_path that provides both things if you can't convert regexes right away.

Justification

url() is in 2.2 a shortcut to re_path and django states that this method will be deprecated in a future release. https://docs.djangoproject.com/en/2.2/ref/urls/#url

Originally created by @Grokzen on GitHub (May 8, 2019).  ### Proposed Changes In django >= 2.0 there is a simpler form of url routing syntax that was introduced in 2.0 and expanded in 2.1. The basic example and changelog item can be found here https://docs.djangoproject.com/en/2.0/releases/2.0/#simplified-url-routing-syntax The basic example of the change is ``` The new django.urls.path() function allows a simpler, more readable URL routing syntax. For example, this example from previous Django releases: url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive), could be written as: path('articles/<int:year>/', views.year_archive), ``` It simplifies the syntax some and removes a few things that is not needed in this simpler form. But the main advantage is the simpler format of getting out simple variables from the URL. In the old way you needed to provide a regex for all types. But in this new format you get 5 built-in common types `str, int, slug, uuid, path` see https://docs.djangoproject.com/en/2.1/topics/http/urls/#path-converters And you can also build your own path converters if you have some custom format or need a new type like `FourDigitYearConverter` as shown in the example. For all other cases you have access to a new method `re_path` that provides both things if you can't convert regexes right away.  ### Justification `url()` is in 2.2 a shortcut to `re_path` and django states that this method will be deprecated in a future release. https://docs.djangoproject.com/en/2.2/ref/urls/#url

adam added the status: accepted type: housekeeping labels 2025-12-29 18:20:15 +01:00

adam closed this issue

2025-12-29 18:20:15 +01:00

adam referenced this issue

2025-12-29 22:21:20 +01:00

[PR #2596] [CLOSED] Documentation refinement: manage.py rqworker command unknown #12408

Sign in to join this conversation.

Branches Tags

main

21102-fix-graphiql-explorer

update-changelog-comments-docs

20911-dropdown

20239-plugin-menu-classes-mutable-state

21097-graphql-id-lookups

feature

fix_module_substitution

20923-dcim-templates

20044-elevation-stuck-lightmode

feature-ip-prefix-link

v4.5-beta1-release

20068-import-moduletype-attrs

20766-fix-german-translation-code-literals

20378-del-script

7604-filter-modifiers-v3

circuit-swap

12318-case-insensitive-uniqueness

20637-improve-device-q-filter

20660-script-load

19724-graphql

20614-update-ruff

14884-script

02496-max-page

19720-macaddress-interface-generic-relation

19408-circuit-terminations-export-templates

20203-openapi-check

fix-19669-api-image-download

7604-filter-modifiers

19275-fixes-interface-bulk-edit

fix-17794-get_field_value_return_list

11507-show-aggregate-and-rir-on-api

9583-add_column_specific_search_field_to_tables

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/netbox#2596