qt-installer


Nameqt-installer JSON
Version 0.1.0 PyPI version JSON
download
home_pagehttps://github.com/MariusGulbrandsen/qt-installer
SummaryYet Another QT Installer (ya-q-ti!) - A CLI for installing Qt packages and tooling; for use in enviroments like GitHub Actions or Docker
upload_time2023-10-11 21:49:25
maintainer
docs_urlNone
authorMariusGulbrandsen
requires_python>=3.8,<4.0
licenseMIT
keywords packaging dependency qt qt5 qt6 github-actions github actions docker cli
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # yaqti (Yet Another QT Installer - ya-q-ti!)
[![PyPI version](https://badge.fury.io/py/yaqti.svg)](https://badge.fury.io/py/yaqti)
[![Python Unit-Tests (pytest)](https://github.com/WillBrennan/yaqti/actions/workflows/unit_tests.yml/badge.svg)](https://github.com/WillBrennan/yaqti/actions/workflows/unit_tests.yml)
## Overview
`yaqti` is a basic unofficial CLI Qt installer; designed to keep things as stupid as possible. It lets you install different Qt5 and Qt6 versions with optional modules such as QtCharts, QtNetworkAuth ect all in a single command,

```bash
# install yaqti
pip install yaqti
# install Qt! 
python -m yaqti install --os windows --platform desktop --version 6.2.0 --modules qtcharts qtquick3d
```
, optionally the `--set-env` can be specified. This sets `Qt5_DIR`/`Qt6_DIR` so CMake can find the installation. `--install-deps` can be specified, on Linux platforms to install Qt dependencies from `apt-get`.
It can also be used as a github action,

```yml
-   name: Install Qt
    uses: WillBrennan/yaqti
    with:
        version: '6.2.0'
        host: 'linux'
        target: 'desktop'
        modules: 'qtcharts qtwebengine'
```
. By default, the github-action will set the enviroment variables for Qt and install Qt dependencies. For a real-world example visit [disk_usage](https://github.com/WillBrennan/disk_usage), the project this was made for. 

## Options
### `version`
The version of Qt to install, for example `6.2.0` or `5.15.2`. It checks the version is valid. 

### `os`
The operating system you'll be running on `linux`, `windows`, or `mac`.

### `platform`
The platform you'll be building for, `desktop`, `winrt`, `android`, or `ios`. 

### `modules`
The optional Qt modules to install such as, `qtcharts`, `qtpurchasing`, `qtwebengine`, `qtnetworkauth`, `qtscript`, `debug_info`.

### `output` - `default: ./qt`
The directory to install Qt in, it will put it in a `version` sub directory. By default if you install `--version=5.15.2` it will install qt into `./qt/5152`.

### `--set-envs`
Designed for use in CI pipelines; this sets enviromental variables such as `PATH`, `Qt5_DIR`, and `Qt6_DIR` so CMake can find Qt and you can use executables directly.

### `--install-deps`
Designed for use in CI pipelines. This installs dependencies required by Qt on Linux platforms. If this flag is provided on non-linux platforms it does nothing.

## Why Another Qt CLI Installer? 
I've had issues with other CLI installers in the past,

- They'll silently fail to download a module if you type `qcharts` instead of `qtcharts`
- This fetches module and addon configurations directly from the Qt Archive, new modules and versions will appear without the tool updating!
- It keeps module names the same between Qt5 and Qt6 despite Qt moving them around a bit.
- I like to keep things stupidly simple!

## How does it work?!
Qt provides the [Qt Archive](https://download.qt.io/online/qtsdkrepository), this script simply works out what 7zip files to fetch and unpacks them to the specified installation directory. Then if you want, it sets the enviroment variable so CMake can find the install.



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/MariusGulbrandsen/qt-installer",
    "name": "qt-installer",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8,<4.0",
    "maintainer_email": "",
    "keywords": "packaging,dependency,qt,qt5,qt6,github-actions,github,actions,docker,cli",
    "author": "MariusGulbrandsen",
    "author_email": "MariusGulbrandsen@users.noreply.github.com",
    "download_url": "https://files.pythonhosted.org/packages/00/09/37bbb5ab51710f38a1d8c8e539d934d97394e31341f2956a1ff28add9738/qt_installer-0.1.0.tar.gz",
    "platform": null,
    "description": "# yaqti (Yet Another QT Installer - ya-q-ti!)\n[![PyPI version](https://badge.fury.io/py/yaqti.svg)](https://badge.fury.io/py/yaqti)\n[![Python Unit-Tests (pytest)](https://github.com/WillBrennan/yaqti/actions/workflows/unit_tests.yml/badge.svg)](https://github.com/WillBrennan/yaqti/actions/workflows/unit_tests.yml)\n## Overview\n`yaqti` is a basic unofficial CLI Qt installer; designed to keep things as stupid as possible. It lets you install different Qt5 and Qt6 versions with optional modules such as QtCharts, QtNetworkAuth ect all in a single command,\n\n```bash\n# install yaqti\npip install yaqti\n# install Qt! \npython -m yaqti install --os windows --platform desktop --version 6.2.0 --modules qtcharts qtquick3d\n```\n, optionally the `--set-env` can be specified. This sets `Qt5_DIR`/`Qt6_DIR` so CMake can find the installation. `--install-deps` can be specified, on Linux platforms to install Qt dependencies from `apt-get`.\nIt can also be used as a github action,\n\n```yml\n-   name: Install Qt\n    uses: WillBrennan/yaqti\n    with:\n        version: '6.2.0'\n        host: 'linux'\n        target: 'desktop'\n        modules: 'qtcharts qtwebengine'\n```\n. By default, the github-action will set the enviroment variables for Qt and install Qt dependencies. For a real-world example visit [disk_usage](https://github.com/WillBrennan/disk_usage), the project this was made for. \n\n## Options\n### `version`\nThe version of Qt to install, for example `6.2.0` or `5.15.2`. It checks the version is valid. \n\n### `os`\nThe operating system you'll be running on `linux`, `windows`, or `mac`.\n\n### `platform`\nThe platform you'll be building for, `desktop`, `winrt`, `android`, or `ios`. \n\n### `modules`\nThe optional Qt modules to install such as, `qtcharts`, `qtpurchasing`, `qtwebengine`, `qtnetworkauth`, `qtscript`, `debug_info`.\n\n### `output` - `default: ./qt`\nThe directory to install Qt in, it will put it in a `version` sub directory. By default if you install `--version=5.15.2` it will install qt into `./qt/5152`.\n\n### `--set-envs`\nDesigned for use in CI pipelines; this sets enviromental variables such as `PATH`, `Qt5_DIR`, and `Qt6_DIR` so CMake can find Qt and you can use executables directly.\n\n### `--install-deps`\nDesigned for use in CI pipelines. This installs dependencies required by Qt on Linux platforms. If this flag is provided on non-linux platforms it does nothing.\n\n## Why Another Qt CLI Installer? \nI've had issues with other CLI installers in the past,\n\n- They'll silently fail to download a module if you type `qcharts` instead of `qtcharts`\n- This fetches module and addon configurations directly from the Qt Archive, new modules and versions will appear without the tool updating!\n- It keeps module names the same between Qt5 and Qt6 despite Qt moving them around a bit.\n- I like to keep things stupidly simple!\n\n## How does it work?!\nQt provides the [Qt Archive](https://download.qt.io/online/qtsdkrepository), this script simply works out what 7zip files to fetch and unpacks them to the specified installation directory. Then if you want, it sets the enviroment variable so CMake can find the install.\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Yet Another QT Installer (ya-q-ti!) - A CLI for installing Qt packages and tooling; for use in enviroments like GitHub Actions or Docker",
    "version": "0.1.0",
    "project_urls": {
        "Documentation": "https://github.com/MariusGulbrandsen/qt-installer",
        "Homepage": "https://github.com/MariusGulbrandsen/qt-installer",
        "Repository": "https://github.com/MariusGulbrandsen/qt-installer"
    },
    "split_keywords": [
        "packaging",
        "dependency",
        "qt",
        "qt5",
        "qt6",
        "github-actions",
        "github",
        "actions",
        "docker",
        "cli"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "16756ba127012a51c9dae575fe69afb18a2ec0225a9ec0ef61f421419af5b69b",
                "md5": "ec4e1be0710d4a9df41ab2ea7e7996ef",
                "sha256": "2301bf36f05916477ab961b0e1ee1656814ff5fd315c69d66b09dafa98c051fc"
            },
            "downloads": -1,
            "filename": "qt_installer-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ec4e1be0710d4a9df41ab2ea7e7996ef",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8,<4.0",
            "size": 6970,
            "upload_time": "2023-10-11T21:47:31",
            "upload_time_iso_8601": "2023-10-11T21:47:31.380510Z",
            "url": "https://files.pythonhosted.org/packages/16/75/6ba127012a51c9dae575fe69afb18a2ec0225a9ec0ef61f421419af5b69b/qt_installer-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "000937bbb5ab51710f38a1d8c8e539d934d97394e31341f2956a1ff28add9738",
                "md5": "cfe0d238ab998ef1cc9252511d0c84ee",
                "sha256": "1cb5bc218a5ee0a89292c08ab411450fe515af1ef9e687ec0a6723b2c4b2ba0b"
            },
            "downloads": -1,
            "filename": "qt_installer-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "cfe0d238ab998ef1cc9252511d0c84ee",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8,<4.0",
            "size": 6285,
            "upload_time": "2023-10-11T21:49:25",
            "upload_time_iso_8601": "2023-10-11T21:49:25.362144Z",
            "url": "https://files.pythonhosted.org/packages/00/09/37bbb5ab51710f38a1d8c8e539d934d97394e31341f2956a1ff28add9738/qt_installer-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-11 21:49:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "MariusGulbrandsen",
    "github_project": "qt-installer",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "qt-installer"
}
        
Elapsed time: 0.12931s