Elpy is an extension for the Emacs text editor to work with Python projects. This documentation tries to explain how to use Elpy to work on Python project using Emacs, but it does not aim to be an introduction to either Emacs or Python.
You can read a quick tour of Emacs, or read the built-in tutorial
C-h t in the editor. That is, you hold down the
control key and hit
h (the canonical help key in Emacs),
release both, and hit
t (for tutorial).
Once you have these basics, you can go on to install Elpy.
The main Elpy package is installed via the Emacs package interface,
package.el. First, you have to add Elpy’s package archive to your
list of archives, though. Add the following code to your
file and restart Emacs:
(require 'package) (add-to-list 'package-archives '("elpy" . "http://jorgenschaefer.github.io/packages/"))
Now you can run M-x package-refresh-contents to download a fresh
copy of the archive contents, and
M-x package-install RET elpy RET
to install elpy. If you want to enable Elpy by default, you can simply
add the following to your .emacs:
Congratulations, Elpy is now successfully installed!
In order to use all the features (such as navigation with
you’ll need to install some python libraries. You can do that easily
M-x elpy-config RET, and following the instructions.