Software Tools – Page 5 – The Renegade Coder

Once again, thanks for stopping by for another edition of the How to Python. In this tutorial, we'll be taking a step away from Python coding and looking at Python execution. Specifically, we'll be looking at different ways to make a Python script shortcut with arguments. Let's dive in! Problem Introduction Recently, in an effort to simplify my image editing process, I wrote a nice image titling script. Basically, this script generates the titles on my featured images. At first, I developed this script to save me time on image editing. While the script was much faster and more convenient, it quickly became frustrating to find image paths, so I added a feature to allow me to browse the explorer. After that, I added some features to shortcut image titling. Eventually, I added an output path feature as an argument, so I didn't have to move images myself anymore: trc-image-titler.py -o /path/to/output Despite all these features, I still wanted to improve my own user experience, so I decided to make the script a shortcut with arguments. That way, I wouldn't have to open PyCharm every time I wanted to title some image. Solutions As with many problems in this series, there are always a handful of options. Making a Python script shortcut with arguments is no exception. Let's take a look. Create a Windows Shortcut As a fair warning, I own a Windows 10 PC that I tend to use for development. As a result, my primary solution will only be applicable to Windows users: Right-click the script and select create a shortcutRight-click the new shortcut and select propertiesUnder the shortcut tab, note the target optionAdd your options to the target as follows: \path\to\trc-image-titler.py -o \path\to\output Assuming all of your paths are setup correctly, this shortcut with arguments should run your script as expected. Personally, I ran into some issues with site-packages differing from PyCharm, so I had to install them by hand. Note: the target dialogue is limited to 260 characters. Unfortunately, I learned this lesson the hard way. Check out this thread and this thread for more details. That said, there's a nice workaround that involves creating a system variable for all your arguments. Create a Batch File As an alternative, you can always create your own batch script. Yeah, I know this is supposed to be a Python tutorial, but this is helpful information regardless. At any rate, here's a sample batch script that would run a hypothetical Python file: @echo off \path\to\trc-image-titler.py -o \path\to\output Notice that this is effectively the same idea as the shortcut with arguments except we now have a file with a .bat extension. The advantage here is we have more options. For instance, we could spawn up a virtual environment which installs the libraries we need. If you need help writing a Batch file, I found a great little tutorial. Create a Bash Script For everyone else, there's shell scripting: #!/bin/sh python /path/to/trc-image-titler.py -o /path/to/output Again, the solution is basically the same as the batch file. As a result, we can customize the script to our needs. Personally, I didn't need scripting at all, but maybe you do. If you need help writing a shell script, I found another great tutorial. Troubleshooting Typically, we don't need a troubleshooting section for articles in this series, but running Python scripts isn't always easy. In fact, that trickiness is what drove me to share much of the same disdain for Python's package management as this author despite really loving the language. So to help you out, I wanted to share a bit of a caveat for this tutorial. Be aware of your system path. Personally, I have both Python 2 and 3 installed on my PC. This creates an odd situation where I have the py keyword in my system path rather than the python keyword. In addition, I am able to specify the Python version with this py keyword, but Python 3 is the default. If you're in a similar situation, it may be easier to specify the Python executable in your shortcut or script: \path\to\python.exe \path\to\trc-image-titler.py -o \path\to\output Of course, this doesn't solve dependency issues. In that case, you might need to play around with virtual environments. If you've found a better way to run your scripts with arguments, let me know in the comments. A Little Recap Usually, we'd be working with Python, but I figured we could cover a little bit of Python execution today. At any rate, let's get to the recap. Windows Shortcut with Arguments \path\to\trc-image-titler.py -o \path\to\output Batch File with Arguments @echo off \path\to\trc-image-titler.py -o \path\to\output Bash Script with Arguments #!/bin/sh python /path/to/trc-image-titler.py -o /path/to/output And, there we have it! If you enjoyed this article, give it a share. As always, comments and suggestions are welcome.