;;; 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) (require 'ov) (defun prelude-open-with (arg) "Open visited file in default external program. When in dired mode, open file under the cursor. With a prefix ARG always prompt for command to use." (interactive "P") (let ((current-file-name (if (eq major-mode 'dired-mode) (dired-get-file-for-visit) buffer-file-name))) (when current-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 current-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)))))) (defmacro prelude-install-search-engine (search-engine-name search-engine-url search-engine-prompt) "Given some information regarding a search engine, install the interactive command to search through them" `(defun ,(intern (format "prelude-%s" search-engine-name)) () ,(format "Search %s with a query or region if any." search-engine-name) (interactive) (prelude-search ,search-engine-url ,search-engine-prompt))) (prelude-install-search-engine "google" "http://www.google.com/search?q=" "Google: ") (prelude-install-search-engine "youtube" "http://www.youtube.com/results?search_query=" "Search YouTube: ") (prelude-install-search-engine "github" "https://github.com/search?q=" "Search GitHub: ") (prelude-install-search-engine "duckduckgo" "https://duckduckgo.com/?t=lm&q=" "Search DuckDuckGo: ") (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-todo-ov-evaporate (_ov _after _beg _end &optional _length) (let ((inhibit-modification-hooks t)) (if _after (ov-reset _ov)))) (defun prelude-annotate-todo () "Put fringe marker on TODO: lines in the curent buffer." (interactive) (ov-set (format "[[:space:]]*%s+[[:space:]]*TODO:" comment-start) 'before-string (propertize (format "A") 'display '(left-fringe right-triangle)) 'modification-hooks '(prelude-todo-ov-evaporate))) (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-get-positions-of-line-or-region () "Return positions (beg . end) of the current line or region." (let (beg end) (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)) (cons beg end))) (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") (pcase-let* ((origin (point)) (`(,beg . ,end) (prelude-get-positions-of-line-or-region)) (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)))) (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") (pcase-let* ((origin (point)) (`(,beg . ,end) (prelude-get-positions-of-line-or-region)) (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) (when (y-or-n-p (format "Are you sure you want to delete %s? " filename)) (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 to search in Google." "Press to search in GitHub." "Press to search in YouTube." "Press to search in DuckDuckGo." "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 the EmacsWiki at http://emacswiki.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)) (require 'epl) (defun prelude-update () "Update Prelude to its latest version." (interactive) (when (y-or-n-p "Do you want to update Prelude? ") (message "Updating installed packages...") (epl-upgrade) (message "Updating Prelude...") (cd prelude-dir) (shell-command "git pull") (prelude-recompile-init) (message "Update finished. Restart Emacs to complete the process."))) (defun prelude-update-packages (&optional arg) "Update Prelude's packages. This includes package installed via `prelude-require-package'. With a prefix ARG updates all installed packages." (interactive "P") (when (y-or-n-p "Do you want to update Prelude's packages? ") (if arg (epl-upgrade) (epl-upgrade (-filter (lambda (p) (memq (epl-package-name p) prelude-packages)) (epl-installed-packages)))) (message "Update finished. Restart Emacs to complete the process."))) ;;; 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"))) (defun prelude-find-user-init-file (&optional arg) "Edit the `prelude-user-init-file', in another window. With a prefix argument ARG, find the `user-init-file' instead." (interactive "P") (if arg (find-file-other-window user-init-file) (find-file-other-window prelude-user-init-file))) (defun prelude-find-shell-init-file () "Edit the shell init file in another window." (interactive) (let* ((shell (car (reverse (s-split "/" (getenv "SHELL"))))) (shell-init-file (cond ((s-equals? "zsh" shell) ".zshrc") ((s-equals? "bash" shell) ".bashrc") (t (error "Unknown shell"))))) (find-file-other-window (expand-file-name shell-init-file (getenv "HOME"))))) (defun prelude-wrap-with (s) "Create a wrapper function for smartparens using S." `(lambda (&optional arg) (interactive "P") (sp-wrap-with-pair ,s))) (provide 'prelude-core) ;;; prelude-core.el ends here