Add Go binding (#1)

* Merge LICENSE files of this repo and core library's repo

* Remove myself from LICENSE

I haven't made any noteworthy contributions to the Go bindings.

* Add Go bindings

* Add content to README

* Fix Go docs URL and add reference to core library

Author: SteffenL

.github/workflows/ci.yaml

@@ -0,0 +1,21 @@
+name: CI Pipeline
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        image:
+          - macos-latest
+          - ubuntu-latest
+          - windows-latest
+    runs-on: ${{ matrix.image }}
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install dependencies
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y libwebkit2gtk-4.0-dev
+      - name: Build examples
+        run: go build ./examples/basic ./examples/bind
+      - name: Run tests
+        run: go test

LICENSE

@@ -1,5 +1,6 @@
 MIT License
 
+Copyright (c) 2017 Serge Zaitsev
 Copyright (c) 2020 webview
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

README.md

@@ -1,3 +1,50 @@
 # webview_go
 
-For the foreseeable future, golang bindings for webview_core will be maintained in https://github.com/webview/webview 
+[![GoDoc](https://godoc.org/github.com/webview/webview_go?status.svg)](https://godoc.org/github.com/webview/webview_go)
+[![Go Report Card](https://goreportcard.com/badge/github.com/webview/webview_go)](https://goreportcard.com/report/github.com/webview/webview_go)
+
+Go language binding for the [webview library][webview].
+
+> [!NOTE]
+> Versions <= 0.1.1 are available in the [old repository][webview].
+
+### Getting Started
+
+See [Go package documentation][go-docs] for the Go API documentation, or simply read the source code.
+
+Start with creating a new directory structure for your project.
+
+```sh
+mkdir my-project && cd my-project
+```
+
+Create a new Go module.
+
+```sh
+go mod init example.com/app
+```
+
+Save one of the example programs into your project directory.
+
+```sh
+curl -sSLo main.go "https://raw.githubusercontent.com/webview/webview_go/master/examples/basic/main.go"
+```
+
+Install dependencies.
+
+```sh
+go get github.com/webview/webview_go
+```
+
+Build the example. On Windows, add `-ldflags="-H windowsgui"` to the command line.
+
+```sh
+go build
+```
+
+### Notes
+
+Calling `Eval()` or `Dispatch()` before `Run()` does not work because the webview instance has only been configured and not yet started.
+
+[go-docs]: https://pkg.go.dev/github.com/webview/webview_go
+[webview]: https://github.com/webview/webview

examples/basic/main.go

@@ -0,0 +1,12 @@
+package main
+
+import webview "github.com/webview/webview_go"
+
+func main() {
+	w := webview.New(false)
+	defer w.Destroy()
+	w.SetTitle("Basic Example")
+	w.SetSize(480, 320, webview.HintNone)
+	w.SetHtml("Thanks for using webview!")
+	w.Run()
+}

examples/bind/main.go

@@ -0,0 +1,38 @@
+package main
+
+import webview "github.com/webview/webview_go"
+
+const html = `<button id="increment">Tap me</button>
+<div>You tapped <span id="count">0</span> time(s).</div>
+<script>
+  const [incrementElement, countElement] =
+    document.querySelectorAll("#increment, #count");
+  document.addEventListener("DOMContentLoaded", () => {
+    incrementElement.addEventListener("click", () => {
+      window.increment().then(result => {
+        countElement.textContent = result.count;
+      });
+    });
+  });
+</script>`
+
+type IncrementResult struct {
+	Count uint `json:"count"`
+}
+
+func main() {
+	var count uint = 0
+	w := webview.New(false)
+	defer w.Destroy()
+	w.SetTitle("Bind Example")
+	w.SetSize(480, 320, webview.HintNone)
+
+	// A binding that increments a value and immediately returns the new value.
+	w.Bind("increment", func() IncrementResult {
+		count++
+		return IncrementResult{Count: count}
+	})
+
+	w.SetHtml(html)
+	w.Run()
+}

glue.c

@@ -0,0 +1,32 @@
+#include "webview.h"
+
+#include <stdlib.h>
+#include <stdint.h>
+
+struct binding_context {
+    webview_t w;
+    uintptr_t index;
+};
+
+void _webviewDispatchGoCallback(void *);
+void _webviewBindingGoCallback(webview_t, char *, char *, uintptr_t);
+
+static void _webview_dispatch_cb(webview_t w, void *arg) {
+    _webviewDispatchGoCallback(arg);
+}
+
+static void _webview_binding_cb(const char *id, const char *req, void *arg) {
+    struct binding_context *ctx = (struct binding_context *) arg;
+    _webviewBindingGoCallback(ctx->w, (char *)id, (char *)req, ctx->index);
+}
+
+void CgoWebViewDispatch(webview_t w, uintptr_t arg) {
+    webview_dispatch(w, _webview_dispatch_cb, (void *)arg);
+}
+
+void CgoWebViewBind(webview_t w, const char *name, uintptr_t index) {
+    struct binding_context *ctx = calloc(1, sizeof(struct binding_context));
+    ctx->w = w;
+    ctx->index = index;
+    webview_bind(w, name, _webview_binding_cb, (void *)ctx);
+}

go.mod

@@ -0,0 +1,3 @@
+module github.com/webview/webview_go
+
+go 1.13

go.sum

@@ -0,0 +1,27 @@
+Copyright (C) Microsoft Corporation. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+   * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+   * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+   * The name of Microsoft Corporation, or the names of its contributors 
+may not be used to endorse or promote products derived from this
+software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.