my-emacs-d/elpa/magithub-20160928.1650/magithub-issue.el
Gergely Polonkai f7ef9aced2 Update packages
2016-09-29 09:33:23 +02:00

179 lines
6.2 KiB
EmacsLisp

;;; magithub-issue.el --- Browse issues with Magithub -*- lexical-binding: t; -*-
;; Copyright (C) 2016 Sean Allred
;; Author: Sean Allred <code@seanallred.com>
;; Keywords: tools
;; This program 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 of the License, or
;; (at your option) any later version.
;; This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
;; Jump to issues from `magit-status'!
;;; Code:
(require 'magit)
(require 'magit-section)
(require 'magithub-core)
(require 'magithub-cache)
(magit-define-popup magithub-issues-popup
"Popup console for creating GitHub issues."
'magithub-commands
:man-page "hub"
:options '((?l "Add labels" "--label=" magithub-issue-read-labels))
:actions '((?c "Create new issue" magithub-issue-new)))
(defvar magithub-issue-format
(list :number " %3d "
:title " %s ")
"These properties will be inserted in the order in which their
found. See `magithub-issue--process-line'.")
(defun magithub-issue-new ()
"Create a new issue on GitHub."
(interactive)
(unless (magithub-github-repository-p)
(user-error "Not a GitHub repository"))
(magithub--command-with-editor
"issue" (cons "create" (magithub-issues-arguments))))
(defun magithub-issue-label-list ()
"Return a list of issue labels.
This is a hard-coded list right now."
(list "bug" "duplicate" "enhancement"
"help wanted" "invalid" "question" "wontfix"))
(defun magithub-issue-read-labels (prompt &optional default)
"Read some issue labels and return a comma-separated string.
Available issues are provided by `magithub-issue-label-list'.
DEFAULT is a comma-separated list of issues -- those issues that
are in DEFAULT are not prompted for again."
;; todo: probably need to add DEFAULT to the top here
(s-join
","
(magithub--completing-read-multiple
(format "%s... %s" prompt "Issue labels (or \"\" to quit): ")
(let* ((default-labels (when default (s-split "," default t))))
(cl-set-difference (magithub-issue-label-list) default-labels)))))
(defun magithub-issue--process-line (s)
"Process a line S into an issue.
Returns a plist with the following properties:
:number issue or pull request number
:type either 'pull-request or 'issue
:title the title of the issue or pull request
:url link to issue or pull request"
(let (number title url)
(if (ignore-errors
(with-temp-buffer
(insert s)
(goto-char 0)
(search-forward "]")
(setq number (string-to-number (substring s 0 (point))))
(setq title (substring s (point)
(save-excursion
(goto-char (point-max))
(- (search-backward "(") 2))))
(goto-char (point-max))
(delete-char -2)
(search-backward "(")
(forward-char 2)
(setq url (buffer-substring-no-properties (point) (point-max)))
t))
(list :number number
:type (if (string-match-p (rx "/pull/" (+ digit) eos) url)
'pull-request 'issue)
:title title
:url url)
(magithub-error
"failed to parse issue"
"There was an error parsing issues."))))
(defun magithub-issue-list ()
"Return a list of issues for the current repository."
(magithub-cache (magithub-repo-id) :issues
'(with-temp-message "Retrieving issue list..."
(magithub-issue-list--internal))))
(defun magithub-issue-list--internal ()
(sort (mapcar #'magithub-issue--process-line
(magithub--command-output "issue"))
(lambda (a b) (< (plist-get a :number)
(plist-get b :number)))))
(defun magithub-issue--insert (issue)
"Insert an `issue' as a Magit section into the buffer."
(when issue
(magit-insert-section (magithub-issue issue)
(let ((formats (or magithub-issue-format
(list :number " %3d " :title " %s "))))
(while formats
(let ((key (car formats)) (fmt (cadr formats)))
(insert (format fmt (plist-get issue key))))
(setq formats (cddr formats))))
(insert ?\n))))
(defun magithub-issue-browse (issue)
"Visits `issue' in the browser.
Interactively, this finds the issue at point.
If `issue' is nil, open the repository's issues page."
(interactive (list (magit-section-value
(magit-current-section))))
(browse-url
(if (plist-member issue :url)
(plist-get issue :url)
(car (magithub--command-output "browse" '("--url-only" "--" "issues"))))))
(defun magithub-issue-refresh ()
(interactive)
(magithub-cache-clear (magithub-repo-id) :issues)
(when (derived-mode-p 'magit-status-mode)
(magit-refresh)))
(defvar magit-magithub-issue-section-map
(let ((map (make-sparse-keymap)))
(define-key map [remap magit-visit-thing] #'magithub-issue-browse)
(define-key map [remap magit-refresh] #'magithub-issue-refresh)
map)
"Keymap for `magithub-issue' sections.")
(defvar magit-magithub-issue-list-section-map
(let ((map (make-sparse-keymap)))
(define-key map [remap magit-visit-thing] #'magithub-issue-browse)
(define-key map [remap magit-refresh] #'magithub-issue-refresh)
map)
"Keymap for `magithub-issue-list' sections.")
(defun magithub-issue--insert-section ()
"Insert GitHub issues if appropriate."
(when (magithub-usable-p)
(let* ((issues (magithub-issue-list)))
(magit-insert-section (magithub-issue-list)
(magit-insert-heading "Issues and Pull Requests:")
(if issues (mapc #'magithub-issue--insert issues)
(insert " No issues.\n"))))))
;;; Hook into the status buffer
(add-hook 'magit-status-sections-hook #'magithub-issue--insert-section t)
(provide 'magithub-issue)
;;; magithub-issue.el ends here