wxWidgets/build/bakefiles
Vadim Zeitlin e70fc11ef1 Replace CppUnit with Catch for unit tests
Drop the legacy CppUnit testing framework used for the unit tests.
Replacing it with Catch has the advantage of not requiring CppUnit
libraries to be installed on the system in order to be able to run
tests (Catch is header-only and a copy of it is now included in the
main repository itself) and, in the future, of being able to write
the tests in a much more natural way.

For now, however, avoid changing the existing tests code as much as
[reasonably] possible to avoid introducing bugs in them and provide
the CppUnit compatibility macros in the new wx/catch_cppunit.h header
which allow to preserve the 99% of the existing code unchanged. Some
of the required changes are:

 - Decompose asserts using "a && b" conditions into multiple asserts
   checking "a" and "b" independently. This would have been better
   even with CppUnit (to know which part of condition exactly failed)
   and is required with Catch.

 - Use extra parentheses around such conditions when they can't be
   easily decomposed in the arrays test, due to the use of macros.
   This is not ideal from the point of view of messages given when
   the tests fail but will do for now.

 - Rewrite asserts using "a || b" as a combination of condition
   checks and assert macros. Again, this is better anyhow, and is
   required with Catch. Incidentally, this allowed to fix a bug in
   the "exec" unit test which didn't leave enough time for the new
   process to be launched before trying to kill it.

 - Remove multiple CPPUNIT_TEST_SUITE_NAMED_REGISTRATION() macros,
   our emulation of this macro can be used only once.

 - Provide string conversions using Catch-specific StringMaker for
   a couple of types.

 - Replace custom wxImage comparison with a Catch-specific matcher
   class.

 - Remove most of test running logic from test.cpp, in particular don't
   parse command line ourselves any longer but use Catch built-in
   command line parser. This is a source of a minor regression:
   previously, both "Foo" and "FooTestCase" could be used as the name of
   the test to run, but now only the latter is accepted.
2017-11-02 01:53:16 +01:00
..
wxpresets Use HTTPS with Trac links. 2017-07-04 13:15:14 -06:00
Bakefiles.bkgen Revert "Manage VC[789] project files with upmake too" 2016-03-05 15:34:45 +01:00
build_cfg.bkl Remove all mentions of msevc4prj from bakefiles 2015-10-07 18:14:55 +02:00
common_samples_intree.bkl Fix resource compiler include path for Borland. 2014-10-11 16:30:00 +00:00
common_samples_outoftree.bkl Merge wxQT branch into the trunk. 2014-08-24 01:50:11 +00:00
common_samples.bkl Remove all lines containing cvs/svn "$Id$" keyword. 2013-07-26 16:02:46 +00:00
common.bkl Fix building with WebKit2GTK+ 2017-06-05 23:34:18 -04:00
config.bkl Replace CppUnit with Catch for unit tests 2017-11-02 01:53:16 +01:00
expat.bkl Remove MS-DOS source files. 2015-08-26 21:09:41 +02:00
files.bkl Extract wxPenInfoBase in a separate header 2017-09-10 01:24:16 +02:00
jpeg.bkl
mac_bundles.bkl Remove all lines containing cvs/svn "$Id$" keyword. 2013-07-26 16:02:46 +00:00
make_dist.mk Remove Windows CE support 2015-09-23 00:52:30 +02:00
monolithic.bkl Fix building with WebKit2GTK+ 2017-06-05 23:34:18 -04:00
multilib.bkl Fix building with WebKit2GTK+ 2017-06-05 23:34:18 -04:00
opengl.bkl Remove all lines containing cvs/svn "$Id$" keyword. 2013-07-26 16:02:46 +00:00
plugins_deps.bkl Remove all lines containing cvs/svn "$Id$" keyword. 2013-07-26 16:02:46 +00:00
plugins.bkl Limit the use of "webkit2_ext" to autoconf only in bakefiles 2017-05-15 23:40:08 +02:00
png.bkl
README Remove (Open)Watcom support. 2014-05-16 13:01:06 +00:00
regex.bkl Remove Windows CE support 2015-09-23 00:52:30 +02:00
scintilla.bkl Upgrade Scintilla component to 3.7.2 2017-02-12 19:56:21 +01:00
tiff.bkl Remove Windows CE support 2015-09-23 00:52:30 +02:00
version.bkl Update version to 3.1.1 2016-03-03 23:23:06 +01:00
wx.bkl Update to bakefile 0.2.11 and rebake everything 2017-10-21 17:42:30 +02:00
wxwin.py Only link webview library with libwebkitgtk in wxGTK, not the core one. 2014-10-16 13:33:08 +00:00
zlib.bkl Remove all mentions of msevc4prj from bakefiles 2015-10-07 18:14:55 +02:00

This directory contains Bakefile (see http://bakefile.sourceforge.net)
files needed to generate native makefiles for wxWidgets library and
samples.

Use the bakefile_gen utility to regenerate the makefiles (run it in this
directory!). If you run it with no arguments, it will generate all makefiles
that are not up to date.

Use "bakefile_gen -c" to clean generated files.

You can generate or clean only subset of files by specifying -f or -b flags
when invoking bakefile_gen. For example, "bakefile_gen -fborland,msvc" will
only regenerate Borland C++ and MSVC makefiles. -b flag limits
regeneration only to specified bakefiles. For example,
"bakefile_gen -b wx.bkl" will only regenerate main library makefiles.
"bakefile_gen -b "../../samples/html/*/*.bkl" will regenerate makefiles for
all wxHTML samples. -b and -f can be combined.

You can customize the process of generating makefiles by adding file
Bakefiles.local.bkgen (same format as Bakefiles.bkgen) with further settings.
For example, you may disable output for compilers you don't use:
   <?xml version="1.0" ?>
   <bakefile-gen>
     <disable-formats>msvc,msvs2003prj</disable-formats>
   </bakefile-gen>

Note: bakefile_gen creates file .bakefile_gen.state with dependencies
information. This file can be safely deleted, but it contains valuable
information that speed up regeneration process.

Note: the following files are generated using bakefile_gen:
  * build/msw/*
  * makefiles with same names as makefiles in above dirs, Makefile.in files 
    that contain "This makefile was generated by Bakefile" banner and
    VC++ project files in samples, demos and utils directories
  * src/wxWindows.dsp
  * autoconf_inc.m4
  * all Makefile.in files
  (hopefully I didn't forget anything - VS)