30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# The `rustc-std-workspace-core` crate
|
|
|
|
This crate is a shim and empty crate which simply depends on `libcore` and
|
|
reexports all of its contents. The crate is the crux of empowering the standard
|
|
library to depend on crates from crates.io
|
|
|
|
Crates on crates.io that the standard library depend on the
|
|
`rustc-std-workspace-core` crate from crates.io. On crates.io, however, this
|
|
crate is empty. We use `[patch]` to override it to this crate in this
|
|
repository. As a result, crates on crates.io will draw a dependency edge to
|
|
`libcore`, the version defined in this repository. That should draw all the
|
|
dependency edges to ensure Cargo builds crates successfully!
|
|
|
|
Note that crates on crates.io need to depend on this crate with the name `core`
|
|
for everything to work correctly. To do that they can use:
|
|
|
|
```toml
|
|
core = { version = "1.0.0", optional = true, package = 'rustc-std-workspace-core' }
|
|
```
|
|
|
|
Through the use of the `package` key the crate is renamed to `core`, meaning
|
|
it'll look like
|
|
|
|
```
|
|
--extern core=.../librustc_std_workspace_core-XXXXXXX.rlib
|
|
```
|
|
|
|
when Cargo invokes the compiler, satisfying the implicit `extern crate core`
|
|
directive injected by the compiler.
|