Emacs, portable self-installing configuration with “use-package” and “straight”

1 Emacs, use-package and straight in short.

Emacs uses the GNU ELPA (Emacs Lisp Package Archive) for updating installed packages.

MELPA (Milkypostman’s Emacs Lisp Package Archive) is, on the other hand, an unofficial manager with numerous other packages and must be installed by following the directions on this page.

The original methods for installing packages are as follows:

  • M-x package-install <RET> package-name <RET>
  • M-x package-list-packages <RET> followed by i on the desired packages and x for the actual installation of the selected packages.

To update packages you open the package-list above and press U followed by x.

All very simple and efficient.

There is only one small problem: the configuration is not exportable.

2 What is configuration exportability?

Anyone who uses Vim are well aware of the concept of configuration exportability: just write the configuration in .vimrc and you automatically have the system update through your plugin-manager.

In “native” Emacs it doesn’t work that way, but you can achieve a similar result through use-package: a package that simplifies the configuration of other packages.

In summary: instead of having to write the configuration for each package explicitly, you can use the “use-package” syntax to declare the packages you want to use and their configuration.

The “use-package” method ensures that ELPA or MELPA packages are installed, if they are not already, and allows you to specify their configuration clearly and concisely.

In summary: ELPA and MELPA are the package managers, and “use-package” is a package that simplifies the handling of packages from those managers.

3 Beyond exportability: “straight”.

At this point we can take one more step: change the package manager to straight.

Unlike other package managers, such as “package.el” or “el-get,” “straight” uses a directory structure dedicated to packages, rather than installing them in the Emacs system directory.

This makes it easier to manage dependencies and provides greater system stability and allows, via GIT, the installation of packages not found in ELPA or MELPA.

Below is the configuration of Emacs to use “use-package” and “straight”.

4 Configuring “straight”.

Here is the configuration code to install “straight” in Emacs:

(defvar bootstrap-version)
(let ((bootstrap-file
       (expand-file-name "straight/repos/straight.el/bootstrap.el" user-emacs-directory))
      (bootstrap-version 5))
  (unless (file-exists-p bootstrap-file)
    (with-current-buffer
	(url-retrieve-synchronously
	 "https://raw.githubusercontent.com/raxod502/straight.el/develop/install.el"
	 'silent 'inhibit-cookies)
      (goto-char (point-max))
      (eval-print-last-sexp)))
  (load bootstrap-file nil 'nomessage))

5 Configuration of “use-package”.

The following code includes “use-package” in the configuration:

(straight-use-package 'use-package)

Lastly: code to “force” use-package to use straight.el as package manager:

(use-package straight
  :custom
  (straight-use-package-by-default t))

The above code ensures that “use-package” is always installed using “straight”, even without the string straight t, and enables the use of “use-package” for package configuration.

6 Little example with little analysis.

For example, to install the “magit” package, the configuration can be written as follows:

(use-package magit
  :bind (("C-x g" . magit-status)))

In this example, "“use-package” declares the package “magit”. Also, a quick bind is configured for opening “magit-status” with the C-x g key combination.

As anticipated, it is not necessary to enter the code :straight t having previously “forced” use-package to use such a default handler.

7 List of applications in my configuration file.

After the above configuration part, I add a selection of self-installing applications with the above technique (tested in GNU/Linux distributions Ubuntu, Debian, EndeavourOS):

(use-package markdown-mode
  :mode ("README\\.md\\'" . gfm-mode)
  :init (setq markdown-command "multimarkdown"))

(use-package htmlize
)

(use-package evil
  :bind (("<escape>" . keyboard-escape-quit))
  :config
 (evil-mode 1)
 (setq evil-default-state 'emacs)
 )

(use-package evil-surround
:config
(global-evil-surround-mode 1)
)

(use-package switch-window
;;  :straight t
  :bind 
  ("C-x o" . switch-window)
  ("C-x 1" . switch-window-then-maximize)
  ("C-x 2" . switch-window-then-split-below)
  ("C-x 3" . switch-window-then-split-right)
  ("C-x 0" . switch-window-then-delete)
  ("C-x 4 d" . switch-window-then-dired)
  ("C-x 4 f" . switch-window-then-find-file)
  ("C-x 4 m" . switch-window-then-compose-mail)
  ("C-x 4 r" . switch-window-then-find-file-read-only)
  ("C-x 4 C-f" . switch-window-then-find-file)
  ("C-x 4 C-o" . switch-window-then-display-buffer)
  ("C-x 4 0" . switch-window-then-kill-buffer)
)

(use-package avy
  :bind
    ("C-;" . avy-goto-char)
    ("C-c C-;" . avy-goto-char-2)
    ("M-g w" . avy-goto-word-1)
)


(use-package org
:init
(setq org-log-done t)
(setq org-agenda-files '("~/org"))
:bind
("\C-cl" . org-store-link)
("\C-ca" . org-agenda)
)

(global-set-key (kbd "C-x C-b") 'ibuffer)

8 And now?

Thus, with the same syntax, it is possible to add a virtually infinite set of applications and export the current configuration in a self-installing way simply by copying the related code.

Thank you for your attention.

Originally published at https://francopasut.netlify.app

Comments

Post a Comment

Popular posts from this blog

Vim: searching for text containing a slash or a question mark

Vim: searching for text containing a slash or a question mark Vim: the search command To activate a text search in Vim, press one of the following trigger keys in your keyboard: the slash "/" key (do not confuse with the back-slash "\" key) the question mark key. By pressing the slash "/" key will activate a forward search. By pressing the question mark "/" key will activate a backward search. To move the cursor to the results in your document, press the "n" key (mnemonic for “ next ”). To invert the direction of the cursor, press the "N" key, (“upper n”) . What about if you need to search for a slash or a question mark , i.e. the same trigger characters , in your document? You can prepend the Escape character to the trigger key. The Escape character The Escape character is the back-slash key: "\" . Just an example: if you need to forward search (then with / trigger k...
Read more

Vim: Cut, Copy and Paste to and from the system clipboard

Image
Vim: Cut, Copy and Paste to and from the system clipboard Table of Contents 1. Cut, Copy and Paste using the computer keyboard 2. Vim and the clipboard 3. From Vim to the Clipboard 4. From the Clipboard to Vim 5. Some key shortcuts in gVim Figure 1: Vim 1 Cut, Copy and Paste using the computer keyboard Everybody knows how to use the keyboard combinations Ctrl-c , Ctrl-x , and Ctrl-v in Windows and Linux (or Cmd-c , Cmd-x and Cmd-v in macOS) to copy, cut and paste text across applications. Many think that those combinations are universal and work with any application. But Vim and gVim are different, they use another system to exchange information with the rest of the IT world. For example, in Vim under Linux, the key combination Ctrl-v corresponds to the visual block function and does not affect the pasting text. I wrote this article to remind me, as a non-programmer, the key combinations to be used in the Vim world to sha...
Read more