1
# Copyright (C) 2005-2010 Canonical Ltd
1
# Copyright (C) 2005-2011 Canonical Ltd
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18
17
"""Commit message editor support."""
19
from __future__ import absolute_import
22
23
from subprocess import call
25
26
from bzrlib import (
59
61
def _run_editor(filename):
60
62
"""Try to execute an editor to edit the commit message."""
61
63
for candidate, candidate_source in _get_editor():
62
edargs = candidate.split(' ')
64
edargs = cmdline.split(candidate)
64
66
## mutter("trying editor: %r", (edargs +[filename]))
65
67
x = call(edargs + [filename])
143
145
if not msgfilename:
145
147
basename = osutils.basename(msgfilename)
146
msg_transport = transport.get_transport(osutils.dirname(msgfilename))
148
msg_transport = transport.get_transport_from_path(osutils.dirname(msgfilename))
147
149
reference_content = msg_transport.get_bytes(basename)
148
150
if not _run_editor(msgfilename):
150
152
edited_content = msg_transport.get_bytes(basename)
151
153
if edited_content == reference_content:
152
if not ui.ui_factory.get_boolean(
153
"Commit message was not edited, use anyway"):
154
if not ui.ui_factory.confirm_action(
155
u"Commit message was not edited, use anyway",
156
"bzrlib.msgeditor.unchanged",
154
158
# Returning "" makes cmd_commit raise 'empty commit message
155
159
# specified' which is a reasonable error, given the user has
156
160
# rejected using the unedited template.
207
211
def _create_temp_file_with_commit_template(infotext,
208
212
ignoreline=DEFAULT_IGNORE_LINE,
210
215
"""Create temp file and write commit template in it.
212
:param infotext: Text to be displayed at bottom of message
213
for the user's reference;
214
currently similar to 'bzr status'.
215
The text is already encoded.
217
:param infotext: Text to be displayed at bottom of message for the
218
user's reference; currently similar to 'bzr status'. The text is
217
221
:param ignoreline: The separator to use above the infotext.
219
:param start_message: The text to place above the separator, if any.
220
This will not be removed from the message
221
after the user has edited it.
222
The string is already encoded
223
:param start_message: The text to place above the separator, if any.
224
This will not be removed from the message after the user has edited
225
it. The string is already encoded
224
227
:return: 2-tuple (temp file name, hasinfo)
227
230
tmp_fileno, msgfilename = tempfile.mkstemp(prefix='bzr_log.',
230
msgfilename = osutils.basename(msgfilename)
231
dir=tmpdir, text=True)
231
232
msgfile = os.fdopen(tmp_fileno, 'w')
233
234
if start_message is not None:
303
304
These are all empty initially.
306
self.create_hook(HookPoint('commit_message_template',
306
Hooks.__init__(self, "bzrlib.msgeditor", "hooks")
307
self.add_hook('set_commit_message',
308
"Set a fixed commit message. "
309
"set_commit_message is called with the "
310
"bzrlib.commit.Commit object (so you can also change e.g. revision "
311
"properties by editing commit.builder._revprops) and the message "
312
"so far. set_commit_message must return the message to use or None"
313
" if it should use the message editor as normal.", (2, 4))
314
self.add_hook('commit_message_template',
307
315
"Called when a commit message is being generated. "
308
316
"commit_message_template is called with the bzrlib.commit.Commit "
309
317
"object and the message that is known so far. "
310
318
"commit_message_template must return a new message to use (which "
311
"could be the same as it was given. When there are multiple "
319
"could be the same as it was given). When there are multiple "
312
320
"hooks registered for commit_message_template, they are chained "
313
321
"with the result from the first passed into the second, and so "
314
"on.", (1, 10), None))
317
325
hooks = MessageEditorHooks()
328
def set_commit_message(commit, start_message=None):
329
"""Sets the commit message.
330
:param commit: Commit object for the active commit.
331
:return: The commit message or None to continue using the message editor
334
for hook in hooks['set_commit_message']:
335
start_message = hook(commit, start_message)
320
339
def generate_commit_message_template(commit, start_message=None):
321
340
"""Generate a commit message template.