[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
2.1 Functions and Variables for Bug Detection and Reporting |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Run the Maxima test suite. Tests producing the desired answer are considered "passes," as are tests that do not produce the desired answer, but are marked as known bugs.
run_testsuite
takes the following optional keyword arguments
Display all tests. Normally, the tests are not displayed, unless the test
fails. (Defaults to false
).
Displays tests that are marked as known bugs. (Default is false
).
This is a single test or a list of tests that should be run. Each test can be specified by
either a string or a symbol. By default, all tests are run. The complete set
of tests is specified by testsuite_files
.
Display time information. If true
, the time taken for each
test file is displayed. If all
, the time for each individual
test is shown if display_all
is true
. The default is
false
, so no timing information is shown.
For example run_testsuite(display_known_bugs = true, tests=[rtest5])
runs just test rtest5
and displays the test that are marked as
known bugs.
run_testsuite(display_all = true, tests=["rtest1", rtest1a])
will
run tests rtest1
and rtest2
, and displays each test.
run_testsuite
changes the Maxima environment.
Typically a test script executes kill
to establish a known environment
(namely one without user-defined functions and variables)
and then defines functions and variables appropriate to the test.
run_testsuite
returns done
.
@ref{Category: Debugging}
testsuite_files
is the set of tests to be run by
run_testsuite
.
It is a list of names of the files containing
the tests to run. If some of the tests in a file are known to fail,
then instead of listing the name of the file, a list containing the
file name and the test numbers that fail is used.
For example, this is a part of the default set of tests:
["rtest13s", ["rtest14", 57, 63]]
This specifies the testsuite consists of the files "rtest13s" and "rtest14", but "rtest14" contains two tests that are known to fail: 57 and 63.
@ref{Category: Debugging} · @ref{Category: Global variables}
Prints out Maxima and Lisp version numbers, and gives a link
to the Maxima project bug report web page.
The version information is the same as reported by build_info
.
When a bug is reported, it is helpful to copy the Maxima and Lisp version information into the bug report.
bug_report
returns an empty string ""
.
@ref{Category: Debugging}
Returns a summary of the parameters of the Maxima build,
as a Maxima structure (defined by defstruct
).
The fields of the structure are:
version
, timestamp
, host
, lisp_name
, and lisp_version
.
When the pretty-printer is enabled (via display2d
),
the structure is displayed as a short table.
See also bug_report
.
Examples:
(%i1) build_info (); (%o1) Maxima version: "5.26.0_16_gb72c64c_dirty" Maxima build date: "2012-01-29 12:29:04" Host type: "i686-pc-linux-gnu" Lisp implementation type: "CMU Common Lisp" Lisp implementation version: "CVS release-19a 19a-release-20040728 + minimal debian patches" (%i2) x : build_info ()$ (%i3) x@version; (%o3) 5.26.0_16_gb72c64c_dirty (%i4) x@timestamp; (%o4) 2012-01-29 12:29:04 (%i5) x@host; (%o5) i686-pc-linux-gnu (%i6) x@lisp_name; (%o6) CMU Common Lisp (%i7) x@lisp_version; (%o7) CVS release-19a 19a-release-20040728 + minimal debian patches (%i8) x; (%o8) Maxima version: "5.26.0_16_gb72c64c_dirty" Maxima build date: "2012-01-29 12:29:04" Host type: "i686-pc-linux-gnu" Lisp implementation type: "CMU Common Lisp" Lisp implementation version: "CVS release-19a 19a-release-20040728 + minimal debian patches"
@ref{Category: Debugging}
[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated by landry on March, 11 2015 using texi2html 1.76.