bytecodealliance / bytecodealliance/component-docs

Improve ergonomics of Rust examples, re-enable use of published packages

Abierto
#255 3 comentarios 0 reacciones 0 asignados Ver en GitHub
enhancement lang/rust
Lenguaje dominante
Rust
Estrellas
137
Forks
88
Merge medio
5 d 12 h
PR fusionados (30 d)
4

Descripción

This issue arguably shouldn't go here, but currently UX issues in upstream tooling is making the Rust

The goal is to revert [this reverted functionality](https://github.com/bytecodealliance/component-docs/pull/254) -- we *want* to be able to use published WIT packages but there are a few issues stopping us:

- `cargo-component` does not configure/patch where `wkg` looks for deps (the target kind) when configured in `Cargo.toml` (i.e. we should be able to specify that `docs` is a known package w/ a known registry)
- `cargo-component` currently does not properly resolve targets w/ multiple worlds *even if* `wkg` is configured (via [it's global config file](https://github.com/bytecodealliance/wasm-pkg-tools?tab=readme-ov-file#configuration))
- `wkg` should be able to use local fconfig

There are at least a few ways to solve this issue:

1. Update `cargo-component` to perform the patching of registries for namespaces before using `wasm-pkg-tools` functionality
2. Update `wkg` to prefer local config files and include one in the tutorial code
3. Update the guide to get users to configure `wkg` global config before attempting usage.

A somewhat hidden requirement/sidequest to this issue is that we need more `cargo-component`/`wasm-pkg-tools` maintainers. The current functionality is fantastic for these tools, but the UX needs to be polished just a bit.

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.