PyCodeTools (PCT)

Run Python scripts with a few extra scripting helpers, and package them into standalone .exe files from a simple Tkinter GUI — all from the command line.

Install

pip install PyCodeTools

This gives you two equivalent commands: pycodetools and pct.

Enabling PCT in a script

Add this as the first line of your .py file:

pycodetools = {true}PCT.enable
print("pycodetools")

That first line is what PCT looks for. It's still valid, harmless Python (just a variable assignment) if someone runs the file normally with python file.py — but when you run it through PCT, PCT detects it, prints a confirmation, and unlocks extra helpers for your script.

Running a script

pct myscript.py
# or explicitly:
pct run myscript.py
# or the long form:
pycodetools myscript.py

If the enable line is found, you'll see:

{true}PCT.enable
PyCodeTools is now enabled for this run.
Running: py myscript.py
----------------------------------------
pycodetools

Extra helpers in your script

Once enabled, your script can use the extra helper functions by importing the package:

pycodetools = {true}PCT.enable
import pycodetools as pct

if pct.enabled:
    pct.title("My App")
    pct.banner("Welcome!")
    print(pct.color("This is red text", "red"))
    pct.timer(3)
    if pct.confirm("Keep going?"):
        print("Continuing...")
    pct.pause()

Available helpers:

Config / Build GUI

pct config myscript.py

Opens a Tkinter window with two tabs:

• Dependencies — pick from a preset list of common packages (or type a custom one) and install them with pip.
• Build .exe — compile the script into a standalone executable using PyInstaller, with options for one-file builds, hiding the console window, and naming the output.

Building .exe files requires PyInstaller:

pip install PyCodeTools[build]

License

MIT