pyopt

I recently had the pleasure of using pyopt, a Python 3 module that simplifies command-line options with a decorator-centric syntax. This tool provides an easy way to auto-generate help with docstrings, as well as type casting for arguments and enforcing argument count.

One example that utilizes pyopt involves rolling a dice – this is extremely useful for gamers who want to test their luck or play D&D. By setting up two arguments for the number of faces and the amount of repetitions, you can easily achieve the desired output. Here is a sample code:

import pyopt
import random
expose = pyopt.Exposer()
@expose.args
def roll_dice(number_of_faces:int, repetitions:int):
'''
Roll the dice to see if you are lucky or for general D&D pleasure.
number_of_faces - the max value of the die.
repetitions - the amount of times to throw the dice.
'''
for i in range(repetitions):
print(random.randint(1, number_of_faces))
expose.run()

Overall, there are three modes of operation with pyopt: positional arguments, keyword arguments, and a mixture of both. This makes it flexible for various projects.

Of course, there are certain limitations with this tool. For instance, certain features cannot be converted to Python 2.x, and keyword command-line functions require every argument to start with a different letter to avoid collisions. Annotations aren't mandatory either, and while it's a slight inconvenience, it's still an option. Lastly, defaulting booleans to false is not possible – although, the need for such a feature is unclear.

Overall, pyopt is an excellent tool for simplifying command-line options with an easy-to-use Pythonic syntax. The benefits of this module far outweigh the minor concerns, and I would highly recommend it to anyone looking for an easier way to manage command-line options in Python 3.