my-emacs-d/elpa/magit-20160926.517/magit-submodule.el

315 lines
13 KiB
EmacsLisp
Raw Normal View History

2016-02-24 22:06:01 +00:00
;;; magit-submodule.el --- submodule support for Magit -*- lexical-binding: t -*-
2016-06-29 07:21:54 +00:00
;; Copyright (C) 2011-2016 The Magit Project Contributors
2016-02-24 22:06:01 +00:00
;;
;; You should have received a copy of the AUTHORS.md file which
;; lists all contributors. If not, see http://magit.vc/authors.
;; Author: Jonas Bernoulli <jonas@bernoul.li>
;; Maintainer: Jonas Bernoulli <jonas@bernoul.li>
;; Magit 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 3, or (at your option)
;; any later version.
;;
;; Magit 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 Magit. If not, see http://www.gnu.org/licenses.
;;; Code:
(require 'magit)
2016-08-18 20:01:20 +00:00
;;; Options
(defcustom magit-submodule-list-columns
'(("Path" 25 magit-modulelist-column-path nil)
("Version" 25 magit-repolist-column-version nil)
("Branch" 20 magit-repolist-column-branch nil)
("L<U" 3 magit-repolist-column-unpulled-from-upstream (:right-align t))
("L>U" 3 magit-repolist-column-unpushed-to-upstream (:right-align t))
("L<P" 3 magit-repolist-column-unpulled-from-pushremote (:right-align t))
("L>P" 3 magit-repolist-column-unpushed-to-pushremote (:right-align t)))
"List of columns displayed by `magit-list-submodules'.
Each element has the form (HEADER WIDTH FORMAT PROPS).
HEADER is the string displayed in the header. WIDTH is the width
of the column. FORMAT is a function that is called with one
argument, the repository identification (usually its basename),
and with `default-directory' bound to the toplevel of its working
tree. It has to return a string to be inserted or nil. PROPS is
an alist that supports the keys `:right-align' and `:pad-right'."
:package-version '(magit . "2.8.0")
:group 'magit-commands
:type `(repeat (list :tag "Column"
(string :tag "Header Label")
(integer :tag "Column Width")
(function :tag "Inserter Function")
(repeat :tag "Properties"
(list (choice :tag "Property"
(const :right-align)
(const :pad-right)
(symbol))
(sexp :tag "Value"))))))
2016-02-24 22:06:01 +00:00
;;; Commands
;;;###autoload (autoload 'magit-submodule-popup "magit-submodule" nil t)
(magit-define-popup magit-submodule-popup
"Popup console for submodule commands."
'magit-commands nil nil
:man-page "git-submodule"
:actions '((?a "Add" magit-submodule-add)
(?b "Setup" magit-submodule-setup)
(?i "Init" magit-submodule-init)
(?u "Update" magit-submodule-update)
(?s "Sync" magit-submodule-sync)
(?f "Fetch" magit-submodule-fetch)
(?d "Deinit" magit-submodule-deinit)))
;;;###autoload
2016-04-21 21:27:19 +00:00
(defun magit-submodule-add (url &optional path name)
2016-02-24 22:06:01 +00:00
"Add the repository at URL as a submodule.
2016-04-21 21:27:19 +00:00
2016-02-24 22:06:01 +00:00
Optional PATH is the path to the submodule relative to the root
2016-04-21 21:27:19 +00:00
of the superproject. If it is nil, then the path is determined
2016-04-26 11:40:21 +00:00
based on the URL.
2016-04-21 21:27:19 +00:00
Optional NAME is the name of the submodule. If it is nil, then
PATH also becomes the name."
2016-02-24 22:06:01 +00:00
(interactive
(magit-with-toplevel
2016-06-29 07:21:54 +00:00
(let* ((url (magit-read-string-ns "Add submodule (remote url)"))
(path (let ((read-file-name-function #'read-file-name-default))
(directory-file-name
(file-relative-name
(read-directory-name
"Add submodules at path: " nil nil nil
(and (string-match "\\([^./]+\\)\\(\\.git\\)?$" url)
(match-string 1 url))))))))
(list url
2016-04-26 11:40:21 +00:00
(directory-file-name path)
2016-06-29 07:21:54 +00:00
(magit-submodule-read-name path)))))
2016-04-21 21:27:19 +00:00
(magit-run-git "submodule" "add" (and name (list "--name" name)) url path))
2016-02-24 22:06:01 +00:00
2016-06-29 07:21:54 +00:00
;;;###autoload
(defun magit-submodule-read-name (path)
(setq path (directory-file-name (file-relative-name path)))
(push (file-name-nondirectory path) minibuffer-history)
(magit-read-string-ns
"Submodule name" nil (cons 'minibuffer-history 2)
(or (--keep (-let [(var val) (split-string it "=")]
(and (equal val path)
(cadr (split-string var "\\."))))
(magit-git-lines "config" "--list" "-f" ".gitmodules"))
path)))
2016-02-24 22:06:01 +00:00
;;;###autoload
(defun magit-submodule-setup ()
"Clone and register missing submodules and checkout appropriate commits."
(interactive)
2016-06-29 07:21:54 +00:00
(magit-with-toplevel
(--if-let (--filter (not (file-exists-p (expand-file-name ".git" it)))
(magit-get-submodules))
(magit-run-git-async "submodule" "update" "--init" "--" it)
(message "All submodules already setup"))))
2016-02-24 22:06:01 +00:00
;;;###autoload
(defun magit-submodule-init ()
"Register submodules listed in \".gitmodules\" into \".git/config\"."
(interactive)
(magit-with-toplevel
(magit-run-git-async "submodule" "init")))
;;;###autoload
(defun magit-submodule-update (&optional init)
"Clone missing submodules and checkout appropriate commits.
With a prefix argument also register submodules in \".git/config\"."
(interactive "P")
(magit-with-toplevel
(magit-run-git-async "submodule" "update" (and init "--init"))))
;;;###autoload
(defun magit-submodule-sync ()
"Update each submodule's remote URL according to \".gitmodules\"."
(interactive)
(magit-with-toplevel
(magit-run-git-async "submodule" "sync")))
;;;###autoload
(defun magit-submodule-fetch (&optional all)
"Fetch all submodules.
With a prefix argument fetch all remotes."
(interactive "P")
(magit-with-toplevel
(magit-run-git-async "submodule" "foreach"
(format "git fetch %s || true" (if all "--all" "")))))
;;;###autoload
(defun magit-submodule-deinit (path)
"Unregister the submodule at PATH."
(interactive
(list (magit-completing-read "Deinit module" (magit-get-submodules)
nil t nil nil (magit-section-when module))))
(magit-with-toplevel
(magit-run-git-async "submodule" "deinit" path)))
;;; Sections
2016-04-26 11:40:21 +00:00
;;;###autoload
(defun magit-insert-submodules ()
"Insert sections for all modules.
For each section insert the path and the output of `git describe --tags'."
(-when-let (modules (magit-get-submodules))
2016-08-18 20:01:20 +00:00
(magit-insert-section (submodules nil t)
2016-04-26 11:40:21 +00:00
(magit-insert-heading "Modules:")
(magit-with-toplevel
2016-08-18 20:01:20 +00:00
(let ((col-format (format "%%-%is " (min 25 (/ (window-width) 3)))))
(dolist (module modules)
(let ((default-directory
(expand-file-name (file-name-as-directory module))))
(magit-insert-section (file module t)
(insert (propertize (format col-format module)
'face 'magit-diff-file-heading))
(if (not (file-exists-p ".git"))
(insert "(uninitialized)")
(insert (format col-format
(--if-let (magit-get-current-branch)
(propertize it 'face 'magit-branch-local)
(propertize "(detached)" 'face 'warning))))
(--when-let (magit-git-string "describe" "--tags")
(when (string-match-p "\\`[0-9]" it)
(insert ?\s))
(insert (propertize it 'face 'magit-tag))))
(insert ?\n))))))
2016-06-29 07:21:54 +00:00
(insert ?\n))))
2016-04-26 11:40:21 +00:00
2016-08-18 20:01:20 +00:00
(defvar magit-submodules-section-map
(let ((map (make-sparse-keymap)))
(define-key map [remap magit-visit-thing] 'magit-list-submodules)
map)
"Keymap for `submodules' sections.")
2016-02-24 22:06:01 +00:00
;;;###autoload
2016-04-21 21:27:19 +00:00
(defun magit-insert-modules-unpulled-from-upstream ()
"Insert sections for modules that haven't been pulled from the upstream.
These sections can be expanded to show the respective commits."
2016-04-26 11:40:21 +00:00
(magit--insert-modules-logs "Modules unpulled from @{upstream}"
'modules-unpulled-from-upstream
'magit-get-upstream-ref
"HEAD..%s"))
2016-02-24 22:06:01 +00:00
;;;###autoload
2016-04-21 21:27:19 +00:00
(defun magit-insert-modules-unpulled-from-pushremote ()
"Insert sections for modules that haven't been pulled from the push-remote.
2016-02-24 22:06:01 +00:00
These sections can be expanded to show the respective commits."
2016-04-26 11:40:21 +00:00
(magit--insert-modules-logs "Modules unpulled from <push-remote>"
'modules-unpulled-from-pushremote
'magit-get-push-branch
"HEAD..%s"))
2016-02-24 22:06:01 +00:00
;;;###autoload
2016-04-21 21:27:19 +00:00
(defun magit-insert-modules-unpushed-to-upstream ()
"Insert sections for modules that haven't been pushed to the upstream.
2016-02-24 22:06:01 +00:00
These sections can be expanded to show the respective commits."
2016-04-26 11:40:21 +00:00
(magit--insert-modules-logs "Modules unmerged into @{upstream}"
'modules-unpushed-to-upstream
'magit-get-upstream-ref
"%s..HEAD"))
2016-04-21 21:27:19 +00:00
;;;###autoload
(defun magit-insert-modules-unpushed-to-pushremote ()
"Insert sections for modules that haven't been pushed to the push-remote.
These sections can be expanded to show the respective commits."
2016-04-26 11:40:21 +00:00
(magit--insert-modules-logs "Modules unpushed to <push-remote>"
'modules-unpushed-to-pushremote
'magit-get-push-branch
"%s..HEAD"))
2016-04-21 21:27:19 +00:00
2016-04-26 11:40:21 +00:00
(defun magit--insert-modules-logs (heading type fn format)
2016-04-21 21:27:19 +00:00
"For internal use, don't add to a hook."
2016-02-24 22:06:01 +00:00
(-when-let (modules (magit-get-submodules))
2016-04-21 21:27:19 +00:00
(magit-insert-section section ((eval type) nil t)
(string-match "\\`\\(.+\\) \\([^ ]+\\)\\'" heading)
(magit-insert-heading
(concat
(propertize (match-string 1 heading) 'face 'magit-section-heading) " "
(propertize (match-string 2 heading) 'face 'magit-branch-remote) ":"))
2016-02-24 22:06:01 +00:00
(magit-with-toplevel
(dolist (module modules)
(let ((default-directory
(expand-file-name (file-name-as-directory module))))
2016-04-21 21:27:19 +00:00
(--when-let (and (magit-file-accessible-directory-p default-directory)
(funcall fn))
2016-02-24 22:06:01 +00:00
(magit-insert-section sec (file module t)
(magit-insert-heading
(concat (propertize module 'face 'magit-diff-file-heading) ":"))
2016-04-21 21:27:19 +00:00
(magit-git-wash (apply-partially 'magit-log-wash-log 'module)
"log" "--oneline" (format format it))
(when (> (point) (magit-section-content sec))
(delete-char -1)))))))
2016-02-24 22:06:01 +00:00
(if (> (point) (magit-section-content section))
(insert ?\n)
(magit-cancel-section)))))
2016-08-18 20:01:20 +00:00
;;; List
;;;###autoload
(defun magit-list-submodules ()
"Display a list of the current repository's submodules."
(interactive)
(magit-display-buffer (magit-mode-get-buffer 'magit-submodule-list-mode t))
(magit-submodule-list-mode)
(setq tabulated-list-entries
(mapcar (lambda (module)
(let ((default-directory
(expand-file-name (file-name-as-directory module))))
(list module
(vconcat (--map (or (funcall (nth 2 it) module) "")
magit-submodule-list-columns)))))
(magit-get-submodules)))
(tabulated-list-print))
(defvar magit-submodule-list-mode-map
(let ((map (make-sparse-keymap)))
(set-keymap-parent map tabulated-list-mode-map)
(define-key map "g" 'magit-list-submodules)
(define-key map "\r" 'magit-repolist-status)
map)
"Local keymap for Magit-Submodule-List mode buffers.")
(define-derived-mode magit-submodule-list-mode tabulated-list-mode "Modules"
"Major mode for browsing a list of Git submodules."
(setq x-stretch-cursor nil)
(setq tabulated-list-padding 0)
(setq tabulated-list-sort-key (cons "Path" nil))
(setq tabulated-list-format
(vconcat (mapcar (-lambda ((title width _fn props))
(nconc (list title width t)
(-flatten props)))
magit-submodule-list-columns)))
(tabulated-list-init-header))
(defun magit-modulelist-column-path (path)
"Insert the relative path of the submodule."
path)
2016-02-24 22:06:01 +00:00
;;; magit-submodule.el ends soon
2016-04-21 21:27:19 +00:00
(define-obsolete-function-alias 'magit-insert-unpulled-module-commits
'magit-insert-modules-unpulled-from-upstream "Magit 2.6.0")
(define-obsolete-function-alias 'magit-insert-unpushed-module-commits
'magit-insert-modules-unpushed-to-upstream "Magit 2.6.0")
2016-02-24 22:06:01 +00:00
(provide 'magit-submodule)
;; Local Variables:
;; indent-tabs-mode: nil
;; End:
;;; magit-submodule.el ends here