maketool 0.5.7__tar.gz

maketool-0.5.7/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: maketool
+Version: 0.5.7
+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
+
+# 🛠️ 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**.
+
+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 or PyQt, `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`
+
+Executes the Python program after recursively builds all `.ui` and `.qrc` files in the current directory and subdirectories using `pyside6-uic.exe` and `pyside6-rcc.exe`.  Then run python source code.
+
+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
+
+positional parameters:
+  file        python file to run
+
+parameters:
+  -h, --help  show this help message and exit
+```
+
+### 2. `clean`
+
+Removes temporary files and build artifacts, including:
+
+- `__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`
+
+Builds your python app into an executable using PyInstaller.
+
+- Compiles `.ui` and `.qrc` and image resources  
+- Generates a PyInstaller `.spec` file  
+- Runs PyInstaller with the provided options
+
+```cli
+usage: maketool-compile [-h] --file FILE --type {onefile,onedir,console} [--icon="myicon.ico"] [--embed="sqlite3.dll"]
+
+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`
+
+Update local `Sublime Text 4` installation with these useful shortcuts:
+
+F1 - insert print statement for variable where cursor is located
+CTRL+BACKSPACE - delete line
+CTRL+ALT+E - open windows explorer where current file is located
+F5 - run pyflakes on current python source
+CTRL+0 - reset font size
+F10 - insert current date/day
+F7 - maketool-run - build and run current python script
+
+```cli
+usage: maketool-sublime [-h] --path PATH
+
+parameters:
+  -h, --help            show this help message and exit
+  --path PATH           sublime text - data/package/user path
+```
+
+---
+
+## ✨ 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/)
+- 📦 [**PyInstaller 5.8**](https://pypi.org/project/pyinstaller/)
+
+---
+
+## 📥 Installation
+
+Install maketool helper from PyPI with following command:
+
+```cli
+pip install maketool
+```
+
+---
+
+## 📝 License
+
+MIT License  
+© 2025 Alan Lilly  

maketool-0.5.7/README.md

@@ -0,0 +1,131 @@
+# 🛠️ 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**.
+
+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 or PyQt, `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`
+
+Executes the Python program after recursively builds all `.ui` and `.qrc` files in the current directory and subdirectories using `pyside6-uic.exe` and `pyside6-rcc.exe`.  Then run python source code.
+
+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
+
+positional parameters:
+  file        python file to run
+
+parameters:
+  -h, --help  show this help message and exit
+```
+
+### 2. `clean`
+
+Removes temporary files and build artifacts, including:
+
+- `__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`
+
+Builds your python app into an executable using PyInstaller.
+
+- Compiles `.ui` and `.qrc` and image resources  
+- Generates a PyInstaller `.spec` file  
+- Runs PyInstaller with the provided options
+
+```cli
+usage: maketool-compile [-h] --file FILE --type {onefile,onedir,console} [--icon="myicon.ico"] [--embed="sqlite3.dll"]
+
+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`
+
+Update local `Sublime Text 4` installation with these useful shortcuts:
+
+F1 - insert print statement for variable where cursor is located
+CTRL+BACKSPACE - delete line
+CTRL+ALT+E - open windows explorer where current file is located
+F5 - run pyflakes on current python source
+CTRL+0 - reset font size
+F10 - insert current date/day
+F7 - maketool-run - build and run current python script
+
+```cli
+usage: maketool-sublime [-h] --path PATH
+
+parameters:
+  -h, --help            show this help message and exit
+  --path PATH           sublime text - data/package/user path
+```
+
+---
+
+## ✨ 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/)
+- 📦 [**PyInstaller 5.8**](https://pypi.org/project/pyinstaller/)
+
+---
+
+## 📥 Installation
+
+Install maketool helper from PyPI with following command:
+
+```cli
+pip install maketool
+```
+
+---
+
+## 📝 License
+
+MIT License  
+© 2025 Alan Lilly  

maketool-0.5.7/maketool/__init__.py

@@ -0,0 +1,5 @@
+from .build import main as build
+from .clean import main as clean
+from .compile import main as compile
+from .run import main as run
+from .sublime import main as sublime

maketool-0.5.7/maketool/build.py

@@ -0,0 +1,118 @@
+import sys
+import subprocess
+import os
+
+# build .ui and .qrc files in current folder and all sub folders
+# this is typically called from maketool-run or maketool-compile
+    
+def processfile(fullpath):
+
+    python3path = os.path.dirname(sys.executable)
+    pyrcc = os.path.join(python3path,"Scripts/pyside6-rcc.exe")
+    pyuic = os.path.join(python3path,"Scripts/pyside6-uic.exe")
+
+    path,file = os.path.split(fullpath)    
+    basename, ext = os.path.splitext(file)
+
+    infile = path + "/" + file
+
+    if ext.lower() != ".qrc" and ext.lower() != ".ui": return
+    
+    # process .qrc files
+    if ext.lower() == ".qrc":
+
+        outfile = path + "/" + basename + '_rc.py'
+
+        if comparefiles(infile, outfile):
+            sys.stdout.flush()
+
+            command = [sys.executable,    # path to python interpreter
+                       pyrcc, 
+                       infile, 
+                       '-o', outfile ]
+
+            p = subprocess.Popen(command,shell=True) #,stdout = subprocess.PIPE, stderr= subprocess.PIPE) #, startupinfo=startupinfo)
+            rc = p.wait()
+            # output,error = p.communicate()
+
+    # process .ui files
+    if ext.lower() == ".ui":
+
+        outfile = path + "/" + basename + '_ui.py'
+
+        if comparefiles(infile, outfile):
+            sys.stdout.flush()
+
+            command = [sys.executable,   # path to python interpreter
+                       pyuic, 
+                       infile, 
+                       '-o', outfile ]
+
+            p = subprocess.Popen(command,shell=True) #,stdout = subprocess.PIPE, stderr= subprocess.PIPE) #, startupinfo=startupinfo)
+            rc = p.wait()
+
+def walk(top, maxdepth):
+    dirs, nondirs = [], []
+    for name in os.listdir(top):
+        (dirs if os.path.isdir(os.path.join(top, name)) else nondirs).append(name)
+    yield top, dirs, nondirs
+    if maxdepth > 1:
+        for name in dirs:
+            for x in walk(os.path.join(top, name), maxdepth-1):
+                yield x
+
+def comparefiles(infile,outfile):
+    """
+    compare file dates
+    return true if infile is newer or if outfile doesn't exist
+    """
+
+    if not os.path.isfile(outfile):   # outfile does not exist 
+        return True
+    else:             # outfile does exist
+        # get infile date and outfile date
+        # infile_date = os.path.getmtime(infile)
+        # outfile_date = os.path.getmtime(outfile)
+
+        infile_date = os.stat(infile).st_mtime      # quicker than getmtime
+        outfile_date = os.stat(outfile).st_mtime    # quicker than getmtime
+        
+        # if outfile date < infile date then flag = True
+        if (outfile_date < infile_date):
+            return True
+
+    return False
+
+def main():
+
+    python3path = os.path.dirname(sys.executable)
+    pyrcc = os.path.join(python3path,"Scripts/pyside6-rcc.exe")
+    pyuic = os.path.join(python3path,"Scripts/pyside6-uic.exe")
+
+    if not os.path.isfile(pyrcc):
+        print("Warning: pyrcc not found: {}".format(pyrcc), file=sys.stderr)
+        sys.exit(1)
+
+    if not os.path.isfile(pyuic):
+        print("Warning: pyuic not found: {}".format(pyuic), file=sys.stderr)
+        sys.exit(1)
+
+    #-----------------------------------------------------------------
+    # build .ui and .qrc files in current folder and all sub folders
+    #-----------------------------------------------------------------
+
+    cwd = os.getcwd()  # e.g. cwd = E:\EDMS\python3\MUD
+
+    # traverse but only to a max depth of 2
+    depth = 2
+    for path, subdirs, files in walk(cwd, depth):
+        path = path.replace("\\", "/")   # flip all backslashes to forward slashes because python prefers
+        for file in files:
+            fullpath = os.path.join(path,file) 
+            processfile(fullpath)
+
+    sys.stdout.flush()
+
+if __name__ == "__main__":
+
+    main()     

maketool-0.5.7/maketool/clean.py

@@ -0,0 +1,102 @@
+# delete __pycache__ folder
+# delete *_ui.py"
+# delete *_rc.py"
+# delete *_pyc.py"
+# delete *_pyo.py"
+# delete pyinstaller build folder
+# delete pyinstaller dist folder
+# delete .spec files in current folder
+
+# -----------------------------------------------------------------
+# cleanup pyside6 temp files
+# -----------------------------------------------------------------
+
+import sys
+import os
+import shutil
+
+# -----------------------------------------------------------------
+# traverse current directory and all subfolders
+# -----------------------------------------------------------------
+
+def main():
+
+    cwd = os.getcwd()
+    cwd = cwd.replace("\\", "/")
+
+    print("")
+    print("Cleaning %s" % cwd)
+    sys.stdout.flush()
+
+    for path, subdirs, files in os.walk(cwd):
+
+        parent, lastfolder = os.path.split(path)     # get last folder in path
+
+        # python prefers forward slashes
+        path = path.replace("\\", "/")   # flip all backslashes to forward slashes
+
+        if lastfolder == "__pycache__":
+            if os.path.exists(path):
+                print("   deleting %s" % path)
+                sys.stdout.flush()
+                shutil.rmtree(path)  # recursively delete folder
+                continue
+
+        for file in files:
+
+            if file.lower().endswith("_ui.py"):
+                print("   removing %s" % file)
+                sys.stdout.flush()
+                os.remove(path+'/'+file)
+
+            if file.lower().endswith("_rc.py"):
+                print("   removing %s" % file)
+                sys.stdout.flush()
+                os.remove(path+'/'+file)
+
+            if file.lower().endswith(".pyc"):
+                print("   removing %s" % file)
+                sys.stdout.flush()
+                os.remove(path+'/'+file)
+
+            if file.lower().endswith(".pyo"):
+                print("   removing %s" % file)
+                sys.stdout.flush()
+                os.remove(path+'/'+file)
+
+    # -----------------------------------------------------------------
+    # cleanup pyinstaller build and dist folders
+    # -----------------------------------------------------------------
+
+    build_folder = "%s/build" % cwd
+    if os.path.exists(build_folder):
+        print("   removing %s" % build_folder)
+        sys.stdout.flush()
+        shutil.rmtree(build_folder)  # recursively delete folder
+
+    dist_folder = "%s/dist" % cwd
+    if os.path.exists(dist_folder):
+        print("   removing %s" % dist_folder)
+        sys.stdout.flush()
+        shutil.rmtree(dist_folder)   # recursively delete folder
+
+    # -----------------------------------------------------------------
+    # remove .spec files in current folder
+    # -----------------------------------------------------------------
+
+    files = os.listdir(cwd)  # get files in current directory
+
+    for file in files:
+
+        base, ext = os.path.splitext(file)
+
+        if ext.lower() == ".spec":
+            fullpath = "%s/%s" % (cwd, file)
+            print("   removing %s" % fullpath)
+            sys.stdout.flush()
+            os.remove(fullpath)
+
+
+if __name__ == "__main__":
+
+    main()   

maketool-0.5.7/maketool/compile.py

@@ -0,0 +1,401 @@
+#---------------------------------------------------------------------
+# console app to compile python source to exe using pyinstaller
+# 
+# 1. read commandline params
+# 2. build spec file for desired compiletype
+# 3. call pyinstaller build
+#---------------------------------------------------------------------
+
+import sys
+import os
+import argparse   # commandline option parsing
+import subprocess
+import re
+import ast
+
+import maketool
+
+def read_version_from_py(pyfile):
+    """Safely extract __version__ = 'x.y.z' from a python file."""
+    try:
+        with open(pyfile, "r", encoding="utf-8") as f:
+            tree = ast.parse(f.read(), filename=pyfile)
+
+        for node in tree.body:
+            if isinstance(node, ast.Assign):
+                for target in node.targets:
+                    if isinstance(target, ast.Name) and target.id == "__version__":
+                        if isinstance(node.value, ast.Str):
+                            return node.value.s
+        return None
+    except Exception:
+        return None
+
+def normalize_version(version):
+    """Normalize to 4-part Windows version."""
+    if not version:
+        return "0.0.0.0"
+
+    parts = re.split(r"[.\-]", version)
+    parts = [p for p in parts if p.isdigit()]
+
+    while len(parts) < 4:
+        parts.append("0")
+
+    return ".".join(parts[:4])
+
+def main():
+
+    #---------------------------------------------------------------------
+    # process commandline options 
+    #---------------------------------------------------------------------
+
+    parser = argparse.ArgumentParser(description='Compile python source into exe using pyinstaller')
+
+    parser.add_argument('--file', 
+                        dest='file',
+                        required=True,
+                        help='python file to compile to exe')      
+
+    parser.add_argument('--type',
+                        dest='type',
+                        required=True,
+                        choices=['onefile', 'onedir', 'console'],
+                        help='type of exe to build')
+
+    parser.add_argument('--icon',
+                        dest='icon',
+                        default='',
+                        help='ico file') 
+
+    parser.add_argument('--embed',
+                        dest='embed',
+                        default='',
+                        help='comma delimited list of files to embed') 
+
+    parser.add_argument('--version',
+                        dest='version',
+                        default='',
+                        help='product version (overrides internal __version__)') 
+
+    parser._positionals.title = "positional parameters"
+    parser._optionals.title = "parameters"
+
+    argcount = len(sys.argv)
+
+    # if no args supplied, then display help
+    if argcount == 1:
+        parser.print_help()
+        sys.exit()
+
+    args = parser.parse_args()   # will exit here if required parms are not provided
+
+    pythonfile     = args.file
+    iconfile       = args.icon
+    compiletype    = args.type
+    embedlist      = args.embed
+    version        = args.version
+
+    # strip possible quotes and spaces
+    pythonfile     = pythonfile.strip("\"' ")   
+    iconfile       = iconfile.strip("\"' ")   
+    compiletype    = compiletype.strip("\"' ")   
+    embedlist      = embedlist.strip("\"' ")   
+    version        = version.strip("\"' ")   
+
+    # file must be a file and must exist
+    if not os.path.isfile(pythonfile):    # use unicode instead of str to convert unicode qstring to python string
+        print ( f"ERROR: Python file does not exist: {pythonfile}")
+        #sys.stdout.flush()
+        sys.exit()
+
+    # file must be a file and must exist
+    if iconfile != "":
+        if not os.path.isfile(iconfile):    # use unicode instead of str to convert unicode qstring to python string
+            print ( f"ERROR: Icon file does not exist: {iconfile}")
+            sys.exit()
+
+    pythonfile = os.path.abspath(pythonfile)  # convert to absolute path (spec file expects absolute path)
+    pythonfile = pythonfile.replace("\\", "/")  
+
+    py_version = read_version_from_py(pythonfile)    
+
+    raw_version = (
+        version
+        or py_version
+        or "0.0.0.0"
+    )    
+
+    version = normalize_version(raw_version)  
+    
+    pgm_path = os.path.dirname(pythonfile)
+    pgm_filename = os.path.basename(pythonfile)
+    pgm_basename, pgm_ext = os.path.splitext(pgm_filename) 
+
+    print ("\n__________________ Compile __________________")
+
+    print ("----------- Settings -----------")
+    print (f"    python file: {pgm_filename}")
+    print (f"      icon file: {iconfile}")
+    print (f"   compile type: {compiletype}")
+    print (f"     embed list: {embedlist}")
+    print (f"        version: {version}")
+
+    sys.stdout.flush()
+
+    #-------------------------------------------------------------------
+    # build .ui and .qrc files in current folder and all sub folders
+    #-------------------------------------------------------------------
+
+    maketool.build()
+
+    #-------------------------------------------------------------------
+    # create pyinstaller version resource file
+    #-------------------------------------------------------------------
+
+    version_file = os.path.join(pgm_path, f"{pgm_basename}_version.txt")
+    major, minor, patch, build = version.split(".")
+
+    version_resource = f"""
+    VSVersionInfo(
+      ffi=FixedFileInfo(
+        filevers=({major},{minor},{patch},{build}),
+        prodvers=({major},{minor},{patch},{build}),
+        mask=0x3f,
+        flags=0x0,
+        OS=0x4,
+        fileType=0x1,
+        subtype=0x0,
+        date=(0,0)
+      ),
+      kids=[
+        StringFileInfo([
+          StringTable(
+            '040904B0',
+            [
+              StringStruct('CompanyName', 'GM'),
+              StringStruct('ProductName', '{pgm_basename}'),
+              StringStruct('ProductVersion', '{version}'),
+              StringStruct('FileVersion', '{version}'),
+              StringStruct('OriginalFilename', '{pgm_basename}.exe'),
+            ]
+          )
+        ]),
+        VarFileInfo([VarStruct('Translation', [1033, 1200])])
+      ]
+    )
+    """.strip()
+
+    with open(version_file, "w", encoding="utf-8") as vf:
+        vf.write(version_resource)
+
+    print(f"version resource: {version_file}")    
+
+    #-------------------------------------------------------------------
+    # build spec file data list for embedding files
+    # typically for embedding dll, exe, chm ... etc.
+    #-------------------------------------------------------------------
+
+    # Example a.datas line for file Excel2MySQL.chm
+    # a.datas += [('Excel2MySQL.chm', 'Excel2MySQL.chm', 'DATA')] 
+
+    if embedlist == "":
+        data = ""
+    else:
+        data = ""
+        embedlist = embedlist.split(',')   # convert comma delimited list into a python list using split method
+        for item in embedlist:
+            filename = os.path.basename(item)
+            data += f"a.datas += [('{filename}', '{item}', 'DATA')]\n"
+        data = data.strip()   # remove leading and trailing blank lines
+
+    # these files appear unused in many python programs and would therefore only bloat the dist exe.
+    # HOWEVER, if your exe crashes or is strangely missing functionality that otherwise appears when you run .py
+    # then maybe you need to no longer exclude 1 or more of the following excluded files
+    excludeDLLs = """
+to_keep = []
+to_exclude = ['opengl32sw.dll', 
+              'Qt6Network.dll', 
+              'Qt6Pdf.dll', 
+              'Qt6Pdf.dll.dll', 
+              'Qt6QmlModels.dll', 
+              'Qt6Qml.dll', 
+              'libssl-3.dll', 
+              'Qt6Quick.dll', 
+              'Qt6Svg.dll', 
+              'libcrypto-3.dll', 
+              'QtNetwork.pyd', 
+              'Qt6VirtualKeyboard.dll', 
+              'qtuiotouchplugin.dll', 
+              'qsvgicon.dll', 
+              'qnetworklistmanager.dll', 
+              'qtvirtualkeyboardplugin.dll', 
+              'qwindowsvistastyle.dll', 
+              'qcertonlybackend.dll', 
+              'qopensslbackend.dll', 
+              'qschannelbackend.dll', 
+              'Qt6OpenGL.dll']
+for (dest, source, kind) in a.binaries:   # Iterate through the list of included binaries.
+    if os.path.split(dest)[1] in to_exclude: continue
+    to_keep.append((dest, source, kind))
+a.binaries = to_keep  # Replace list of data files with filtered one.
+    """
+
+              # 'unicodedata.pyd', 
+
+    #-------------------------------------------------------------------
+    # define iconspec
+    #-------------------------------------------------------------------
+
+    # examples:
+    # iconfile = f"myicon.ico"
+    # iconfile = f"./icons/myicon.ico"
+
+    if iconfile != "": 
+        iconspec = f", icon='{iconfile}'"
+    else:
+        iconspec = ""
+
+    #-------------------------------------------------------------------
+    # create spec file name
+    #-------------------------------------------------------------------
+
+    specfile = pgm_path + "/" + pgm_basename + ".spec"
+    print (f"specfile={specfile}")
+    sys.stdout.flush()
+
+    #-------------------------------------------------------------------
+    # build specdata for console or onefile
+    #-------------------------------------------------------------------
+
+    if compiletype != "onedir":
+
+        if compiletype == "console":
+            value = "True"
+        elif compiletype == "onefile":
+            value = "False"
+
+        specdata = f"""
+# -*- mode: python -*-
+a = Analysis(['{pythonfile}'],
+             pathex=['./lib',
+                     '../lib',
+                     '../../lib',
+                     '../../../lib',
+                     './widgets',
+                     './dialogs',                     
+                     './views',                     
+                     '{pgm_path}',                     
+                    ],
+             hiddenimports=[])
+{data}
+
+{excludeDLLs}
+
+for d in a.datas:
+    if 'pyconfig' in d[0]:
+        a.datas.remove(d)
+        break
+pyz = PYZ(a.pure)
+exe = EXE(pyz,
+          a.scripts,
+          a.binaries,
+          a.zipfiles,
+          a.datas,
+          name='{pgm_basename}.exe',
+          debug=False,
+          strip=None,
+          upx=False,
+          version='{version_file}',
+          console={value} {iconspec})
+        """
+
+    #-------------------------------------
+    # build specdata for onedir
+    #-------------------------------------
+
+    if compiletype == "onedir":
+
+        specdata = f"""
+# -*- mode: python -*-
+a = Analysis(['{pythonfile}'],
+             pathex=['./lib',
+                     '../lib',
+                     '../../lib',
+                     '../../../lib',
+                     './widgets',
+                     './dialogs',                     
+                     './views',  
+                     '{pgm_path}',                     
+                    ],
+             hiddenimports=[])
+{data}
+
+{excludeDLLs}
+
+pyz = PYZ(a.pure)
+exe = EXE(pyz,
+          a.scripts,
+          exclude_binaries=True,
+          name='{pgm_basename}.exe',
+          debug=False,
+          strip=None,
+          upx=False,
+          version='{version_file}',
+          console=False {iconspec})
+coll = COLLECT(exe,
+               a.binaries,
+               a.datas,
+               strip=None,
+               upx=False,
+               name='{pgm_basename}')
+        """
+
+    #-------------------------------------------------------------------
+    # write specdata to file
+    #-------------------------------------------------------------------
+
+    specdata = specdata.strip()   # remove leading and trailing blank lines caused by """ notation
+
+    fout = open(specfile, 'w')      # open file for write
+    fout.write(specdata)
+    fout.close()
+
+    print (f"Generated specfile = {specfile}")
+
+    #-------------------------------------------------------------------
+    # calls pyinstaller build
+    # c:\python27\python.exe -OO c:\pyinstaller\utils\build.py excel2mysqlCLI.spec
+    #-------------------------------------------------------------------
+
+    print ("Calling Pyinstaller Build...")
+    sys.stdout.flush()
+
+    #sys.stdout.flush()   # this will flush and force the print statements to appear immediately.
+
+    # hide the command window
+    startupinfo = subprocess.STARTUPINFO()
+    startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
+
+    # run with basic optimizations
+    # python -O -m PyInstaller myscript.py
+    # OR discard docstrings
+    # python -OO -m PyInstaller myscript.py
+
+    # command = [sys.executable,'-OO','c:/python37/scripts/pyinstaller-script.py', specfile ]   # removes docstrings, so it is slightly smaller than above
+    # command = [sys.executable, '-OO', '-m', 'PyInstaller', specfile]  
+    command = [sys.executable, '-m', 'PyInstaller', specfile]     # had to disable -OO because winevt and pycparser has a known bug which crashes pyinstaller
+
+    p = subprocess.Popen(command,shell=True) #,stdout = subprocess.PIPE, stderr= subprocess.PIPE) #, startupinfo=startupinfo)
+
+    p.wait()
+    output,error = p.communicate()
+
+    # print ("Compile Done.")
+    print("___________________________________________________")
+    print("")
+    sys.stdout.flush()
+
+if __name__ == "__main__":
+
+    main()   

maketool-0.5.7/maketool/run.py

@@ -0,0 +1,66 @@
+import sys
+import os
+import argparse   
+import subprocess
+import maketool
+
+# read commandline parameters
+# call build.run so we can prebuild pyside6 components before we execute the main script
+# run the main script via pythonw.exe
+
+def main():
+    
+    #===================================================================
+    # process commandline options 
+    #===================================================================
+
+    parser = argparse.ArgumentParser(description='Build ui and qrc files, then run python source')
+
+    parser.add_argument('file',help='python file to run')
+
+    parser._positionals.title = "positional parameters"
+    parser._optionals.title = "parameters"
+
+    argcount = len(sys.argv)
+
+    if argcount == 1:
+        parser.print_help()
+        print('ERROR: No arguments supplied for PythonRun', file=sys.stderr) 
+        sys.exit(1)
+
+    args = parser.parse_args()   # will exit here if required parms are not provided
+
+    pythonfile = args.file
+    pythonfile = pythonfile.strip("\"' ")   # strip possible quotes and spaces
+    pythonfile = os.path.abspath(pythonfile)  # convert to absolute path
+    pythonfile = pythonfile.replace("\\", "/")   # flip all backslashes to forward slashes because python prefers
+
+    if not os.path.isfile(pythonfile):    # use unicode instead of str to convert unicode qstring to python string
+        print(f"Python file does not exist: {pythonfile}", file=sys.stderr) 
+        sys.exit(1)
+
+    #===================================================================
+    # build .ui and .qrc files in current folder and all sub folders
+    #===================================================================
+
+    maketool.build()
+
+    #===================================================================
+    # call pythonw
+    #===================================================================
+
+    command = ['pythonw.exe', '-u', pythonfile]     # this is the new python launcher (pyw.exe) which looks for shebang at top of python source and is installed with python3 but will run python2
+    p = subprocess.Popen(command,shell=True) #,stdout = subprocess.PIPE, stderr= subprocess.PIPE) #, startupinfo=startupinfo)
+
+    sys.stdout.flush()
+
+    rc = p.wait()
+
+    output,error = p.communicate()
+
+    sys.stdout.flush()
+
+
+if __name__ == "__main__":
+
+    main()   

maketool-0.5.7/maketool/sublime.py

@@ -0,0 +1,146 @@
+import os
+import sys
+import argparse
+import json
+import shutil
+
+
+def process(user_packages_dir: str):
+    """
+    Update Pythonw.sublime-build in a Sublime Text 4 installation so that maketool python build will work when F7 pressed.
+    
+    Parameters:
+        user_packages_dir (str): Path to the 'Packages/User' folder.
+        Example: r"C:/alan/app/sublime text 4/Data/Packages/User"
+    """
+
+    if user_packages_dir is None:
+        print("Error: sublime_text user_packages_dir must be provided.")
+        sys.exit()
+
+    keymap_file_path = os.path.join(user_packages_dir, "Default (Windows).sublime-keymap")
+    keymap_config = [
+        {
+            "keys": ["f1"],
+            "command": "run_macro_file",
+            "args": {"file": "Packages/User/print-python.sublime-macro"},
+            "context": [{"key": "selector", "operator": "equal", "operand": "source.python"}]
+        },
+        {
+            "keys": ["ctrl+backspace"],
+            "command": "run_macro_file",
+            "args": {"file": "res://Packages/Default/Delete Line.sublime-macro"}
+        },
+        {
+            "keys": ["ctrl+alt+e"],
+            "command": "open_dir",
+            "args": {"dir": "$file_path", "file": "$file_name"}
+        },
+        {
+            "keys": ["f5"],
+            "command": "build",
+            "args": {"variant": "pyflakes"}
+        },
+        {
+            "keys": ["ctrl+0"],
+            "command": "reset_font_size"
+        },
+
+        {   
+            "keys": ["f10"],
+            "command": "insert_date" 
+        }
+    ]
+
+
+    # Backup existing keymap if it exists
+    if os.path.exists(keymap_file_path):
+        backup_path = keymap_file_path + ".bak"
+        shutil.copy2(keymap_file_path, backup_path)
+        print(f"Backed up existing keymap to {backup_path}")
+
+    # Write the new keymap file
+    with open(keymap_file_path, "w", encoding="utf-8") as f:
+        json.dump(keymap_config, f, indent=4)
+
+    print(f"Updated Sublime Text: {keymap_file_path}")
+
+
+
+
+    build_file_path = os.path.join(user_packages_dir, "Pythonw.sublime-build")
+    maketool_build_config = {
+        "selector": "source.python",
+        "shell": True,
+        "working_dir": "${file_path}",
+        "cmd": ["maketool-run", "$file"],
+        "file_regex": "File \"(.*)\", line (.*)",
+        "variants": [
+            {
+                "cmd": ["maketool-build", "${file}"],
+                "name": "build",
+                "shell": True
+            },
+            {
+                "cmd": ["maketool-clean"],
+                "name": "clean",
+                "shell": True
+            },
+            {
+                "cmd": ["pyflakes", "${file}"],
+                "file_regex": "^(.*?):(\\d+):(\\d+): ([^\\n]+)",
+                "name": "pyflakes",
+                "shell": True
+            },
+            {
+                "name": "print",
+                "command": "run_macro_file",
+                "args": {"file": "Packages/User/print.sublime-macro"}
+            }
+        ]
+    }
+
+    # Backup existing file if it exists
+    if os.path.exists(build_file_path):
+        backup_path = build_file_path + ".bak"
+        shutil.copy2(build_file_path, backup_path)
+        print(f"Backed up existing file to {backup_path}")
+
+    # Ensure directory exists
+    print(f"user_packages_dir = {user_packages_dir}")
+    os.makedirs(user_packages_dir, exist_ok=True)
+    
+    # Write the new build file
+    with open(build_file_path, "w", encoding="utf-8") as f:
+        json.dump(maketool_build_config, f, indent=4)
+
+    print(f"Updated Sublime Text: {build_file_path}")
+
+
+
+def main():
+
+    #------------------------------------
+    # parse command line for path argument and value
+    #------------------------------------
+    # parser = argparse.ArgumentParser(
+    #     description="Setup Sublime Text for maketool integration."
+    # )
+    # parser.add_argument(
+    #     "--path",
+    #     required=True,
+    #     help=r"Path to Sublime Text folder, e.g. C:\alan\app\sublime text 4",
+    # )
+    # args = parser.parse_args()
+    # user_packages_dir = os.path.normpath(args.path)
+
+    user_packages_dir = os.path.normpath(r"C:\alan\app\sublime text 4")
+
+    process(user_packages_dir)
+
+    print("Sublime Text setup complete!")
+
+
+if __name__ == "__main__":
+
+    main()   

maketool-0.5.7/maketool.egg-info/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: maketool
+Version: 0.5.7
+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
+
+# 🛠️ 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**.
+
+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 or PyQt, `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`
+
+Executes the Python program after recursively builds all `.ui` and `.qrc` files in the current directory and subdirectories using `pyside6-uic.exe` and `pyside6-rcc.exe`.  Then run python source code.
+
+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
+
+positional parameters:
+  file        python file to run
+
+parameters:
+  -h, --help  show this help message and exit
+```
+
+### 2. `clean`
+
+Removes temporary files and build artifacts, including:
+
+- `__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`
+
+Builds your python app into an executable using PyInstaller.
+
+- Compiles `.ui` and `.qrc` and image resources  
+- Generates a PyInstaller `.spec` file  
+- Runs PyInstaller with the provided options
+
+```cli
+usage: maketool-compile [-h] --file FILE --type {onefile,onedir,console} [--icon="myicon.ico"] [--embed="sqlite3.dll"]
+
+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`
+
+Update local `Sublime Text 4` installation with these useful shortcuts:
+
+F1 - insert print statement for variable where cursor is located
+CTRL+BACKSPACE - delete line
+CTRL+ALT+E - open windows explorer where current file is located
+F5 - run pyflakes on current python source
+CTRL+0 - reset font size
+F10 - insert current date/day
+F7 - maketool-run - build and run current python script
+
+```cli
+usage: maketool-sublime [-h] --path PATH
+
+parameters:
+  -h, --help            show this help message and exit
+  --path PATH           sublime text - data/package/user path
+```
+
+---
+
+## ✨ 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/)
+- 📦 [**PyInstaller 5.8**](https://pypi.org/project/pyinstaller/)
+
+---
+
+## 📥 Installation
+
+Install maketool helper from PyPI with following command:
+
+```cli
+pip install maketool
+```
+
+---
+
+## 📝 License
+
+MIT License  
+© 2025 Alan Lilly  

maketool-0.5.7/maketool.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+maketool/__init__.py
+maketool/build.py
+maketool/clean.py
+maketool/compile.py
+maketool/run.py
+maketool/sublime.py
+maketool.egg-info/PKG-INFO
+maketool.egg-info/SOURCES.txt
+maketool.egg-info/dependency_links.txt
+maketool.egg-info/entry_points.txt
+maketool.egg-info/top_level.txt

maketool-0.5.7/maketool.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

maketool-0.5.7/maketool.egg-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+maketool-build = maketool.build:main
+maketool-clean = maketool.clean:main
+maketool-compile = maketool.compile:main
+maketool-run = maketool.run:main
+maketool-sublime = maketool.sublime:main

maketool-0.5.7/maketool.egg-info/top_level.txt

@@ -0,0 +1 @@
+maketool

maketool-0.5.7/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "maketool"
+version = "0.5.7"
+description = "Python Automation tool for building PySide6 UI and PyInstaller EXE."
+authors = [{ name = "Alan Lilly", email = "panofish@gmail.com" }]
+readme = "README.md"
+requires-python = ">=3.7"
+dependencies = []
+
+[project.scripts]
+maketool-build = "maketool.build:main"
+maketool-clean = "maketool.clean:main"
+maketool-compile = "maketool.compile:main"
+maketool-run = "maketool.run:main"
+maketool-sublime = "maketool.sublime:main"

maketool-0.5.7/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+