#pragma section-numbers off
''On August 31st, 2005, the wiki data was deleted.  The latest backup was from August 11th - any changes since then have been lost.  Oops.''

Welcome! to CppUnit Wiki.

= What is CppUnit? =
CppUnit is a C++ unit testing framework. It started its life as a port of
[http://www.junit.org JUnit] to C++ by Michael Feathers. For a quick tour of
unit testing with CppUnit, see
[http://cppunit.sourceforge.net/doc/lastest/cppunit_cookbook.html the Cookbook]
in the latest documentation. For an introduction to unit testing, see
Wiki:UnitTest, Wiki:ProgrammerTest, and Wiki:CodeUnitTestFirst at the
[wiki:Wiki:FrontPage C2.com wiki].

Features:
 * XML output with hooks for additional data (XSL format avaliable in release 1.10.2 needs some FiXing)
 * Compiler-like text output to integrate with an IDE
 * Helper macros for easier test suite declaration
 * Hierarchical test fixture support
 * Test registry to reduce recompilation need
 * Test plug-in for faster compile/test cycle (self testable dynamic library)
 * Protector to encapsulate test execution (allow capture of exception not derived from std::exception)
 * MfcTestRunner
 * QtTestRunner, a Qt based graphic test runner

Features available in the patch section of SourceForgeProject:aaa
 * CursesTestRunner
 * WxWidgetsTestRunner (formerly: WxWindowsTestRunner)

= Online documentation =
 * [http://cppunit.sourceforge.net/doc/lastest/index.html CppUnit 1.10.2] (lastest stable)
 * [http://cppunit.sourceforge.net/doc/1.11.6/ CppUnit 1.11.6] (last dev. snapshot)

= Other documentation =
 * BuildingCppUnit1 (platform-specific build instructions contributed by users)
 * [http://sourceforge.net/forum/forum.php?forum_id=37108 Discussion Forums: Help]
 * [http://sourceforge.net/forum/forum.php?forum_id=37107 Discussion Forums: Open Discussion]
 * FrequentlyAskedQuestions - Frequently Asked Questions (answers always needed!)

User documentation for CppUnit:
 * [http://www.embracetherandom.com/MFCTestRunner/index.htm Using CppUnit's MFCTestRunner with VS 6.0] Guide to getting MfcTestRunner working with VS6. It has images similar to those in the German document below, but they are from an English version of VS6.
 * [http://stud.fbi.fh-darmstadt.de/~apos/de/softwaretechnik/cppunit/docs/CppUnit_GUI_under_VC6_0.html Tips on setting up CppUnit with VC++ 6] Images are in German, but helpful to non-German speakers anyway.
 * Simplified Chinese Document on CppUnit Source Code Analysis [http://www.polyrandom.com/content/view/16//]
 * A CppUnit "Hello, world!" : [http://pantras.free.fr/articles/helloworld.html]
 * Step by step instructions on how to build CppUnit with Eclipse and CDT: CppUnitWithEclipse.

= Download =
It is recommended to download the latest stable version 1.10.2. You can find it
on the [https://sourceforge.net/project/showfiles.php?group_id=11795 SourceForge download page]. Notice: development snapshots have been moved from the web page to the download page for better visibility and easier access.

Link to CppUnit 1.10.2
[http://prdownloads.sourceforge.net/cppunit/cppunit-1.10.2.tar.gz?download source],
[http://prdownloads.sourceforge.net/cppunit/cppunit-docs-1.10.2.tar.gz?download documentation],
and [http://prdownloads.sourceforge.net/cppunit/cppunit-cvs-1.10.2.tar.gz?download a cvs export of the source]
tarballs.

Link to the CVS [http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/*checkout*/cppunit/cppunit/NEWS?rev=HEAD&content-type=text/plain What's News] file.

= CVS =
You can get the most recent source from CVS. See instructions in the CVS tab of the SourceForgeProject page about accessing the CVS repository.

Alternatively, if you are behind a strict firewall, you can download the  [http://cvs.sourceforge.net/cvstarballs/cppunit-cvsroot.tar.bz2 nightly backup tarball] of the CVS repository (about 1.2Mo). You'll need to install it as a local CVS repository to use it.

= The Future =
A set of documents (features, todo...) concerning CppUnit 2 can be found at the following url: http://cppunit.sourceforge.net/cppunit2/.  

There is a page for CppUnit2 discussions.

= CppUnit Wiki =
Information about this Wiki:

 * RecentChanges: see where people are currently working
 * HelpForBeginners: to get you going. Specifically, help on wiki, not on CppUnit
 * WikiSandBox: feel free to change this page and experiment with editing
 * FindPage: search or browse the database in various ways...

= This wiki =
Backups of this wiki are done on a nightly basis (around midnight UTC) and can be
downloaded from [http://cppunit.sourceforge.net/backup/]. ''It appears the backups are out-of-date...''

See MoinMoin:SourceForge for information and tips on installing your own SourceForge wiki.

= IRC =
 * irc://irc.freenode.org/cppunit/, An IRC channel to discuss CppUnit and get help.
