Prompting wasm32-unknown-emscripten users to install Emscripten
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 7k
- Forks
- 1.1k
- Avg merge
- 22h 40m
- Merged PRs (30d)
- 46
Description
Describe the problem you are trying to solve
The wasm32-unknown-emscripten target is unique (AFAIK) in that it requires an external toolchain, Emscripten, to be additionally installed to work correctly. Further, different versions of Rust require different specific versions of Emscripten to be installed and activated to ensure compatibility between the versions of LLVM used by Rust and Emscripten. Unfortunately, the matching Rust and Emscripten versions are not really documented anywhere. While we plan to improve the documentation situation, we will still have the problem of surfacing this issue and its documentation to users who install the wasm32-unknown-emscripten component.
Describe the solution you'd like
I could imagine Rustup helping in multiple ways when wasm32-uknown-emscripten is installed, from simply printing a generic message pointing to documentation, to printing a message identifying the specific version of Emscripten to install, to actually installing the correct version of Emscripten automatically. For now, I would be satisfied if we could just print a generic message. Is that something Rustup would accept a PR for? Would it make sense to pursue doing more than just printing a generic message in the future?
cc @RReverser and @kripken
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
The issue concerns the wasm32-unknown-emscripten component and prompting users about the required Emscripten toolchain. Begin by locating where rustup handles component installation and user-facing messages; done means installing this component produces a generic message pointing users to the relevant documentation.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust, wasm
- Domain
- cli, tooling
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100