feat: add Zig SDK and documentation (#196)

* feat: add support for zig (#144)

* add wasi_exec_model reactor

* use custom request/response entities

* add params and env

* add example zig-basic

* add example zig-kv

* add example zig-params

* add example zig-envs

* add zig docs to example README

* add .gitignore to ignore zig build and cache directories

* add utf8 validity check

* add corrections to docs

Co-authored-by: Rafael Fernández López <[email protected]>

* rename writeHeader to setStatus

* rename s/data/body to be consistent with other languages

* rename s/bash/shell-session

Co-authored-by: Rafael Fernández López <[email protected]>

* add info for RequestAndOutput wrapper struct

* fix read input until EOF

---------

Co-authored-by: Rafael Fernández López <[email protected]>

.gitignore

@@ -3,4 +3,6 @@ target
 !tests/**/*.wasm
 examples/*.toml
 .DS_Store
-.wws
+.wws
+**/zig-cache
+**/zig-out

README.md

@@ -99,7 +99,7 @@ Wasm Workers Server focuses on simplicity. We want you to run workers (written i
 | Go | ✅ | No | [#95](https://github.com/vmware-labs/wasm-workers-server/issues/95) |
 | Ruby | ✅ | [Yes](https://workers.wasmlabs.dev/docs/languages/ruby#installation) | [#63](https://github.com/vmware-labs/wasm-workers-server/issues/63) |
 | Python | ✅ | [Yes](https://workers.wasmlabs.dev/docs/languages/python#installation) | [#63](https://github.com/vmware-labs/wasm-workers-server/issues/63) |
-| Zig | 🚧 | No | [#144](https://github.com/vmware-labs/wasm-workers-server/issues/144) |
+| Zig | ✅ | No | [#144](https://github.com/vmware-labs/wasm-workers-server/issues/144) |
 | PHP | 🚧 | No | [#100](https://github.com/vmware-labs/wasm-workers-server/issues/100) |
 
 To get more information about multi-language support in Wasm Workers Server, [check our documentation](https://workers.wasmlabs.dev/docs/languages/introduction).

docs/docs/features/all.md

@@ -36,3 +36,4 @@ The following table shows the language compatibility for the different worker fu
 | Go | ✅ | ✅ | ✅ | ✅ | ✅ |
 | Ruby | ✅ | ✅ | ✅ | ✅ | ❌ |
 | Python | ✅ | ✅ | ✅ | ✅ | ❌ |
+| Zig | ✅ | ❌ | ✅ | ✅ | ❌ |

docs/docs/features/dynamic-routes.md

@@ -27,6 +27,7 @@ Check these guides to understand how to read parameters in the different support
 * [Dynamic routes in Python](../languages/python.md#dynamic-routes)
 * [Dynamic routes in Ruby](../languages/ruby.md#dynamic-routes)
 * [Dynamic routes in Go](../languages/go.md#dynamic-routes)
+* [Dynamic routes in Zig](../languages/zig.md#dynamic-routes)
 
 ## Dynamic routes and folders
 
@@ -64,3 +65,4 @@ In this case, the `./[resource]/[id]/show.js` worker replies to URLs like `/arti
 | Go | ✅ |
 | Ruby | ✅ |
 | Python | ✅ |
+| Zig | ✅ |

docs/docs/features/environment-variables.md

@@ -50,3 +50,4 @@ This feature allows you to configure environment variables dynamically.
 | Go | ✅ |
 | Ruby | ✅ |
 | Python | ✅ |
+| Zig | ❌ |

docs/docs/features/http-requests.md

@@ -44,3 +44,4 @@ Check these guides to perform HTTP requests in the different supported languages
 | Go | ✅ |
 | Ruby | ❌ |
 | Python | ❌ |
+| Zig | ❌ |

docs/docs/features/key-value.md

@@ -21,6 +21,7 @@ The worker may access all the data and perform changes over it. Then, a new K/V
 * [Add a K/V store to Python workers](../languages/python.md#add-a-key--value-store)
 * [Add a K/V store to Ruby workers](../languages/ruby.md#add-a-key--value-store)
 * [Add a K/V store to Go workers](../languages/go.md#add-a-key--value-store)
+* [Add a K/V store to Zig workers](../languages/zig.md#add-a-key--value-store)
 
 ## Limitations
 
@@ -35,3 +36,4 @@ A known limitation of the snapshot approach is the data override when concurrent
 | Go | ✅ |
 | Ruby | ✅ |
 | Python | ✅ |
+| Zig | ✅ |

docs/docs/features/mount-folders.md

@@ -49,3 +49,4 @@ Note that those folders may include files that `wws` recognizes as workers (like
 | Go | ✅ |
 | Ruby | ✅ |
 | Python | ✅ |
+| Zig | ✅ |