Skip to content

phillord/assess

Repository files navigation

Assess

Assess provides additional support for testing Emacs packages.

It provides:

  • a set of predicates for comparing strings, buffers and file contents.
  • explainer functions for all predicates giving useful output
  • macros for creating many temporary buffers at once, and for restoring the buffer list.
  • methods for testing indentation, by comparison or "roundtripping".
  • methods for testing fontification.

Assess aims to be a stateless as possible, leaving Emacs unchanged whether the tests succeed or fail, with respect to buffers, open files and so on; this helps to keep tests independent from each other.

Documentation

Assess is fully documented. Documentation is written and generating using the lentic-doc documentation system. It is also possible to generate the documentation locally:

M-x package-install lentic-server
M-x lentic-server-browse

Status

The core of assess should now be considered stable and may be actively used.

Assess supports runs all of the Emacs-24 series, Emacs-25 and Emacs-26 (to be). I will maintain support for older Emacs as far back as I am easily able to compile or run older versions; currently this is Emacs-24.1.

Roadmap

I plan to move this to core Emacs, as ert-assess. This will happen after Emacs-25.1 release.

Release

Version 0.5

This release mostly changes internal implementation details. Specifically, the original use of "types" has been removed. Functions such as assess-file now return strings.

Version 0.4

This release features the first feature added by an external contributor (thanks to Matus Goljer and Damien Cassou). Assess now also supports the entire Emacs-24 series, after several requests; that this was possible was largely, if indirectly, due to Nicolas Petton's seq.el supporting all these versions

Features

  • All of Emacs-24 series now supported.
  • assess-with-filesystem enables creation of a temporary file hierarchy.

Bug Fixes

  • assess-with-preserved-buffer-list now kills even file associated buffers at the end of the form.

Version 0.3.2

Fix Version Number

Version 0.3.1

Add test, fix keybinding

Version 0.3

Add assess-robot.el

Version 0.2

Add assess-call.el

Version 0.1

First Release

Build Status