wasm-server-runner 0.5.1

cargo run for wasm programs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# wasm-server-runner

Allows you to run programs in the browser using web assembly using a simple `cargo run`.

## Usage

### Step 1.

```sh
rustup target add wasm32-unknown-unknown
cargo install wasm-server-runner
```

### Step 2.

Add this to your `~/.cargo/config.toml` (**not** the `Cargo.toml` of your project!):

```toml
[target.wasm32-unknown-unknown]
runner = "wasm-server-runner"
```

### Step 3.

Run programs in the browser using
```sh
cargo run --target wasm32-unknown-unknown
cargo run --target wasm32-unknown-unknown --example example

wasm-server-runner path/to/file.wasm
```

Example output:
```yaml
INFO wasm_server_runner: wasm output is 49.79kb large
INFO wasm_server_runner: starting webserver at http://127.0.0.1:1334
```

The website will reload when the server is restarted and serve files relative to the current directory.

## Configuration options

All configuration options can be specified via environment variables.

<details>
<summary>WASM_SERVER_RUNNER_ADDRESS</summary>

Default: `127.0.0.1`

Control the address that the server listens on. Set to `0.0.0.0` to allow access from anywhere.

</details>

<details>
<summary>WASM_SERVER_RUNNER_DIRECTORY</summary>

Default: `.`

Can be used to specify where relative path requests are loaded from.

If there is an `index.html` file within this directory it will be used instead of [the
default](static/index.html).

</details>

<details>
<summary>WASM_SERVER_RUNNER_HTTPS</summary>

Default: `false`

Controls whether https is used.

</details>

<details>
<summary>WASM_SERVER_RUNNER_NO_MODULE</summary>

Default: `false`

Controls whether the wasm-bindgen output uses `module`s or not.
</details>