1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
"""
useful context functions, see
http://jinja.pocoo.org/docs/dev/api/#jinja2.contextfunction
"""
import warnings
from typing import Dict, Optional, TypedDict, Union
import jinja2
from aiohttp import web
from yarl import URL
class _Context(TypedDict, total=False):
app: web.Application
static_root_key = web.AppKey("static_root_key", str)
@jinja2.pass_context
def url_for(
context: _Context,
__route_name: str,
query_: Optional[Dict[str, str]] = None,
**parts: Union[str, int]
) -> URL:
"""Filter for generating urls.
Usage: {{ url('the-view-name') }} might become "/path/to/view" or
{{ url('item-details', id=123, query_={'active': 'true'}) }}
might become "/items/1?active=true".
"""
app = context["app"]
parts_clean: Dict[str, str] = {}
for key in parts:
val = parts[key]
if isinstance(val, str):
# if type is inherited from str expilict cast to str makes sense
# if type is exactly str the operation is very fast
val = str(val)
elif type(val) is int:
# int inherited classes like bool are forbidden
val = str(val)
else:
raise TypeError(
"argument value should be str or int, "
"got {} -> [{}] {!r}".format(key, type(val), val)
)
parts_clean[key] = val
url = app.router[__route_name].url_for(**parts_clean)
if query_:
url = url.with_query(query_)
return url
@jinja2.pass_context
def static_url(context: _Context, static_file_path: str) -> str:
"""Filter for generating urls for static files.
NOTE: you'll need to set app[aiohttp_jinja2.static_root_key] to be used as the
root for the urls returned.
Usage: {{ static('styles.css') }} might become
"/static/styles.css" or "http://mycdn.example.com/styles.css"
"""
app = context["app"]
try:
static_url = app[static_root_key]
except KeyError:
try:
# TODO (aiohttp 3.10+): Remove this fallback
static_url = app["static_root_url"]
except KeyError:
raise RuntimeError(
"app does not define a static root url, you need to set the url root "
"with app[aiohttp_jinja2.static_root_key] = '<static root>'."
) from None
else:
warnings.warn(
"'static_root_url' is deprecated, use aiohttp_jinja2.static_root_key.",
category=DeprecationWarning,
stacklevel=2,
)
return "{}/{}".format(static_url.rstrip("/"), static_file_path.lstrip("/"))
GLOBAL_HELPERS = dict(
url=url_for,
static=static_url,
)
|
