ezpyc 0.1.0

Easy Python Commands

ezpyc

Easy Python Commands allows you to execute your python scripts as if they were system commands.

Without ezpyc:

python mycommand.py
# or
python C:\Users\wintermute\dev\mycommand.py

With ezpyc:

mycommand

✅ Requirements

• Python >=3.11
  • Add python.exe to PATH
• Windows >=10

🖥️ How to install ezpyc for Windows

Clone repo and run python src/ezpyc.py install as administrator:

git clone https://github.com/itonx/ezpyc

cd ezpyc

python src/ezpyc.py install

Output:

└─ ...
▒ Setup done. Create a new python script at C:\Users\ayrto\.ezpyc and try to run it. If you cannot execute it, restart your terminal or open a new one.

Once the installation's done you'll be able to execute your python scripts as if they were simple windows commands. All scripts must be added to %USERPROFILE%\.ezpyc if don't want to type the full path of your scripts.

Installation details

The installation will make the next changes on your system:

• Create .ezpyc folder: %USERPROFILE%\.ezpyc
• Add .ezpyc folder to PATH environment variable for CURRENT_USER
• Add .PY extension to PATHEXT environment variable for LOCAL_MACHINE
• Add built-in ezpyc scripts

Built-in ezpyc scripts

%USERPROFILE%\.ezpyc
│   ezpyc.py
└───ezpyc
    __init__.py
    clipboard.py
    command_decorators.py
    env_variable.py
    file.py
    folder.py
    installation_wizard.py
    os_decorators.py
    output.py

Details:

Built-in scripts are created to help you getting started with your own python script commands. All scripts use click to manage command line arguments. hworld is the simplest script, you might want to follow its structure to create simple scripts/commands. The rest of built-in files are a simple abstraction of click, you could follow their structure to create your own abstraction for complex scripts/commands with your own python packages.

• %USERPROFILE%\.ezpyc\ezpyc is a python package which contains shared code for ezpyc.py.
• ezpyc.py manages your ezpyc installation

ezpyc command accepts -h and --help args.

⚒️ Create your first script/command

This process is as simple as creating a new file with a print.

mycommand.py

print('mycommand works')

Magic happends once you place your scripts at %USERPROFILE%\.ezpyc.

%USERPROFILE%\.ezpyc
└───mycommand.py

Open a terminal and run the command using the name of your script (no need to type the full path or restart the terminal if you add new scripts to .ezpyc folder):

mycommand

If you want to know how to process command line arguments with click see documentation: https://click.palletsprojects.com/en/stable/.

🖥️ How to uninstall

Option 1: ezpyc_installer.py

Clone repo and run python src/ezpyc.py uninstall as administrator:

git clone https://github.com/itonx/ezpyc

cd ezpyc

python src/ezpyc.py uninstall

Output:

└─ ...
▒ ezpyc's been uninstalled. C:\Users\wintermute\.ezpyc needs to be deleted manually, don't forget to backup your scripts.

Method 2: built-in ezpyc command

This will work only if you installed ezpyc.

Run as administrator:

ezpyc uninstall

Output:

└─ ...
▒ ezpyc's been uninstalled. C:\Users\wintermute\.ezpyc needs to be deleted manually, don't forget to backup your scripts.

NOTE: Commands will be available until you restart your terminal or open a new one.