src/packages.lisp

   1 ;; -*- lisp -*-
   2
   3 ;;;; * Introduction
   4
   5 ;;;; FiveAM is a testing framework. It takes care of all the boring
   6 ;;;; bookkeeping associated with managing a test framework allowing
   7 ;;;; the developer to focus on writing tests and code.
   8
   9 ;;;; FiveAM was designed with the following premises:
  10
  11 ;;;; - Defining tests should be about writing tests, not
  12 ;;;; infrastructure. The developer should be able to focus on what
  13 ;;;; they're testing, not the testing framework.
  14
  15 ;;;; - Interactive testing is the norm. Common Lisp is an interactive
  16 ;;;; development environment, the testing environment should allow the
  17 ;;;; developer to quickly and easily redefine, change, remove and run
  18 ;;;; tests.
  19
  20 (defpackage :it.bese.FiveAM
  21   (:use :common-lisp :it.bese.arnesi)
  22   (:nicknames :5am)
  23   (:export ;; creating tests and test-suites
  24            #:make-suite
  25            #:def-suite
  26            #:in-suite
  27            #:make-test
  28            #:test
  29            #:get-test
  30            #:rem-test
  31            ;; fixtures
  32            #:make-fixture
  33            #:def-fixture
  34            #:with-fixture
  35            #:get-fixture
  36            #:rem-fixture
  37            ;; running checks
  38            #:is
  39            #:is-true
  40            #:is-false
  41            #:signals
  42            #:finishes
  43            #:skip
  44            #:pass
  45            #:fail
  46            #:*test-dribble*
  47            #:for-all
  48            #:gen-integer
  49            #:gen-float
  50            #:gen-character
  51            #:gen-string
  52            #:gen-list
  53            ;; running tests
  54            #:run
  55            #:run-all-tests
  56            #:explain
  57            #:explain!
  58            #:run!
  59            #:!
  60            #:!!
  61            #:!!!
  62            #:*run-test-when-defined*
  63            #:*debug-on-error*
  64            #:*debug-on-failure*
  65            #:*verbose-failures*))
  66
  67 ;;;; You can use #+5am to put your test-defining code inline with your
  68 ;;;; other code - and not require people to have fiveam to run your
  69 ;;;; package.
  70
  71 (pushnew :5am *features*)
  72
  73 ;;;;@include "check.lisp"
  74
  75 ;;;;@include "random.lisp"
  76
  77 ;;;;@include "fixture.lisp"
  78
  79 ;;;;@include "test.lisp"
  80
  81 ;;;;@include "suite.lisp"
  82
  83 ;;;;@include "run.lisp"
  84
  85 ;;;;@include "explain.lisp"
  86
  87 ;;;; * Colophon
  88
  89 ;;;; This documentaion was written by Edward Marco Baringer
  90 ;;;; <mb@bese.it> and generated by qbook.
  91
  92 ;;;; ** COPYRIGHT
  93
  94 ;;;; Copyright (c) 2002-2003, Edward Marco Baringer
  95 ;;;; All rights reserved.
  96
  97 ;;;; Redistribution and use in source and binary forms, with or without
  98 ;;;; modification, are permitted provided that the following conditions are
  99 ;;;; met:
 100
 101 ;;;;  - Redistributions of source code must retain the above copyright
 102 ;;;;    notice, this list of conditions and the following disclaimer.
 103
 104 ;;;;  - Redistributions in binary form must reproduce the above copyright
 105 ;;;;    notice, this list of conditions and the following disclaimer in the
 106 ;;;;    documentation and/or other materials provided with the distribution.
 107
 108 ;;;;  - Neither the name of Edward Marco Baringer, nor BESE, nor the names
 109 ;;;;    of its contributors may be used to endorse or promote products
 110 ;;;;    derived from this software without specific prior written permission.
 111
 112 ;;;; THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 113 ;;;; "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 114 ;;;; LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 115 ;;;; A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
 116 ;;;; OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 117 ;;;; SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 118 ;;;; LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 119 ;;;; DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 120 ;;;; THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 121 ;;;; (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 122 ;;;; OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE