1 ;;; vc-bzr.el --- VC backend for the bzr revision control system
3 ;; Copyright (C) 2006, 2007, 2008 Free Software Foundation, Inc.
5 ;; Author: Dave Love <fx@gnu.org>, Riccardo Murri <riccardo.murri@gmail.com>
8 ;; Version: 2008-01-04 (Bzr revno 25)
9 ;; URL: http://launchpad.net/vc-bzr
11 ;; This file is free software; you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation; either version 3, or (at your option)
16 ;; This file is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the
23 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
24 ;; Boston, MA 02110-1301, USA.
29 ;; See <URL:http://bazaar-vcs.org/> concerning bzr. See
30 ;; <URL:http://launchpad.net/vc-bzr> for alternate development
31 ;; branches of `vc-bzr'.
33 ;; Load this library to register bzr support in VC.
38 ;; When edititing a symlink and *both* the symlink and its target
39 ;; are bzr-versioned, `vc-bzr` presently runs `bzr status` on the
40 ;; symlink, thereby not detecting whether the actual contents
41 ;; (that is, the target contents) are changed.
42 ;; See https://bugs.launchpad.net/vc-bzr/+bug/116607
44 ;; For an up-to-date list of bugs, please see:
45 ;; https://bugs.launchpad.net/vc-bzr/+bugs
52 (require 'vc
)) ; for vc-exec-after
54 ;; Clear up the cache to force vc-call to check again and discover
55 ;; new functions when we reload this file.
56 (put 'Bzr
'vc-functions nil
)
63 (defcustom vc-bzr-program
"bzr"
64 "Name of the bzr command (excluding any arguments)."
68 (defcustom vc-bzr-diff-switches nil
69 "String/list of strings specifying extra switches for bzr diff under VC."
70 :type
'(choice (const :tag
"None" nil
)
71 (string :tag
"Argument String")
72 (repeat :tag
"Argument List" :value
("") string
))
75 (defcustom vc-bzr-log-switches nil
76 "String/list of strings specifying extra switches for `bzr log' under VC."
77 :type
'(choice (const :tag
"None" nil
)
78 (string :tag
"Argument String")
79 (repeat :tag
"Argument List" :value
("") string
))
82 ;; since v0.9, bzr supports removing the progress indicators
83 ;; by setting environment variable BZR_PROGRESS_BAR to "none".
84 (defun vc-bzr-command (bzr-command buffer okstatus file-or-list
&rest args
)
85 "Wrapper round `vc-do-command' using `vc-bzr-program' as COMMAND.
86 Invoke the bzr command adding `BZR_PROGRESS_BAR=none' and
87 `LC_MESSAGES=C' to the environment."
88 (let ((process-environment
89 (list* "BZR_PROGRESS_BAR=none" ; Suppress progress output (bzr >=0.9)
90 "LC_MESSAGES=C" ; Force English output
91 process-environment
)))
92 (apply 'vc-do-command buffer okstatus vc-bzr-program
93 file-or-list bzr-command args
)))
97 (defconst vc-bzr-admin-dirname
".bzr"
98 "Name of the directory containing Bzr repository status files.")
100 (defconst vc-bzr-admin-checkout-format-file
101 (concat vc-bzr-admin-dirname
"/checkout/format"))
102 (defconst vc-bzr-admin-dirstate
103 (concat vc-bzr-admin-dirname
"/checkout/dirstate"))
104 (defconst vc-bzr-admin-branch-format-file
105 (concat vc-bzr-admin-dirname
"/branch/format"))
106 (defconst vc-bzr-admin-revhistory
107 (concat vc-bzr-admin-dirname
"/branch/revision-history"))
108 (defconst vc-bzr-admin-lastrev
109 (concat vc-bzr-admin-dirname
"/branch/last-revision"))
111 ;;;###autoload (defun vc-bzr-registered (file)
112 ;;;###autoload (if (vc-find-root file vc-bzr-admin-checkout-format-file)
113 ;;;###autoload (progn
114 ;;;###autoload (load "vc-bzr")
115 ;;;###autoload (vc-bzr-registered file))))
117 (defun vc-bzr-root (file)
118 "Return the root directory of the bzr repository containing FILE."
119 ;; Cache technique copied from vc-arch.el.
120 (or (vc-file-getprop file
'bzr-root
)
121 (let ((root (vc-find-root file vc-bzr-admin-checkout-format-file
)))
122 (when root
(vc-file-setprop file
'bzr-root root
)))))
124 (defun vc-bzr-registered (file)
125 "Return non-nil if FILE is registered with bzr.
127 For speed, this function tries first to parse Bzr internal file
128 `checkout/dirstate', but it may fail if Bzr internal file format
129 has changed. As a safeguard, the `checkout/dirstate' file is
130 only parsed if it contains the string `#bazaar dirstate flat
131 format 3' in the first line.
133 If the `checkout/dirstate' file cannot be parsed, fall back to
134 running `vc-bzr-state'."
135 (lexical-let ((root (vc-bzr-root file
)))
136 (when root
; Short cut.
137 ;; This looks at internal files. May break if they change
139 (lexical-let ((dirstate (expand-file-name vc-bzr-admin-dirstate root
)))
140 (if (not (file-readable-p dirstate
))
141 (vc-bzr-state file
) ; Expensive.
143 (insert-file-contents dirstate
)
144 (goto-char (point-min))
145 (if (not (looking-at "#bazaar dirstate flat format 3"))
146 (vc-bzr-state file
) ; Some other unknown format?
147 (let* ((relfile (file-relative-name file root
))
148 (reldir (file-name-directory relfile
)))
151 (if reldir
(regexp-quote (directory-file-name reldir
)))
153 (regexp-quote (file-name-nondirectory relfile
))
157 (defconst vc-bzr-state-words
158 "added\\|ignored\\|kind changed\\|modified\\|removed\\|renamed\\|unknown"
159 "Regexp matching file status words as reported in `bzr' output.")
161 (defun vc-bzr-file-name-relative (filename)
162 "Return file name FILENAME stripped of the initial Bzr repository path."
164 ((filename* (expand-file-name filename
))
165 (rootdir (vc-bzr-root filename
*)))
167 (file-relative-name filename
* rootdir
))))
169 (defun vc-bzr-status (file)
170 "Return FILE status according to Bzr.
171 Return value is a cons (STATUS . WARNING), where WARNING is a
172 string or nil, and STATUS is one of the symbols: `added',
173 `ignored', `kindchanged', `modified', `removed', `renamed', `unknown',
174 which directly correspond to `bzr status' output, or 'unchanged
175 for files whose copy in the working tree is identical to the one
176 in the branch repository, or nil for files that are not
179 If any error occurred in running `bzr status', then return nil."
181 (let ((ret (condition-case nil
182 (vc-bzr-command "status" t
0 file
)
183 (file-error nil
))) ; vc-bzr-program not found.
185 ;; the only secure status indication in `bzr status' output
186 ;; is a couple of lines following the pattern::
189 ;; if the file is up-to-date, we get no status report from `bzr',
190 ;; so if the regexp search for the above pattern fails, we consider
191 ;; the file to be up-to-date.
192 (goto-char (point-min))
193 (when (re-search-forward
194 ;; bzr prints paths relative to the repository root.
195 (concat "^\\(" vc-bzr-state-words
"\\):[ \t\n]+"
196 (regexp-quote (vc-bzr-file-name-relative file
))
197 ;; Bzr appends a '/' to directory names and
198 ;; '*' to executable files
199 (if (file-directory-p file
) "/?" "\\*?")
202 (lexical-let ((statusword (match-string 1)))
203 ;; Erase the status text that matched.
204 (delete-region (match-beginning 0) (match-end 0))
206 (intern (replace-regexp-in-string " " "" statusword
)))))
208 (goto-char (point-min))
209 (skip-chars-forward " \n\t") ;Throw away spaces.
211 ;; "bzr" will output warnings and informational messages to
212 ;; stderr; due to Emacs' `vc-do-command' (and, it seems,
213 ;; `start-process' itself) limitations, we cannot catch stderr
214 ;; and stdout into different buffers. So, if there's anything
215 ;; left in the buffer after removing the above status
216 ;; keywords, let us just presume that any other message from
217 ;; "bzr" is a user warning, and display it.
218 (unless (eobp) (buffer-substring (point) (point-max))))))))
220 (defun vc-bzr-state (file)
221 (lexical-let ((result (vc-bzr-status file
)))
224 (message "Warnings in `bzr' output: %s" (cdr result
)))
225 (cdr (assq (car result
)
227 (kindchanged . edited
)
233 (unchanged . up-to-date
)))))))
235 (defun vc-bzr-workfile-unchanged-p (file)
236 (eq 'unchanged
(car (vc-bzr-status file
))))
238 (defun vc-bzr-working-revision (file)
240 ((rootdir (vc-bzr-root file
))
241 (branch-format-file (expand-file-name vc-bzr-admin-branch-format-file
243 (revhistory-file (expand-file-name vc-bzr-admin-revhistory rootdir
))
244 (lastrev-file (expand-file-name vc-bzr-admin-lastrev rootdir
)))
245 ;; This looks at internal files to avoid forking a bzr process.
246 ;; May break if they change their format.
247 (if (file-exists-p branch-format-file
)
249 (insert-file-contents branch-format-file
)
250 (goto-char (point-min))
253 (looking-at "Bazaar-NG branch, format 0.0.4")
254 (looking-at "Bazaar-NG branch format 5"))
255 ;; count lines in .bzr/branch/revision-history
256 (insert-file-contents revhistory-file
)
257 (number-to-string (count-lines (line-end-position) (point-max))))
258 ((looking-at "Bazaar Branch Format 6 (bzr 0.15)")
259 ;; revno is the first number in .bzr/branch/last-revision
260 (insert-file-contents lastrev-file
)
261 (if (re-search-forward "[0-9]+" nil t
)
262 (buffer-substring (match-beginning 0) (match-end 0))))))
263 ;; fallback to calling "bzr revno"
265 ((result (vc-bzr-command-discarding-stderr
266 vc-bzr-program
"revno" file
))
267 (exitcode (car result
))
268 (output (cdr result
)))
270 ((eq exitcode
0) (substring output
0 -
1))
273 (defun vc-bzr-checkout-model (file)
276 (defun vc-bzr-create-repo ()
277 "Create a new Bzr repository."
278 (vc-bzr-command "init" nil
0 nil
))
280 (defun vc-bzr-init-revision (&optional file
)
281 "Always return nil, as Bzr cannot register explicit versions."
284 (defun vc-bzr-register (files &optional rev comment
)
285 "Register FILE under bzr.
286 Signal an error unless REV is nil.
288 (if rev
(error "Can't register explicit revision with bzr"))
289 (vc-bzr-command "add" nil
0 files
))
291 ;; Could run `bzr status' in the directory and see if it succeeds, but
292 ;; that's relatively expensive.
293 (defalias 'vc-bzr-responsible-p
'vc-bzr-root
294 "Return non-nil if FILE is (potentially) controlled by bzr.
295 The criterion is that there is a `.bzr' directory in the same
296 or a superior directory.")
298 (defun vc-bzr-could-register (file)
299 "Return non-nil if FILE could be registered under bzr."
300 (and (vc-bzr-responsible-p file
) ; shortcut
303 (vc-bzr-command "add" t
0 file
"--dry-run")
304 ;; The command succeeds with no output if file is
305 ;; registered (in bzr 0.8).
306 (goto-char (point-min))
307 (looking-at "added "))
310 (defun vc-bzr-unregister (file)
311 "Unregister FILE from bzr."
312 (vc-bzr-command "remove" nil
0 file
"--keep"))
314 (defun vc-bzr-checkin (files rev comment
)
315 "Check FILE in to bzr with log message COMMENT.
316 REV non-nil gets an error."
317 (if rev
(error "Can't check in a specific revision with bzr"))
318 (vc-bzr-command "commit" nil
0 files
"-m" comment
))
320 (defun vc-bzr-find-version (file rev buffer
)
321 "Fetch version REV of file FILE and put it into BUFFER."
322 (with-current-buffer buffer
323 (if (and rev
(stringp rev
) (not (string= rev
"")))
324 (vc-bzr-command "cat" t
0 file
"-r" rev
)
325 (vc-bzr-command "cat" t
0 file
))))
327 (defun vc-bzr-checkout (file &optional editable rev destfile
)
328 "Checkout revision REV of FILE from bzr to DESTFILE.
329 EDITABLE is ignored."
331 (setq destfile
(vc-version-backup-file-name file rev
)))
332 (let ((coding-system-for-read 'binary
)
333 (coding-system-for-write 'binary
))
334 (with-temp-file destfile
335 (if (and rev
(stringp rev
) (not (string= rev
"")))
336 (vc-bzr-command "cat" t
0 file
"-r" rev
)
337 (vc-bzr-command "cat" t
0 file
)))))
339 (defun vc-bzr-revert (file &optional contents-done
)
340 (unless contents-done
341 (with-temp-buffer (vc-bzr-command "revert" t
0 file
))))
343 (defvar log-view-message-re
)
344 (defvar log-view-file-re
)
345 (defvar log-view-font-lock-keywords
)
346 (defvar log-view-current-tag-function
)
348 (define-derived-mode vc-bzr-log-view-mode log-view-mode
"Bzr-Log-View"
349 (remove-hook 'log-view-mode-hook
'vc-bzr-log-view-mode
) ;Deactivate the hack.
351 ;; Don't have file markers, so use impossible regexp.
352 (set (make-local-variable 'log-view-file-re
) "\\'\\`")
353 (set (make-local-variable 'log-view-message-re
)
354 "^ *-+\n *\\(?:revno: \\([0-9]+\\)\\|merged: .+\\)")
355 (set (make-local-variable 'log-view-font-lock-keywords
)
356 ;; log-view-font-lock-keywords is careful to use the buffer-local
357 ;; value of log-view-message-re only since Emacs-23.
358 (append `((,log-view-message-re .
'log-view-message-face
))
359 ;; log-view-font-lock-keywords
361 \\([^<(]+?\\)[ ]*[(<]\\([[:alnum:]_.+-]+@[[:alnum:]_.-]+\\)[>)]"
363 (2 'change-log-email
))
364 ("^ *timestamp: \\(.*\\)" (1 'change-log-date-face
))))))
366 (defun vc-bzr-print-log (files &optional buffer
) ; get buffer arg in Emacs 22
367 "Get bzr change log for FILES into specified BUFFER."
368 ;; FIXME: `vc-bzr-command' runs `bzr log' with `LC_MESSAGES=C', so
369 ;; the log display may not what the user wants - but I see no other
370 ;; way of getting the above regexps working.
371 (apply 'vc-bzr-command
"log" buffer
0 files
372 (if (stringp vc-bzr-log-switches
)
373 (list vc-bzr-log-switches
)
374 vc-bzr-log-switches
))
375 ;; FIXME: Until Emacs-23, VC was missing a hook to sort out the mode for
376 ;; the buffer, or at least set the regexps right.
377 (unless (fboundp 'vc-default-log-view-mode
)
378 (add-hook 'log-view-mode-hook
'vc-bzr-log-view-mode
)))
380 (defun vc-bzr-show-log-entry (revision)
381 "Find entry for patch name REVISION in bzr change log buffer."
382 (goto-char (point-min))
383 (let (case-fold-search)
384 (if (re-search-forward (concat "^-+\nrevno: " revision
"$") nil t
)
385 (beginning-of-line 0)
386 (goto-char (point-min)))))
388 (autoload 'vc-diff-switches-list
"vc" nil nil t
)
390 (defun vc-bzr-diff (files &optional rev1 rev2 buffer
)
391 "VC bzr backend for diff."
392 ;; `bzr diff' exits with code 1 if diff is non-empty
393 (apply #'vc-bzr-command
"diff" (or buffer
"*vc-diff*") 1 files
394 "--diff-options" (mapconcat 'identity
395 (vc-diff-switches-list bzr
)
397 (list "-r" (format "%s..%s"
402 ;; FIXME: vc-{next,previous}-revision need fixing in vc.el to deal with
403 ;; straight integer revisions.
405 (defun vc-bzr-delete-file (file)
406 "Delete FILE and delete it in the bzr repository."
410 (vc-bzr-command "remove" nil
0 file
))
412 (defun vc-bzr-rename-file (old new
)
413 "Rename file from OLD to NEW using `bzr mv'."
414 (vc-bzr-command "mv" nil
0 new old
))
416 (defvar vc-bzr-annotation-table nil
418 (make-variable-buffer-local 'vc-bzr-annotation-table
)
420 (defun vc-bzr-annotate-command (file buffer
&optional revision
)
421 "Prepare BUFFER for `vc-annotate' on FILE.
422 Each line is tagged with the revision number, which has a `help-echo'
423 property containing author and date information."
424 (apply #'vc-bzr-command
"annotate" buffer
0 file
"--long" "--all"
425 (if revision
(list "-r" revision
)))
426 (with-current-buffer buffer
427 ;; Store the tags for the annotated source lines in a hash table
428 ;; to allow saving space by sharing the text properties.
429 (setq vc-bzr-annotation-table
(make-hash-table :test
'equal
))
430 (goto-char (point-min))
431 (while (re-search-forward "^\\( *[0-9]+\\) +\\(.+\\) +\\([0-9]\\{8\\}\\) |"
433 (let* ((rev (match-string 1))
434 (author (match-string 2))
435 (date (match-string 3))
436 (key (match-string 0))
437 (tag (gethash key vc-bzr-annotation-table
)))
439 (setq tag
(propertize rev
'help-echo
(concat "Author: " author
441 'mouse-face
'highlight
))
442 (puthash key tag vc-bzr-annotation-table
))
444 (insert tag
" |")))))
446 (defun vc-bzr-annotate-time ()
447 (when (re-search-forward "^ *[0-9]+ |" nil t
)
448 (let ((prop (get-text-property (line-beginning-position) 'help-echo
)))
449 (string-match "[0-9]+\\'" prop
)
450 (vc-annotate-convert-time
452 (string-to-number (substring (match-string 0 prop
) 6 8))
453 (string-to-number (substring (match-string 0 prop
) 4 6))
454 (string-to-number (substring (match-string 0 prop
) 0 4))
457 (defun vc-bzr-annotate-extract-revision-at-line ()
458 "Return revision for current line of annoation buffer, or nil.
459 Return nil if current line isn't annotated."
462 (if (looking-at " *\\([0-9]+\\) | ")
463 (match-string-no-properties 1))))
465 (defun vc-bzr-command-discarding-stderr (command &rest args
)
466 "Execute shell command COMMAND (with ARGS); return its output and exitcode.
467 Return value is a cons (EXITCODE . OUTPUT), where EXITCODE is
468 the (numerical) exit code of the process, and OUTPUT is a string
469 containing whatever the process sent to its standard output
470 stream. Standard error output is discarded."
473 (apply #'call-process command nil
(list (current-buffer) nil
) nil args
)
474 (buffer-substring (point-min) (point-max)))))
476 ;; TODO: it would be nice to mark the conflicted files in VC Dired,
477 ;; and implement a command to run ediff and `bzr resolve' once the
478 ;; changes have been merged.
479 (defun vc-bzr-dir-state (dir &optional localp
)
480 "Find the VC state of all files in DIR and its subdirectories.
481 Optional argument LOCALP is always ignored."
482 (let ((bzr-root-directory (vc-bzr-root dir
))
484 current-bzr-state current-vc-state
)
485 ;; Check that DIR is a bzr repository.
486 (unless (file-name-absolute-p bzr-root-directory
)
487 (error "Cannot find bzr repository for directory `%s'" dir
))
488 ;; `bzr ls --versioned' lists all versioned files;
489 ;; assume they are up-to-date, unless we are given
490 ;; evidence of the contrary.
493 (buffer-disable-undo) ;; Because these buffers can get huge
494 (vc-bzr-command "ls" t
0 nil
"--versioned")
495 (goto-char (point-min))
497 (eq 0 (forward-line)))
499 (let ((file (expand-file-name
500 (buffer-substring-no-properties
501 (line-beginning-position) (line-end-position))
502 bzr-root-directory
)))
503 ;; files are up-to-date unless they appear in the `bzr
504 ;; status' output below
505 (vc-file-setprop file
'vc-state
'up-to-date
)
506 ;; XXX: is this correct? what happens if one
507 ;; mixes different SCMs in the same dir?
508 ;; Anyway, we're looking at the output of `bzr ls --versioned',
509 ;; so we know these files are registered with Bzr.
510 (vc-file-setprop file
'vc-backend
'Bzr
))))
511 ;; `bzr status' reports on added/modified/renamed and unknown/ignored files
514 (vc-bzr-command "status" t
0 nil
)
515 (goto-char (point-min))
517 (eq 0 (forward-line)))
520 ((looking-at "^added")
521 (setq current-vc-state
'added
)
522 (setq current-bzr-state
'added
))
523 ((looking-at "^kind changed")
524 (setq current-vc-state
'edited
)
525 (setq current-bzr-state
'kindchanged
))
526 ((looking-at "^modified")
527 (setq current-vc-state
'edited
)
528 (setq current-bzr-state
'modified
))
529 ((looking-at "^renamed")
530 (setq current-vc-state
'edited
)
531 (setq current-bzr-state
'renamed
))
532 ((looking-at "^ignored")
533 (setq current-vc-state
'ignored
)
534 (setq current-bzr-state
'not-versioned
))
535 ((looking-at "^unknown")
536 (setq current-vc-state
'unregistered
)
537 (setq current-bzr-state
'not-versioned
))
539 ;; file names are indented by two spaces
540 (when current-vc-state
541 (let ((file (expand-file-name
542 (buffer-substring-no-properties
543 (match-end 0) (line-end-position))
544 bzr-root-directory
)))
545 (vc-file-setprop file
'vc-state current-vc-state
)
546 (vc-file-setprop file
'vc-bzr-state current-bzr-state
)
547 (when (eq 'added current-bzr-state
)
548 (vc-file-setprop file
'vc-working-revision
"0"))))
549 (when (eq 'not-versioned current-bzr-state
)
550 (let ((file (expand-file-name
551 (buffer-substring-no-properties
552 (match-end 0) (line-end-position))
553 bzr-root-directory
)))
554 (vc-file-setprop file
'vc-backend
'none
)
555 (vc-file-setprop file
'vc-state nil
))))
557 ;; skip this part of `bzr status' output
558 (setq current-vc-state nil
)
559 (setq current-bzr-state nil
)))))))
561 (defun vc-bzr-dired-state-info (file)
562 "Bzr-specific version of `vc-dired-state-info'."
563 (if (eq 'edited
(vc-state file
))
564 (concat "(" (symbol-name (or (vc-file-getprop file
'vc-bzr-state
)
566 ;; else fall back to default vc.el representation
567 (vc-default-dired-state-info 'Bzr file
)))
569 (eval-after-load "vc"
570 '(add-to-list 'vc-directory-exclusion-list vc-bzr-admin-dirname t
))
573 ;; arch-tag: 8101bad8-4e92-4e7d-85ae-d8e08b4e7c06
574 ;;; vc-bzr.el ends here