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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
|
# -*- coding: iso-8859-1 -*-
"""
Creole wiki markup parser
See http://wikicreole.org/ for latest specs.
Notes:
* No markup allowed in headings.
Creole 1.0 does not require us to support this.
* No markup allowed in table headings.
Creole 1.0 does not require us to support this.
* No (non-bracketed) generic url recognition: this is "mission impossible"
except if you want to risk lots of false positives. Only known protocols
are recognized.
* We do not allow ":" before "//" italic markup to avoid urls with
unrecognized schemes (like wtf://server/path) triggering italic rendering
for the rest of the paragraph.
@copyright: 2007 MoinMoin:RadomirDopieralski (creole 0.5 implementation),
2007 MoinMoin:ThomasWaldmann (updates)
@license: GNU GPL, see COPYING for details.
@license: BSD, see COPYING for details.
"""
import re
import sys
__version__ = '1.1'
class Rules:
"""Hold all the rules for generating regular expressions."""
# For the inline elements:
proto = r'http|https|ftp|nntp|news|mailto|telnet|file|irc'
link = r'''(?P<link>
\[\[
(?P<link_target>.+?) \s*
([|] \s* (?P<link_text>.+?) \s*)?
]]
)'''
image = r'''(?P<image>
{{
(?P<image_target>.+?) \s*
([|] \s* (?P<image_text>.+?) \s*)?
}}
)'''
macro = r'''(?P<macro>
<<
(?P<macro_name> \w+)
(\( (?P<macro_args> .*?) \))? \s*
([|] \s* (?P<macro_text> .+?) \s* )?
>>
)'''
code = r'(?P<code> {{{ (?P<code_text>.*?) }}} )'
emph = r'(?P<emph> (?<!:)// )' # there must be no : in front of the //
# avoids italic rendering in urls with
# unknown protocols
strong = r'(?P<strong> \*\* )'
linebreak = r'(?P<break> \\\\ )'
escape = r'(?P<escape> ~ (?P<escaped_char>\S) )'
char = r'(?P<char> . )'
# For the block elements:
separator = r'(?P<separator> ^ \s* ---- \s* $ )' # horizontal line
line = r'(?P<line> ^ \s* $ )' # empty line that separates paragraphs
head = r'''(?P<head>
^ \s*
(?P<head_head>=+) \s*
(?P<head_text> .*? ) \s*
(?P<head_tail>=*) \s*
$
)'''
text = r'(?P<text> .+ )'
list = r'''(?P<list>
^ [ \t]* ([*][^*\#]|[\#][^\#*]).* $
( \n[ \t]* [*\#]+.* $ )*
)''' # Matches the whole list, separate items are parsed later. The
# list *must* start with a single bullet.
item = r'''(?P<item>
^ \s*
(?P<item_head> [\#*]+) \s*
(?P<item_text> .*?)
$
)''' # Matches single list items
pre = r'''(?P<pre>
^{{{ \s* $
(\n)?
(?P<pre_text>
([\#]!(?P<pre_kind>\w*?)(\s+.*)?$)?
(.|\n)+?
)
(\n)?
^}}} \s*$
)'''
pre_escape = r' ^(?P<indent>\s*) ~ (?P<rest> \}\}\} \s*) $'
table = r'''(?P<table>
^ \s*
[|].*? \s*
[|]? \s*
$
)'''
# For splitting table cells:
cell = r'''
\| \s*
(
(?P<head> [=][^|]+ ) |
(?P<cell> ( %s | [^|])+ )
) \s*
''' % '|'.join([link, macro, image, code])
def __init__(self, bloglike_lines=False, url_protocols=None,
wiki_words=False):
c = re.compile
# For pre escaping, in creole 1.0 done with ~:
self.pre_escape_re = c(self.pre_escape, re.M | re.X)
# for link descriptions
self.link_re = c('|'.join([self.image, self.linebreak,
self.char]), re.X | re.U)
# for list items
self.item_re = c(self.item, re.X | re.U | re.M)
# for table cells
self.cell_re = c(self.cell, re.X | re.U)
# For block elements:
if bloglike_lines:
self.text = r'(?P<text> .+ ) (?P<break> (?<!\\)$\n(?!\s*$) )?'
self.block_re = c('|'.join([self.line, self.head, self.separator,
self.pre, self.list, self.table,
self.text]), re.X | re.U | re.M)
# For inline elements:
if url_protocols is not None:
self.proto = '|'.join(re.escape(p) for p in url_protocols)
self.url = r'''(?P<url>
(^ | (?<=\s | [.,:;!?()/=]))
(?P<escaped_url>~)?
(?P<url_target> (?P<url_proto> %s ):\S+? )
($ | (?=\s | [,.:;!?()] (\s | $))))''' % self.proto
inline_elements = [self.link, self.url, self.macro,
self.code, self.image, self.strong,
self.emph, self.linebreak,
self.escape, self.char]
if wiki_words:
import unicodedata
up_case = u''.join(unichr(i) for i in xrange(sys.maxunicode)
if unicodedata.category(unichr(i))=='Lu')
self.wiki = ur'''(?P<wiki>[%s]\w+[%s]\w+)''' % (up_case, up_case)
inline_elements.insert(3, self.wiki)
self.inline_re = c('|'.join(inline_elements), re.X | re.U)
class Parser:
"""
Parse the raw text and create a document object
that can be converted into output using Emitter.
A separate instance should be created for parsing a new document.
The first parameter is the raw text to be parsed. An optional second
argument is the Rules object to use. You can customize the parsing
rules to enable optional features or extend the parser.
"""
def __init__(self, raw, rules=None):
self.rules = rules or Rules()
self.raw = raw
self.root = DocNode('document', None)
self.cur = self.root # The most recent document node
self.text = None # The node to add inline characters to
def _upto(self, node, kinds):
"""
Look up the tree to the first occurence
of one of the listed kinds of nodes or root.
Start at the node node.
"""
while node.parent is not None and not node.kind in kinds:
node = node.parent
return node
# The _*_repl methods called for matches in regexps. Sometimes the
# same method needs several names, because of group names in regexps.
def _url_repl(self, groups):
"""Handle raw urls in text."""
if not groups.get('escaped_url'):
# this url is NOT escaped
target = groups.get('url_target', '')
node = DocNode('link', self.cur)
node.content = target
DocNode('text', node, node.content)
self.text = None
else:
# this url is escaped, we render it as text
if self.text is None:
self.text = DocNode('text', self.cur, u'')
self.text.content += groups.get('url_target')
_url_target_repl = _url_repl
_url_proto_repl = _url_repl
_escaped_url = _url_repl
def _link_repl(self, groups):
"""Handle all kinds of links."""
target = groups.get('link_target', '')
text = (groups.get('link_text', '') or '').strip()
parent = self.cur
self.cur = DocNode('link', self.cur)
self.cur.content = target
self.text = None
re.sub(self.rules.link_re, self._replace, text)
self.cur = parent
self.text = None
_link_target_repl = _link_repl
_link_text_repl = _link_repl
def _wiki_repl(self, groups):
"""Handle WikiWord links, if enabled."""
text = groups.get('wiki', '')
node = DocNode('link', self.cur)
node.content = text
DocNode('text', node, node.content)
self.text = None
def _macro_repl(self, groups):
"""Handles macros using the placeholder syntax."""
name = groups.get('macro_name', '')
text = (groups.get('macro_text', '') or '').strip()
node = DocNode('macro', self.cur, name)
node.args = groups.get('macro_args', '') or ''
DocNode('text', node, text or name)
self.text = None
_macro_name_repl = _macro_repl
_macro_args_repl = _macro_repl
_macro_text_repl = _macro_repl
def _image_repl(self, groups):
"""Handles images and attachemnts included in the page."""
target = groups.get('image_target', '').strip()
text = (groups.get('image_text', '') or '').strip()
node = DocNode("image", self.cur, target)
DocNode('text', node, text or node.content)
self.text = None
_image_target_repl = _image_repl
_image_text_repl = _image_repl
def _separator_repl(self, groups):
self.cur = self._upto(self.cur, ('document', 'section', 'blockquote'))
DocNode('separator', self.cur)
def _item_repl(self, groups):
bullet = groups.get('item_head', u'')
text = groups.get('item_text', u'')
if bullet[-1] == '#':
kind = 'number_list'
else:
kind = 'bullet_list'
level = len(bullet)
lst = self.cur
# Find a list of the same kind and level up the tree
while (lst and
not (lst.kind in ('number_list', 'bullet_list') and
lst.level == level) and
not lst.kind in ('document', 'section', 'blockquote')):
lst = lst.parent
if lst and lst.kind == kind:
self.cur = lst
else:
# Create a new level of list
self.cur = self._upto(self.cur,
('list_item', 'document', 'section', 'blockquote'))
self.cur = DocNode(kind, self.cur)
self.cur.level = level
self.cur = DocNode('list_item', self.cur)
self.parse_inline(text)
self.text = None
_item_text_repl = _item_repl
_item_head_repl = _item_repl
def _list_repl(self, groups):
text = groups.get('list', u'')
self.rules.item_re.sub(self._replace, text)
def _head_repl(self, groups):
self.cur = self._upto(self.cur, ('document', 'section', 'blockquote'))
node = DocNode('header', self.cur, groups.get('head_text', '').strip())
node.level = len(groups.get('head_head', ' '))
_head_head_repl = _head_repl
_head_text_repl = _head_repl
def _text_repl(self, groups):
text = groups.get('text', '')
if self.cur.kind in ('table', 'table_row', 'bullet_list',
'number_list'):
self.cur = self._upto(self.cur,
('document', 'section', 'blockquote'))
if self.cur.kind in ('document', 'section', 'blockquote'):
self.cur = DocNode('paragraph', self.cur)
else:
text = u' ' + text
self.parse_inline(text)
if groups.get('break') and self.cur.kind in ('paragraph',
'emphasis', 'strong', 'code'):
DocNode('break', self.cur, '')
self.text = None
_break_repl = _text_repl
def _table_repl(self, groups):
row = groups.get('table', '|').strip()
self.cur = self._upto(self.cur, (
'table', 'document', 'section', 'blockquote'))
if self.cur.kind != 'table':
self.cur = DocNode('table', self.cur)
tb = self.cur
tr = DocNode('table_row', tb)
text = ''
for m in self.rules.cell_re.finditer(row):
cell = m.group('cell')
if cell:
self.cur = DocNode('table_cell', tr)
self.text = None
self.parse_inline(cell)
else:
cell = m.group('head')
self.cur = DocNode('table_head', tr)
self.text = DocNode('text', self.cur, u'')
self.text.content = cell.strip('=')
self.cur = tb
self.text = None
def _pre_repl(self, groups):
self.cur = self._upto(self.cur, ('document', 'section', 'blockquote'))
kind = groups.get('pre_kind', None)
text = groups.get('pre_text', u'')
def remove_tilde(m):
return m.group('indent') + m.group('rest')
text = self.rules.pre_escape_re.sub(remove_tilde, text)
node = DocNode('preformatted', self.cur, text)
node.sect = kind or ''
self.text = None
_pre_text_repl = _pre_repl
_pre_head_repl = _pre_repl
_pre_kind_repl = _pre_repl
def _line_repl(self, groups):
self.cur = self._upto(self.cur, ('document', 'section', 'blockquote'))
def _code_repl(self, groups):
DocNode('code', self.cur, groups.get('code_text', u'').strip())
self.text = None
_code_text_repl = _code_repl
_code_head_repl = _code_repl
def _emph_repl(self, groups):
if self.cur.kind != 'emphasis':
self.cur = DocNode('emphasis', self.cur)
else:
self.cur = self._upto(self.cur, ('emphasis', )).parent
self.text = None
def _strong_repl(self, groups):
if self.cur.kind != 'strong':
self.cur = DocNode('strong', self.cur)
else:
self.cur = self._upto(self.cur, ('strong', )).parent
self.text = None
def _break_repl(self, groups):
DocNode('break', self.cur, None)
self.text = None
def _escape_repl(self, groups):
if self.text is None:
self.text = DocNode('text', self.cur, u'')
self.text.content += groups.get('escaped_char', u'')
def _char_repl(self, groups):
if self.text is None:
self.text = DocNode('text', self.cur, u'')
self.text.content += groups.get('char', u'')
def _replace(self, match):
"""Invoke appropriate _*_repl method. Called for every matched group."""
groups = match.groupdict()
for name, text in groups.iteritems():
if text is not None:
replace = getattr(self, '_%s_repl' % name)
replace(groups)
return
def parse_inline(self, raw):
"""Recognize inline elements inside blocks."""
re.sub(self.rules.inline_re, self._replace, raw)
def parse_block(self, raw):
"""Recognize block elements."""
re.sub(self.rules.block_re, self._replace, raw)
def parse(self):
"""Parse the text given as self.raw and return DOM tree."""
self.parse_block(self.raw)
return self.root
#################### Helper classes
### The document model
class DocNode:
"""
A node in the document.
"""
def __init__(self, kind='', parent=None, content=None):
self.children = []
self.parent = parent
self.kind = kind
self.content = content
if self.parent is not None:
self.parent.children.append(self)
|