split Go SDK into its own repo

Signed-off-by: Joel Dice <[email protected]>

Author: dicej

.gitignore

@@ -1 +1,3 @@
+.spin
+main.wasm
 */sdk-version-go.c

Makefile

@@ -1,3 +1,5 @@
+VERSION = 2.3.0-pre0
+
 # ----------------------------------------------------------------------
 # Test
 # ----------------------------------------------------------------------
@@ -17,7 +19,7 @@ http/testdata/http-tinygo/main.wasm: http/testdata/http-tinygo/main.go
 # ----------------------------------------------------------------------
 # Build examples
 # ----------------------------------------------------------------------
-EXAMPLES_DIR = ../../examples
+EXAMPLES_DIR = examples
 
 .PHONY: build-examples
 build-examples: generate
@@ -70,9 +72,8 @@ generate: $(GENERATED_OUTBOUND_MYSQL) $(GENERATED_OUTBOUND_PG)
 generate: $(SDK_VERSION_DEST_FILES)
 
 $(SDK_VERSION_DEST_FILES): $(SDK_VERSION_SOURCE_FILE)
-	export version="$$(cd ../rust && cargo run)"; \
 	export commit="$$(git rev-parse HEAD)"; \
-	sed -e "s/{{VERSION}}/$${version}/" -e "s/{{COMMIT}}/$${commit}/" < $< > $@
+	sed -e "s/{{VERSION}}/${VERSION}/" -e "s/{{COMMIT}}/$${commit}/" < $< > $@
 
 $(GENERATED_SPIN_VARIABLES):
 	wit-bindgen c --import wit/spin-config.wit --out-dir ./variables

examples/http-tinygo-outbound-http/README.md

