main 5a91e85

Autogenerated WebKitGTK6 bindings for Go leveraging ebitengine/purego

puregotk-webkit

WebKitGTK 6 bindings for Go, built on top of puregotk.

Credits

This project is entirely based on the work of @jwijenbergh and their excellent puregotk library. The code generator, type system, and template engine are all from puregotk - this repository simply extends it to generate bindings for WebKitGTK 6.

All credit for the core implementation goes to the original author.

What is this?

Autogenerated WebKitGTK 6 bindings for Go leveraging purego - no Cgo required.

This package provides bindings for:

  • WebKit 6.0 - WebKitGTK web views, settings, and web content rendering
  • JavaScriptCore 6.0 - JavaScript engine bindings
  • Soup 3.0 - HTTP client/server library
  • WebKitWebProcessExtension 6.0 - Web process extensions

NOTE: This library is experimental. Some APIs might be incorrectly exposed.

Advantages

No Cgo needed, thus:

  • Easy cross compilation
  • No C toolchain needed
  • Much faster compile times

Installation

go get github.com/bnema/puregotk-webkit

Requires puregotk as a dependency.

Basic Example

package main

import (
	"os"

	"github.com/jwijenbergh/puregotk/v4/gio"
	"github.com/jwijenbergh/puregotk/v4/gtk"
	"github.com/bnema/puregotk-webkit/webkit"
)

func main() {
	app := gtk.NewApplication("com.example.webview", gio.GApplicationFlagsNoneValue)
	defer app.Unref()

	actcb := func(_ gio.Application) {
		activate(app)
	}
	app.ConnectActivate(&actcb)

	if code := app.Run(len(os.Args), os.Args); code > 0 {
		os.Exit(code)
	}
}

func activate(app *gtk.Application) {
	window := gtk.NewApplicationWindow(app)
	window.SetTitle("WebKit Example")
	window.SetDefaultSize(800, 600)

	webview := webkit.NewWebView()
	webkit.WebViewLoadUri(webview, "https://example.com")

	window.SetChild(&webview.Widget)
	window.Present()
}

Generating the Bindings

make all    # sync template, generate, build

Or step by step:

make sync      # fetch template from puregotk
make generate  # run go generate + goimports
make build     # build all packages

License

MIT

Acknowledgements

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. On pages with a side panel: into the panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit; in a file, click a line number to select it, shift-click for a range
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 18

↑↓ moveenter openesc close