Documentation
¶
Index ¶
- Constants
- Variables
- func AskFromList(msg, promptPrefix string, allowVars bool, options []prompt.Suggest, ...) string
- func AskFromListWithMismatchConfirmation(promptPrefix, misMatchMsg string, options []prompt.Suggest) string
- func AskString(msg, promptPrefix string, allowEmpty bool, allowVars bool) string
- func AskStringWithDefault(msg, promptPrefix, defaultValue string) string
- func BackupFile(filePath, backupFileName string) (restore func() error, err error)
- func ConvertToSuggests(options []string) []prompt.Suggest
- func DoubleWinPathSeparator(filePath string) string
- func GetBoolSuggests() []prompt.Suggest
- func GetSuggestsFromKeys(keys []string, suggestionMap map[string]prompt.Suggest) []prompt.Suggest
- func OptionalKeyCallback(iq *InteractiveQuestionnaire, key string) (value string, err error)
- func PromptStrings(items []PromptItem, label string, onSelect func(PromptItem)) error
- func ReadCredentialsFromConsole(details, savedDetails coreutils.Credentials, disallowUsingSavedPassword bool) error
- func ScanFromConsole(caption string, scanInto *string, defaultValue string)
- func ScanJFrogPasswordFromConsole() (string, error)
- func ScanPasswordFromConsole(message string) (string, error)
- func SelectString(items []PromptItem, label string, needSearch bool, onSelect func(PromptItem)) error
- func UnixToWinPathSeparator(filePath string) string
- func WinToUnixPathSeparator(filePath string) string
- func WriteBoolAnswer(resultMap *map[string]interface{}, key, value string) error
- func WriteIntAnswer(resultMap *map[string]interface{}, key, value string) error
- func WriteStringAnswer(resultMap *map[string]interface{}, key, value string) error
- func WriteStringArrayAnswer(resultMap *map[string]interface{}, key, value string) error
- type AnswerWriter
- type InteractiveQuestionnaire
- type PromptItem
- type QuestionInfo
Constants ¶
const ( PressTabMsg = " (press Tab for options):" InvalidAnswerMsg = "Invalid answer. Please select value from the suggestions list." VariableUseMsg = " You may use dynamic variable in the form of ${key}." EmptyValueMsg = "The value cannot be empty. Please enter a valid value." OptionalKey = "OptionalKey" SaveAndExit = ":x" // Boolean answers True = "true" False = "false" CommaSeparatedListMsg = "The value should be a comma separated list" )
const (
DummyDefaultAnswer = "-"
)
Variables ¶
var FreeStringQuestionInfo = QuestionInfo{ Options: nil, AllowVars: false, Writer: WriteStringAnswer, }
Common questions
var VarPattern = regexp.MustCompile(`^\$\{\w+}+$`)
Var can be inserted in the form of ${key}
Functions ¶
func AskFromList ¶
func AskFromList(msg, promptPrefix string, allowVars bool, options []prompt.Suggest, defaultValue string) string
Ask question with list of possible answers. If answer is empty and defaultValue isn't, return defaultValue. Otherwise, the answer must be chosen from the list, but can be a variable if allowVars set to true.
func AskFromListWithMismatchConfirmation ¶
func AskFromListWithMismatchConfirmation(promptPrefix, misMatchMsg string, options []prompt.Suggest) string
Ask question with list of possible answers. If the provided answer does not appear in list, confirm the choice.
func AskStringWithDefault ¶
Ask question with free string answer. If answer is empty and defaultValue isn't, return defaultValue. Otherwise, answer cannot be empty. Variable aren't checked and can be part of the answer.
func BackupFile ¶
BackupFile creates a backup of the file in filePath. The backup will be found at backupPath. The returned restore function can be called to restore the file's state - the file in filePath will be replaced by the backup in backupPath. If there is no file at filePath, a backup file won't be created, and the restore function will delete the file at filePath.
func ConvertToSuggests ¶
func DoubleWinPathSeparator ¶
func GetBoolSuggests ¶
func GetSuggestsFromKeys ¶
func OptionalKeyCallback ¶
func OptionalKeyCallback(iq *InteractiveQuestionnaire, key string) (value string, err error)
After an optional value was chosen we'll ask for its value.
func PromptStrings ¶
func PromptStrings(items []PromptItem, label string, onSelect func(PromptItem)) error
Prompt strings by selecting from list until "Save and continue" is selected. Usage example: 🐸 Save and continue JFrog Artifactory URL (http://localhost:8080/artifactory/) JFrog Distribution URL () JFrog Xray URL () JFrog Mission Control URL () JFrog Pipelines URL ()
func ReadCredentialsFromConsole ¶
func ReadCredentialsFromConsole(details, savedDetails coreutils.Credentials, disallowUsingSavedPassword bool) error
disallowUsingSavedPassword - Prevent changing username or url without changing the password. False if the user changed the username or the url.
func ScanFromConsole ¶
func ScanPasswordFromConsole ¶
func SelectString ¶
func SelectString(items []PromptItem, label string, needSearch bool, onSelect func(PromptItem)) error
func UnixToWinPathSeparator ¶
func WinToUnixPathSeparator ¶
func WriteBoolAnswer ¶
func WriteIntAnswer ¶
func WriteStringAnswer ¶
Common writers
func WriteStringArrayAnswer ¶
Types ¶
type AnswerWriter ¶
Each question can have the following properties:
- Msg - will be printed in separate line
- PromptPrefix - will be printed before the input cursor in the answer line
- Options - In case the answer must be selected from a predefined list
- AllowVars - a flag indicates whether a variable (in form of ${var}) is an acceptable answer despite the predefined list
- Writer - how to write the answer to the final config map
- MapKey - the key under which the answer will be written to the configMap
- Callback - optional function can be executed after the answer was inserted. Can be used to implement some dependencies between questions.
type InteractiveQuestionnaire ¶
type InteractiveQuestionnaire struct {
QuestionsMap map[string]QuestionInfo
MandatoryQuestionsKeys []string
OptionalKeysSuggests []prompt.Suggest
AnswersMap map[string]interface{}
}
The interactive questionnaire works as follows:
We have to provide a map of QuestionInfo which include all possible questions may be asked. 1. Mandatory Questions: * We will ask all the questions in MandatoryQuestionsKeys list one after the other. 2. Optional questions: * We have to provide a slice of prompt.Suggest, in which each suggest.Text is a key of a question in the map. * After a suggestion was chosen from the list, the corresponding question from the map will be asked. * Each answer is written to the configMap using its writer, under the MapKey specified in the questionInfo. * We will execute the previous step until the SaveAndExit string was inserted.
func (*InteractiveQuestionnaire) AskQuestion ¶
func (iq *InteractiveQuestionnaire) AskQuestion(question QuestionInfo) (value string, err error)
Ask question steps:
- Ask for string/from list
- Write the answer to answersMap (if writer provided)
- Run callback (if provided)
func (*InteractiveQuestionnaire) Perform ¶
func (iq *InteractiveQuestionnaire) Perform() error
The main function to perform the questionnaire
Source Files