@@ -0,0 +1,88 @@
+# Making outbound HTTP requests from TinyGo Spin components
+
+The TinyGo SDK for building Spin components allows us to granularly allow
+components to send HTTP requests to certain hosts. This is configured in
+`spin.toml`.
+
+> For more information and examples for using TinyGo with WebAssembly, check
+> [the official TinyGo documentation](https://tinygo.org/docs/guides/webassembly/)
+> and
+> [the Wasm examples](https://github.com/tinygo-org/tinygo/tree/release/src/examples/wasm).
+
+Creating and sending HTTP requests from Spin components closely follows the Go
+`net/http` API.  See [tinygo-hello/main.go](./tinygo-hello/main.go).
+
+Building this as a WebAssembly module can be done using the `tinygo` compiler:
+
+```shell
+$ spin build
+Building component outbound-http-to-same-app with `tinygo build -target=wasi -gc=leaking -no-debug -o main.wasm main.go`
+Working directory: "./outbound-http-to-same-app"
+Building component tinygo-hello with `tinygo build -target=wasi -gc=leaking -no-debug -o main.wasm main.go`
+Working directory: "./tinygo-hello"
+Finished building all Spin components
+```
+
+The component configuration must contain a list of all hosts allowed to send
+HTTP requests to, otherwise sending the request results in an error:
+
+```
+Cannot send HTTP request: Destination not allowed: <URL>
+```
+
+The `tinygo-hello` component has the following allowed hosts set:
+
+```toml
+[component.tinygo-hello]
+source = "tinygo-hello/main.wasm"
+allowed_outbound_hosts = [
+    "https://random-data-api.fermyon.app",
+    "https://postman-echo.com",
+]
+```
+
+And the `outbound-http-to-same-app` uses the dedicated `self` keyword to enable making
+a request to another component in this same app, via a relative path (in this case, the component
+is `tinygo-hello` at `/hello`):
+
+```toml
+[component.outbound-http-to-same-app]
+source = "outbound-http-to-same-app/main.wasm"
+# Use self to make outbound requests to components in the same Spin application.
+allowed_outbound_hosts = ["http://self"]
+```
+
+At this point, we can execute the application with the `spin` CLI:
+
+```shell
+$ RUST_LOG=spin=trace,wasi_outbound_http=trace spin up
+```
+
+The application can now receive requests on `http://localhost:3000/hello`:
+
+```shell
+$ curl -i localhost:3000/hello -X POST -d "hello there"
+HTTP/1.1 200 OK
+content-length: 976
+date: Thu, 26 Oct 2023 18:26:17 GMT
+
+{{"timestamp":1698344776965,"fact":"Reindeer grow new antlers every year"}}
+...
+```
+
+As well as via the `/outbound-http-to-same-app` path to verify outbound http to the `tinygo-hello` component:
+
+```shell
+$ curl -i localhost:3000/outbound-http-to-same-app
+HTTP/1.1 200 OK
+content-length: 946
+date: Thu, 26 Oct 2023 18:26:53 GMT
+
+{{{"timestamp":1698344813408,"fact":"Some hummingbirds weigh less than a penny"}}
+...
+```
+
+## Notes
+
+- this only implements sending HTTP/1.1 requests
+- requests are currently blocking and synchronous

examples/http-tinygo-outbound-http/outbound-http-to-same-app/go.mod

@@ -0,0 +1,9 @@
+module outbound-http-to-same-app
+
+go 1.20
+
+require github.com/fermyon/spin/sdk/go/v2 v2.0.0
+
+require github.com/julienschmidt/httprouter v1.3.0 // indirect
+
+replace github.com/fermyon/spin/sdk/go/v2 v2.0.0 => ../../../

examples/http-tinygo-outbound-http/outbound-http-to-same-app/go.sum

@@ -0,0 +1,2 @@
+github.com/julienschmidt/httprouter v1.3.0 h1:U0609e9tgbseu3rBINet9P48AI/D3oJs4dN7jwJOQ1U=
+github.com/julienschmidt/httprouter v1.3.0/go.mod h1:JR6WtHb+2LUe8TCKY3cZOxFyyO8IZAc4RVcycCCAKdM=

examples/http-tinygo-outbound-http/outbound-http-to-same-app/main.go

@@ -0,0 +1,25 @@
+package main
+
+import (
+	"fmt"
+	"net/http"
+
+	spinhttp "github.com/fermyon/spin/sdk/go/v2/http"
+)
+
+func init() {
+	spinhttp.Handle(func(w http.ResponseWriter, r *http.Request) {
+		// Because we included self in `allowed_http_hosts`, we can make outbound
+		// HTTP requests to our own app using a relative path.
+		resp, err := spinhttp.Get("/hello")
+		if err != nil {
+			http.Error(w, err.Error(), http.StatusInternalServerError)
+			return
+		}
+
+		fmt.Fprintln(w, resp.Body)
+		fmt.Fprintln(w, resp.Header.Get("content-type"))
+	})
+}
+
+func main() {}

examples/http-tinygo-outbound-http/spin.toml

@@ -0,0 +1,33 @@
+spin_manifest_version = 2
+
+[application]
+authors = ["Fermyon Engineering <[email protected]>"]
+description = "A simple Spin application written in (Tiny)Go that performs outbound HTTP requests."
+name = "spin-tinygo-outbound-http"
+version = "1.0.0"
+
+[[trigger.http]]
+route = "/hello"
+component = "tinygo-hello"
+
+[[trigger.http]]
+route = "/outbound-http-to-same-app"
+component = "outbound-http-to-same-app"
+
+[component.tinygo-hello]
+source = "tinygo-hello/main.wasm"
+allowed_outbound_hosts = [
+    "https://random-data-api.fermyon.app:443",
+    "https://postman-echo.com:443",
+]
+[component.tinygo-hello.build]
+workdir = "tinygo-hello"
+command = "tinygo build -target=wasi -gc=leaking -no-debug -o main.wasm main.go"
+
+[component.outbound-http-to-same-app]
+source = "outbound-http-to-same-app/main.wasm"
+# Use self to make outbound requests to components in the same Spin application.
+allowed_outbound_hosts = ["http://self"]
+[component.outbound-http-to-same-app.build]
+workdir = "outbound-http-to-same-app"
+command = "tinygo build -target=wasi -gc=leaking -no-debug -o main.wasm main.go"

examples/http-tinygo-outbound-http/tinygo-hello/go.mod

@@ -0,0 +1,9 @@
+module github.com/fermyon/spin/templates/spin-http-tinygo-outbound-http
+
+go 1.20
+
+require github.com/fermyon/spin/sdk/go/v2 v2.0.0
+
+require github.com/julienschmidt/httprouter v1.3.0 // indirect
+
+replace github.com/fermyon/spin/sdk/go/v2 v2.0.0 => ../../../

examples/http-tinygo-outbound-http/tinygo-hello/go.sum

@@ -0,0 +1,2 @@
+github.com/julienschmidt/httprouter v1.3.0 h1:U0609e9tgbseu3rBINet9P48AI/D3oJs4dN7jwJOQ1U=
+github.com/julienschmidt/httprouter v1.3.0/go.mod h1:JR6WtHb+2LUe8TCKY3cZOxFyyO8IZAc4RVcycCCAKdM=

examples/http-tinygo-outbound-http/tinygo-hello/main.go

@@ -0,0 +1,52 @@
+package main
+
+import (
+	"bytes"
+	"fmt"
+	"net/http"
+	"os"
+
+	spinhttp "github.com/fermyon/spin/sdk/go/v2/http"
+)
+
+func init() {
+	spinhttp.Handle(func(w http.ResponseWriter, r *http.Request) {
+		r1, err := spinhttp.Get("https://random-data-api.fermyon.app/animals/json")
+		if err != nil {
+			http.Error(w, err.Error(), http.StatusInternalServerError)
+			return
+		}
+
+		fmt.Fprintln(w, r1.Body)
+		fmt.Fprintln(w, r1.Header.Get("content-type"))
+
+		r2, err := spinhttp.Post("https://postman-echo.com/post", "text/plain", r.Body)
+		if err != nil {
+			http.Error(w, err.Error(), http.StatusInternalServerError)
+			return
+		}
+		fmt.Fprintln(w, r2.Body)
+
+		req, err := http.NewRequest("PUT", "https://postman-echo.com/put", bytes.NewBufferString("General Kenobi!"))
+		if err != nil {
+			http.Error(w, err.Error(), http.StatusInternalServerError)
+			return
+		}
+		req.Header.Add("foo", "bar")
+		r3, err := spinhttp.Send(req)
+		if err != nil {
+			http.Error(w, err.Error(), http.StatusInternalServerError)
+			return
+		}
+
+		fmt.Fprintln(w, r3.Body)
+
+		// `spin.toml` is not configured to allow outbound HTTP requests to this host,
+		// so this request will fail.
+		if _, err := spinhttp.Get("https://fermyon.com"); err != nil {
+			fmt.Fprintf(os.Stderr, "Cannot send HTTP request: %v", err)
+		}
+	})
+}
+
+func main() {}