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
|
#!/usr/bin/env python
# emacs: -*- mode: python; py-indent-offset: 4; indent-tabs-mode: nil -*-
# vi: set ft=python sts=4 ts=4 sw=4 et:
''' Script to do very basic conversion of TRAC to reST format '''
import sys
import re
rst_section_levels = ['*', '=', '-', '~', '^']
heading_re = re.compile('^(=+) +([^=]+) +(=+)')
enumerate_re = re.compile(r'^ +(\d+\)) +(.*)')
link_re = re.compile(r'\[+ *(http://[\w.\-~/]+) +(.+?) *\]+')
italic_re = re.compile(r"'''(.+?)'''")
bold_re = re.compile(r"''(.+?)''")
inpre_re = re.compile(r"{{{(.+?)}}}")
outprestart_re = re.compile(r"^ *{{{ *$")
outprestop_re = re.compile(r"^ *}}} *$")
define_re = re.compile("^([^ ])(.*?)::")
class state_object(object):
def __init__(self, lines, indent=''):
self.lines = lines
self.indent = indent
def add_line(self, line):
self.lines.append(self.indent+line)
def __call__(self, line):
raise NotImplementedError
def __iter__(self):
for line in self.lines:
yield line
class preformatted_state(state_object):
''' State function for within preformatted blocks '''
def __call__(self, line):
if outprestop_re.match(line):
self.add_line('')
return standard_state(self.lines)
self.add_line(' ' + line)
return self
def std_subs(line):
''' standard in-line substitutions '''
line = link_re.sub(r'`\2 <\1>`_', line)
line = italic_re.sub(r'*\1*', line)
line = bold_re.sub(r'**\1**', line)
line = inpre_re.sub(r'``\1``', line)
return line
class standard_state(state_object):
def __call__(self, line):
''' State function for within normal text '''
# beginning preformat block?
if outprestart_re.match(line):
self.add_line('::')
self.add_line('')
return preformatted_state(self.lines)
# Heading
hmatch = heading_re.match(line)
if hmatch:
eq1, heading, eq2 = hmatch.groups()
if len(eq1) == len(eq2):
self.add_line(heading)
self.add_line(rst_section_levels[len(eq1)] * len(heading))
return self
if line.startswith(' *'):
line = line[1:]
line = enumerate_re.sub(r'#. \2', line)
line = define_re.sub(r'\1\2', line)
line = std_subs(line)
self.add_line(line)
return self
def trac2rst(linesource):
''' Process trac line source
A simple finite state machine
>>> lines = ['Hello', '= Heading1 =', '=Heading2=', '== Heading 3 ==']
>>> trac2rst(lines)
['Hello', 'Heading1', '========', '=Heading2=', 'Heading 3', '---------']
>>> trac2rst([' * bullet point'])
['* bullet point']
>>> trac2rst([' 33 not numbered'])
[' 33 not numbered']
>>> trac2rst([' 33) numbered'])
['#. numbered']
>>> trac2rst(['some text then [http://www.python.org/doc a link], then text'])
['some text then `a link <http://www.python.org/doc>`_, then text']
>>> line = 'text [http://www.python.org python] ' + \
'text [http://www.scipy.org scipy] '
>>> trac2rst([line])
['text `python <http://www.python.org>`_ text `scipy <http://www.scipy.org>`_']
>>> # The next line conceals the triple quotes from the docstring parser
>>> trac2rst([r"Some %sitalic%s text, then %smore%s" % (("'"*3,) * 4)])
['Some *italic* text, then *more*']
>>> trac2rst([r"Some ''bold'' text, then ''more''"])
['Some **bold** text, then **more**']
>>> # inline preformatted text
>>> trac2rst(['here is some {{{preformatted text}}} (end)'])
['here is some ``preformatted text`` (end)']
>>> # multiline preformatted
>>> trac2rst(['','{{{','= preformatted =', ' * text', '}}}'])
['', '::', '', ' = preformatted =', ' * text', '']
>>> # define
>>> trac2rst(['a definition::', ' some explanation'])
['a definition', ' some explanation']
'''
processor = standard_state([])
for line in linesource:
line = line.rstrip()
processor = processor(line)
return processor.lines
if __name__ == '__main__':
try:
infile = sys.argv[1]
except IndexError:
raise OSError('Need input file')
lines = trac2rst(file(infile))
print '\n'.join(lines)
|
