;;; prelude-core.el --- Emacs Prelude: Core Prelude functions. ;; ;; Copyright © 2011-2013 Bozhidar Batsov ;; ;; Author: Bozhidar Batsov ;; URL: https://github.com/bbatsov/prelude ;; Version: 1.0.0 ;; Keywords: convenience ;; This file is not part of GNU Emacs. ;;; Commentary: ;; Here are the definitions of most of the functions added by Prelude. ;;; License: ;; 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 GNU Emacs; see the file COPYING. If not, write to the ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, ;; Boston, MA 02110-1301, USA. ;;; Code: (require 'thingatpt) (require 'dash) (defun prelude-open-with (arg) "Open visited file in default external program. With a prefix ARG always prompt for command to use." (interactive "P") (when buffer-file-name (start-process "prelude-open-with-process" "*prelude-open-with-output*" (cond ((and (not arg) (eq system-type 'darwin)) "open") ((and (not arg) (member system-type '(gnu gnu/linux gnu/kfreebsd))) "xdg-open") (t (read-shell-command "Open current file with: "))) (shell-quote-argument buffer-file-name)))) (defun prelude-buffer-mode (buffer-or-name) "Retrieve the `major-mode' of BUFFER-OR-NAME." (with-current-buffer buffer-or-name major-mode)) (defun prelude-visit-term-buffer () "Create or visit a terminal buffer." (interactive) (prelude-start-or-switch-to (lambda () (ansi-term (getenv "SHELL"))) "*ansi-term*")) (defun prelude-search (query-url prompt) "Open the search url constructed with the QUERY-URL. PROMPT sets the `read-string prompt." (browse-url (concat query-url (url-hexify-string (if mark-active (buffer-substring (region-beginning) (region-end)) (read-string prompt)))))) (defun prelude-google () "Googles a query or region if any." (interactive) (prelude-search "http://www.google.com/search?q=" "Google: ")) (defun prelude-youtube () "Search YouTube with a query or region if any." (interactive) (prelude-search "http://www.youtube.com/results?search_query=" "Search YouTube: ")) (defun prelude-github () "Search GitHub with a query or region if any." (interactive) (prelude-search "https://github.com/search?q=" "Search GitHub: ")) (defun prelude-indent-rigidly-and-copy-to-clipboard (begin end arg) "Indent region between BEGIN and END by ARG columns and copy to clipboard." (interactive "r\nP") (let ((arg (or arg 4)) (buffer (current-buffer))) (with-temp-buffer (insert-buffer-substring-no-properties buffer begin end) (indent-rigidly (point-min) (point-max) arg) (clipboard-kill-ring-save (point-min) (point-max))))) (defun prelude-smart-open-line-above () "Insert an empty line above the current line. Position the cursor at it's beginning, according to the current mode." (interactive) (move-beginning-of-line nil) (newline-and-indent) (forward-line -1) (indent-according-to-mode)) (defun prelude-smart-open-line (arg) "Insert an empty line after the current line. Position the cursor at its beginning, according to the current mode. With a prefix ARG open line above the current line." (interactive "P") (if arg (prelude-smart-open-line-above) (progn (move-end-of-line nil) (newline-and-indent)))) (defun prelude-top-join-line () "Join the current line with the line beneath it." (interactive) (delete-indentation 1)) (defun prelude-kill-whole-line (&optional arg) "A simple wrapper around command `kill-whole-line' that respects indentation. Passes ARG to command `kill-whole-line' when provided." (interactive "P") (kill-whole-line arg) (back-to-indentation)) (defun prelude-move-beginning-of-line (arg) "Move point back to indentation of beginning of line. Move point to the first non-whitespace character on this line. If point is already there, move to the beginning of the line. Effectively toggle between the first non-whitespace character and the beginning of the line. If ARG is not nil or 1, move forward ARG - 1 lines first. If point reaches the beginning or end of the buffer, stop there." (interactive "^p") (setq arg (or arg 1)) ;; Move lines first (when (/= arg 1) (let ((line-move-visual nil)) (forward-line (1- arg)))) (let ((orig-point (point))) (back-to-indentation) (when (= orig-point (point)) (move-beginning-of-line 1)))) (global-set-key [remap move-beginning-of-line] 'prelude-move-beginning-of-line) (defun prelude-indent-buffer () "Indent the currently visited buffer." (interactive) (indent-region (point-min) (point-max))) (defun prelude-indent-region-or-buffer () "Indent a region if selected, otherwise the whole buffer." (interactive) (save-excursion (if (region-active-p) (progn (indent-region (region-beginning) (region-end)) (message "Indented selected region.")) (progn (prelude-indent-buffer) (message "Indented buffer."))))) (defun prelude-indent-defun () "Indent the current defun." (interactive) (save-excursion (mark-defun) (indent-region (region-beginning) (region-end)))) (defun prelude-annotate-todo () "Put fringe marker on TODO: lines in the curent buffer." (interactive) (save-excursion (goto-char (point-min)) (while (re-search-forward "TODO:" nil t) (let ((overlay (make-overlay (- (point) 5) (point)))) (overlay-put overlay 'before-string (propertize (format "A") 'display '(left-fringe right-triangle))))))) (defun prelude-copy-file-name-to-clipboard () "Copy the current buffer file name to the clipboard." (interactive) (let ((filename (if (equal major-mode 'dired-mode) default-directory (buffer-file-name)))) (when filename (kill-new filename) (message "Copied buffer file name '%s' to the clipboard." filename)))) (defun prelude-duplicate-current-line-or-region (arg) "Duplicates the current line or region ARG times. If there's no region, the current line will be duplicated. However, if there's a region, all lines that region covers will be duplicated." (interactive "p") (let (beg end (origin (point))) (if (and mark-active (> (point) (mark))) (exchange-point-and-mark)) (setq beg (line-beginning-position)) (if mark-active (exchange-point-and-mark)) (setq end (line-end-position)) (let ((region (buffer-substring-no-properties beg end))) (-dotimes arg (lambda (n) (goto-char end) (newline) (insert region) (setq end (point)))) (goto-char (+ origin (* (length region) arg) arg))))) ;; TODO: Remove code duplication by extracting something more generic (defun prelude-duplicate-and-comment-current-line-or-region (arg) "Duplicates and comments the current line or region ARG times. If there's no region, the current line will be duplicated. However, if there's a region, all lines that region covers will be duplicated." (interactive "p") (let (beg end (origin (point))) (if (and mark-active (> (point) (mark))) (exchange-point-and-mark)) (setq beg (line-beginning-position)) (if mark-active (exchange-point-and-mark)) (setq end (line-end-position)) (let ((region (buffer-substring-no-properties beg end))) (comment-or-uncomment-region beg end) (setq end (line-end-position)) (-dotimes arg (lambda (n) (goto-char end) (newline) (insert region) (setq end (point)))) (goto-char (+ origin (* (length region) arg) arg))))) (defun prelude-rename-file-and-buffer () "Renames current buffer and file it is visiting." (interactive) (let ((filename (buffer-file-name))) (if (not (and filename (file-exists-p filename))) (message "Buffer is not visiting a file!") (let ((new-name (read-file-name "New name: " filename))) (cond ((vc-backend filename) (vc-rename-file filename new-name)) (t (rename-file filename new-name t) (set-visited-file-name new-name t t))))))) (defun prelude-delete-file-and-buffer () "Kill the current buffer and deletes the file it is visiting." (interactive) (let ((filename (buffer-file-name))) (when filename (if (vc-backend filename) (vc-delete-file filename) (progn (delete-file filename) (message "Deleted file %s" filename) (kill-buffer)))))) (defun prelude-view-url () "Open a new buffer containing the contents of URL." (interactive) (let* ((default (thing-at-point-url-at-point)) (url (read-from-minibuffer "URL: " default))) (switch-to-buffer (url-retrieve-synchronously url)) (rename-buffer url t) (cond ((search-forward "> (buffer-list) (-filter #'buffer-file-name) (--remove (eql (current-buffer) it))) #'kill-buffer)) (defun prelude-create-scratch-buffer () "Create a new scratch buffer." (interactive) (progn (switch-to-buffer (get-buffer-create (generate-new-buffer-name "*scratch*"))) (emacs-lisp-mode))) (defvar prelude-tips '("Press to open a file with external program." "Press or to navigate a project's files with ido." "Press or to run grep on a project." "Press or to switch between projects." "Press or to expand the selected region." "Press quickly to jump to the beginning of a visible word." "Press quickly to jump to a visible character." "Press quickly to jump to a visible line." "Press to navigate a project in Helm." "Press to search in Google." "Press to search in GitHub." "Press to search in YouTube." "Press to rename the current buffer and file it's visiting." "Press to open a terminal in Emacs." "Press to kill all the buffers, but the active one." "Press or to run magit-status." "Press to delete the current file and buffer." "Press to swap two windows." "Press or to open a new beneath the current one." "Press to open a line above the current one." "Press in a Elisp buffer to launch an interactive Elisp shell." "Press to kill a line backwards." "Press or to kill the whole line." "Press to toggle fullscreen mode." "Press to toggle the menu bar." "Explore the Tools->Prelude menu to find out about some of Prelude extensions to Emacs." "Access the official Emacs manual by pressing ." "Visit WikEmacs at http://wikemacs.org to find out even more about Emacs.")) (defun prelude-tip-of-the-day () "Display a random entry from `prelude-tips'." (interactive) (unless (window-minibuffer-p) ;; pick a new random seed (random t) (message (concat "Prelude tip: " (nth (random (length prelude-tips)) prelude-tips))))) (defun prelude-eval-after-init (form) "Add `(lambda () FORM)' to `after-init-hook'. If Emacs has already finished initialization, also eval FORM immediately." (let ((func (list 'lambda nil form))) (add-hook 'after-init-hook func) (when after-init-time (eval form)))) (defun prelude-exchange-point-and-mark () "Identical to `exchange-point-and-mark' but will not activate the region." (interactive) (exchange-point-and-mark) (deactivate-mark nil)) (defun prelude-update () "Update Prelude to its latest version." (interactive) (when (y-or-n-p "Do you want to update Prelude? ") (message "Updating Prelude...") (cd prelude-dir) (shell-command "git pull") (prelude-recompile-init) (message "Update finished. Restart Emacs to complete the process."))) (defun thing-at-point-goto-end-of-integer () "Go to end of integer at point." (let ((inhibit-changing-match-data t)) ;; Skip over optional sign (when (looking-at "[+-]") (forward-char 1)) ;; Skip over digits (skip-chars-forward "[[:digit:]]") ;; Check for at least one digit (unless (looking-back "[[:digit:]]") (error "No integer here")))) (put 'integer 'beginning-op 'thing-at-point-goto-end-of-integer) (defun thing-at-point-goto-beginning-of-integer () "Go to end of integer at point." (let ((inhibit-changing-match-data t)) ;; Skip backward over digits (skip-chars-backward "[[:digit:]]") ;; Check for digits and optional sign (unless (looking-at "[+-]?[[:digit:]]") (error "No integer here")) ;; Skip backward over optional sign (when (looking-back "[+-]") (backward-char 1)))) (put 'integer 'beginning-op 'thing-at-point-goto-beginning-of-integer) (defun thing-at-point-bounds-of-integer-at-point () "Get boundaries of integer at point." (save-excursion (let (beg end) (thing-at-point-goto-beginning-of-integer) (setq beg (point)) (thing-at-point-goto-end-of-integer) (setq end (point)) (cons beg end)))) (put 'integer 'bounds-of-thing-at-point 'thing-at-point-bounds-of-integer-at-point) (defun thing-at-point-integer-at-point () "Get integer at point." (let ((bounds (bounds-of-thing-at-point 'integer))) (string-to-number (buffer-substring (car bounds) (cdr bounds))))) (put 'integer 'thing-at-point 'thing-at-point-integer-at-point) (defun prelude-increment-integer-at-point (&optional inc) "Increment integer at point by one. With numeric prefix arg INC, increment the integer by INC amount." (interactive "p") (let ((inc (or inc 1)) (n (thing-at-point 'integer)) (bounds (bounds-of-thing-at-point 'integer))) (delete-region (car bounds) (cdr bounds)) (insert (int-to-string (+ n inc))))) (defun prelude-decrement-integer-at-point (&optional dec) "Decrement integer at point by one. With numeric prefix arg DEC, decrement the integer by DEC amount." (interactive "p") (prelude-increment-integer-at-point (- (or dec 1)))) ;;; Emacs in OSX already has fullscreen support ;;; Emacs has a similar built-in command in 24.4 (defun prelude-fullscreen () "Make Emacs window fullscreen. This follows freedesktop standards, should work in X servers." (interactive) (if (eq window-system 'x) (x-send-client-message nil 0 nil "_NET_WM_STATE" 32 '(2 "_NET_WM_STATE_FULLSCREEN" 0)) (error "Only X server is supported"))) (provide 'prelude-core) ;;; prelude-core.el ends here