source: src/documentation/tests/unit-tests.dox@ 936a02

Action_Thermostats Add_AtomRandomPerturbation Add_FitFragmentPartialChargesAction Add_RotateAroundBondAction Add_SelectAtomByNameAction Added_ParseSaveFragmentResults AddingActions_SaveParseParticleParameters Adding_Graph_to_ChangeBondActions Adding_MD_integration_tests Adding_ParticleName_to_Atom Adding_StructOpt_integration_tests AtomFragments Automaking_mpqc_open AutomationFragmentation_failures Candidate_v1.5.4 Candidate_v1.6.0 Candidate_v1.6.1 ChangeBugEmailaddress ChangingTestPorts ChemicalSpaceEvaluator CombiningParticlePotentialParsing Combining_Subpackages Debian_Package_split Debian_package_split_molecuildergui_only Disabling_MemDebug Docu_Python_wait EmpiricalPotential_contain_HomologyGraph EmpiricalPotential_contain_HomologyGraph_documentation Enable_parallel_make_install Enhance_userguide Enhanced_StructuralOptimization Enhanced_StructuralOptimization_continued Example_ManyWaysToTranslateAtom Exclude_Hydrogens_annealWithBondGraph FitPartialCharges_GlobalError Fix_BoundInBox_CenterInBox_MoleculeActions Fix_ChargeSampling_PBC Fix_ChronosMutex Fix_FitPartialCharges Fix_FitPotential_needs_atomicnumbers Fix_ForceAnnealing Fix_IndependentFragmentGrids Fix_ParseParticles Fix_ParseParticles_split_forward_backward_Actions Fix_PopActions Fix_QtFragmentList_sorted_selection Fix_Restrictedkeyset_FragmentMolecule Fix_StatusMsg Fix_StepWorldTime_single_argument Fix_Verbose_Codepatterns Fix_fitting_potentials Fixes ForceAnnealing_goodresults ForceAnnealing_oldresults ForceAnnealing_tocheck ForceAnnealing_with_BondGraph ForceAnnealing_with_BondGraph_continued ForceAnnealing_with_BondGraph_continued_betteresults ForceAnnealing_with_BondGraph_contraction-expansion FragmentAction_writes_AtomFragments FragmentMolecule_checks_bonddegrees GeometryObjects Gui_Fixes Gui_displays_atomic_force_velocity ImplicitCharges IndependentFragmentGrids IndependentFragmentGrids_IndividualZeroInstances IndependentFragmentGrids_IntegrationTest IndependentFragmentGrids_Sole_NN_Calculation JobMarket_RobustOnKillsSegFaults JobMarket_StableWorkerPool JobMarket_unresolvable_hostname_fix MoreRobust_FragmentAutomation ODR_violation_mpqc_open PartialCharges_OrthogonalSummation PdbParser_setsAtomName PythonUI_with_named_parameters QtGui_reactivate_TimeChanged_changes Recreated_GuiChecks Rewrite_FitPartialCharges RotateToPrincipalAxisSystem_UndoRedo SaturateAtoms_findBestMatching SaturateAtoms_singleDegree StoppableMakroAction Subpackage_CodePatterns Subpackage_JobMarket Subpackage_LinearAlgebra Subpackage_levmar Subpackage_mpqc_open Subpackage_vmg Switchable_LogView ThirdParty_MPQC_rebuilt_buildsystem TrajectoryDependenant_MaxOrder TremoloParser_IncreasedPrecision TremoloParser_MultipleTimesteps TremoloParser_setsAtomName Ubuntu_1604_changes stable
Last change on this file since 936a02 was 750cff, checked in by Frederik Heber <heber@…>, 13 years ago

HUGE: Update on documenation.

  • a general skeleton of the documentation is now in place with all the major components of MoleCuilder explained to some extent.
  • some information has been transfered from TRAC (e.g. install procecure) into this doxygen documentation where it is general and not specific to the situation at our institute.
  • Property mode set to 100644
