Emacs mode for searching python documents with convenience
Clone or download
Latest commit 2be9aeb Aug 19, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore - update readme Dec 5, 2011
Makefile support both python2/3 Aug 19, 2018
README.md update readme Aug 19, 2018
pylookup.el support both python2/3 Aug 19, 2018
pylookup.py support both python2/3 Aug 19, 2018



Taesoo Kim (taesoo@mit.edu)

Michael Markert (markert.michael@gmail.com) Austin Bingham (austin.bingham@gmail.com) Takafumi Arakaki aka.tkf@gmail.com


Pylookup stole idea from 'http://furius.ca/haddoc', one of my favorite emacs mode for python documentation lookup. I reimplemented python code and elisp code not just to support new version of python 2.7 but also to extend it for other documentation lookup interfaces with easy. Importantly, pylookup mode is much faster and supports fancy highlighting.

Please check, Web : http://taesoo.org/proj/pylookup.html Repo : http://github.com/tsgates/pylookup


Create database

You can browse python documents from either online or offline. Since I prefer offline, here is an easy step:

 make build

It will download python documents, and construct database for you. If you get in any trouble, follow the below steps manually:

  1. Download your own version of python document (e.g., http://docs.python.org/archives/python-2.7.2-docs-html.zip)
  2. Unzip: 'unzip python-2.7.2-docs-html.zip'
  3. Index: './pylookup.py -u python-2.7.1-docs-html'
  4. Test : './pylookup.py -l ljust'

(see updateing database section for more options)


Here is lisp part for emacs.

  • [PATH] parameter depends on your environment (i.e. "~/.emacs.d/pylookup")
;; add pylookup to your loadpath, ex) ~/.emacs.d/pylookup
(setq pylookup-dir "[PATH]")
(add-to-list 'load-path pylookup-dir)

;; load pylookup when compile time
(eval-when-compile (require 'pylookup))

;; set search option if you want
;; (setq pylookup-search-options '("--insensitive" "0" "--desc" "0"))

;; to speedup, just load it on demand
(autoload 'pylookup-lookup "pylookup"
  "Lookup SEARCH-TERM in the Python HTML indexes." t)

Updating Databases

You can easily accumulate many sources into single database. For example, you can index python and scipy at the same time. Here are the examples:

You probably like to type './pylookup.py -h' to see more options.