interesting
/
andlabs-ui
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
421 Commits 4 Branches 1 Tag 48 MiB
Go 59.1%
C 40.8%
Go to file
Pietro Gagliardi 34549384ae Update README now that I think I have the API as I want it. 2014-03-12 21:24:22 -04:00
test Added GTK+ indeterminate ProgressBars. 2014-03-12 17:31:13 -04:00
unmigrated unmigrated/messages_windows.go removed; it was migrated ages ago (in uitask_windows.go). The only thing that is lost here is HWND_BROADCAST, but we don't use it. 2014-03-10 11:24:41 -04:00
.travis.yml Remove the 32-bit GTK+ from linux/386 Travis.ci builds; I have no idea how to fix this. 2014-03-05 12:38:49 -05:00
LICENSE Added license and README. 2014-02-17 18:38:50 -05:00
README.md Update README now that I think I have the API as I want it. 2014-03-12 21:24:22 -04:00
bleh_darwin.m Have ui.Go() return on main() return on Mac OS X. 2014-03-05 20:09:15 -05:00
button.go Removed error returns from [all controls].SetText() and Window.SetTitle(). 2014-03-10 10:45:15 -04:00
callbacks_unix.go Changed the way uitask is dispatched on GTK+ to make event handling not a CPU hog. 2014-03-12 20:00:29 -04:00
checkbox.go Removed a TODO in Checkbox and made its behavior more precise. 2014-03-11 11:47:38 -04:00
cocoalists Added the beginning of the Mac OS X implementation of Combobox; also added a file to plan out how lists will be implemented/are being implemented. 2014-03-02 17:19:25 -05:00
combobox.go Removed error returns from Combobox.Delete(), Listbox.Delete(), and sysData.delete(), since they are no longer used. Updated the TODO file to mark this issue closed. 2014-03-11 13:50:02 -04:00
comctl_windows.go Added indeterminate ProgressBar code on Windows and fixed up a few other things along the way. 2014-03-12 18:53:57 -04:00
common_windows.go Added Windows implementation of ProgressBar and the requisite comctl32.dll code. 2014-02-25 08:28:10 -05:00
control.go Removed error returns from Control.preferredSize() since errors are not going to be returned anymore. 2014-03-09 19:44:41 -04:00
controlcandidates.md More control candidate information. 2014-03-07 09:12:15 -05:00
controls_windows.go Dropped Windows 2000 support. 2014-03-12 16:58:33 -04:00
d32 cgo inserts -m32 automatically, so we don't need to in ./d32. 2014-03-08 17:32:56 -05:00
delegate_darwin.go More TODO reduction. 2014-03-11 11:54:32 -04:00
dialog.go Standardized message boxes so they appear similarly on all platforms. This shafts Windows because primary/secondary text message boxes were only added in Windows Vista, but at least MSDN provides discourse. 2014-03-12 12:14:24 -04:00
dialog_darwin.go Standardized message boxes so they appear similarly on all platforms. This shafts Windows because primary/secondary text message boxes were only added in Windows Vista, but at least MSDN provides discourse. 2014-03-12 12:14:24 -04:00
dialog_unix.go Removed a stray TODO resolved by the previous few commits. 2014-03-12 12:34:09 -04:00
dialog_windows.go Made message boxes run on uitask on Windows; adjusted some related TODOs. 2014-03-12 12:21:50 -04:00
grid.go Added more TODOs. 2014-03-11 17:38:31 -04:00
gtkcalls_unix.go Changed the way uitask is dispatched on GTK+ to make event handling not a CPU hog. 2014-03-12 20:00:29 -04:00
gtkcasts_unix.go Added GTK+ implementation of ProgressBar and added a ProgressBar to the test program. 2014-02-25 00:49:08 -05:00
implementation.md Changed the way uitask is dispatched on GTK+ to make event handling not a CPU hog. 2014-03-12 20:00:29 -04:00
init.go Update ui.Go() documentation to show that it will return nil when its main() returns now that that behavior is fully implemented. 2014-03-05 20:11:45 -05:00
init_windows.go More TODO reduction. 2014-03-11 12:22:04 -04:00
label.go Removed error returns from [all controls].SetText() and Window.SetTitle(). 2014-03-10 10:45:15 -04:00
layoutplan.md Added a new layout plan for Stack. 2014-02-24 10:22:23 -05:00
lineedit.go Removed error returns from [all controls].SetText() and Window.SetTitle(). 2014-03-10 10:45:15 -04:00
listbox.go Split NewListbox() into NewListbox() (single-selection) and NewMultiSelListbox() (multiple selection); fixed the documentaiton for the Listbox constructor(s) to talk about Listbox and not Combobox, and added some TODOs. 2014-03-11 20:44:04 -04:00
listbox_darwin.go Made Listboxes non-editable in Mac OS X; also more TODOs. 2014-03-09 11:33:05 -04:00
listbox_unix.go Removed gListboxSelected; it was never being called anyway (only gListboxSelectedMulti is; Windows still uses selectedIndex() for Listbox because of differences in how multi-selection listboxes are handled there and Mac OS X never had this function written to begin with). 2014-03-09 11:36:44 -04:00
menus_windows.go Moved to a proper package; main() is now a test and go test -c is used to build. Once I iron out a bug with Windows event handling, I'll add a README. 2014-02-19 11:41:10 -05:00
objc_darwin.go Added initial Mac OS X sysData code. Almost ready for first test build, hopefully? 2014-03-01 13:29:24 -05:00
objc_darwin.h Have ui.Go() return on main() return on Mac OS X. 2014-03-05 20:09:15 -05:00
plan.md Added version compatibility notes to plan.md. 2014-02-16 16:55:48 -05:00
prefsize_darwin.go Removed a leftover crash guard from the Mac OS X sysData code (in this case sysData.preferredSize()). 2014-03-03 15:45:26 -05:00
prefsize_unix.go Added the preferred widget size basework and its GTK+ implementation. 2014-02-23 20:04:33 -05:00
prefsize_windows.go Changed Windows sysData.preferredSize() to panic on error, since the other platforms don't return explicit errors either. 2014-03-09 19:34:43 -04:00
progressbar.go Added GTK+ indeterminate ProgressBars. 2014-03-12 17:31:13 -04:00
restrictions.md Windows sysData has been adjusted to deal with child controls. Rather than storing the parent window, it is passed as an argument to sysData.make(), which does the child ID allocation. Child IDs are now window-local, getting rid of that restriction. 2014-02-12 21:08:10 -05:00
stack.go Made Stack.SetStretchy() panic on invalid index, ending that group of functions. Also added the tests for those functions who did not have tests already written. 2014-03-11 17:37:04 -04:00
stdfont_windows.go Re-added Windows font grabbing code. I won't use it just yet, since I only now realize I don't actually need it for preferred sizes, but eh 2014-02-24 11:55:38 -05:00
stdwndclass_windows.go Fixed Mac OS X control placement flipping. This is done by passing the height of the window around setRect() calls to avoid polling the content view frame each time. 2014-03-03 17:44:03 -05:00
sysdata.go Removed error returns from Combobox.Delete(), Listbox.Delete(), and sysData.delete(), since they are no longer used. Updated the TODO file to mark this issue closed. 2014-03-11 13:50:02 -04:00
sysdata_darwin.go Added indeterminate ProgressBar code for Mac OS X. 2014-03-12 19:40:01 -04:00
sysdata_unix.go Added GTK+ indeterminate ProgressBars. 2014-03-12 17:31:13 -04:00
sysdata_windows.go Added indeterminate ProgressBar code on Windows and fixed up a few other things along the way. 2014-03-12 18:53:57 -04:00
test.sh Changed the ".." import in the test binary to a proper "github.com/andlabs/ui" import. (This means I finally moved my working environment out of a folder src/wingo and into the proper src/github.com/andlabs/ui.) 2014-03-04 23:10:48 -05:00
todo.md Whoops, that commit that was to remove the ProgressBar line from todo.md actually removed the wrong line; fixed. 2014-03-12 20:01:30 -04:00
uitask_darwin.go Made programs go to the front of the screen on Mac OS X like other programs do (and like on other platforms). 2014-03-12 10:02:59 -04:00
uitask_unix.go Changed the way uitask is dispatched on GTK+ to make event handling not a CPU hog. 2014-03-12 20:00:29 -04:00
uitask_windows.go Have ui.Go() return on main() return on Windows. 2014-03-05 13:21:45 -05:00
window.go Removed error returns from [all controls].SetText() and Window.SetTitle(). 2014-03-10 10:45:15 -04:00
windows_windows.go Added indeterminate ProgressBar code on Windows and fixed up a few other things along the way. 2014-03-12 18:53:57 -04:00
winerrors.md More TODO reduction. 2014-02-15 15:41:50 -05:00

