├── ARCHIVE.md
├── LICENSE
└── README.md


/ARCHIVE.md:
--------------------------------------------------------------------------------
  1 | ARCHIVE of "Make HTTP request from inside WebAssembly" list
  2 | ===========================================================
  3 | 
  4 | > [!CAUTION]
  5 | > Approaches listed on this page are deprecated or/and do not longer work. 
  6 | > They are collected here for historical purposes.
  7 |  
  8 | Each item has hyperlink to up-to-date alternative in the [main list](README.md).
  9 | 
 10 | ### Contents
 11 | <table>
 12 | <tr>
 13 | <th>Language</th>
 14 | <th>Browsers and JS runtimes</th>
 15 | <th>Standalone / server-side / WASI runtimes</th>
 16 | </tr>
 17 | <tr>
 18 | <td>AssemblyScript</td>
 19 | <td></td>
 20 | <td>
 21 | 
 22 | [wasi-experimental-http, wasi-http-ts](#assemblyscript-wasi)
 23 | 
 24 | </td>
 25 | </tr>
 26 | <tr>
 27 | <td>C# / .Net</td>
 28 | <td>
 29 | 
 30 | [Uno Platform](#csharp)
 31 | 
 32 | </td>
 33 | <td>
 34 | 
 35 | [wasi-experimental-http](#csharp-wasi)
 36 | 
 37 | </td>
 38 | </tr>
 39 | <tr>
 40 | <td>C / C++</td>
 41 | <td>
 42 | 
 43 | 
 44 | 
 45 | </td>
 46 | <td>
 47 | 
 48 | [wasi-experimental-http](#cpp-wasi)
 49 | 
 50 | </td>
 51 | </tr>
 52 | <tr>
 53 | <td>Golang / TinyGo</td>
 54 | <td></td>
 55 | <td>
 56 | 
 57 | [wasi-experimental-http](#golang-wasi)
 58 | 
 59 | </td>
 60 | </tr>
 61 | <tr>
 62 | <td>PHP</td>
 63 | <td>
 64 | 
 65 | [PIB aka php-wasm](#php)
 66 | 
 67 | </td>
 68 | <td></td>
 69 | </tr>
 70 | <tr>
 71 | <td>Python</td>
 72 | <td>
 73 | 
 74 | [requests-wasm-polyfill](#python)
 75 | 
 76 | </td>
 77 | <td></td>
 78 | </tr>
 79 | <tr>
 80 | <td>Rust</td>
 81 | <td></td>
 82 | <td>
 83 | 
 84 | [wasi-experimental-http](#rust-wasi)
 85 | 
 86 | </td>
 87 | </tr>
 88 | <tr>
 89 | <td>Zig</td>
 90 | <td></td>
 91 | <td>
 92 | 
 93 | [wasi-experimental-http](#zig-wasi)
 94 | 
 95 | </td>
 96 | </tr>
 97 | </table>
 98 | 
 99 | Browser WASM runtimes and standalone JS runtimes like Node.js and Deno (and other V8-based), also Bun
100 | -----------------------------------------------------------------------------------------------------
101 | 
102 | <a id="csharp"></a>
103 | ### C#
104 | 
105 | <table>
106 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
107 | <th>Doc</th>
108 | <th>Online demo</th>
109 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
110 | <tr>
111 | <td>
112 | 
113 | [Uno Platform](https://platform.uno/)
114 | 
115 | > [!CAUTION]
116 | > <sub>`Uno.UI.Wasm. WasmHttpHandler` deprecated since .NET 6</sub>
117 | 
118 | 
119 | > [!TIP]
120 | > <sub>[Use](README.md#uno-platform) `System.Net. Http.HttpClient` instead.</sub>
121 | 
122 | </td>
123 | <td>
124 | 
125 | ```csharp
126 | // Uno Platform's own way
127 | // Deprecated since .NET 6,
128 | // use 'System.Net.Http.HttpClient' and 'HttpHandler' instead
129 | // See https://github.com/unoplatform/uno/issues/9665
130 | using System.Net.Http;
131 | 
132 | using (var handler = new Uno.UI.Wasm.WasmHttpHandler())
133 | using (var client = new HttpClient(handler))
134 | {
135 | var request = new HttpRequestMessage(HttpMethod.Get,
136 |   new Uri("https://httpbin.org/anything"));
137 | var response = await client.SendAsync(request);
138 | var content = await response.Content.ReadAsStringAsync();
139 | }
140 | ```
141 | 
142 | </td>
143 | <td>
144 | 
145 | [Test](https://github.com/unoplatform/uno/blob/4.7.37/src/SamplesApp/SamplesApp.Shared/Samples/UnitTests/HttpUnitTests.xaml.cs#L33)
146 | 
147 | </td>
148 | <td>
149 | 
150 | [Tutorial](https://platform.uno/docs/articles/howto-consume-webservices.html)
151 | 
152 | </td>
153 | <td>
154 | 
155 | [Playground](https://playground.platform.uno/)
156 | 
157 | </td>
158 | <td>Browser</td>
159 | <td>
160 | 
161 | [JS Interop](https://github.com/unoplatform/uno/blob/4.7.37/src/Uno.UI.Runtime.WebAssembly/WasmHttpHandler.cs#L62) invokes the TS
162 | [wrapper](https://github.com/unoplatform/uno/blob/4.7.37/src/Uno.UI/ts/HttpClient.ts#L27) for `fetch`
163 | 
164 | </td>
165 | </tr>
166 | </table>
167 | 
168 | ### PHP
169 | <table>
170 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
171 | <th>Doc</th>
172 | <th>Online demo</th>
173 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
174 | <tr>
175 | <td>
176 | 
177 | [PIB: PHP in Browser aka php-wasm](https://github.com/seanmorris/php-wasm/)
178 | 
179 | > [!CAUTION]
180 | > <sub>This code does not work in php-wasm v0.0.8.</sub>
181 | 
182 | 
183 | > [!TIP]
184 | > <sub>Use [up-to-date method](README.md#php-wasm) instead.</sub>
185 | 
186 | </td>
187 | <td>
188 | 
189 | ```php
190 | $js=<<<JSCODE
191 | var xhr=new XMLHttpRequest();
192 | xhr.open('GET', 'https://httpbin.org/anything', 0);
193 | xhr.send();
194 | 
195 | xhr.responseText;
196 | JSCODE;
197 | 
198 | var_dump(vrzno_eval($js));
199 | ```
200 | 
201 | </td>
202 | <td>
203 | 
204 | [Example](https://github.com/WordPress/wordpress-playground/blob/bb148069e37d8b7f3314a3e675abb316f7749e4e/src/wordpress-playground/mu-plugins/includes/requests_transport_fetch.php#L68)
205 | 
206 | </td>
207 | <td>
208 | 
209 | [Doc](https://github.com/seanmorris/vrzno#usage)
210 | 
211 | </td>
212 | <td>
213 | 
214 | * [Demo](https://seanmorris.github.io/php-wasm/?autorun=0&persist=0&single-expression=0&code=%253C%253Fphp%250A%2524js%253D%253C%253C%253CJSCODE%250Avar%2520xhr%253Dnew%2520XMLHttpRequest%28%29%253B%250Axhr.open%28%27GET%27%252C%2520%27https%253A%252F%252Fhttpbin.org%252Fanything%27%252C%25200%29%253B%250Axhr.send%28%29%253B%250A%250Axhr.responseText%253B%250AJSCODE%253B%250A%250Avar_dump%28vrzno_eval%28%2524js%29%29%253B%250A)
215 | * [Playground](https://seanmorris.github.io/php-wasm/)
216 | 
217 | </td>
218 | <td>Browser, Node.js, and maybe Deno</td>
219 | <td>
220 | 
221 | Manual JS `XMLHttpRequest` interop using [`vrzno`](https://github.com/seanmorris/vrzno/blob/228514316299f8d1dbc8abcff51523ed37929f1f/vrzno.c#L36) PHP extension.
222 | 
223 | </td>
224 | </tr>
225 | </table>
226 | 
227 | 
228 | ### Python
229 | 
230 | <table>
231 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
232 | <th>Doc</th>
233 | <th>Online demo</th>
234 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
235 | <tr>
236 | <td>
237 | 
238 | [requests-wasm-polyfill](https://github.com/emscripten-forge/requests-wasm-polyfill)
239 | 
240 | <sub>For [pyjs](https://github.com/emscripten-forge/pyjs)</sub>
241 | 
242 | > [!CAUTION]
243 | > <sub>Repo was [archived](https://github.com/emscripten-forge/requests-wasm-polyfill/issues/7) and package was [dropped from recipes](https://github.com/emscripten-forge/recipes/pull/796) on Feb 6, 2024.</sub>
244 | 
245 | 
246 | > [!TIP]
247 | > <sub>[Use](https://github.com/emscripten-forge/requests-wasm-polyfill/blob/568560020f74704c183fe49f8e527942d19e276c/README.md?plain=1#L8) the official `requests` instead.</sub>
248 | 
249 | </td>
250 | <td>
251 | 
252 | ```python
253 | import requests
254 | 
255 | r = requests.get('https://httpbin.org/anything')
256 | result = r.text
257 | print(result)
258 | ```
259 | 
260 | </td>
261 | <td>
262 | 
263 | [Example](https://github.com/wasm-outbound-http-examples/pyjs/blob/596d23d2dcd930ec7025eb734feaaffa478c13f5/requests-wasm-polyfill/script.js#L26)
264 | 
265 | </td>
266 | <td></td>
267 | <td>
268 | 
269 | * [Demo](https://wasm-outbound-http-examples.github.io/pyjs/requests-wasm-polyfill/)
270 | * [Dev Container](https://codespaces.new/wasm-outbound-http-examples/pyjs)
271 | 
272 | </td>
273 | <td>
274 | 
275 | Browser
276 | 
277 | </td>
278 | <td>
279 | 
280 | Direct [`XMLHttpRequest` interop](https://github.com/emscripten-forge/requests-wasm-polyfill/blob/0.3.0/requests/api.py#L41) in
281 | [sync](https://github.com/emscripten-forge/requests-wasm-polyfill/blob/0.3.0/requests/api.py#L27) mode.
282 | 
283 | </td>
284 | </tr>
285 | </table>
286 | 
287 | 
288 | 
289 | Standalone and server-side runtimes (mostly WASI and WASI-Socket-enabled), incl containers, FaaS, Edge Computing, etc
290 | ------------------------------------------------------------------------------------------------------------
291 | 
292 | <a id="assemblyscript-wasi"></a>
293 | ### AssemblyScript
294 | 
295 | <table>
296 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
297 | <th>Doc</th>
298 | <th>Online demo</th>
299 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
300 | <tr>
301 | <td>
302 | 
303 | [wasi-experimental-http](https://www.npmjs.com/package/@deislabs/wasi-experimental-http)
304 | 
305 | > [!CAUTION]
306 | > <sub>[Repo](https://github.com/deislabs/wasi-experimental-http) was archived on Feb 22, 2024.</sub>
307 | 
308 | 
309 | > [!TIP]
310 | > <sub>Use [wasi-http](README.md#assemblyscript-wasi-http) instead.</sub>
311 | 
312 | </td>
313 | <td>
314 | 
315 | ```typescript
316 | import { 
317 |   Method, RequestBuilder, Response 
318 | } from "@deislabs/wasi-experimental-http";
319 | import { Console } from "as-wasi/assembly";
320 | 
321 | let resp = new RequestBuilder("https://httpbin.org/anything")
322 |     .header("User-Agent", "wasm32-wasi-http")
323 |     .method(Method.GET)
324 |     .send();
325 | 
326 | let text = String.UTF8.decode(resp.bodyReadAll().buffer);
327 | Console.log(text);
328 | ```
329 | 
330 | </td>
331 | <td>
332 | 
333 | * [Example 1](https://github.com/dev-wasm/dev-wasm-ts/blob/a7eb8737aa12b87f55c60acd6d3dd8be0c9d8508/http/main.ts#L15)
334 | * [Example 2](https://github.com/fermyon/spin-kitchensink/blob/c0d0f2b0487df0cb9f151b7dd8f7cd13f9ab1087/assemblyscript-outbound-http/index.ts#L11) _from [old](https://github.com/fermyon/spin/pull/699) Spin_
335 | 
336 | </td>
337 | <td>
338 | 
339 | [Readme](https://github.com/dev-wasm/dev-wasm-ts/blob/a7eb8737aa12b87f55c60acd6d3dd8be0c9d8508/http/README.md#experimental-http-client-example)
340 | 
341 | </td>
342 | <td>
343 | 
344 | [Dev Container](https://github.com/codespaces/new?hide_repo_select=true&ref=wasi-experimental-http&repo=656267188) _created by brendandburns_
345 | 
346 | </td>
347 | <td>
348 | 
349 | Wasmtime with integrated `wasi-experimental-http` crate, e.g. [brendandburns's fork](https://github.com/brendandburns/wasmtime/commit/e2a567c4ca38190a74a7eca62cf65892547f2f3b)
350 | or [**old** Spin](https://github.com/fermyon/spin/pull/699)
351 | 
352 | </td>
353 | <td>
354 | 
355 | [Importing](https://github.com/dev-wasm/dev-wasm-ts/blob/a7eb8737aa12b87f55c60acd6d3dd8be0c9d8508/http/package.json#L18)
356 | [npm package](https://www.npmjs.com/package/@deislabs/wasi-experimental-http) which [calls](https://github.com/deislabs/wasi-experimental-http/blob/v0.5.0/crates/as/index.ts#L202)
357 | [imported](https://github.com/deislabs/wasi-experimental-http/blob/v0.5.0/crates/as/raw.ts#L113)
358 | [host function](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L238) implemented in [wasi-experimental-http-wasmtime](https://github.com/deislabs/wasi-experimental-http/tree/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime) Wasmtime's WASI module.
359 | 
360 | </td>
361 | </tr>
362 | <tr>
363 | <td>
364 | 
365 | [brendandburns/wasi-http-ts](https://github.com/brendandburns/wasi-http-ts)
366 | 
367 | > [!CAUTION]
368 | > <sub>[Repo](https://github.com/deislabs/wasi-experimental-http) was archived on Feb 22, 2024.</sub>
369 | 
370 | 
371 | > [!TIP]
372 | > <sub>Use [wasi-http](README.md#assemblyscript-wasi-http) instead.</sub>
373 | 
374 | </td>
375 | <td>
376 | 
377 | ```typescript
378 | // Identical to wasi-experimental-http currently
379 | // Needs `npm i https://github.com/brendandburns/wasi-http-ts`
380 | import { 
381 |   Method, RequestBuilder 
382 | } from "@brendandburns/wasi-http-ts";
383 | import { Console } from "as-wasi/assembly";
384 | 
385 | let resp = new RequestBuilder("https://httpbin.org/anything")
386 |     .header("User-Agent", "wasm32-wasi-http")
387 |     .method(Method.GET)
388 |     .send();
389 | 
390 | let text = String.UTF8.decode(resp.bodyReadAll().buffer);
391 | Console.log(text);
392 | ```
393 | 
394 | </td>
395 | <td>
396 | 
397 | &lt;--
398 | 
399 | </td>
400 | <td>
401 | 
402 | [Readme](https://github.com/dev-wasm/dev-wasm-ts/blob/a7eb8737aa12b87f55c60acd6d3dd8be0c9d8508/http/README.md#experimental-http-client-example)
403 | _from dev-wasm-ts_
404 | 
405 | </td>
406 | <td>
407 | 
408 | Possible with
409 | [Dev Container](https://github.com/codespaces/new?hide_repo_select=true&ref=wasi-experimental-http&repo=656267188) _created by brendandburns_
410 | 
411 | </td>
412 | <td>
413 | 
414 | Wasmtime with integrated `wasi-experimental-http` crate, e.g. [brendandburns's fork](https://github.com/brendandburns/wasmtime/commit/e2a567c4ca38190a74a7eca62cf65892547f2f3b)
415 | 
416 | </td>
417 | <td>
418 | 
419 | Using [client lib](https://github.com/brendandburns/wasi-http-ts) which [calls](https://github.com/brendandburns/wasi-http-ts/blob/1f8c7d7e48a79575df080a77fe589cf5cf2309ac/index.ts#L202)
420 | [imported](https://github.com/brendandburns/wasi-http-ts/blob/1f8c7d7e48a79575df080a77fe589cf5cf2309ac/raw.ts#L113)
421 | [host function](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L238) implemented in [wasi-experimental-http-wasmtime](https://github.com/deislabs/wasi-experimental-http/tree/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime) Wasmtime's WASI module.
422 | 
423 | </td>
424 | </tr>
425 | </table>
426 | 
427 | 
428 | <a id="csharp-wasi"></a>
429 | ### C# / .Net
430 | 
431 | <table>
432 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
433 | <th>Doc</th>
434 | <th>Online demo</th>
435 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
436 | <tr>
437 | <td>
438 | 
439 | [wasi-experimental-http](https://crates.io/crates/wasi-experimental-http)
440 | 
441 | > [!CAUTION]
442 | > <sub>[Repo](https://github.com/deislabs/wasi-experimental-http) was archived on Feb 22, 2024.</sub>
443 | 
444 | 
445 | > [!TIP]
446 | > <sub>Use [wasi-http](README.md#csharp-wasi-http) instead.</sub>
447 | 
448 | </td>
449 | <td>
450 | 
451 | ```csharp
452 | using Wasi.Http;
453 | 
454 | var client = new HttpClient(new WasiHttpHandler());
455 | var result = await client.GetAsync("https://httpbin.org/anything", 
456 |  System.Threading.CancellationToken.None);
457 | var content = await result.Content.ReadAsStringAsync();
458 | Console.WriteLine(content);
459 | ```
460 | 
461 | </td>
462 | <td>
463 | 
464 | [Example](https://github.com/dev-wasm/dev-wasm-dotnet/blob/a08955929b18352c1ff4916a3ecd5aca9237539c/http/Program.cs#L34)
465 | 
466 | </td>
467 | <td>
468 | 
469 | [Readme](https://github.com/dev-wasm/dev-wasm-dotnet/blob/a08955929b18352c1ff4916a3ecd5aca9237539c/http/README.md#experimental-http-client-example)
470 | 
471 | </td>
472 | <td>
473 | 
474 | [Dev Container](https://github.com/codespaces/new?hide_repo_select=true&ref=wasi-experimental-http&repo=650329121) _created by brendandburns_
475 | 
476 | </td>
477 | <td>
478 | 
479 | Wasmtime with integrated `wasi-experimental-http` crate, e.g. [brendandburns's fork](https://github.com/brendandburns/wasmtime/commit/e2a567c4ca38190a74a7eca62cf65892547f2f3b)
480 | 
481 | </td>
482 | <td>
483 | 
484 | [Calling](https://github.com/dev-wasm/dev-wasm-dotnet/blob/a08955929b18352c1ff4916a3ecd5aca9237539c/http/WasiHttpHandler.cs#L158) [imported](https://github.com/dev-wasm/dev-wasm-dotnet/blob/a08955929b18352c1ff4916a3ecd5aca9237539c/http/WasiHttpExperimental.cs#L25) via [C level](https://github.com/dev-wasm/dev-wasm-dotnet/blob/a08955929b18352c1ff4916a3ecd5aca9237539c/http/req.h#L26)
485 | [bindings](https://github.com/dev-wasm/dev-wasm-dotnet/blob/a08955929b18352c1ff4916a3ecd5aca9237539c/http/wasi_http.c#L93) the [host function](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L238) implemented in [wasi-experimental-http-wasmtime](https://github.com/deislabs/wasi-experimental-http/tree/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime) Wasmtime's WASI module.
486 | 
487 | </td>
488 | </tr>
489 | </table>
490 | 
491 | 
492 | <a id="cpp-wasi"></a>
493 | ### C / C++
494 | 
495 | <table>
496 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
497 | <th>Doc</th>
498 | <th>Online demo</th>
499 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
500 | <tr>
501 | <td>
502 | 
503 | [wasi-experimental-http](https://crates.io/crates/wasi-experimental-http)
504 | 
505 | > [!CAUTION]
506 | > <sub>[Repo](https://github.com/deislabs/wasi-experimental-http) was archived on Feb 22, 2024.</sub>
507 | 
508 | 
509 | > [!TIP]
510 | > <sub>Use [wasi-http](README.md#cpp-wasi-http) instead.</sub>
511 | 
512 | </td>
513 | <td>
514 | 
515 | ```C
516 | #include "req.h"
517 | #include <string.h>
518 | #include <stdio.h>
519 | 
520 | const char* url =  "https://httpbin.org/anything";
521 | const char* headers = "User-agent: wasm32-wasi-http";
522 | size_t length = 1024 * 1024;
523 | char* buffer = (char*) malloc(length);
524 | uint16_t code;
525 | ResponseHandle handle;
526 | 
527 | HttpError err = req(url, strlen(url), "GET", 3, headers, 
528 |   strlen(headers), "", 0, &code, &handle);
529 | 
530 | size_t written;
531 | err = bodyRead(handle, buffer, length, &written);
532 | close(handle);
533 | 
534 | printf("%s\n", buffer);
535 | 
536 | free(buffer);
537 | ```
538 | 
539 | </td>
540 | <td>
541 | 
542 | [Example](https://github.com/dev-wasm/dev-wasm-c/blob/37e5fcc2cad204ed2534762e81bbceaa32399952/http/main.c#L14)
543 | 
544 | </td>
545 | <td>
546 | 
547 | [Readme](https://github.com/dev-wasm/dev-wasm-c/blob/37e5fcc2cad204ed2534762e81bbceaa32399952/http/README.md#experimental-http-client-example)
548 | 
549 | </td>
550 | <td>
551 | 
552 | [Dev Container](https://github.com/codespaces/new?hide_repo_select=true&ref=wasi-experimental-http&repo=648389246) _created by brendandburns_
553 | 
554 | </td>
555 | <td>
556 | 
557 | Wasmtime with integrated `wasi-experimental-http` crate, e.g. [brendandburns's fork](https://github.com/brendandburns/wasmtime/commit/e2a567c4ca38190a74a7eca62cf65892547f2f3b)
558 | 
559 | </td>
560 | <td>
561 | 
562 | [Calling](https://github.com/dev-wasm/dev-wasm-c/blob/37e5fcc2cad204ed2534762e81bbceaa32399952/http/main.c#L14) [imported](https://github.com/dev-wasm/dev-wasm-c/blob/37e5fcc2cad204ed2534762e81bbceaa32399952/http/req.h#L26) [host function](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L238) implemented in [wasi-experimental-http-wasmtime](https://github.com/deislabs/wasi-experimental-http/tree/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime) Wasmtime's WASI module.
563 | 
564 | </td>
565 | </tr>
566 | </table>
567 | 
568 | 
569 | <a id="golang-wasi"></a>
570 | ### Golang (Tinygo)
571 | 
572 | <table>
573 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
574 | <th>Doc</th>
575 | <th>Online demo</th>
576 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
577 | <tr>
578 | <td>
579 | 
580 | [wasi-experimental-http](https://crates.io/crates/wasi-experimental-http)
581 | 
582 | > [!CAUTION]
583 | > <sub>[Repo](https://github.com/deislabs/wasi-experimental-http) was archived on Feb 22, 2024.</sub>
584 | 
585 | 
586 | > [!TIP]
587 | > <sub>Use [wasi-http](README.md#golang-wasi-http) instead.</sub>
588 | 
589 | </td>
590 | <td>
591 | 
592 | ```go
593 | response, err := Request(
594 |   "https://httpbin.org/anything", "GET",
595 |   "User-agent: wasm32-wasi-http", "")
596 | defer response.Close()
597 | 
598 | body, err := response.Body()
599 | if err == nil {
600 |   println(string(body))
601 | }
602 | ```
603 | 
604 | </td>
605 | <td>
606 | 
607 | [Example](https://github.com/dev-wasm/dev-wasm-go/blob/d7482362e292598bdb04493a6b664272a60e9c71/http/main.go#L8)
608 | 
609 | </td>
610 | <td>
611 | 
612 | [Readme](https://github.com/dev-wasm/dev-wasm-go/blob/d7482362e292598bdb04493a6b664272a60e9c71/http/README.md#experimental-http-client-example)
613 | 
614 | </td>
615 | <td>
616 | 
617 | [Dev Container](https://github.com/codespaces/new?hide_repo_select=true&ref=wasi-experimental-http&repo=648324699) _created by brendandburns_
618 | 
619 | </td>
620 | <td>
621 | 
622 | Wasmtime with integrated `wasi-experimental-http` crate, e.g. [brendandburns's fork](https://github.com/brendandburns/wasmtime/commit/e2a567c4ca38190a74a7eca62cf65892547f2f3b)
623 | 
624 | </td>
625 | <td>
626 | 
627 | [Calling](https://github.com/dev-wasm/dev-wasm-go/blob/d7482362e292598bdb04493a6b664272a60e9c71/http/req.go#L64) [imported](https://github.com/dev-wasm/dev-wasm-go/blob/d7482362e292598bdb04493a6b664272a60e9c71/http/req.go#L36-L38) [host function](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L238) implemented in [wasi-experimental-http-wasmtime](https://github.com/deislabs/wasi-experimental-http/tree/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime) Wasmtime's WASI module.
628 | 
629 | </td>
630 | </tr>
631 | </table>
632 | 
633 | 
634 | <a id="rust-wasi"></a>
635 | ### Rust
636 | 
637 | <table>
638 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
639 | <th>Doc</th>
640 | <th>Online demo</th>
641 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
642 | <tr>
643 | <tr>
644 | <td>
645 | 
646 | <a id="wasi-experimental-http"></a>
647 | [wasi-experimental-http](https://crates.io/crates/wasi-experimental-http)
648 | 
649 | > [!CAUTION]
650 | > <sub>[Repo](https://github.com/deislabs/wasi-experimental-http) was archived on Feb 22, 2024.</sub>
651 | 
652 | 
653 | > [!TIP]
654 | > <sub>Use [wasi-http](README.md#wasi-http) instead.</sub>
655 | 
656 | </td>
657 | <td>
658 | 
659 | ```rust
660 | use http;
661 | use wasi_experimental_http;
662 | 
663 | let req = http::request::Builder::new()
664 |   .uri("https://httpbin.org/anything").body(None).unwrap();
665 | let resp = wasi_experimental_http::request(req);
666 | let data = std::str::from_utf8(&resp.body_read_all().unwrap())
667 |   .unwrap().to_string();
668 | println!("{}", data);
669 | ```
670 | 
671 | </td>
672 | <td>
673 | 
674 | [Test](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/tests/rust/src/lib.rs#L7)
675 | 
676 | </td>
677 | <td>
678 | 
679 | [Doc](https://docs.rs/wasi-experimental-http/0.10.0/wasi_experimental_http/)
680 | 
681 | </td>
682 | <td></td>
683 | <td>
684 | 
685 | Wasmtime with integrated `wasi-experimental-http` crate, e.g. [brendandburns's fork](https://github.com/brendandburns/wasmtime/commit/e2a567c4ca38190a74a7eca62cf65892547f2f3b)
686 | 
687 | </td>
688 | <td>
689 | 
690 | [Calling](https://github.com/deislabs/wasi-experimental-http/blob/v0.5.0/crates/wasi-experimental-http/src/raw.rs#L180) [imported](https://github.com/deislabs/wasi-experimental-http/blob/v0.5.0/crates/wasi-experimental-http/src/raw.rs#L163-L165) Wasmtime's [host function](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L238). The actual request is [here](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L516).
691 | 
692 | </td>
693 | </tr>
694 | </table>
695 | 
696 | 
697 | <a id="zig-wasi"></a>
698 | ### Zig
699 | 
700 | <table>
701 | <tr><th>Product / Implementation</th><th>TLDR: Usage</th><th>TLDR: Example code</th>
702 | <th>Doc</th>
703 | <th>Online demo</th>
704 | <th>WASM Runtime</th><th>Internals: method to do real request</th></tr>
705 | <tr>
706 | <td>
707 | 
708 | [wasi-experimental-http](https://crates.io/crates/wasi-experimental-http)
709 | 
710 | > [!CAUTION]
711 | > <sub>[Repo](https://github.com/deislabs/wasi-experimental-http) was archived on Feb 22, 2024.</sub>
712 | 
713 | 
714 | > [!TIP]
715 | > <sub>Use wasi-http instead.</sub>
716 | 
717 | </td>
718 | <td>
719 | 
720 | ```zig
721 | var gp_all = std.heap.GeneralPurposeAllocator(.{}){};
722 | const allocator = gp_all.allocator();
723 | var status: u16 = 0;
724 | var handle: u32 = 0;
725 | 
726 | _ = request("https://httpbin.org/anything", "GET", "", "", &status, &handle);
727 | defer _ = close(@bitCast(i32, handle));
728 | 
729 | var headers_buffer = try allocator.alloc(u8, 1024);
730 | var header_len: u32 = 0;
731 | _ = header(handle, "content-length", headers_buffer, &header_len);
732 | const length = try std.fmt.parseInt(u32, headers_buffer[0..header_len], 10);
733 | var buffer = try allocator.alloc(u8, length + 1);
734 | defer allocator.free(buffer);
735 | 
736 | var written: u32 = 0;
737 | _ = body_read(handle, &buffer[0], @bitCast(i32, buffer.len), &written);
738 | try std.io.getStdOut().writer().print("{s}\n", .{buffer[0..written]});
739 | ```
740 | 
741 | </td>
742 | <td>
743 | 
744 | [Example](https://github.com/dev-wasm/dev-wasm-zig/blob/84c2edf33e025103aae4d0861177585cc56fac8e/src/http.zig#L32)
745 | 
746 | </td>
747 | <td>
748 | 
749 | [Doc](https://docs.rs/wasi-experimental-http/0.10.0/wasi_experimental_http/)
750 | 
751 | </td>
752 | <td>
753 | 
754 | [Dev Container](https://codespaces.new/dev-wasm/dev-wasm-zig) _by brendandburns_
755 | 
756 | </td>
757 | <td>
758 | 
759 | Wasmtime with integrated `wasi-experimental-http` crate, e.g. [brendandburns's fork](https://github.com/brendandburns/wasmtime/commit/e2a567c4ca38190a74a7eca62cf65892547f2f3b)
760 | 
761 | </td>
762 | <td>
763 | 
764 | [Calling](https://github.com/dev-wasm/dev-wasm-zig/blob/84c2edf33e025103aae4d0861177585cc56fac8e/src/http.zig#L17)
765 | [imported](https://github.com/dev-wasm/dev-wasm-zig/blob/84c2edf33e025103aae4d0861177585cc56fac8e/src/http.zig#L1)
766 | Wasmtime's [host function](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L238).
767 | The actual request is [here](https://github.com/deislabs/wasi-experimental-http/blob/8291baece45cc51e18e69d7d5ad39ca20744e9f9/crates/wasi-experimental-http-wasmtime/src/lib.rs#L516).
768 | 
769 | </td>
770 | </tr>
771 | </table>
772 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2023 vasilev
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.


--------------------------------------------------------------------------------