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 = enabled
print("pycodetools")

That first line is what PCT looks for. Run the file through pct and it detects the line, prints a confirmation, and unlocks the extra helpers below. Run it with plain python file.py instead and it will raise NameError: name 'enabled' is not defined — always launch PCT-enabled scripts with pct, not python.

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:

pycodetools = enabled
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 = enabled
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