Metadata-Version: 2.4
Name: maketool
Version: 0.8.31
Summary: Python Automation tool for building PySide6 UI and PyInstaller EXE.
Author-email: Alan Lilly <panofish@gmail.com>
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: psutil

# maketool

**maketool** is a command-line utility and helper module that simplifies execution and building [PySide6](https://doc.qt.io/qtforpython/) Python 3.7+ applications into executables using **PyInstaller 5.8.0**.  Note: Windows only

It's especially useful for GUI projects that need embedded resources (e.g., `.ui`, `.qrc`) and aim to produce portable `.exe` builds with minimal setup.

---

## Why Use maketool?

If you build windows desktop apps using PySide6, `maketool`:

- Saves time when converting `.ui` and `.qrc` files
- Simplifies PyInstaller builds
- Packages your application with minimal commands
- Automates repetitive tasks like building and cleanup
- Integrates easily with `.bat` scripts or shell commands
- Is great for both beginners and advanced developers using PySide6

---

## Commands

### 1. `run`

Purpose: Compile .ui and .qrc files recursively (using `pyside6-uic.exe` and `pyside6-rcc.exe`), then run the Python program using pythonw.exe.

Note: it will ONLY rebuild pyside components that are out of date, so that execution is fast as possible, yet always includes any changes.
FYI: python program is run with pythonw.exe so that the terminal window does not appear.

```cli
usage: maketool-run [-h] file

parameters:
  file        python file to run

parameters:
  -h, --help  show this help message and exit
```

### 2. `clean`

Purpose: Remove build artifacts, caches, generated UI files, PyInstaller output, and spec files.

- `__pycache__` folders  
- `*_ui.py`, `*_rc.py`, `*.pyc`, `*.pyo`  
- PyInstaller `build/` and `dist/` folders  
- `.spec` files in the current directory

Run it like this:

```cli
maketool-clean
```

### 3. `compile`

Purpose: Build an executable using PyInstaller, including UI/QRC compilation, icon embedding, version stamping, and resource embedding.

- Supports onefile/onedir/console modes.
- AutoGenerates a PyInstaller `.spec` file  
- Handles .ui/.qrc compilation automatically.
- Supports embedding arbitrary files which is useful for DLLs or data assets.

- Runs PyInstaller with the provided options
- Updates __version__ if exists in python file with --version value if provided

```cli
usage: maketool-compile [-h] --file FILE --type {onefile,onedir,console} [--icon=ICON] [--embed=EMBED] [--version=VERSION]

parameters:
  -h, --help            show this help message and exit
  --file FILE           python file to compile to exe
  --type {onefile,onedir,console}
                        type of exe to build
  --icon ICON           ico file
  --embed EMBED         comma delimited list of files to embed
  --version VERSION     program version (otherwise use __version__ in py source)
```

### 4. `sublime`

WARNING: This will overwrite existing custom key bindings at that path
Purpose: Install custom Sublime Text 4 shortcuts and commands.
Future: plan for support of vscode editor.

CTRL+BACKSPACE - delete line
CTRL+ALT+E - open windows explorer where current file is located
CTRL+0 - reset font size
F1 - insert print statement for variable where cursor is located
F5 - run pyflakes on current python source
F6 - maketool-refscan - scan for unused/orphan files in the project
F7 - build (runs maketool-run on current script via the build system)
F10 - insert current date/day

```cli
usage: maketool-sublime [-h] --path PATH

parameters:
  -h, --help            show this help message and exit
  --path PATH           sublime text - data/package/user path
```


### 5. `refscan`

Purpose: Scan for unused/orphan files using string-based heuristics.
This is especially useful for catching forgotten assets like `.ui`, `.qss`, `.ico`, images, etc.
"Unused" means "no string reference found anywhere in .py files".

Default behavior is **unused only**:

```cli
maketool-refscan
```

Show both used and unused:

```cli
maketool-refscan --show-used
```

Write a CSV report:

```cli
maketool-refscan --csv refscan-report.csv
```

Notes:
- This is heuristic (string-based). It may miss dynamically constructed paths/imports and may produce false positives.
- For best results, run it from your project root.


---

## Features

- Simple command-line interface for `.bat` or `.sh` workflows 
- Converts all `.ui` and `.qrc` files recursively
- Cleans up Python build artifacts
- Packages apps using PyInstaller 
- Supports custom `.ico` icons  
- Supports optional resource embedding

---

## Requirements

- [**Python 3.7+**](https://www.python.org/downloads/)
- [**PySide6**](https://pypi.org/project/PySide6/)
- [Tested with **PyInstaller 5.8**](https://pypi.org/project/pyinstaller/)

---

## Installation

Install maketool helper from PyPI with following command:

```cli
pip install maketool
```

---

## License

MIT License  
Copyright 2026 Alan Lilly 
