Knut is an automation tool for code transformation using scripts. The main use case is for migration, but it could be used elsewhere.
The scripts are written either in javascript or QML languages, the latter being able to display a user interface to customize some parts of the application. The script API is available in this documentation, and ranges from normal text transformations (find and replace) to getting contextual information based on the file language (using TreeSitter).
Knut can be used via a command line interface or a user interface.
Knut is using Language Server Protocol servers for the GUI. It is not used for the scripts, so if you are using Knut with the command line interface, you don't need it.
For C++, if you are using clangd, note that some tests are disabled for clangd version < 13.
Knut is © Klarälvdalens Datakonsult AB (KDAB) and is licensed according to the terms of GPL 3.0.
Contact KDAB at info@kdab.com to inquire about licensing options.
Knut includes different 3rd party software, you can find the list and licenses for them in the 3RDPARTY document.
To build Knut, you will need an up-to-date C++ & Qt toolchain. This includes:
- A recent C++ compiler (GCC 11+, Clang 15+, MSVC 19.40+)
- CMake 3.15+
- An installation of Qt 6
- (optional: Ninja build system)
On Windows, you may run into issues when building, especially if using QtCreator. This is a known issue, and the steps to resolve it are detailed in the link to the Contributing Guide in the Contributing section of this readme.
To clone the code, simply run:
git clone https://github.com/KDAB/knut.git && cd knutIf you are a member of KDAB and have access to our private repositories, you may then simply run:
git submodule update --init --recursiveto download all dependencies.
If you are a contributor outside KDAB, you will need to download all submodules in the 3rdparty/ folder, without the private dependencies in the 3rdparty-kdab/ folder.
git submodule update --init --recursive -- 3rdparty/*After that you can build Knut with CMake via one of the presets. E.g.:
cmake --preset=release
cmake --build --preset=releaseTake a look at CMakePreset.json for a list of available presets.
After building with CMake, run the knut binary from the bin folder within your build directory.
e.g.:
./build-release/bin/knutVisit our comprehensive documentation here: https://kdab.github.io/knut/index.html
For information about contributing to Knut, see the "Contributing Guide" in our documentation.
Knut is written and maintained by Klarälvdalens Datakonsult AB (KDAB).
The KDAB Group is the global No.1 software consultancy for Qt, C++ and OpenGL applications across desktop, embedded and mobile platforms.
The KDAB Group provides consulting and mentoring for developing Qt applications from scratch and in porting from all popular and legacy frameworks to Qt. We continue to help develop parts of Qt and are one of the major contributors to the Qt Project. We can give advanced or standard training anywhere around the globe on Qt as well as C++, OpenGL, 3D and more.
Please visit https://www.kdab.com to meet the people who write code like this
Stay up-to-date with KDAB product announcements: