pycoverage.el

An emacs mode for reporting on coverage stats for python 2.x

Dependencies

Coverage reporter for Python:

• coverage.py (currently we only support this)
• figleaf (support pending)
• nose (there is limited supported for testing a method/function using nose)

Installation

Put something like this in your .emacs:

(load-file "/home/matt/work/emacs/pycoverage/pycov2.el")
(require 'linum)
(require 'pycov2)
(add-hook 'python-mode-hook
          (function (lambda ()
                      (pycov2-mode)
                      (linum-mode))))

Install cov2emacs using setuptools or virtualenv or distutils

There should be .coverage file in the directory of the module you want coverage reporting on (or the parents of that directory). If no coverage file is found, you may specify one useing pycov2-rerun. Note that if your file has been modified later than the .coverage file, it will be considered as stale and ignore it.

Running

M-x pycov2-mode

Ideal Usage

If there is a .coverage file in the directory (or a parent) of the source file try to use it for coverage information. Red highlights mean that lines were missed (Coverage percent for file is in mode line). Orange means .coverage file is missing or OLD. Purple means the cov2emacs file is not found, you need to put it in PATH or set pycov2-cov2emacs-cmd.

pycov2-rerun will re-run the coverage stats for .coverage file located elsewhere.

pycov2-test-function (not implemented) will try to find tests for that function and run them.

Todo

• Make invalidate data when you save file!

• Make it work! Semi-DONE

• Use flymake mode instead of/in combination with compile mode? - Initial Flymake DONE

• Use missing line numbers instead of covered lines - DONE for coverage.py

• Make pycoverage-load-report look for a .coverage file recursively up the parents of the file - DONE

• Make cov2emacs accept location of .coverage file - DONE

• Make report use normal coverage.py text output, since it's a little friendlier on the eyes (instead of reporting for every group of lines in a file)

• Put status in modeline - DONE * Number - current coverage % * OLD - dirty * ? - no .coverage file available

  Note that if coverage file has not been specified (pycov2-rerun) it will skip over old .coverage files it finds (see .cov2emacs.log)

  • ERR - Error (see messages)

• Figleaf support

• Nose integration?

Thanks

• rcov - for code to start from