// Package zenity provides cross-platform access to simple dialogs that interact // graphically with the user. // // It is inspired by, and closely follows the API of, the zenity program, which // it uses to provide the functionality on various Unixes. See: // // https://help.gnome.org/users/zenity/stable/ // // This package does not require cgo, and it does not impose any threading or // initialization requirements. package zenity import ( "context" "image/color" ) type stringErr string func (e stringErr) Error() string { return string(e) } func stringPtr(s string) *string { return &s } type options struct { // General options title *string width uint height uint okLabel *string cancelLabel *string extraButton *string icon DialogIcon // Entry options entryText string hideText bool // Message options noWrap bool ellipsize bool defaultCancel bool // File selection options directory bool confirmOverwrite bool confirmCreate bool showHidden bool filename string fileFilters []FileFilter // Color selection options color color.Color showPalette bool // Context for timeout ctx context.Context } // An Option is an argument passed to dialog functions to customize their // behavior. type Option interface { apply(*options) } type funcOption func(*options) func (f funcOption) apply(o *options) { f(o) } func applyOptions(options []Option) (res options) { for _, o := range options { o.apply(&res) } return } // Title returns an Option to set the dialog title. func Title(title string) Option { return funcOption(func(o *options) { o.title = &title }) } // Width returns an Option to set the dialog width (Unix only). func Width(width uint) Option { return funcOption(func(o *options) { o.width = width }) } // Height returns an Option to set the dialog height (Unix only). func Height(height uint) Option { return funcOption(func(o *options) { o.height = height }) } // OKLabel returns an Option to set the label of the OK button. func OKLabel(ok string) Option { return funcOption(func(o *options) { o.okLabel = &ok }) } // CancelLabel returns an Option to set the label of the Cancel button. func CancelLabel(cancel string) Option { return funcOption(func(o *options) { o.cancelLabel = &cancel }) } // ExtraButton returns an Option to add an extra button. func ExtraButton(extra string) Option { return funcOption(func(o *options) { o.extraButton = &extra }) } // DialogIcon is the enumeration for dialog icons. type DialogIcon int // The stock dialog icons. const ( ErrorIcon DialogIcon = iota + 1 WarningIcon InfoIcon QuestionIcon PasswordIcon NoIcon ) // Icon returns an Option to set the dialog icon. func Icon(icon DialogIcon) Option { return funcOption(func(o *options) { o.icon = icon }) } // Context returns an Option to set a Context that can dismiss the dialog. // // Dialogs dismissed by the Context return Context.Err. func Context(ctx context.Context) Option { return funcOption(func(o *options) { o.ctx = ctx }) }