cli tools are super handy and easy to add to your python libraries to supercharge them. Even if your library is not a cli tool there are a number of things that a cli can do to your library.

Example Ideas

Things a cli can do to enhance your library.

🆚 print version
📃 print config
🕶 print readme
📝 print changelog
✏ change config
👩‍🎓 run a tutorial
🏗 scaffold a project with cookiecutter

🖱 Click

Click is the most popular python cli tool framework for python. There are others, some old, some new comers that make take the crown. For now Click is the gold standard if you want to make a powerful cli quickly. If you are dependency conscious and dont need a lot of tooling, use argparse.

Project Structure

.
├── setup.py
└── simple_click
    ├── cli.py
    └── __init__.py

❯ cli.py

# simple_click/cli.py
import click

__version__ = "1.0.0"

@click.group()
def cli():
   pass

@cli.command()
def version():
    """prints project version"""
    click.echo(__version__)


if __name__ == '__main__':
    cli()

✨ __init__.py

For our simple_click library __init__.py__ can be left empty. It is here purely to signify that simple_click is a library. It is likely that you will import other modules here that need to reside at the top level of your library api, your cli does not need to be at the top of of your api.

# __init__.py

🚪 Entry Points

Entry points are the magic that make python cli tools available as their own command without having python before it or the file extension.

# setup.py

from setuptools import setup, find_packages

# this is the 🥩 meat of this snippet
# simple_click is the command name
# = simple_click is the library name
# .cli is the cli.py file
# :cli is the cli function
#
# the second item is a shorthand alias to the main command

entry_points = [
   "simple_click = simple_click.cli:cli",
   "scli         = simple_click.cli:cli",
]


setup(
    name='simple_click',
    version='1.0.0',
    url='https://github.com/mypackage.git',
    packages=find_packages(),
    entry_points={"console_scripts": entry_points},

)

🕶 See it in action

📢 Discuss

What do You wish more python libraries included in their cli?

Shameless Plug

This page was originally posted on my personal blog https://waylonwalker.com/b/scli/