{"componentChunkName":"component---src-pages-post-index-js","path":"/building-cli-with-python/","result":{"data":{"site":{"siteMetadata":{"siteUrl":"https://www.zuhaibahmad.com"}},"ogImageFile":null,"markdownRemark":{"id":"16f9153a-cbff-5ef8-a567-4b24ec476dc2","html":"

When it comes to command-line interfaces (CLI), they are often viewed as dull and unengaging. However, CLI wizards offer a fun and interactive way for users to interact with the CLI. In this post, we'll take a deep dive into how to create a beautiful CLI wizard using PyInquirer.

\n

What is PyInquirer?

\n

PyInquirer is an interactive CLI prompt library that allows you to build interactive command-line interfaces. The library provides intuitive prompts with various controls and widgets, such as dropdowns, checkboxes, text input, and more. The library is built on top of the prompt-toolkit library for Python.

\n

How to Install PyInquirer

\n

To install PyInquirer, open your terminal and run the following command:

\n\n pip install PyInquirer\n \n

Creating a CLI Wizard with PyInquirer

\n

To create a CLI wizard using PyInquirer, you need to first define the questions to ask the user. In PyInquirer, these questions are referred to as prompts. The library supports various types of prompts, including input prompts, list prompts, checkbox prompts, and more.

\n

Here's an example of a simple CLI wizard using PyInquirer:

\n\n from PyInquirer import prompt\n\nquestions = [\n {\n 'type': 'input',\n 'name': 'name',\n 'message': 'What is your name?'\n },\n {\n 'type': 'checkbox',\n 'message': 'Select toppings',\n 'name': 'toppings',\n 'choices': [\n {'name': 'Pepperoni'},\n {'name': 'Mushroom'},\n {'name': 'Onion'},\n {'name': 'Tomato'},\n {'name': 'Extra cheese'},\n ],\n 'validate': lambda answer: 'You must choose at least one topping.' \\\n if len(answer) == 0 else True\n }\n]\n\nanswers = prompt(questions)\nprint(answers)\n \n

In this example, we define two prompts: one for the user's name and another for the pizza toppings they want. The prompts are defined using a Python dictionary, with each prompt having a name, type, and message.

\n

We use the prompt method to display the prompts and get the user's answers. The method returns a dictionary containing the answers provided by the user.

\n

Customizing the Look of the CLI Wizard

\n

pyinquirer provides several customization options that allow you to tweak the look and feel of the CLI wizard. You can change the color of the prompts, change the borders, add headers and footers, and more.

\n

Here's an example of a custom CLI wizard using pyinquirer:

\n\n from PyInquirer import prompt, style_from_dict, Token\n\nstyle = style_from_dict({\n Token.Separator: '#cc5454',\n Token.QuestionMark: '#7f7fff bold',\n Token.Selected: '#5F819D', # default\n Token.Pointer: '#5F819D bold',\n Token.Instruction: '', # default\n Token.Answer: '#5F819D bold',\n Token.Question: '',\n})\n\nquestions = [\n {\n 'type': 'list',\n 'name': 'theme',\n 'message': 'What do you want to do?',\n 'choices': [\n 'Create a new project',\n 'Help',\n 'Exit',\n ],\n 'default': 'Create a new project',\n 'filter': lambda val: val.lower()\n },\n {\n 'type': 'input',\n 'name': 'project_name',\n 'message': 'Project name:',\n 'validate': lambda answer: 'You must enter a project name.' \\\n if len(answer) == 0 else True\n },\n]\n\nanswers = prompt(questions, style=style)\nprint(answers)\n \n

In this example, we define a custom style for the CLI wizard using a Python dictionary. We then pass the style to the prompt method to apply it to the prompts.

\n

\n \n