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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
import re
def serialize(nodes):
"""Serialize nodes to CSS syntax.
This should be used for :term:`component values`
instead of just :meth:`tinycss2.ast.Node.serialize` on each node
as it takes care of corner cases such as ``;`` between declarations,
and consecutive identifiers
that would otherwise parse back as the same token.
:type nodes: :term:`iterable`
:param nodes: An iterable of :class:`tinycss2.ast.Node` objects.
:returns: A :obj:`string <str>` representing the nodes.
"""
chunks = []
_serialize_to(nodes, chunks.append)
return ''.join(chunks)
def serialize_identifier(value):
"""Serialize any string as a CSS identifier
:type value: :obj:`str`
:param value: A string representing a CSS value.
:returns:
A :obj:`string <str>` that would parse as an
:class:`tinycss2.ast.IdentToken` whose
:attr:`tinycss2.ast.IdentToken.value` attribute equals the passed
``value`` argument.
"""
if value == '-':
return r'\-'
if value[:2] == '--':
return '--' + serialize_name(value[2:])
if value[0] == '-':
result = '-'
value = value[1:]
else:
result = ''
c = value[0]
result += (
c if c in ('abcdefghijklmnopqrstuvwxyz_'
'ABCDEFGHIJKLMNOPQRSTUVWXYZ') or ord(c) > 0x7F else
r'\A ' if c == '\n' else
r'\D ' if c == '\r' else
r'\C ' if c == '\f' else
'\\%X ' % ord(c) if c in '0123456789' else
'\\' + c
)
result += serialize_name(value[1:])
return result
def serialize_name(value):
return ''.join(
c if c in ('abcdefghijklmnopqrstuvwxyz-_0123456789'
'ABCDEFGHIJKLMNOPQRSTUVWXYZ') or ord(c) > 0x7F else
r'\A ' if c == '\n' else
r'\D ' if c == '\r' else
r'\C ' if c == '\f' else
'\\' + c
for c in value
)
_replacement_string_value = {
'"': r'\"',
'\\': r'\\',
'\n': r'\A ',
'\r': r'\D ',
'\f': r'\C ',
}
_re_string_value = ''.join(re.escape(char) for char in _replacement_string_value)
_re_string_value = re.compile(f'[{_re_string_value}]', re.MULTILINE)
def _serialize_string_value_match(match):
return _replacement_string_value[match.group(0)]
def serialize_string_value(value):
return _re_string_value.sub(_serialize_string_value_match, value)
def serialize_url(value):
return ''.join(
r"\'" if c == "'" else
r'\"' if c == '"' else
r'\\' if c == '\\' else
r'\ ' if c == ' ' else
r'\9 ' if c == '\t' else
r'\A ' if c == '\n' else
r'\D ' if c == '\r' else
r'\C ' if c == '\f' else
r'\(' if c == '(' else
r'\)' if c == ')' else
c
for c in value
)
# https://drafts.csswg.org/css-syntax/#serialization-tables
def _serialize_to(nodes, write):
"""Serialize an iterable of nodes to CSS syntax.
White chunks as a string by calling the provided :obj:`write` callback.
"""
bad_pairs = BAD_PAIRS
previous_type = None
for node in nodes:
serialization_type = (node.type if node.type != 'literal'
else node.value)
if (previous_type, serialization_type) in bad_pairs:
write('/**/')
elif previous_type == '\\' and not (
serialization_type == 'whitespace' and
node.value.startswith('\n')):
write('\n')
node._serialize_to(write)
if serialization_type == 'declaration':
write(';')
previous_type = serialization_type
BAD_PAIRS = set(
[(a, b)
for a in ('ident', 'at-keyword', 'hash', 'dimension', '#', '-', 'number')
for b in ('ident', 'function', 'url', 'number', 'percentage',
'dimension', 'unicode-range')] +
[(a, b)
for a in ('ident', 'at-keyword', 'hash', 'dimension')
for b in ('-', '-->')] +
[(a, b)
for a in ('#', '-', 'number', '@')
for b in ('ident', 'function', 'url')] +
[(a, b)
for a in ('unicode-range', '.', '+')
for b in ('number', 'percentage', 'dimension')] +
[('@', b) for b in ('ident', 'function', 'url', 'unicode-range', '-')] +
[('unicode-range', b) for b in ('ident', 'function', '?')] +
[(a, '=') for a in '$*^~|'] +
[('ident', '() block'), ('|', '|'), ('/', '*')]
)
|
