Metadata-Version: 2.4
Name: EzQt_App
Version: 2.0.2
Summary: Lightweight framework based on PySide6 to quickly build modern desktop applications, with integrated resource, theme, and reusable component management.
Author-email: Florian Salort <floriansalort@gmail.com>
License: MIT
Keywords: application,framework
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Office/Business
Requires-Python: <3.13,>=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PySide6==6.7.3
Requires-Dist: PyYaml==6.0.2
Requires-Dist: ruamel.yaml==0.18.6
Requires-Dist: colorama==0.4.6
Provides-Extra: dev
Requires-Dist: pytest>=6.2.5; extra == "dev"
Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
Requires-Dist: flake8>=4.0.1; extra == "dev"
Dynamic: license-file

# EzQt_App

## Description

EzQt_App is a Python framework designed to make it easy to create modern Qt applications, based on a template by Wanderson M. Pimenta. It automates resource management, generates all required files, and offers a fast project bootstrap experience with a CLI command.

## Features

- Automatic generation of asset folders and files (icons, images, themes, etc.)
- Dynamic themes (light/dark) with integrated toggle
- CLI command `ezqt_init` to quickly initialize a new project
- Ready-to-use `main.py` example generated automatically
- Modular and extensible structure

## Installation

Install the module via pip (recommended):

```bash
pip install ezqt_app
```

Or locally:

```bash
git clone https://github.com/neuraaak/ezqt_app.git
cd ezqt_app
pip install .
```

## Dependencies

Main dependencies are installed automatically:
- PySide6
- PyYaml
- colorama

## Project Initialization

After installation, initialize a new project in an empty folder with:

```bash
ezqt_init
```

This command creates the base structure, resource folders, and a sample `main.py` file.

## Minimal Usage Example

```python
import ezqt_app.main as ezqt
from ezqt_app.app import EzQt_App, EzApplication
import sys

ezqt.init()
app = EzApplication(sys.argv)
window = EzQt_App(themeFileName="main_theme.qss")
window.show()
app.exec()
```

## Generated Project Structure

```
my_project/
  main.py
  bin/
    config/
    fonts/
    icons/
    images/
    themes/
    modules/
```

## Customization
- Edit the theme in `bin/themes/main_theme.qss` or use the toggle in the UI.
- Add your own icons/images in the corresponding folders.

## FAQ
- **main.py already exists?**: The CLI will ask for confirmation before overwriting.
- **pyside6-rcc error?**: Make sure PySide6 is installed and available in your PATH.

## Contribution
Contributions are welcome! Submit your ideas, fixes, or extensions via issues or pull requests.

## License & Credits
This project is inspired by the template of Wanderson M. Pimenta. See the LICENSE file for details.
"# ezqt_app" 
