Use `--target web` to reduce complexity of "Hello World" (cut down on tools needed to start) #181

kud1ing · 2019-07-27T21:13:29Z

Suggested instructions that don't need a generator or a bundler:

make sure wasm-pack is installed
checkout or download https://github.com/rustwasm/wasm-bindgen
got to examples/hello_world/
execute wasm-pack build --target web
create an index.html like

<html>
  <head>
    <meta content="text/html;charset=utf-8" http-equiv="Content-Type"/>
  </head>
  <body>
    <script type="module">
      import init, { greet } from './pkg/hello_world.js';

      async function run() {
        await init();

        greet("World");
      }

      run();
    </script>
  </body>
</html>

open index.html in a browser

The text was updated successfully, but these errors were encountered:

kud1ing · 2019-07-27T21:16:28Z

Note:

the 4th step will fail, if the example was obtained by checking out the repository, see wasm-pack build --target web panics for hello_world from a checked out repository wasm-bindgen#1680
it would be nice, if the hello_world directory included the index.html already
the last step works in Firefox, but fails in Safari:

[Error] Origin null is not allowed by Access-Control-Allow-Origin.
[Error] Failed to load resource: Origin null is not allowed by Access-Control-Allow-Origin. (hello_world.js, line 0)
[Error] TypeError: Cross-origin script load denied by Cross-Origin Resource Sharing policy.
	promiseReactionJob

fitzgen · 2019-07-29T17:11:57Z

This is pretty close to what we already have here: https://rustwasm.github.io/docs/book/game-of-life/hello-world.html

The main difference is that it doesn't use --target web, but we would like it to eventually. The main thing blocking switching the tutorial to using --target web is the addition of watch and serve subcommands to wasm-pack, so that we don't regress dev server and file watching fromt he developer experience.

Since we don't have an issue open in the book repo to track this, I'll make this issue be that.

fitzgen · 2019-07-29T17:14:21Z

Upstream blockers:

rustwasm/rfcs#10

rustwasm/wasm-pack#457

kud1ing · 2019-07-29T17:50:31Z

I appreciate this, OTOH:

a typical C "Hello world" requires about 2 things: a text editor and a C compiler/linker.
a minimal WASM with Rust "hello world" would require about 3 things: a text editor/git client, Rust and wasm-bindgen.
The current "hello world" asks the reader to install a project generator and an advanced development tool. I would reserve that to later.

I am not a newcomer to Rust, but i've struggled for about 1 hour to figure out how to get the current "hello world" working without installing tools i don't understand the need for.

It' s subjective. I prefer to learn bottom up, from the simple towards the complex.

kud1ing · 2019-08-09T11:08:36Z

I've just noticed that there are some more minimal examples:

kud1ing changed the title ~~Suggestion for a simple hello_world~~ Suggestion for a simple hello_world instructions Jul 27, 2019

kud1ing changed the title ~~Suggestion for a simple hello_world instructions~~ Suggestion for a simple hello_world example Jul 27, 2019

kud1ing changed the title ~~Suggestion for a simple hello_world example~~ Suggestion for a simple wasm-bindgen hello_world example Jul 27, 2019

fitzgen added the enhancement New feature or request label Jul 29, 2019

fitzgen changed the title ~~Suggestion for a simple wasm-bindgen hello_world example~~ Use --target web to simplify tutorial / cut down on tools needed to start Jul 29, 2019

kud1ing changed the title ~~Use --target web to simplify tutorial / cut down on tools needed to start~~ Use --target web to reduce complexity of "Hello World" (cut down on tools needed to start) Aug 9, 2019

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Use `--target web` to reduce complexity of "Hello World" (cut down on tools needed to start) #181

Use `--target web` to reduce complexity of "Hello World" (cut down on tools needed to start) #181

kud1ing commented Jul 27, 2019 •

edited

Loading

kud1ing commented Jul 27, 2019 •

edited

Loading

fitzgen commented Jul 29, 2019

fitzgen commented Jul 29, 2019

kud1ing commented Jul 29, 2019 •

edited

Loading

kud1ing commented Aug 9, 2019 •

edited

Loading

Use --target web to reduce complexity of "Hello World" (cut down on tools needed to start) #181

Use --target web to reduce complexity of "Hello World" (cut down on tools needed to start) #181

Comments

kud1ing commented Jul 27, 2019 • edited Loading

kud1ing commented Jul 27, 2019 • edited Loading

fitzgen commented Jul 29, 2019

fitzgen commented Jul 29, 2019

kud1ing commented Jul 29, 2019 • edited Loading

kud1ing commented Aug 9, 2019 • edited Loading

Use `--target web` to reduce complexity of "Hello World" (cut down on tools needed to start) #181

Use `--target web` to reduce complexity of "Hello World" (cut down on tools needed to start) #181

kud1ing commented Jul 27, 2019 •

edited

Loading

kud1ing commented Jul 27, 2019 •

edited

Loading

kud1ing commented Jul 29, 2019 •

edited

Loading

kud1ing commented Aug 9, 2019 •

edited

Loading