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
|
#! /usr/bin/env python
"""
This script will extract the documentation from the full_configbase.py
module, reformat it somewhat, and write it as a reST document in
$PYFIFF/doc/source.
"""
import os
import re
from fiff import __file__ as fifffile
fiffpath = os.path.join(os.path.split(fifffile)[0], os.pardir)
confid = open(os.path.join(
fiffpath, "data", "configfiles", "full_configbase.py"), "r")
docfid = open(os.path.join(
fiffpath, "doc", "source", "config_doc.rst"), "w")
docfid.write(".. _config_doc:\n\n")
write = False
space = False
def flip(value):
if value:
return False
else:
return True
sectionhead = re.compile("(<)([\w\s]+)(>)")
def get_head(line):
m = sectionhead.search(line)
if m:
head = m.groups()[1]
else:
return ""
length = len(head)
head = "\n\n%s\n" % head
for i in range(length):
head = "%s-" % head
head = "%s\n\n" % head
return head
for num, line in enumerate(confid):
if re.match("-+\n", line):
space = True
newline = ""
for i in range(len(line) - 1):
newline = "%s^" % newline
line = "%s\n" % newline
elif re.match("[ \t\n]+", line):
space = False
if line.startswith("#-"):
docfid.write(get_head(line))
else:
if line.startswith("\"\"\""):
write = flip(write)
lastflip = num
if space:
line = "%s\n" % line
if write and not num == lastflip:
docfid.write(line)
confid.close()
docfid.close()
|
