is a Go library that provides a simple interface to create cli prompts. The library has two main modes: — which provides a single line for user input, and — which displays a list of items to choose from. Both modes have several options for customization and take advantage of the powerful to support multiple terminals. promptui Prompt Select readline In this post we are going to create a food recipe command-line app that asks for a dish type, retrieves information from an API and displays the relevant recipes. If you want to jump to the complete app source code, go to: https://github.com/luizbranco/promptui-demo/ Initial Prompt Before we begin our app, we first need to get the library: go get -u github.com/manifoldco/promptui With that in our Go path we can start writing our file. main.go If you then run the program, you should see a prompt asking to search: go run main.go That seems nice, but if we just press enter without entering information it still works. It would be nice if we could prevent empty searches. So lets add a validation to the prompt: This is a very simple validation. But you can create more complex ones using regexp or , for example. govalidator Retrieving data For this cli app we are going to use the awesome to search for recipes. Its doesn’t require authentication, so it’s perfect for our . RecipePuppy API experiment First we define how to request the data: That’s easy! Now we have to parse the response JSON. First we need an example of the data returned: As we can see, there is an array of results with title, link and a list of ingredients for each recipe. With that, we can define a few structures to parse the body: Displaying Data Now that we have the list of recipes parsed, we can use to display it to the user. Select Well, that’s a bit ugly. The issue here is that promptui usually expects a slice of strings to display. But we have recipe structures instead. We have to teach promptui how to display them. That’s when templates are handy: If you have used Go you should be familiar with the syntax. Promptui out-of-the-box supports a few template functions such as colors and styles, but you can define your own helpers. templates/html Much better! Notice the pizza unicode symbol there. Go supports UTF-8 source code 👍. Additional Details Since we also have a list of ingredients, we can show it when users are hovering an element with the template option. But first, lets be good cli citizens and avoid a long list of ingredients! Details This defines a custom helper function that truncates strings longer than X characters. Then we change templates to be: Search Finally, lets allow users to search the list inline for either the recipe name or ingredients: As it was with the validation example, this is a trivial string search, but you can make as complex as you need. Final Thoughts promptui was part of our in which we use mainly as a fallback when users don’t input all flags necessary for commands. This small app shows a few features of promptui, but the library has much more to offer. Make sure to check the . command-line tool Manifold Github project page
