码云 Gitee IDE 全新上线——支持 Git 管理的轻量在线编码环境
0 Watch 1 Star 1 Fork 1

君无畏 / adb4jJava

加入码云
与超过 300 万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
暂无描述
junwuwei 最后提交于 console ui
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README.md 3.33 KB

Build Status

Console UI

Join the chat at https://gitter.im/awegmann/consoleui

Tiny java library that provides simple UI elements on ANSI console based terminals. ConsoleUI is inspired by Inquirer.js which is written in JavaScript.

Intention

I was impressed by JavaScript based Yeoman which leads the user through the process of creating new projects by querying with a simple user interface on the console. An investigation how this is done, brought me to Inquirer.js which implements a very simple and intuitive set of controls for checkbox, list and text input.

Because I didn't found anything comparable to this in the Java eco system, I decided to write Console UI as a library with the same easy 'look and feel'. Some parts of the API are also comparable, but Console UI is not a Java clone of Inquirer.js.

Features

Console UI currently supports:

  • Text input with completion and GNU ReadLine compatible editing
  • Checkboxes
  • Lists
  • Expandable Choices (multiple key based answers for a question with help and optional list navigation)
  • Yes/No-Questions

A screen recording of the basic elements demo can be fund on Youtube console UI demo.

Dependencies

Console UI uses jansi and jline for the dirty console things.

Test Run

You can get an idea how the project works by looking at de.codeshelf.consoleui.Basic. You can run this by executing the following from the project root:

gradlew fatJar 
java -jar build/libs/consoleui-all-0.0.10.jar     # <- replace with the latest version

Usage

Before you can use Console UI the AnsiConsole library has to be initialized.

AnsiConsole.systemInstall();

Entry point to the builder classes is to create a new object of type ConsolePrompt.

ConsolePrompt prompt = new ConsolePrompt();

From the prompt object, use the getPromptBuilder() method to create the builder for all subsequent UI elements you want to use.

PromptBuilder promptBuilder = prompt.getPromptBuilder();

From with this PromptBuilder you can access UI builder with the following methods:

  • createCheckboxPrompt()
    • creates a checkbox prompt. This prompt lets the user choose any number of items of a given list.
  • createChoicePrompt()
    • creates a choice prompt. This prompt lets the user choose one from a given number of possible answers.
  • createConfirmPromp()
    • creates a confirm prompt. This prompt lets the user answer with 'yes' or 'no' to a given question.
  • createInputPrompt()
    • creates a input prompt. This prompt is a classic entry line like a shell. Because of the underlying readline implementation it offers you to provide completers (like file name completer or string completer). In addition to his, you can define a mask character which is printed on the screen instead of the typed keys like used for hidden password entry.
  • createListPrompt()
    • creates a list prompt. This prompt lets the user choose one item from a given list.

项目点评 ( 0 )

你可以在登录后,发表评论

搜索帮助