chiark / gitweb /
40f1a48fff200a34a37fcf76e50f0403da459963
[stgit] / stgit / commands / export.py
1 """Export command
2 """
3
4 __copyright__ = """
5 Copyright (C) 2005, Catalin Marinas <catalin.marinas@gmail.com>
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License version 2 as
9 published by the Free Software Foundation.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 """
20
21 import sys, os
22 from optparse import OptionParser, make_option
23
24 from stgit.commands.common import *
25 from stgit.utils import *
26 from stgit import stack, git
27
28
29 help = 'exports a series of patches to <dir> (or patches)'
30 usage = """%prog [options] [<dir>]
31
32 Export the applied patches into a given directory (defaults to
33 'patches') in a standard unified GNU diff format. A file (defaulting
34 to '.git/patchexport.tmpl') can be used as a template for the patch
35 format. The following variables are supported in the template file:
36
37   %(description)s - patch description
38   %(diffstat)s    - the diff statistics
39   %(authname)s    - author's name
40   %(authemail)s   - author's e-mail
41   %(authdate)s    - patch creation date
42   %(commname)s    - committer's name
43   %(commemail)s   - committer's e-mail
44
45 'export' can also generate a diff for a range of patches."""
46
47 options = [make_option('-n', '--numbered',
48                        help = 'prefix the patch names with order numbers',
49                        action = 'store_true'),
50            make_option('-d', '--diff',
51                        help = 'append .diff to the patch names',
52                        action = 'store_true'),
53            make_option('-t', '--template', metavar = 'FILE',
54                        help = 'Use FILE as a template'),
55            make_option('-r', '--range',
56                        metavar = '[PATCH1][:[PATCH2]]',
57                        help = 'export patches between PATCH1 and PATCH2')]
58
59
60 def func(parser, options, args):
61     if len(args) == 0:
62         dirname = 'patches'
63     elif len(args) == 1:
64         dirname = args[0]
65     else:
66         parser.error('incorrect number of arguments')
67
68     if git.local_changes():
69         print 'Warning: local changes in the tree. ' \
70               'You might want to commit them first'
71
72     if not os.path.isdir(dirname):
73         os.makedirs(dirname)
74     series = file(os.path.join(dirname, 'series'), 'w+')
75
76     applied = crt_series.get_applied()
77
78     if options.range:
79         boundaries = options.range.split(':')
80         if len(boundaries) == 1:
81             start = boundaries[0]
82             stop = boundaries[0]
83         elif len(boundaries) == 2:
84             if boundaries[0] == '':
85                 start = applied[0]
86             else:
87                 start = boundaries[0]
88             if boundaries[1] == '':
89                 stop = applied[-1]
90             else:
91                 stop = boundaries[1]
92         else:
93             raise CmdException, 'incorrect parameters to "--range"'
94
95         if start in applied:
96             start_idx = applied.index(start)
97         else:
98             raise CmdException, 'Patch "%s" not applied' % start
99         if stop in applied:
100             stop_idx = applied.index(stop) + 1
101         else:
102             raise CmdException, 'Patch "%s" not applied' % stop
103
104         if start_idx >= stop_idx:
105             raise CmdException, 'Incorrect patch range order'
106     else:
107         start_idx = 0
108         stop_idx = len(applied)
109
110     patches = applied[start_idx:stop_idx]
111
112     num = len(patches)
113     zpadding = len(str(num))
114     if zpadding < 2:
115         zpadding = 2
116
117     patch_no = 1;
118     for p in patches:
119         pname = p
120         if options.diff:
121             pname = '%s.diff' % pname
122         if options.numbered:
123             pname = '%s-%s' % (str(patch_no).zfill(zpadding), pname)
124         pfile = os.path.join(dirname, pname)
125         print >> series, pname
126
127         # get the template
128         if options.template:
129             patch_tmpl = options.template
130         else:
131             patch_tmpl = os.path.join(git.base_dir, 'patchexport.tmpl')
132         if os.path.isfile(patch_tmpl):
133             tmpl = file(patch_tmpl).read()
134         else:
135             tmpl = ''
136
137         # get the patch description
138         patch = crt_series.get_patch(p)
139
140         tmpl_dict = {'description': patch.get_description().rstrip(),
141                      'diffstat': git.diffstat(rev1 = git_id('%s/bottom' % p),
142                                               rev2 = git_id('%s/top' % p)),
143                      'authname': patch.get_authname(),
144                      'authemail': patch.get_authemail(),
145                      'authdate': patch.get_authdate(),
146                      'commname': patch.get_commname(),
147                      'commemail': patch.get_commemail()}
148         for key in tmpl_dict:
149             if not tmpl_dict[key]:
150                 tmpl_dict[key] = ''
151
152         try:
153             descr = tmpl % tmpl_dict
154         except KeyError, err:
155             raise CmdException, 'Unknown patch template variable: %s' \
156                   % err
157         except TypeError:
158             raise CmdException, 'Only "%(name)s" variables are ' \
159                   'supported in the patch template'
160         f = open(pfile, 'w+')
161         f.write(descr)
162
163         # write the diff
164         git.diff(rev1 = git_id('%s/bottom' % p),
165                  rev2 = git_id('%s/top' % p),
166                  out_fd = f)
167         f.close()
168         patch_no += 1
169
170     series.close()