README.md

Build Status

Native UI library for Go

THIS PACKAGE IS UNDER ACTIVE DEVELOPMENT. It can be used; the API is stable enough at this point, but keep in mind there may still be crashes and API changes, as suggestions are always open. If you can help, please do! Run ./test to build a test binary test/test which runs a (mostly) feature-complete UI test. Run ./d32 ./test to build a 32-bit version (you will need a cgo-enabled 32-bit go environment, and I have only tested this on Mac OS X).

UPDATE 12 March 2014: Windows 2000 is no longer supported as it is no longer supported by Go.

This is a simple library for building cross-platform GUI programs in Go. It targets Windows, Mac OS X, Linux, and other Unixes, and provides a thread-safe, channel-based API. The API itself is minimal; it aims to provide only what is necessary for GUI program design. That being said, suggestions are welcome. Layout is done using various layout managers, and some effort is taken to conform to the target platform's UI guidelines. Otherwise, the library uses native toolkits.

ui aims to run on all supported versions of supported platforms. To be more precise, the system requirements are:

  • Windows: Windows XP or newer. The Windows backend uses package syscall and calls Windows DLLs directly, so does not rely on cgo.
  • Mac OS X: Mac OS X 10.6 (Snow Leopard) or newer. Objective-C dispatch is done by interfacing with libobjc directly, and thus this uses cgo.
    • Note: you will need Go 1.3 or newer for this verison, as it uses a single .m file due to technical restrictions (read the comments in bleh_darwin.m for details), and earlier versions of Go do not auto-build .m files.
  • Other Unixes: The Unix backend uses GTK+, and thus cgo. It requires GTK+ 3.4 or newer; for Ubuntu this means 12.04 LTS (Precise Pangolin) at minimum. Check your distribution.

