Skip to main content

QMake to CMake project file converter

Project description

qmake2cmake

This repository contains Python scripts to convert QMake projects to CMake projects.

Goals

The qmake2cmake tool creates a CMakeLists.txt that covers the most common attributes of the converted .pro file. The generated CMake project can be used as baseline and will most likely need manual adjustments.

QMake constructs that cannot be converted end up in the CMake project as comment.

Non-goals

Qt versions lower than 6.0 are not supported.

The following QMake constructs are not converted:

  • TEMPLATE = aux projects
  • custom .prf files
  • extra compilers
  • extra targets
  • installation rules

Requirements

Installation

You can install the qmake2cmake package directly via pip install qmake2cmake.

In case you are developing a new feature or want to install the latest repository version, do an editable build by running pip install -e .

Installation for contributors

For developers who want to contribute to qmake2cmake, we recommend using a virtual environment to avoid conflicts with other packages that are already installed.

  • Create an environment: python3 -m venv env --prompt qmake2cmake,
  • Activate the environment: source env/bin/activate (on Windows: env\Scripts\activate.bat)
  • Install the requirements: pip install -r requirements.txt

If the pip install command above doesn't work, try:

python3.7 -m pip install -r requirements.txt

Usage

After installing the qmake2cmake package, two scripts will be available in your bin/ directory of your Python environment: qmake2cmake and qmake2cmake_all.

The following call converts a single QMake project file to CMake:

qmake2cmake ~/projects/myapp/myapp.pro --min-qt-version 6.3

It's necessary to specify a minimum Qt version the project is supposed to be built with. Use the --min-qt-version option or the environment variable QMAKE2CMAKE_MIN_QT_VERSION.

By default, a CMakeLists.txt is placed next to the .pro file.

To generate CMakeLists.txt in a different location, use the -o option:

qmake2cmake ~/projects/myapp/myapp.pro --min-qt-version 6.3 -o ~/projects/myapp-converted/CMakeLists.txt

To convert a whole project tree, pass the project directory to qmake2cmake_all:

qmake2cmake_all ~/projects/myapp --min-qt-version 6.3

Contributing

The main source code repository is hosted at codereview.qt-project.org.

See the Qt Contribution Guidelines page, Setting up Gerrit and Gerrit Introduction for more details about how to upload patches for review.

Code style and tests

You can run the linter (mypy), code-style checkers (flake8, black) and tests (pytest) by executing:

make test

There are also separate make targets for each of those make mypy, make flake8, make black_format_check, make pytest.

You can auto-format the code using black:

make format

Releasing a new version

Increase the version number in setup.cfg according to semantic versioning 2.0.

For building and uploading qmake2cmake you will need the Python modules build and twine.

Build the wheel:

$ python -m build

Upload to testpypi:

$ twine upload --repository testpypi dist/<wheel-name>

Install the uploaded wheel in a fresh venv:

$ python -m venv fresh && . ./fresh/bin/activate
(fresh)$ pip install -i https://testpypi.python.org/pypi qmake2cmake --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple

If the installation succeeded, try to convert something. If everything is bueno, upload the wheel to production pypi.

$ twine upload --repository pypi dist/<wheel-name>

It is advisable to try out this wheel in another fresh venv.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qmake2cmake-1.0.6.tar.gz (76.4 kB view details)

Uploaded Source

Built Distribution

qmake2cmake-1.0.6-py3-none-any.whl (71.1 kB view details)

Uploaded Python 3

File details

Details for the file qmake2cmake-1.0.6.tar.gz.

File metadata

  • Download URL: qmake2cmake-1.0.6.tar.gz
  • Upload date:
  • Size: 76.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for qmake2cmake-1.0.6.tar.gz
Algorithm Hash digest
SHA256 0c6b1b0d19dc76d4bee76f2c4ef84ec4deb67897245798fe3a2b72ecbc3f39d9
MD5 752792333c46975525c7410362cd23ee
BLAKE2b-256 30c2c0fce293cc988ce4cf7f399ae0a0d23c4836e3d9d8410acfb59297ef3f58

See more details on using hashes here.

File details

Details for the file qmake2cmake-1.0.6-py3-none-any.whl.

File metadata

  • Download URL: qmake2cmake-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 71.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for qmake2cmake-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 4fc5dfa7adb9979c555c9445a1b6dd107bee107f54cdc4e91b313ca063820036
MD5 d8a562ba7c8c150aa4cf4499d6d25f54
BLAKE2b-256 a37cfe7511e3bee8409a4ed1ccedc6acefd4a9c388dd81f59886125690b7d41e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page