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
- Python 3.7,
pip
to manage Python packages.
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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0c6b1b0d19dc76d4bee76f2c4ef84ec4deb67897245798fe3a2b72ecbc3f39d9 |
|
MD5 | 752792333c46975525c7410362cd23ee |
|
BLAKE2b-256 | 30c2c0fce293cc988ce4cf7f399ae0a0d23c4836e3d9d8410acfb59297ef3f58 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4fc5dfa7adb9979c555c9445a1b6dd107bee107f54cdc4e91b313ca063820036 |
|
MD5 | d8a562ba7c8c150aa4cf4499d6d25f54 |
|
BLAKE2b-256 | a37cfe7511e3bee8409a4ed1ccedc6acefd4a9c388dd81f59886125690b7d41e |