File size: 3.9 KB
Line 
1/*
2 * Project: MoleCuilder
3 * Description: creates and alters molecular systems
4 * Copyright (C) 2010 University of Bonn. All rights reserved.
5 * Please see the LICENSE file or "Copyright notice" in builder.cpp for details.
6 */
7
8/**
9 * \file unit-tests.dox
10 *
11 * Created on: Oct 28, 2011
12 * Author: heber
13 */
14
15/**
16 * \page unittest "Unit test"
17 *
18 * Unit tests are done via the CppUnit framework (http://cppunit.sourceforge.net/doc/1.8.0/).
19 *
20 * \section unittest-structure Directory structure
21 *
22 * Unit tests are always located in a subfolder \b unittests of the component
23 * that they test, e.g. if checking one of the Parsers, then its unit test
24 * resides in \b src/Parser/unittests.
25 *
26 * \section unittest-launch-all Launching all tests
27 *
28 * All unit tests can be launched as follows:
29 * -# Enter the build directory
30 * -# Enter \b src/unittests
31 * -# Run
32 * \code make check
33 * \endcode
34 *
35 * This will run all present unit tests one after the other.
36 *
37 * \section unittest-launch-some Launching some tests
38 *
39 * If only some of the tests should be checked, then they have to be launched by
40 * hand via entering the same directory as in the section before and e.g.
41 * \code
42 * ./AnalysisBondsUnitTest
43 * \endcode
44 * Note that to allow for debugging of the unit tests, one has to prepend the
45 * executable as follows:
46 * \code
47 * libtool --mode=execute gdb --args ./AnalysisBondsUnitTest
48 * \endcode
49 * As we use libtool to take care of shared libraries the executables in
50 * \b src/unittests are just scripts. The true executables hide in another
51 * subfolder \b .libs. The scripts set environment variables such that shared
52 * libraries, which have not been installed so far, are found.
53 *
54 * \section unittest-results Inspecting results
55 *
56 * Results of the test are shown during run. An \a Ok(2) indicates that
57 * two tests for the single launched testsuite passed.
58 *
59 * \section unittest-add Adding new tests
60 *
61 * \attention Name convention of files, (no spaces, use CamelCase) e.g.
62 * \b AnalysisBondsUnitTest
63 * - the unit test module should be called as follows:
64 * -# either the name of the component or the module
65 * -# followed by UnitTest.
66 * - the test class should be called as follows:
67 * -# the name of the class it tests
68 * -# followed by Test.
69 *
70 * Adding a new test is as easy as this:
71 * -# Create a new module for declaration and definition of the unit test
72 * in a suitable \b unittests subfolder (see above on policy and naming).
73 * Check out one of the present unit tests and rename, but beware of
74 * copy&paste errors!
75 * -# Add the test to the \b Makefile.am contained in \b unittests.
76 *
77 * If there is not yet a \b unittests folder:
78 * -# Create a new \b Makefile.am, check out one of the present ones to get
79 * an idea, below is a small list of contained elements. Note that the
80 * variable must begin with a unique name as all Makefile.am on unit tests
81 * are included into one big Makefile.am in \b src/unittests.
82 * -# Add your ...SOURCES and ...HEADERS to TESTSOURCES and TESTHEADERS.
83 * -# Add an include directive to \b src/unittests/Makefile.am of this
84 * newly created \b Makefile.am.
85 *
86 * What's contained in the \b Makefile.am:
87 * -# ...SOURCES and ...HEADERS gathering all source and header files in this
88 * \b unittests folder (this is needed for the test program that contains
89 * all unit test in one executable).
90 * -# ...TESTS gathering all test programs in this \b unittests folder.
91 * -# ...TESTS is added to TESTS, check_PROGRAMS, noinst_PROGRAMS such that
92 * it is known that they are just tests, programs for \a make \a check and
93 * are not to be installed.
94 * -# ...LIBS gathers general libs that all of the tests in this \b unittests
95 * folder share.
96 * -# for each unit test:
97 * -# ...SOURCES gathers all source files that are required for the test.
98 * -# ...LDADD gathers all libs that are required for compilation.
99 *
100 *
101 * \date 2011-10-31
102 *
103 */
Note: See TracBrowser for help on using the repository browser.