3
# Copyright 2009 Canonical Ltd.
 
 
5
# This program is free software; you can redistribute it and/or modify
 
 
6
# it under the terms of the GNU General Public License as published by
 
 
7
# the Free Software Foundation; either version 2 of the License, or
 
 
8
# (at your option) any later version.
 
 
10
# This program is distributed in the hope that it will be useful,
 
 
11
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
 
12
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
 
13
# GNU General Public License for more details.
 
 
15
# You should have received a copy of the GNU General Public License
 
 
16
# along with this program; if not, write to the Free Software
 
 
17
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
 
21
from optparse import OptionParser
 
 
23
sys.path.insert(0, os.path.dirname(os.path.dirname(__file__)))
 
 
26
def split_into_topics(lines, out_file, out_dir):
 
 
27
    """Split a large NEWS file into topics, one per release.
 
 
29
    Releases are detected by matching headings that look like
 
 
30
    release names. Topics are created with matching names
 
 
31
    replacing spaces with dashes.
 
 
34
    for index, line in enumerate(lines):
 
 
35
        maybe_new_topic = line[:4] in ['bzr ', 'bzr-0',]
 
 
36
        if maybe_new_topic and lines[index + 1].startswith('####'):
 
 
37
            release = line.strip()
 
 
38
            if topic_file is None:
 
 
40
                out_file.write(".. toctree::\n   :maxdepth: 1\n\n")
 
 
42
                # close the current topic
 
 
44
            topic_file = open_topic_file(out_file, out_dir, release)
 
 
46
            topic_file.write(line)
 
 
48
            # Still in the header - dump content straight to output
 
 
52
def open_topic_file(out_file, out_dir, release):
 
 
53
    topic_name = release.replace(' ', '-')
 
 
54
    out_file.write("   %s\n" % (topic_name,))
 
 
55
    topic_path = os.path.join(out_dir, "%s.txt" % (topic_name,))
 
 
56
    result = open(topic_path, 'w')
 
 
57
    result.write("%s\n" % (release,))
 
 
63
    parser = OptionParser(usage="%prog SOURCE DESTINATION")
 
 
64
    (options, args) = parser.parse_args(argv)
 
 
69
    # Open the files and do the work
 
 
71
    outfile_name = args[1]
 
 
72
    outdir = os.path.dirname(outfile_name)
 
 
73
    infile = open(infile_name, 'r')
 
 
75
        lines = infile.readlines()
 
 
78
    outfile = open(outfile_name, 'w')
 
 
80
        split_into_topics(lines, outfile, outdir)
 
 
85
if __name__ == '__main__':