Skip to main content

Qt Interface Builder (QFace)

Build Status Weekly Build Status Documentation Status Chat at https://gitter.im/qmlbook/qface

QFace is a generator framework based on a common modern IDL. It is not a generator as such but enforces a common IDL format and provides a library to write your own generator. It is actually very easy to create your own generator and generate your custom solution based on your needs from the same IDL.

The IDL is designed after the Qt/QML interface and as such is optimized to generate source code used with Qt C++ or Qt QML, but it is not limited to this use case.

QFace is already very fast by design and suitable for large IDL document sets. Additionally it can use a cache to avoid parsing unchanged IDL documents. It can automatically avoid writing new files if the target file has the same content.

QFace is written out of the learnings of using IDLs in other large projects. Often in the project you need to adjust the code generation but in many generators this is awfully complicated. Or you need to run a report on the documents or generate specific documentation. In QFace this is enabled by having a very flexible code generation framework which enforces the same IDL.

Please see the INSTALL and USAGE guides for more information.

Documentation

Documentation is hosted at readthedocs.

Install

To install the qface library you need to have python3 and pip installed.

pip3 install qface

Install Development Version

Prerequisites

To install the development version you need to clone the repository and ensure you have checkout the develop branch.

git clone git@github.com:Pelagicore/qface.git
cd qface
git checkout develop

The installation requires the python package manager called (pip) using the python 3 version. You can try:

python3 --version
pip3 --version

Installation

Use the editable option of pip to install an editable version.

cd qface
pip3 install --editable .

This reads the setup.py document and installs the package as reference to this repository. So all changes will be immediatly reflected in the installation.

To update the installation just simple pull from the git repository.

Download

If you are looking for the examples and the builtin generators you need to download the code.

git clone git@github.com:Pelagicore/qface.git

Copyright (C) 2016 Pelagicore AG

The source code in this repository is subject to the terms of the MIT license, please see included "LICENSE" file for details.

QFace Example

// echo.qface
module org.example 1.0;

/**!
The echo interface to call someone
on the other side
*/
interface Echo {
    readonly Message lastMessage;
    void echo(Message message);
    signal callMe();
};

struct Message {
    string text;
};

Now you write a small script using qface to generate your code

# mygenerator.py
from qface.generator import FileSystem, Generator

# load the interface files
system = FileSystem.parse('echo.qface')
# prepare the generator
generator = Generator(searchpath='.')

# iterate over the domain model
for module in system.modules:
    for interface in module.interfaces:
        # prepare a context object
        ctx = { 'interface': interface }
        # use header.h template with ctx to write to a file
        generator.write('{{interface|lower}}.h', 'header.h', ctx)

Depending on the used generator it reads the input file and runs it through the generator. The output files are written relative to the given output directory. The input can be either a file or a folder.

Metadata

Release files for qface 2.0.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qface 2.0.14
File Size Uploaded Provenance Actions
qface-2.0.14.tar.gz 49.6 kB Without provenance Details for qface-2.0.14.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for qface 2.0.14
File Interpreter ABI Platform Actions
qface-2.0.14-12-py3-none-any.whl Python 3 none any Details for qface-2.0.14-12-py3-none-any.whl

Total release size: 105.4 kB

Release files / qface-2.0.14.tar.gz

Download URL qface-2.0.14.tar.gz
Size 49.6 kB
Tags Source
SHA-256 checksum
How to use checksums
df31014fbe95b3d910d059ce1a8e827d57d234aca3a5c42094d6ad096fd8f39e
BLAKE2b-256 checksum
How to use checksums
1fb96f09a2319e78861396cdc4f07a5075299699d96fde22453d2bb7354af5a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.17

Release files / qface-2.0.14-12-py3-none-any.whl

Download URL qface-2.0.14-12-py3-none-any.whl
Size 55.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
34ae4e8c40a1d9bdadf724ef273183e0dcedc42729436d5cac5fc08eae5dc212
BLAKE2b-256 checksum
How to use checksums
13f9ba8ca316fd142edab23f8e625b900a81ecf4efc57665d9a05c301e5a103f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.7.17

Security for qface 2.0.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page