add Zig support #144

[voigt]

This PR adds a Zig library to write Workers for wasm-worker-server in Zig (#144) .

Fixes: #144

Some remarks:

• tested with Zig version 0.11.0
• still new to Zig, so possible that things can be done more idiomatic/elegant :)
• I wanted to use Request and Response from Zigs standard library. Unfortunately std.http.Server.Response as well as std.http.Client.Request are not sufficient :( Using std.http.Server.Response even lead to a WASI compile error error: root struct of file 'os.wasi' has no member named 'sockaddr'. Therefore I created custom entities and hope that we can fix this in the future
• The environment variable example is currently not working. Either I'm doing something wrong or Zigs WASI implementation for std.os.getenv() does not work properly/differently than expected.

Work to be done before merge:

• Detect the content in the response. If it's a valid UTF-8 string, we can return. If it uses a different encoding, you need to encode it in base64. (I ran into a weird error)...
• testing of examples
• testing of docs

[Angelmmiguel]

I saw you already included the documentation! That's amazing @voigt 😄

[ereslibre]

Amazing contribution, thanks @voigt! Although I don't have experience with Zig, I expect to be able to have a look at this PR this week :)

[ereslibre]

Thanks for the amazing and important contribution @voigt! I think this is already in a very nice shape :)

Disclaimer: despite I like Zig's ideas I don't have experience with it, so I cannot help that much on Zig's specifics. :)

Some comments from my side on a first pass. Thanks again! 👏

[Angelmmiguel]

This is an amazing contribution @voigt! I tested the different examples in my laptop and I could run my first Zig workers!!

$ wws zig-out/bin/ 

⚙️  Preparing the project from: zig-out/bin/
⚙️  Loading routes from: zig-out/bin/
⏳ Loading workers from 1 routes...
✅ Workers loaded in 46.583667ms.
    - http://127.0.0.1:8080/basic
      => zig-out/bin/basic.wasm
🚀 Start serving requests at http://127.0.0.1:8080

[2023-08-28T07:58:55Z INFO  actix_web::middleware::logger] 127.0.0.1 "GET /basic HTTP/1.1" 200 682 "-" "..." 0.003404

As you mentioned, environment variables are not working. It would be great to dig into this issue to understand if this is a Zig bug. We can create a separate issue for it, but for now I would delete the zig-envs example from the PR.

I added some minor comments. For me, the only important topic to clarify is the input read process and \n.

Again thank you! I'm really glad to see Zig support on wws 😄

[voigt]

Thank you for your feedback @Angelmmiguel & @ereslibre! I will incorporate it asap, during the course of this week :)

[Angelmmiguel]

Amazing contribution @voigt! I'm really happy to see Zig on Wasm Workers Server! We definitely should write an article about it 😉

I added a last minor comment on the zig-basic example.

[ereslibre]

Huge LGTM, thanks @voigt for your efforts!

Tried all the examples and they worked perfectly 🎉

[Angelmmiguel]

This is really cool!! 👏 👏 Thank you very much for your contribution @voigt!

Related CLA: #210 (comment)