Two minutes tutorial

Installation

Install required libraries (and dependencies)

  • cxxtools9
  • tntdb4
  • log4cxx10
  • boost-program-options

Download here compressed version of your choice, preferably the last one.

configure && make && make install

Configuration

First time you execute pbuilder4cpp, it creates the basic information that needs including a test unit and log configuration. This information is stored in $HOME/.pbuilder directory.

saulario@workstation:~$ /usr/local/bin/pbuilder4cpp
 Creating pbuilder directory structure
 Creating pbuilder log4cxx configuration file
 Creating pbuilder configuration file
 main -----> begin
 *** exception report ***
 Parameter unit undefined
 Parameter unit undefined
 main <----- end
 saulario@workstation:~$

$HOME/.pbuilder directory contains two subdirectories.

  • etc, with configuration files
  • log

log4cxx.properties. You don’t need to modify this file. If you need information about log4cxx configuration use this link. Log file is placed in $HOME/.pbuilder/pbuilder.log.

pbuilder.xml contains a default unit called test.

<pbuilder>
  <units>
    <unit>
      <name>test</name>
      <database>test</database>
      <url>mysql:db=test</url>
      <namespace>test</namespace>
      <geometry>false</geometry>
    </unit>
  </units>
</pbuilder>

In order to configure a unit for example1 (included in examples directory) you must add following configuration:

    <unit>
      <name>ex1</name>
      <database>ex1</database>
      <url>mysql:db=ex1;user=ex1user;password=passwd</url>
      <namespace>ex1</namespace>
      <geometry>false</geometry>
    </unit>

Invoke pbuilder4cpp as follows and you will generate your code!

/usr/local/bin/pbuilder4cpp --unit ex1

Unit parameters reference

Men at work 🙂