cpptraining.UsingBoostWithMingwAndEclipse

Overview

Now that you’ve successfully build boot, it is finally time to use it in a project.

Overview of the Steps

Create an Eclipse project
Configure the project to use CppUTest
Configure the project to use Boost

title: cpptraining.SettingUpInitialProject —

Setting up Initial Project

Start Eclipse and create a new workspace. I’ll usec:\workspaces\firstexample for my workspace.
Close the welcome screen.
Create a new C++ project (File:New:C++ Project).
Enter a name, I’ll useCppUTestHasItsSmoke
UnderExecutable, selectHello World C++ Project
ClickFinish.
Right-click on your project (CppUTestHasItsSmoke), selectRun As:Local C++ Application
Notice the output in the console:

!!!Hello World!!!

title: cpptraining.ConfiguringTheProjectForCppUTest —

Configuring the Project for CppUTest

Edit your project’s properties (right-click, properties)
SelectC/C++ Build:Settings #include Directories
UnderGCC C++ Compiler:Includes enter the include directory of CppUTest.
- Click the page with the green plus.
- SelectFile system…
- Enter or search to the directory. For my install location, the directory is: C:\workspaces\CppUTest2_1\includes.
  CppUTest Library
UnderMinGW C++ Linker:Libraries, enter both a library path as well as a library
UnderLibraries (-l), click on the page with a green plus
Enter the name of the library (minus “lib” and “.lib”):CppUTest
Library Path
UnderLibrary search path (-L), click on the page with a green plus
Enter the directory where the library is located. On my machine it isC:\workspaces\CppUTest2_1\lib
Click OK
Update main

You won’t notice any changes unless you use CppUTest.
CppUTest uses the main() to execute its tests. So update the file with main() (CppUTestHasItsSmoke.cpp):

#include <CppUTest/CommandLineTestRunner.h>

int main(int argc, char **argv) {
	return CommandLineTestRunner::RunAllTests(argc, argv);
}

You can run your program as a Local C++ Application again:

OK (0 tests, 0 ran, 0 checks, 0 ignored, 0 filtered out, 0 ms)

Alternative main()

If you’d like to see a list of tests and the time each takes to run, you can either:

Provide command-line arguments when you run the program in Eclipse
Use an updated main to make it happen every time:

#include <CppUTest/CommandLineTestRunner.h>

int main() {
	const char* args[] = { "", "-v" };
	return CommandLineTestRunner::RunAllTests(2, args);
}

title: cpptraining.ConfiguringTheProjectToUseBoost — Previous

Configuring the Project to use Boost

Edit your project’s properties (right-click, properties)
SelectC/C++ Build:Settings
UnderGCC C++ Compiler:Includes enter the include directory for boost.
- Click the page with the green plus.
- SelectFile system…
- Enter or search to the directory. For my install location, the directory is: C:\workspaces\boost_1_43_0.
UnderMinGW C++ Linker:Libraries, enter both a library path as well as a library (for this example, we’ll use boost date_time).
- UnderLibraries (-l), click on the page with a green plus
- Enter the name of the library (minus “lib” and “.lib”):boost_date_time-mgw44-mt-1_43
- UnderLibrary search path (-L), click on the page with a green plus
- Enter the directory where the library is located. On my machine it isC:\workspaces\boost_1_43_0\stage\lib
Click OK
Verify these settings.
- Create a new file: BoostDateTimeSmokeTest.cpp:

#include <boost/date_time/gregorian/gregorian.hpp>

#include <CppUTest/TestHarness.h>

TEST_GROUP(Dates) {

};

TEST(Dates, CanBeLinkedIn) {
  using namespace boost::gregorian;
  std::string s("2001-10-9");
  date d(from_simple_string(s));
}

Important: The CppUTest header files need to be includedlast.
Build and run your tests. You’re really just checking that you can compile and link.

Overview

Overview of the Steps

Setting up Initial Project

Configuring the Project for CppUTest

CppUTest Library

Library Path

Update main

Alternative main()

Configuring the Project to use Boost

Comments