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
|
#!/usr/bin/python
# Copyright 2009 Canonical Ltd.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
import os
import sys
from optparse import OptionParser
def split_into_topics(lines, out_file, out_dir):
"""Split a large NEWS file into topics, one per release.
Releases are detected by matching headings that look like
release names. Topics are created with matching names
replacing spaces with dashes.
"""
topic_file = None
for index, line in enumerate(lines):
maybe_new_topic = line[:4] in ('bzr ', 'bzr-',)
if maybe_new_topic and lines[index + 1].startswith('####'):
release = line.strip()
if topic_file is None:
# First topic found
out_file.write(".. toctree::\n :maxdepth: 1\n\n")
else:
# close the current topic
topic_file.close()
topic_file = open_topic_file(out_file, out_dir, release)
elif topic_file:
topic_file.write(line)
else:
# FIXME: the 'content' directive is used for rst2html (and
# conflicts with the 'toctree' we insert), we should get rid of
# that once we fully switch to sphinx -- vila 20100505
if (line.startswith('.. contents::')
or line.startswith(' :depth:')):
continue
# Still in the header - dump content straight to output
out_file.write(line)
if topic_file is not None:
# Close the last topic_file opened
topic_file.close()
def open_topic_file(out_file, out_dir, release):
topic_name = release.replace(' ', '-')
out_file.write(" %s <%s>\n" % (release, topic_name,))
topic_path = os.path.join(out_dir, "%s.txt" % (topic_name,))
result = open(topic_path, 'w')
result.write("%s\n" % (release,))
return result
def main(argv):
# Check usage
parser = OptionParser(usage="%prog SOURCE DESTINATION")
(options, args) = parser.parse_args(argv)
if len(args) != 2:
parser.print_help()
sys.exit(1)
# Open the files and do the work
infile_name = args[0]
outfile_name = args[1]
outdir = os.path.dirname(outfile_name)
infile = open(infile_name, 'r')
try:
lines = infile.readlines()
finally:
infile.close()
outfile = open(outfile_name, 'w')
try:
split_into_topics(lines, outfile, outdir)
finally:
outfile.close()
if __name__ == '__main__':
main(sys.argv[1:])
|