ui itself has no outside Go package dependencies; it is entirely self-contained.

To install, simply go get this package. On Mac OS X, make sure you have the Apple development headers. On other Unixes, make sure you have the GTK+ development files (for Ubuntu, libgtk-3-dev is sufficient).

Package documentation is available at http://godoc.org/github.com/andlabs/ui.

For an example of how ui is used, see https://github.com/andlabs/wakeup, which is a small program that implements a basic alarm clock.

Known To Have Ever Been Built Matrices

For convenience's sake, here are matrices of builds that I have personally done at least once. Each cell represents the run status. These matrices represent builds that I have done at any point in development; it is not a guarantee that the current version works. (I built this list to answer questions of whether or not ui works with a specific configuration.) Only configurations marked with a * are tested during active development. "(invalid)" means the given OS/arch combination is not supported by Go.

386 amd64 arm
windows works on windows; works on wine* works on windows; fails on wine (invalid)
linux see table below see table below Raspian: works
darwin (Mac OS X) works* (cross-compiled from 64-bit) works* (invalid)
dragonfly untested untested (invalid)
freebsd untested (VM failure) untested (VM failure) untested
netbsd untested untested untested
openbsd untested untested (invalid)
solaris (invalid) Oracle Solaris 11: GTK+ 3 not available from official repos (invalid)
plan9 (not written yet; problems building Go) (not written) (invalid)
nacl (not sure how to handle) (not sure how to handle) (invalid)
linux 386 amd64
Kubuntu (14.04) works; cross-compiling on 64-bit Linux fails due to nonexistent .so symlinks works*
Fedora untested untested
openSUSE untested untested
Arch Linux untested untested
Mandriva (TODO choose between PCLinuxOS and Mageia - it appears the original Mandriva is either dead or nonfree and I would rather choose the fork that structures packages identically for parity; do they both?) untested untested
Slackware untested untested
Gentoo untested untested

(The above list should cover all the bases of major Linux distributions and variants thereof; I might add a dedicated Debian test later but other than that... suggestions welcome. Kubuntu 64-bit is my main system and the main development platform; the Windows builds are cross-compiled from here. And yes, this also implies I seriously consider a Plan 9 port of the library using libcontrol, though I'm guessing this will blow up in my face due to any possible conflicts between libthread and Go's runtime (I need to see how the Go runtime implements OS threads on Plan 9).)

Contributing

Contributions are welcome. File issues, pull requests, approach me on IRC (pietro10 in #go-nuts; andlabs elsewhere), etc. Even suggestions are welcome: while I'm mainly drawing from my own GUI programming experience, everyone is different. I have received emails, however I am not likely to see those right away, so I don't suggest contacting me by email if your communication is urgent.

If you want to dive in, read implementation.md: this is a description of how the library works. (Feel free to suggest improvements to this as well.) The other .md files in this repository contain various development notes.

Please suggest documentation improvements as well.