ESUP - Emacs Start Up Profiler
Benchmark Emacs Startup time without ever leaving your Emacs.
Known to work with GNU Emacs 25.1 and later. Esup may work with older versions of Emacs, but this is NOT guaranteed. Bug reports for problems related to using Esup with older versions of Emacs will most like not be addressed.
The master of all the material is the Git repository at https://github.com/jschaf/esup .
master branch will always contain the latest unstable version. If
you wish to check older versions or formal, tagged release, please switch to the
Add MELPA or MELPA Stable to the list of repositories to access this mode. MELPA tracks this Git repository and updates relatively soon after each commit or formal release. For more detail on setting up see MELPA Getting Started.
For those who want only formal, tagged releases use MELPA Stable:
(require 'package) (add-to-list 'package-archives '("melpa-stable" . "https://stable.melpa.org/packages/") t) (package-initialize)
For those who want rolling releases as they happen use MELPA:
(require 'package) (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t) (package-initialize)
After initializing packaging system you can install Esup using preferred way:
Use M-x package-refresh-contents and M-x
package-list-packages to get to the package listing and install
You can install
esup manually by adding following to your init file:
(unless (package-installed-p 'esup) (package-refresh-contents) (package-install 'esup))
Add following to your Cask file:
(source melpa) (depends-on "esup")
Add following to your init file:
(use-package esup :ensure t ;; To use MELPA Stable use ":pin mepla-stable", :pin melpa :commands (esup))
Esup is included in the El-Get repository. To install Esup using El-Get:
M-x el-get-install RET esup RET
Another way is to create a recipe file
esup.rcp as follows:
(:name esup :website "https://github.com/jschaf/esup" :description "Emacs Start Up Profiler" :type github :pkgname "jschaf/esup")
and add it to a directory present in
el-get-recipe-path. Then, use M-x
el-get-install RET esup or add:
to your init file.
Download Esup and place the download directory on your
load-path like so:
(add-to-list 'load-path "~/.emacs.d/path/to/esup")
And add either of the two following lines to your initialization file. The first only loads Esup when necessary, the 2nd always during startup of GNU Emacs.
(autoload 'esup "esup" "Emacs Start Up Profiler." nil) ;; OR (require 'esup)
To start Esup, run M-x esup, and watch the magic happen.
Profile a custom file with esup
By default, Esup will profile
user-init-file. To profile a custom file, call
esup with a prefix argument. That is, C-u M-x esup.
Patches are always welcome. To submit a patch, use something like the following workflow.
- Clone the project:
git clone https://github.com/jschaf/esup.git cd esup git checkout -b MY-NEW-FIX
Implement your fix
Ensure that all elisp code is lint-clean with Flycheck
Test your fix with Cask
Test your fixes with the Emacs Regression Test runner
- Create a pull request with the normal GitHub user interface