PyQtThemeSettings


NamePyQtThemeSettings JSON
Version 1.0.2.post1 PyPI version JSON
download
home_page
SummaryA package for adding a theme management window to any PySide6 applications using PyQtDarkTheme
upload_time2023-01-15 15:47:28
maintainer
docs_urlNone
authorMrSuspicious0
requires_python>=3.11
license
keywords pyqt pyside theme
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # PyQtThemeSettings

[![License](https://img.shields.io/github/license/MrSuspicious0/PyQtThemeSettings?label=License)](https://github.com/MrSuspicious0/PyQtThemeSettings/blob/master/LICENSE)
[![Version](https://img.shields.io/pypi/v/PyQtThemeSettings?label=Version)](https://pypi.org/project/PyQtThemeSettings/)
[![Downloads](https://img.shields.io/pypi/dw/PyQtThemeSettings?color=light&label=Downloads)](https://pypi.org/project/PyQtThemeSettings/)

A package for adding a theme management window to any PySide6 applications using [PyQtDarkTheme](https://github.com/5yutan5/PyQtDarkTheme).

Support for PyQt may come at some point, but PySide6 is the official recommendation of Qt for Python, so it's not a priority for me.

## Installation

PyQtThemeSettings can be installed using [pip](https://pip.pypa.io/en/stable/)

```bash
pip install pyqtthemesettings
```

# Usage

### Without PyQtThemeSettings

```python
if __name__ == "__main__":
    app = QApplication([]) # Initialise the App
    window = MainWindow() # Initialise Window
    window.show()
    exit(app.exec())
```

### With PyQtThemeSettings

```python
from PyQtThemeSettings import AppSettings

if __name__ == "__main__":
    app = QApplication([])
    app.setOrganizationName("MrSuspicious")
    app.setApplicationName("TestApp")
    settings = QSettings()
    appSettings = AppSettings(settings, app) # Pass in QSettings and QApplication
    window = MainWindow()
    window.show()
    exit(app.exec())
```

PyQtThemeSettings takes in a [QSettings](https://doc.qt.io/qtforpython/PySide6/QtCore/QSettings.html) object, which controls where the persistent settings are stored, and a [QApplication](https://doc.qt.io/qtforpython/PySide6/QtWidgets/QApplication.html).

In order to access the settings window, connect whatever signal you wish to the `AppSettings.openSettings` slot.

To reset to default settings, connect whatever signal you wish to the `AppSettings.resetToDefaults` slot.

## Contribution to the Project

If you have any feature suggestions please feel free to make a [pull request](https://github.com/MrSuspicious0/PyQtThemeSettings/pulls)!

Also if you happen to test this with a version other than python 3.11 and notice no issues, please let me know so i can change the entry on PyPi

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "PyQtThemeSettings",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": "",
    "keywords": "pyqt,pyside,theme",
    "author": "MrSuspicious0",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/14/fd/ef0e5d7f016162ea22f11f8603109b202204fc0801ca7b9a4209eb0330ed/PyQtThemeSettings-1.0.2.post1.tar.gz",
    "platform": null,
    "description": "# PyQtThemeSettings\r\n\r\n[![License](https://img.shields.io/github/license/MrSuspicious0/PyQtThemeSettings?label=License)](https://github.com/MrSuspicious0/PyQtThemeSettings/blob/master/LICENSE)\r\n[![Version](https://img.shields.io/pypi/v/PyQtThemeSettings?label=Version)](https://pypi.org/project/PyQtThemeSettings/)\r\n[![Downloads](https://img.shields.io/pypi/dw/PyQtThemeSettings?color=light&label=Downloads)](https://pypi.org/project/PyQtThemeSettings/)\r\n\r\nA package for adding a theme management window to any PySide6 applications using [PyQtDarkTheme](https://github.com/5yutan5/PyQtDarkTheme).\r\n\r\nSupport for PyQt may come at some point, but PySide6 is the official recommendation of Qt for Python, so it's not a priority for me.\r\n\r\n## Installation\r\n\r\nPyQtThemeSettings can be installed using [pip](https://pip.pypa.io/en/stable/)\r\n\r\n```bash\r\npip install pyqtthemesettings\r\n```\r\n\r\n# Usage\r\n\r\n### Without PyQtThemeSettings\r\n\r\n```python\r\nif __name__ == \"__main__\":\r\n    app = QApplication([]) # Initialise the App\r\n    window = MainWindow() # Initialise Window\r\n    window.show()\r\n    exit(app.exec())\r\n```\r\n\r\n### With PyQtThemeSettings\r\n\r\n```python\r\nfrom PyQtThemeSettings import AppSettings\r\n\r\nif __name__ == \"__main__\":\r\n    app = QApplication([])\r\n    app.setOrganizationName(\"MrSuspicious\")\r\n    app.setApplicationName(\"TestApp\")\r\n    settings = QSettings()\r\n    appSettings = AppSettings(settings, app) # Pass in QSettings and QApplication\r\n    window = MainWindow()\r\n    window.show()\r\n    exit(app.exec())\r\n```\r\n\r\nPyQtThemeSettings takes in a [QSettings](https://doc.qt.io/qtforpython/PySide6/QtCore/QSettings.html) object, which controls where the persistent settings are stored, and a [QApplication](https://doc.qt.io/qtforpython/PySide6/QtWidgets/QApplication.html).\r\n\r\nIn order to access the settings window, connect whatever signal you wish to the `AppSettings.openSettings` slot.\r\n\r\nTo reset to default settings, connect whatever signal you wish to the `AppSettings.resetToDefaults` slot.\r\n\r\n## Contribution to the Project\r\n\r\nIf you have any feature suggestions please feel free to make a [pull request](https://github.com/MrSuspicious0/PyQtThemeSettings/pulls)!\r\n\r\nAlso if you happen to test this with a version other than python 3.11 and notice no issues, please let me know so i can change the entry on PyPi\r\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "A package for adding a theme management window to any PySide6 applications using PyQtDarkTheme",
    "version": "1.0.2.post1",
    "split_keywords": [
        "pyqt",
        "pyside",
        "theme"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "37308d28e60ae327b4fc13b3b8e09de0c0570e13a8d3d0cac1dc439937d9b8da",
                "md5": "10f9faeeb82e1710cee820afa3b0b1c0",
                "sha256": "cfd1694bf4c515c3fecc2b04f1ce9d9354a350d61b32a4db7b5ec5ac21379a12"
            },
            "downloads": -1,
            "filename": "PyQtThemeSettings-1.0.2.post1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "10f9faeeb82e1710cee820afa3b0b1c0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 6070,
            "upload_time": "2023-01-15T15:47:27",
            "upload_time_iso_8601": "2023-01-15T15:47:27.190947Z",
            "url": "https://files.pythonhosted.org/packages/37/30/8d28e60ae327b4fc13b3b8e09de0c0570e13a8d3d0cac1dc439937d9b8da/PyQtThemeSettings-1.0.2.post1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "14fdef0e5d7f016162ea22f11f8603109b202204fc0801ca7b9a4209eb0330ed",
                "md5": "85a30a97309c6516e99deb76e5c91ee5",
                "sha256": "5b54a9f5ff8f9938e3315ef30b5d7ab359034c38ac8bcb79dd32a54b04fcc9a0"
            },
            "downloads": -1,
            "filename": "PyQtThemeSettings-1.0.2.post1.tar.gz",
            "has_sig": false,
            "md5_digest": "85a30a97309c6516e99deb76e5c91ee5",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 5575,
            "upload_time": "2023-01-15T15:47:28",
            "upload_time_iso_8601": "2023-01-15T15:47:28.914956Z",
            "url": "https://files.pythonhosted.org/packages/14/fd/ef0e5d7f016162ea22f11f8603109b202204fc0801ca7b9a4209eb0330ed/PyQtThemeSettings-1.0.2.post1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-01-15 15:47:28",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "pyqtthemesettings"
}
        
Elapsed time: 0.02832s