View License

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video

Highlights from
Doctest - embed testable examples in your function's help comments

5.0 | 1 rating Rate this file 3 Downloads (last 30 days) File Size: 18 KB File ID: #28862 Version: 1.1

Doctest - embed testable examples in your function's help comments



27 Sep 2010 (Updated )

Put a usage example in the help of your function, then test it to make sure it still works over time

| Watch this File

File Information

Unit testing is great, but it can seem like overkill to make a whole new file for every test you want to run. Doctest allows you to embed tests in the documentation of your function (or class or method), so that they're in the same file as the code they test. They can also be valuable demonstrations of how to call your code.

Say you have a function that adds 3 to any numbers you give it. Let's add a doctest:

function sum = add3(value)
% adds 3 to a number
% add3(value)
% returns (value + 3)
% Examples:
% >> add3(7)
% ans =
% 10
% >> add3([2 4])
% ans =
% 5 7
if ~ isnumeric(value)
    error('add3(value) requires value to be a number');

sum = value + 3;

Put that in "add3.m".
Now we can run "doctest add3", and we'll get this:

TAP version 13
ok 1 - "add3(7)"
ok 2 - "add3([2 4])"

This tells you that your examples work correctly. Now, if you accidentally change the function so that it adds 10^30 instead of 3, the next time you run your tests you'll quickly find the problem. Yay testing!

Other features --- wildcard support for output that *should* change --- test functions, classes, and methods --- handles exceptions, see if you correctly catch an error --- uses a standard output format ( ) --- easy to write examples, just cut+paste from command window

This function is inspired by the Python doctest module:

The newest version can always be obtained at , where there is also a bug tracker if you have any issues. Contributions are also welcome!


M Unit: A Unit Testing Framework In Matlab and Mlunit 2008a inspired this file.

MATLAB release MATLAB 7.10 (R2010a)
Tags for This File   Please login to tag files.
Please login to add a comment or rating.
Comments and Ratings (1)
07 Mar 2014 Rody Oldenhuis

Rody Oldenhuis (view profile)

Awesome tool, thanks!

28 Sep 2010 1.1

Added a note that the bug tracker is available, and invited to contribute

Contact us