Debian Codegraph @

django/urls/converters.py

raw
1 import functools
2 import uuid
3 import warnings
4
5 from django.utils.deprecation import RemovedInDjango60Warning
6
7
8 class IntConverter:
9 regex = "[0-9]+"
10
11 def to_python(self, value):
12 return int(value)
13
14 def to_url(self, value):
15 return str(value)
16
17
18 class StringConverter:
19 regex = "[^/]+"
20
21 def to_python(self, value):
22 return value
23
24 def to_url(self, value):
25 return value
26
27
28 class UUIDConverter:
29 regex = "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
30
31 def to_python(self, value):
32 return uuid.UUID(value)
33
34 def to_url(self, value):
35 return str(value)
36
37
38 class SlugConverter(StringConverter):
39 regex = "[-a-zA-Z0-9_]+"
40
41
42 class PathConverter(StringConverter):
43 regex = ".+"
44
45
46 DEFAULT_CONVERTERS = {
47 "int": IntConverter(),
48 "path": PathConverter(),
49 "slug": SlugConverter(),
50 "str": StringConverter(),
51 "uuid": UUIDConverter(),
52 }
53
54
55 REGISTERED_CONVERTERS = {}
56
57
58 def register_converter(converter, type_name):
59 if type_name in REGISTERED_CONVERTERS or type_name in DEFAULT_CONVERTERS:
60 # RemovedInDjango60Warning: when the deprecation ends, replace with
61 # raise ValueError(f"Converter {type_name} is already registered.")
62 warnings.warn(
63 f"Converter {type_name!r} is already registered. Support for overriding "
64 "registered converters is deprecated and will be removed in Django 6.0.",
65 RemovedInDjango60Warning,
66 stacklevel=2,
67 )
68 REGISTERED_CONVERTERS[type_name] = converter()
69 get_converters.cache_clear()
70
71 from django.urls.resolvers import _route_to_regex
72
73 _route_to_regex.cache_clear()
74
75
76 @functools.cache
77 def get_converters():
78 return {**DEFAULT_CONVERTERS, **REGISTERED_CONVERTERS}