47 lines
2 KiB
Markdown
47 lines
2 KiB
Markdown
# Zenity dialogs for Golang, Windows and macOS
|
|
|
|
[](https://pkg.go.dev/github.com/ncruces/zenity)
|
|
[](https://goreportcard.com/report/github.com/ncruces/zenity)
|
|
|
|
This repo includes both a cross-platform Go package providing
|
|
[Zenity](https://help.gnome.org/users/zenity/stable/)-like dialogs
|
|
(simple dialogs that interact graphically with the user),
|
|
as well as a *“port”* of the `zenity` command to both Windows and macOS based on that library.
|
|
|
|
**This is a work in progress.**
|
|
|
|
Lots of things are missing.
|
|
For now, these are the only implemented dialogs:
|
|
* [message](https://github.com/ncruces/zenity/wiki/Message-dialog) (error, info, question, warning)
|
|
* [file selection](https://github.com/ncruces/zenity/wiki/File-Selection-dialog)
|
|
* [color selection](https://github.com/ncruces/zenity/wiki/Color-Selection-dialog)
|
|
* [text entry](https://github.com/ncruces/zenity/wiki/Text-Entry-dialog)
|
|
* [password](https://github.com/ncruces/zenity/wiki/Password-dialog)
|
|
* [notification](https://github.com/ncruces/zenity/wiki/Notification)
|
|
|
|
Behavior on Windows, macOS and other Unixes might differ slightly.
|
|
Some of that is intended (reflecting platform differences),
|
|
other bits are unfortunate limitations,
|
|
others still are open to be fixed.
|
|
|
|
## Why?
|
|
|
|
There are a bunch of other dialog packages for Go.\
|
|
Why reinvent this particular wheel?
|
|
|
|
#### Benefits:
|
|
|
|
* no `cgo` (see [benefits](https://dave.cheney.net/2016/01/18/cgo-is-not-go), mostly cross-compilation)
|
|
* no main loop (or any other threading or initialization requirements)
|
|
* cancelation through [`context`](https://golang.org/pkg/context/)
|
|
* on Windows:
|
|
* no additional dependencies
|
|
* Explorer shell not required
|
|
* works in Server Core
|
|
* Unicode support
|
|
* High DPI support (no manifest required)
|
|
* WSL/Cygwin/MSYS2 [support](https://github.com/ncruces/zenity/wiki/Zenity-for-WSL,-Cygwin,-MSYS2)
|
|
* on macOS:
|
|
* only dependency is `osascript`
|
|
* on other Unixes:
|
|
* wraps either one of `zenity`, `qarma`, `matedialog`
|