Django 2.0
Simplified url
routing syntax

Florian Demmer

Django Meetup, 2018-06-19

Past and future

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


  • urlpatterns_2_0 = [
    path('articles/2018/', views.special_case_2018),
    path('articles/<int:year>/', views.year_archive),
    path('articles/<:year>/', views.year_archive),
]

Path converters

  • str - non-empty string, excluding '/', default
  • path - non-empty string, including '/'
  • int - positive integer
  • slug - ASCII letters/numbers, hyphen, underscore
  • uuid - formatted UUID lowercase string

but my {4}  :(

(?P<year>[0-9]{4})

vs

<int:year>

Custom path converters

class FourDigitYearConverter:
    regex = '[0-9]{4}'

    def to_python(self, value):
        return int(value)

    def to_url(self, value):
        return '%04d' % value


register_converter(FourDigitYearConverter, 'yyyy')


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

or... why change at all?!

urlpatterns = [
    path('articles/2003/', views.special_case_2003),
    re_path(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
]

Fun with custom converters

class MyThingConverter(IntConverter):
    def to_python(self, value):
        try:
            return MyThing.objects.get(pk=int(value))
        except MyThing.DoesNotExist:
            raise ValueError

    def to_url(self, value):
        return str(obj.pk)

register_converter(MyThingConverter, 'my_thing')

path('things/<my_thing:instance>/', my_things_view)

All the things

 

  • https://docs.djangoproject.com/en/2.0/topics/http/urls/

  • https://consideratecode.com/2018/05/11/the-hidden-powers-of-custom-django-2-0-path-converters/

  • my twitter: @fdemmer

  • slides: https://slides.com/fdemmer

Made with Slides.com