Python Fire – Turning any Python script into a command line tool

It’s been a while since I wrote a post and I’m also going to make this one a short one.

Python Fire is a pretty cool Python library from Google that lets you turn any Python script into a command line tool, this means that you don’t have to write any logic for handling command line parameters and options, but, if you script has sophisticated use cases then you’ll be probably be better by using argparse from the standard library.

You can install Python fire from pip by running these commands:

pip install ipython<br></br>pip install fire

Then, to turn your script into a command line tool, all you need to do is import fire and and call the Fire method by passing it a class. Fire parses the class and generates logic for handling command line arguments for each method the class has. For example:

class LzwCommandLineAdapter:
    """
    This will be used with Google Fire for easy usage,
    so we can avoid argparse/optparse.
    """
    @staticmethod
    def encode(filename, out="encoded.txt"):
        """
        Encodes the text from the give filename.
        """
        pass
    @staticmethod
    def decode(filename, out="decoded.txt"):
        """
        Decodes the text from the given filename.
        """
        pass
 
if __name__ == "__main__":
    import fire
    fire.Fire(LzwCommandLineAdapter)

When we run the script, we get the following result:

➜  Desktop python lzw.py
 Type:      LzwCommandLineAdapter
 File:      ~/Desktop/lzw.py
 Docstring: This will be used with Google Fire for easy usage,
 so we can avoid argparse/optparse.
 Usage:     lzw.py
            lzw.py decode
            lzw.py encode
 ➜  Desktop python lzw.py decode
 Fire trace:
 Initial component
 Instantiated class "LzwCommandLineAdapter" (lzw.py:248)
 Accessed property "decode" (lzw.py:264)
 ('The function received no value for the required argument:', 'filename') 
 Type:        function
 String form: 
 File:        ~/Desktop/lzw.py
 Line:        264
 Docstring:   Decodes the text from the given filename.
 Usage:       lzw.py decode FILENAME [OUT]
              lzw.py decode --filename FILENAME [--out OUT]

This is a pretty nice solution when you’re writing lots of Python scripts to experiment with things. Thank you for reading!

Further reading