Unit tests and demos

[apjanke]

This package could use some tests (BISTs). For a bunch of stuff; there are hardly any tests at all.

Some demos would be nice too, both for demonstration purposes, and as a form of test.

[apjanke]

Actually, I maybe want to wait until I can do this in Matlab Unit Test framework style. The code for the tests is going to be too long to fit comfortably in BISTs.

[apjanke]

For 0.3.0, we'll do executable examples in lieu of a bunch of stuff explicitly structured as tests.

[apjanke]

Ah, looks like there's a pkg test <package> command now.

Minor bummer: it requires the package to actually be installed; you can't just run it on an inst/ directory you have on your path, AFAICT.

It calls __run_test_suite__ with a special argument pointing at the directory. Maybe I can do that directly. Looks like __run_test_suite__ ({'/Users/janke/repos/octave-tablicious/inst'}, {}) works.

          printf ("Testing functions in package '%s':\n", files{i});
          installed_pkgs_dirs = {installed_pkgs_lst{i}.dir, ...
                                 installed_pkgs_lst{i}.archprefix};
          installed_pkgs_dirs = ...
            installed_pkgs_dirs (! cellfun (@isempty, installed_pkgs_dirs));
          ## For local installs installed_pkgs_dirs contains the same subdirs
          installed_pkgs_dirs = unique (installed_pkgs_dirs);
          if (! isempty (installed_pkgs_dirs))
            ## FIXME invoke another test routine once that is available.
            ## Until then __run_test_suite__.m will do the job fine enough
            __run_test_suite__ ({installed_pkgs_dirs{:}}, {});
          endif

Bigger bummer: it doesn't find any of my BISTs.

>> pkg test tablicious
Testing functions in package 'tablicious':

Integrated test scripts:


Fixed test scripts:


Summary:

  PASS                                0
  FAIL                                0

See the file /Users/janke/fntests.log for additional details.

278 (of 278) .m files have no tests.

Please help improve Octave by contributing tests for these files
(see the list in the file /Users/janke/fntests.log).

>>

[apjanke]

Okay, looks like oruntests() is the new version of runtests(). Probably just renamed for Matlab compatibility.

Reason the BISTs weren't being picked up is because they used #! prefixes instead of %!, and they need to be %!. Fixed in 62f6f9e.

You can now run the test suite with oruntests, and the few BISTs we have are passing. Now just need to write some more of them. Leaving this ticket open for that.