qpropgen

A tool to generate QML-friendly QObject-based C++ classes from class definition files.

Install it with:

pip install qpropgen

Quick Intro

Declaring properties in a QObject class requires writing a lot of boilerplate code. qpropgen goal is to write this boilerplate for you.

Suppose we want to create a Person class, with firstName, lastName and birthDate properties.

First we create a class definition file named person.yaml with the following content:

class: Person
properties:
- name: firstName
  type: QString
- name: lastName
  type: QString
- name: birthDate
  type: QDateTime

Next, we generate its header and implementation with qpropgen person.yaml. This produces two files: person.h and person.cpp (The filenames are based on the filename of the class definition).

Note: in practice, you probably want to inherit from the generated classes to implement other aspects of the class to create and/or to override getters and setters.

Syntax of class definition files

A class definition file must contain the following fields:

• class: the name of the class to generate.

• properties: the list of its properties (see below).

It may also contain the following fields:

• includes: a list of files to include in the header.

• baseClass: name of the class to inherit from. Defaults to QObject.

• defaults: default values for some property attributes (see below).

The properties field

properties is an array of property definitions.

A property definition must contain the following fields:

• name
• type (can be set in the defaults field)

It may contain the following fields:

• access: Can be private or protected. Defines the access modifier for the generated member variables. Defaults to private.

• mutability: One of constant, readonly, readwrite. Defaults to readwrite.

• argType: The type of the setter argument. If not set qpropgen uses const references for types which are not pointers and not known scalars (int, bool, qreal).

• varName: Name of the variable backing the property. Defaults to m<Name>, so the variable of the foo property will be mFoo.

• setterName: Name of the setter. Defaults to set<Name>, so the setter of the foo property will be setFoo.

• impl: One of plain (getter and setter), virtual (virtual getter and setter) or pure (virtual pure getter and setter). Defaults to plain.

• value: The default value of the property.

The defaults field

Adding a field to the defaults object lets you define default values for all properties.

For example you can define that all properties are of type qreal by default with:

defaults:
  type: qreal

Of course fields which require a unique value, like name, should not have a default.

Build system integration

The cmake/qpropgen.cmake can be included in your project to integrate qpropgen. It takes care of finding the qpropgen executable and provides a qpropgen() CMake function.

This CMake function lets you define .yaml files to process. For example:

set(prj_SRCS main.cpp)
qpropgen(prj_QPROPGEN foo.yaml bar.yaml)
add_executable(prj ${prj_SRCS} ${prj_QPROPGEN})

Examples

The examples/ directory contains examples of the various settings. The produced executable does nothing, but you can look in the build directory at the .h and .cpp files produced by qpropgen during the build.

Tests

The ./tests.sh script runs the unit tests and builds the examples.

Trivia

I started this project when I was working on the SFXR-Qt sound generator (a QtQuick port of SFXR), and was finding it too tedious to declare all the properties necessary to represent sounds :)