bors 5aad9b302a Auto merge of #9992 - Byron:rfc-3028, r=ehuss ... Implement "artifact dependencies" (RFC-3028) Tracking issue: #9096 #### Tasks * [x] -Z unstable option called `bindeps` * ✅ **(config)** allow parsing of newly introduced 'artifact' fields * [x] into `TomlManifest` * [x] into `Manifest` - [x] ~~abort~~ warn if artifacts are used on stable * ✅ **resolver** : assure artifact dependencies are part of the resolution process and unified into the dependency tree * 🔬**compiler**: make it understand 'artifact' dependencies and pass new environment variables to the crate being build * [x] `lib=false` should not be considered a rust library for the dependent, in unit and possibly resolve graph * [x] assure profile settings are applied correctly * [x] target overrides work * [x] `target = "target"` in build deps * [x] other targets on build deps * [x] other targets on non-build deps * [x] 'no-cross doc tests' seems like a constraint we should apply as well maybe * [x] more confidence with `resolver = "2"` * [x] assure artifact placement is correct (bin and various forms of lib) * ✅ **serialization**: rewriting manifests (i.e. for publishing) does not discard artifact information * [x] publishing keeps `artifact` and `lib` values * **Other cargo subcommands** * [x] `cargo metadata` * leave unchanged * [x] artifacts work with `cargo check` * [x] artifacts work with rustdoc, such that it doesn't document them unless `lib=true` * [x] `cargo tree` maybe? * [x] `cargo clean` should clean artifacts - even though it's more complex, ultimately it deletes the `target` directory. * [x] artifacts work with `cargo test` (and dev-dependencies) * [x] doctests * [x] try `reproducible` repository as well. * 🧪 **tests** for more subtle RFC constraints - [x] build scripts cannot access artifact environment variables at compile time, only at runtime) - [x] assure 'examples' which also support crate-type fields like [[lib]] won't become artifacts themselves. - [x] assure `--out-dir` does not leak artifacts - tested manually, it seemed to niche to add a test. - [x] try `target="foo"` in artifact and assure it sees a decent error message - [x] Assure RFC 3176 _doesn't_ work * 🧹cleanup and finalization - [x] assure no `TODO(ST)` markers are left in code - [x] assure no tests are ignored - [x] use `resolver = "1"` once to assert everything also works with the previous resolver, but leave it on "2". #### Implementation and review notes - artifacts and unstable options are only checked when transforming them from `TomlManifest` to `Manifest`, discarding artifact information if the unstable flag is not set. Nowhere else in code will the CLI options be checked again. - `If no binaries are specified, all the binaries in the package will be built and made available.` - this should only refer to `[[bin]]` targets, not examples for instance. - artifact binaries won't be uplifted, hence won't be present outside of their output directory - ❗️We don't know how [package links](00e925f61f/src/cargo/core/compiler/unit_dependencies.rs (L380)) will affect artifacts for build dependencies. Should probably be thought through. - ❗️The location of artifacts is only tested roughly to avoid having to deal with different output names on the four platforms that seem to matter (gnu, macos, windows msvc, windows gnu). - `cargo tree` doesn't handle artifacts specifically, and it might be interesting to make clear if an artifact is only an artifact, or both artifact and dependency. - Most error and warning messages can probably be more cargo-matic. #### Questions * Does `cargo` without the feature enabled have to complain about the "artifact" field in a dependency, like it does right now? It doesn't look like machinery for that exists in `do_read_manifest()`. - ✔️It warns now * Should parsing of artifact values, like "bin" be case sensitive? - ✔️ It's case sensitive now, which should help with serde roundtripping. #### Review Progress * [x] address Josh's review notes one by one * [x] introduce `IsArtifact` (see [this answer](https://github.com/rust-lang/cargo/pull/9992#discussion_r774928102)) (76cd48a2d62d74e043a1a482199c5bb920f50311) * [x] prefer uplifting artifact deps that were written into the `deps` directory, but prefer to do that in [this PR instead](https://github.com/rust-lang/cargo/pull/9992) * [x] add extra-tests as described in Josh's comment: " features get unified between a Rust library and a binary, and one that confirms features don't get unified between a Rust library and a binary for a different target?" * [x] Make target-based artifact splitting work by porting parts of RFC-3176 * [x] test-support/cross-compile * [x] namespace separation * [x] re-create RFC-3176 what's not in RFC-3028, namely multidep support and all related tests * [x] Address Eh2406 's review comments * [x] Address Eric's comments * [x] Unstable features need to be documented in unstable.md. * [x] sort out [`target_data`](https://github.com/rust-lang/cargo/pull/9992#discussion_r787316229) * [x] figure out [cargo metadata](https://github.com/rust-lang/cargo/pull/9992#discussion_r787320923) * [x] See if target-data can work without an [index format update](https://github.com/rust-lang/cargo/pull/9992#issuecomment-1021697124). * [x] truncate comments at 80-90 lines and remove unused methods, remove -Z unstable-options, use `cfg!(target_env = "msvc")` * [x] add missing doc comments to newly added methods and funtions * [x] simplify method parameters and inline some functions * [x] add test and extend test to show additional issues * [x] assure current set of tests works consistently, also on windows Sponsored by [Profian](https://www.profian.com)		2022-02-22 03:56:46 +00:00
..
build-std	Fix build-std updating the index on every build.	2021-04-22 17:18:26 -07:00
testsuite	Auto merge of #9992 - Byron:rfc-3028, r=ehuss	2022-02-22 03:56:46 +00:00
internal.rs	Update clippy lint allow set.	2021-04-13 09:02:07 -07:00