271 KiB
Changelog
Cargo 1.80 (2024-07-25)
Added
Changed
Fixed
Nightly only
-Zcargo-lints
: Don't always inherit workspace lints. #13812
Documentation
Internal
Cargo 1.79 (2024-06-13)
Added
- 🎉
cargo add
respectspackage.rust-version
a.k.a. MSRV when adding new dependencies. The behavior can be overridden by specifying a version requirement, or passing the--ignore-rust-version
flag. (RFC 3537) #13608 - A new
Locking
status message shows dependency changes on any command. Forcargo update
, it also tells you if any dependency version is outdated. #13561 #13647 #13651 #13657 #13759 #13764
Changed
- ❗️
RUSTC_WRAPPER
,RUSTC_WORKSPACE_WRAPPER
, and variables from the[env]
table now also apply to the initialrustc -vV
invocation Cargo uses for probing rustc information. #13659 - ❗️ Turns dependencies like
foo = { optional = true }
fromversion="*"
dependencies with a warning into errors. This behavior has been considered a bug from the beginning. #13775 - ❗️ Replace dashes with underscores also if
lib.name
is inferred frompackage.name
. This change aligns to the documented behavior. One caveat is thatcargo metadata
starts reporting underscore lib names. #12783 - Switch to
gitoxide
for listing files. This improves the performance of build script andcargo doc
for computing cache freshness, as well as fixes some subtle bugs forcargo publish
. #13592 #13696 #13704 #13777 - Warn on
-Zlints
being passed and no longer necessary. #13632 - Warn on unused
workspace.dependencies
keys on virtual workspaces. #13664 - cargo-init: don't assign
target.name
in Cargo.toml if the value can be inferred. #13606 - cargo-package: normalize paths in
Cargo.toml
, including replacing\
with/
. #13729 - cargo-test: recategorize cargo test's
--doc
flag under “Target Selection”. #13756 - Emit 1.77 build script syntax error only when msrv is incompatible. #13808
Fixed
- Dont panic when resolving an empty alias. #13613
- When using
--target
, the default debuginfo strip rule also applies. Note that on Windows MSVC Cargo no longer strips by default. #13618 - Don't crash on Cargo.toml parse errors that point to multi-byte character #13780
- cargo-add: Maintain sorting of dependency features. #13682
- cargo-add: Preserve comments when updating simple deps #13655
- cargo-fix: dont apply same suggestion twice. #13728
- cargo-package: error when the package specified via
--package
cannot be found #13735 - credential-provider: trim newlines in tokens from stdin. #13770
- Don't emit deprecation warning if one of
.cargo/{config,config.toml}
is a symlink to the other. #13793 - Follow HTTP redirections when checking if a repo on GitHub is up-to-date. #13718
- Bash completion fallback in
nounset
mode. #13686 - Rerun build script when rustflags changed and
--target
was passed. #13560 - Fix doc collision for lib/bin with a dash in the inferred name. #13640
Nightly only
- 🔥 cargo-update: allows
--precise
to specify a pre-release version of a package (RFC 3493) (docs) #13626 - RFC 3491: Unused dependencies cleanup #13778
-Zcargo-lints
: Add a basic linting system for Cargo. This is still under development and not available for general use. #13621 #13635 #13797 #13740 #13801- 🔥
edition2024
: Add default Edition2024 to resolver v3 (MSRV-aware resolver). #13785 edition2024
: Remove underscore field support in 2024. #13783 #13798 #13800 #13804edition2024
: Error on[project]
in Edition 2024 #13747-Zmsrv-policy
: Respect '--ignore-rust-version' #13738-Zmsrv-policy
: Add--ignore-rust-version
to update/generate-lockfile #13741 #13742-Zmsrv-policy
: Put MSRV-aware resolver behind a config #13769-Zmsrv-policy
: Error, rather than panic, on rust-version 'x' #13771-Zmsrv-policy
: Fallback to 'rustc -V' for MSRV resolving. #13743-Zmsrv-policy
: Add v3 resolver for MSRV-aware resolving #13776-Zmsrv-policy
: Don't respect MSRV for non-local installs #13790-Zmsrv-policy
: Track when MSRV is explicitly set, either way #13732- test: don't compress test registry crates. #13744
Documentation
- Clarify
--locked
ensuring that Cargo uses dependency versions in lockfile #13665 - Clarify the precedence of
RUSTC_WORKSPACE_WRAPPER
andRUSTC_WRAPPER
. #13648 - Clarify only in the root Cargo.toml the
[workspace]
section is allowed. #13753 - Clarify the differences between virtual and real manifests. #13794
Internal
- 🎉 New member crates
cargo-test-support
andcargo-test-macro
! They are designed for testing Cargo itself, so no guarantee on any stability across versions. The crates.io publish of this crate is the same as other members crates. They follow Rust's 6-week release process. #13418 - Fix publish script due to crates.io CDN change #13614
- Push diagnostic complexity on annotate-snippets #13619
- cargo-package: Simplify getting of published Manifest #13666
- ci: update macos images to macos-13 #13685
- manifest: Split out an explicit step to resolve
Cargo.toml
#13693 - manifest: Decouple target discovery from Target creation #13701
- manifest: Expose surce/spans for VirtualManifests #13603
- Update dependencies #13609 #13674 #13675 #13679 #13680 #13692 #13731 #13760
Cargo 1.78 (2024-05-02)
Added
- Stabilize global cache data tracking. The
-Zgc
flag is still unstable. This is only for Cargo to start data collection, so that when automatic gc is stabilized, it's less likely to see cache misses. #13492 #13467 - Stabilize lockfile format v4. Lockfile v3 is still the default version. #12852
- Auto-detecting whether output can be rendered using non-ASCII Unicode characters.
A configuration value
term.unicode
is added to control the behavior manually. docs #13337 - Support
target.<triple>.rustdocflags
in Cargo configuration. docs #13197
Changed
- cargo-add: Print a status when a dep feature is being created #13434
- cargo-add: improve the error message when adding a package from a replaced source. #13281
- cargo-doc: Collapse down
Generated
statuses without--verbose
. #13557 - cargo-new: Print a 'Creating', rather than 'Created' status #13367
- cargo-new: Print a note, rather than a comment, for more information #13371
- cargo-new: Print a hint when adding members to workspace #13411
- cargo-test: Suggest
--
for libtest arguments #13448 - cargo-update: Tell users when some dependencies are still behind latest. #13372
- Deprecate non-extension
.cargo/config
files. #13349 - Don't print rustdoc command lines on failure by default #13387
- Respect
package.rust-version
when generating new lockfiles. #12861 - Send
User-Agent: cargo/1.2.3
header when communicating with remote registries. Previously it wascargo 1.2.3
, which didn't follow the HTTP specifications. #13548 - Emit a warning when
package.edition
field is missing in Cargo.toml. #13499 #13504 #13505 #13533 - Emit warnings from parsing virtual manifests. #13589
- Mention the workspace root location in the error message when collecting workspace members. #13480
- Clarify the profile in use in
Finished
status message. #13422 - Switched more notes/warnings to lowercase. #13410
- Report all packages incompatible with
package.rust-version.
, not just a random one. #13514
Fixed
- cargo-add: don't add the new package to
workspace.members
if there is no existing workspace in Cargo.toml. #13391 - cargo-add: Fix markdown line break in cargo-add #13400
- cargo-run: use Package ID Spec match packages #13335
- cargo-doc: doctest searches native libs in build script outputs. #13490
- cargo-publish: strip also features from dev-dependencies from Cargo.toml to publish. #13518
- Don't duplicate comments when editing TOML via
cargo add/rm/init/new
. #13402 - Fix confusing error messages for sparse index replaced source. #13433
- Respect
CARGO_TERM_COLOR
in '--list' and '-Zhelp'. #13479 - Control colors of errors and help texts from clap through
CARGO_TERM_COLOR
. #13463 - Don't panic on empty spans in Cargo.toml. #13375 #13376
Nightly only
- 🔥 cargo-update: allows
--precise
to specify a yanked version of a package #13333 -Zcheck-cfg
: Adddocsrs
cfg as a well known--check-cfg
#13383-Zcheck-cfg
: Silently ignorecargo::rustc-check-cfg
to avoid MSRV annoyance when stabilizing-Zcheck-cfg
. #13438-Zmsrv-policy
: Fallback torustc -v
when no MSRV is set #13516-Zscript
: Improve errors related to cargo script #13346-Zpanic-abort-tests
: applies to doctests too #13388-Zpublic-dependency
: supports enabling via the-Zpublic-dependency
flag. #13340 #13556 #13547-Zpublic-dependency
: test for packaging a public dependency #13536-Zrustdoc-map
: Add all unit's children recursively fordoc.extern-map
option #13481 #13544edition2024
: Enable edition migration for 2024. #13429open-namespaces
: basic support for open namespaces (RFC 3243) (docs) #13591
Documentation
- cargo-fetch: hide
cargo-fetch
recursive link in--offline
man page. #13364 - cargo-install:
--list
option description starting with uppercase #13344 - cargo-vendor: clarify vendored sources as read-only and ways to modify them #13512
- build-script: clarification of build script metadata set via
cargo::metadata=KEY=VALUE
. #13436 - Clarify the
version
field in[package]
is optional in Cargo.toml #13390 - Improve "Registry Authentication" docs #13351
- Improve "Specifying Dependencies" docs #13341
- Remove
package.documentation
from the “before publishing” list. #13398
Internal
- 🎉 Integrated tracing-chrome as a basic profiler for Cargo itself. docs #13399 #13551
- Updated to
gix
0.58.0 #13380 - Updated to
git2
0.18.2 #13412 - Updated to
jobserver
0.1.28 #13419 - Updated to
supports-hyperlinks
3.0.0 #13511 - Updated to
rusqlite
0.31.0 #13510 - bump-check: use symmetric difference when comparing source code #13581
- bump-check: include rustfix and cargo-util-schemas #13421
- ci: enable m1 runner #13377
- ci: Ensure lockfile is respected during MSRV testing via
cargo-hack
. #13523 - cargo-util-schemas: Consistently compare MSRVs via
RustVersion::is_compatible_with
. #13537 - console: Use new fancy
anstyle
API #13368 #13562 - fingerprint: remove unnecessary Option in
Freshness::Dirty
#13361 - fingerprint: abstract
std::fs
away from on-disk index cache #13515 - mdman: Updated to
pulldown-cmark
0.10.0 #13517 - refactor: Renamed
Config
toGlobalContext
#13409 #13486 #13506 - refactor: Removed unused
sysroot_host_libdir
. #13468 - refactor: Expose source/spans to Manifest for emitting lints #13593
- refactor: Flatten manifest parsing #13589
- refactor: Make lockfile diffing/printing more reusable #13564
- test: Updated to
snapbox
0.5.0 #13441 - test: Verify terminal styling via snapbox's
term-svg
feature. #13461 #13465 #13520 - test: Ensure
nonzero_exit_code
test isn't affected by developersRUST_BACKTRACE
setting #13385 - test: Add tests for using worktrees. #13567
- test: Fix old_cargos tests #13435
- test: Fixed tests due to changes in rust-lang/rust. #13362 #13382 #13415 #13424 #13444 #13455 #13464 #13466 #13469
- test: disable lldb test as it requires privileges to run on macOS #13416
Cargo 1.77.1 (2024-03-28)
Fixed
- Debuginfo is no longer stripped by default for Windows MSVC targets. This caused an unexpected regression in 1.77.0 that broke backtraces. #13654
Cargo 1.77 (2024-03-21)
Added
- 🎉 Stabilize the package identifier format as Package ID Spec.
This format can be used across most of the commands in Cargo, including the
--package
/-p
flag,cargo pkgid
,cargo metadata
, and JSON messages from--message-format=json
. #12914 #13202 #13311 #13298 #13322 - Add colors to
-Zhelp
console output #13269 - build script: Extend the build directive syntax with
cargo::
. #12201 #13212
Changed
- 🎉 Disabling debuginfo now implies
strip = "debuginfo"
(whenstrip
is not set) to strip pre-existing debuginfo coming from the standard library, reducing the default size of release binaries considerably (from ~4.5 MiB down to ~450 KiB for helloworld on Linux x64). #13257 - Add
rustc
style errors for manifest parsing. #13172 - Deprecate rustc plugin support in cargo #13248
- cargo-vendor: Hold the mutate exclusive lock when vendoring. #12509
- crates-io: Set
Content-Type: application/json
only for requests with a body payload #13264
Fixed
- jobserver: inherit jobserver from env for all kinds of runner #12776
- build script: Set
OUT_DIR
for all units with build scripts #13204 - cargo-add: find the correct package with given features from Git repositories with multiple packages. #13213
- cargo-fix: always inherit the jobserver #13225
- cargo-fix: Call rustc fewer times to improve the performance. #13243
- cargo-new: only inherit workspace package table if the new package is a member #13261
- cargo-update:
--precise
accepts arbitrary git revisions #13250 - manifest: Provide unused key warnings for lints table #13262
- rustfix: Support inserting new lines. #13226
Nightly only
- 🔥
-Zgit
: Implementation of shallow libgit2 fetches behind an unstable flag docs #13252 - 🔥 Add unstable
--output-format
option tocargo rustdoc
, providing tools with a way to lean on rustdoc’s experimental JSON format. docs #12252 #13284 #13325 -Zcheck-cfg
: Rework--check-cfg
generation comment #13195-Zcheck-cfg
: Go back to passing an emptyvalues()
when no features are declared #13316-Zprecise-pre-release
: the flag is added but not implemented yet. #13296 #13320-Zpublic-dependency
: support publish package with apublic
field. #13245-Zpublic-dependency
: help text of--public
/--no-public
flags forcargo add
#13272-Zscript
: Add prefix-char frontmatter syntax support #13247-Zscript
: Add multiple experimental manifest syntaxes #13241-Ztrim-paths
: remap common prefix only #13210
Documentation
- Added guidance on setting homepage in manifest #13293
- Clarified how custom subcommands are looked up. #13203
- Clarified why
du
function uses mutex #13273 - Highlighted "How to find features enabled on dependencies" #13305
- Delete sentence about parentheses being unsupported in license #13292
- resolver: clarify how pre-release version is handled in dependency resolution. #13286
- cargo-test: clarify the target selection of the test options. #13236
- cargo-install: clarify
--path
is the installation source not destination #13205 - contrib: Fix team HackMD links #13237
- contrib: Highlight the non-blocking feature gating technique #13307
Internal
- 🎉 New member crate
cargo-util-schemas
! This contains low-level Cargo schema types, focusing onserde
andFromStr
for use in reading files and parsing command-lines. Any logic for getting final semantics from these will likely need other tools to process, likecargo metadata
. The crates.io publish of this crate is the same as other members crates. It follows Rust's 6-week release process. #13178 #13185 #13186 #13209 #13267 - Updated to
gix
0.57.1. #13230 - cargo-fix: Remove error-format special-case in
cargo fix
#13224 - cargo-credential: bump to 0.4.3 #13221
- mdman: updated to
handlebars
5.0.0. #13168 #13249 - rustfix: remove useless clippy rules and fix a typo #13182
- ci: fix Dependabot's MSRV auto-update #13265 #13324 #13268
- ci: Add dependency dashboard. #13255
- ci: update alpine docker tag to v3.19 #13228
- ci: Improve GitHub Actions CI config #13317
- resolver: do not panic when sorting empty summaries #13287
Cargo 1.76 (2024-02-08)
Added
- Added a Windows application manifest file to the built
cargo.exe
for windows msvc. #13131
Notable changes:- States the compatibility with Windows versions 7, 8, 8.1, 10 and 11.
- Sets the code page to UTF-8.
- Enables long path awareness.
- Added color output for
cargo --list
. #12992 - cargo-add:
--optional <dep>
would create a<dep> = "dep:<dep>"
feature. #13071 - Extends Package ID spec for unambiguous specs.
docs
#12933
Specifically,- Supports
git+
andpath+
schemes. - Supports Git ref query strings, such as
?branch=dev
or?tag=1.69.0
.
- Supports
Changed
- ❗️ Disallow
[lints]
in virtual workspaces as they are ignored and users likely meant[workspace.lints]
. This was an oversight in the initial implementation (e.g. a[dependencies]
produces the same error). #13155 - Disallow empty name in several places like package ID spec and
cargo new
. #13152 - Respect
rust-lang/rust
'somit-git-hash
option. #12968 - Displays error count with a number, even when there is only one error. #12484
all-static
feature now includesvendored-libgit2
. #13134- crates-io: Add support for other 2xx HTTP status codes when interacting with registries. #13158 #13160
- home: Replace SHGetFolderPathW with SHGetKnownFolderPath. #13173
Fixed
- Print rustc messages colored on wincon. #13140
- Fixed bash completion in directory with spaces. #13126
- Fixed uninstall a running binary failed on Windows. #13053 #13099
- Fixed the error message for duplicate links. #12973
- Fixed
--quiet
being used with nested subcommands. #12959 - Fixed panic when there is a cycle in dev-dependencies. #12977
- Don't panic when failed to parse rustc commit-hash. #12963 #12965
- Don't do git fetches when updating workspace members. #12975
- Avoid writing CACHEDIR.TAG if it already exists. #13132
- Accept
?
in the--package
flag if it's a valid pkgid spec. #13315 #13318 - cargo-package: Only filter out
target
directory if it's in the package root. #12944 - cargo-package: errors out when a build script doesn't exist or is outside the package root. #12995
- cargo-credential-1password: Add missing
--account
argument toop signin
command. #12985 #12986
Nightly only
- 🔥 The
-Zgc
flag enables garbage collection for deleting old, unused files in cargo's cache. That is, downloaded source files and registry index under theCARGO_HOME
directory. docs #12634 #12958 #12981 #13055 - 🔥 Added a new environment variable
CARGO_RUSTC_CURRENT_DIR
. This is a path that rustc is invoked from. docs #12996 -Zcheck-cfg
: Include declared list of features in fingerprint for-Zcheck-cfg
. #13012-Zcheck-cfg
: Fix--check-cfg
invocations with zero features. #13011-Ztrim-paths
: reorder--remap-path-prefix
flags for-Zbuild-std
. #13065-Ztrim-paths
: explicitly remap current dir by using.
. #13114-Ztrim-paths
: exercise with real world debugger. #13091 #13118-Zpublic-dependency
: Limitexported-private-dependencies
lints to libraries. #13135-Zpublic-dependency
: Disallow workspace-inheriting of dependency public status. #13125-Zpublic-dependency
: Add--public
forcargo add
. #13046-Zpublic-dependency
: Remove unused public-deps error handling #13036-Zmsrv-policy
: Prefer MSRV, rather than ignore incompatible. #12950-Zmsrv-policy
: De-prioritize no-rust-version in MSRV resolver. #13066-Zrustdoc-scrape-examples
: Don't filter on workspace members when scraping doc examples. #13077
Documentation
- Recommends a wider selection of libsecret-compatible password managers. #12993
- Clarified different targets has different sets of
CARGO_CFG_*
values. #13069 - Clarified
[lints]
table only affects local development of the current package. #12976 - Clarified
cargo search
can search in alternative registries. #12962 - Added common CI practices for verifying
rust-version
(MSRV) field. #13056 - Added a link to rustc lint levels doc. #12990
- Added a link to the packages lint table from the related workspace table #13057
- contrib: Add more resources to the contrib docs. #13008
- contrib: Update how that credential crates are published. #13006
- contrib: remove review capacity notice. #13070
Internal
- 🎉 Migrate
rustfix
crate to therust-lang/cargo
repository. #13005 #13042 #13047 #13048 #13050 - Updated to
curl-sys
0.4.70, which corresponds to curl 8.4.0. #13147 - Updated to
gix-index
0.27.1. #13148 - Updated to
itertools
0.12.0. #13086 - Updated to
rusqlite
0.30.0. #13087 - Updated to
toml_edit
0.21.0. #13088 - Updated to
windows-sys
0.52.0. #13089 - Updated to
tracing
0.1.37 for being be compatible with rustc_log. #13239 #13242 - Re-enable flaky gitoxide auth tests thanks to update to
gix-config
. #13117 #13129 #13130 - Dogfood Cargo
-Zlints
table feature. #12178 - Refactored
Cargo.toml
parsing code in preparation of extracting an official schema API. #12954 #12960 #12961 #12971 #13000 #13021 #13080 #13097 #13123 #13128 #13154 #13166 - Use
IndexSummary
inquery{_vec}
functions. #12970 - ci: migrate renovate config #13106
- ci: Always update gix packages together #13093
- ci: Catch naive use of AtomicU64 early #12988
- xtask-bump-check: dont check
home
against beta/stable branches #13167 - cargo-test-support: Handle $message_type in JSON diagnostics #13016
- cargo-test-support: Add more options to registry test support. #13085
- cargo-test-support: Add features to the default Cargo.toml file #12997
- cargo-test-support: Fix clippy-wrapper test race condition. #12999
- test: Don't rely on mtime to test changes #13143
- test: remove unnecessary packages and versions for
optionals
tests #13108 - test: Remove the deleted feature
test_2018_feature
from the test. #13156 - test: remove jobserver env var in some tests. #13072
- test: Fix a rustflags test using a wrong buildfile name #12987
- test: Fix some test output validation. #12982
- test: Ignore changing_spec_relearns_crate_types on windows-gnu #12972
Cargo 1.75 (2023-12-28)
Added
package.version
field inCargo.toml
is now optional and defaults to0.0.0
. Packages without thepackage.version
field cannot be published. #12786- Links in
--timings
andcargo doc
outputs are clickable on supported terminals, controllable throughterm.hyperlinks
config value. #12889 - Print environment variables for build script executions with
-vv
. #12829 - cargo-new: add new packages to [workspace.members] automatically. #12779
- cargo-doc: print a new
Generated
status displaying the full path. #12859
Changed
- cargo-new: warn if crate name doesn't follow snake_case or kebab-case. #12766
- cargo-install: clarify the arg
<crate>
to install is positional. #12841 - cargo-install: Suggest an alternative version on MSRV failure. #12798
- cargo-install: reports more detailed SemVer errors. #12924
- cargo-install: install only once if there are crates duplicated. #12868
- cargo-remove: Clarify flag behavior of different dependency kinds. #12823
- cargo-remove: suggest the dependency to remove exists only in the other section. #12865
- cargo-update: Do not call it "Downgrading" when difference is only build metadata. #12796
- Enhanced help text to clarify
--test
flag is for Cargo targets, not test functions. #12915 - Included package name/version in build script warnings. #12799
- Provide next steps for bad -Z flag. #12857
- Suggest
cargo search
whencargo-<command>
cannot be found. #12840 - Do not allow empty feature name. #12928
- Added unsupported short flag suggestion for
--target
and--exclude
flags. #12805 - Added unsupported short flag suggestion for
--out-dir
flag. #12755 - Added unsupported lowercase
-z
flag suggestion for-Z
flag. #12788 - Added better suggestion for unsupported
--path
flag. #12811 - Added detailed message when target directory path is invalid. #12820
Fixed
- Fixed corruption when cargo was killed while writing to files. #12744
- cargo-add: Preserve more comments #12838
- cargo-fix: preserve jobserver file descriptors on rustc invocation. #12951
- cargo-remove: Preserve feature comments #12837
- Removed unnecessary backslash in timings HTML report when error happens. #12934
- Fixed error message that invalid a feature name can contain
-
. #12939 - When there's a version of a dependency in the lockfile, Cargo would use that "exact" version, including the build metadata. #12772
Nightly only
- Added
Edition2024
unstable feature. docs #12771 - 🔥 The
-Ztrim-paths
feature adds a new profile setting to control how paths are sanitized in the resulting binary. (RFC 3127) (docs) #12625 #12900 #12908 -Zcheck-cfg
: Adjusted for new rustc syntax and behavior. #12845-Zcheck-cfg
: Remove outdated option to-Zcheck-cfg
warnings. #12884public-dependency
: Supportpublic
dependency configuration with workspace deps. #12817
Documentation
- profile: add missing
strip
info. #12754 - features: a note about the new limit on number of features. #12913
- crates-io: Add doc comment for
NewCrate
struct. #12782 - resolver: Highlight commands to answer dep resolution questions. #12903
- cargo-bench:
--bench
is passed in unconditionally to bench harnesses. #12850 - cargo-login: mention args after
--
in manpage. #12832 - cargo-vendor: clarify config to use vendored source is printed to stdout #12893
- manifest: update to SPDX 2.3 license expression and 3.20 license list. #12827
- contrib: Policy on manifest editing #12836
- contrib: use
AND
search terms in mdbook search and fixed broken links. #12812 #12813 #12814 - contrib: Describe how to add a new package #12878
- contrib: Removed review capacity notice. #12842
Internal
- Updated to
itertools
0.11.0. #12759 - Updated to
cargo_metadata
0.18.0. #12758 - Updated to
curl-sys
0.4.68, which corresponds to curl 8.4.0. #12808 - Updated to
toml
0.8.2. #12760 - Updated to
toml_edit
0.20.2. #12761 - Updated to
gix
to 0.55.2 #12906 - Disabled the
custom_target::custom_bin_target
test on windows-gnu. #12763 - Refactored
Cargo.toml
parsing code in preparation of extracting an official schema API. #12768 #12881 #12902 #12911 #12948 - Split out SemVer logic to its own module. #12926 #12940
- source: Prepare for new
PackageIDSpec
syntax #12938 - resolver: Consolidate logic in
VersionPreferences
#12930 - Make the
SourceId::precise
field an Enum. #12849 - shell: Write at once rather than in fragments. #12880
- Move up looking at index summary enum #12749 #12923
- Generate redirection HTML pages in CI for Cargo Contributor Guide. #12846
- Add new package cache lock modes. #12706
- Add regression test for issue 6915: features and transitive dev deps. #12907
- Auto-labeling when PR review state changes. #12856
- credential: include license files in all published crates. #12953
- credential: Filter
cargo-credential-*
dependencies by OS. #12949 - ci: bump cargo-semver-checks to 0.24.0 #12795
- ci: set and verify all MSRVs for Cargo's crates automatically. #12767 #12654
- ci: use separate concurrency group for publishing Cargo Contributor Book. #12834 #12835
- ci: update
actions/checkout
action to v4 #12762 - cargo-search: improved the margin calculation for the output. #12890
Cargo 1.74 (2023-11-16)
Added
- 🎉 The
[lints]
table has been stabilized, allowing you to configure reporting levels for rustc and other tool lints inCargo.toml
. (RFC 3389) (docs) #12584 #12648 - 🎉 The unstable features
credential-process
andregistry-auth
have been stabilized. These features consolidate the way to authenticate with private registries. (RFC 2730) (RFC 3139) (docs) #12590 #12622 #12623 #12626 #12641 #12644 #12649 #12671 #12709
Notable changes:- Introducing a new protocol for both external and built-in providers to store and retrieve credentials for registry authentication.
- Adding the
auth-required
field in the registry index'sconfig.json
, enabling authenticated sparse index, crate downloads, and search API. - For using alternative registries with authentication, a credential provider must be configured to avoid unknowingly storing unencrypted credentials on disk.
- These settings can be configured in
[registry]
and[registries]
tables.
- 🎉
--keep-going
flag has been stabilized and is now available in each build command (exceptbench
andtest
, which have--no-fail-fast
instead). (docs) #12568 - Added
--dry-run
flag and summary line at the end forcargo clean
. #12638 - Added a short alias
-n
for cli option--dry-run
. #12660 - Added support for
target.'cfg(..)'.linker
. #12535 - Allowed incomplete versions when they are unambiguous for flags like
--package
. #12591 #12614 #12806
Changed
- ❗️ Changed how arrays in configuration are merged. The order was unspecified and now follows how other configuration types work for consistency. summary #12515
- ❗️ cargo-clean: error out if
--doc
is mixed with-p
. #12637 - ❗ cargo-new / cargo-init no longer exclude
Cargo.lock
in VCS ignore files for libraries. #12382 - cargo-update: silently deprecate
--aggressive
in favor of the new--recursive
. #12544 - cargo-update:
-p/--package
can be used as a positional argument. #12545 #12586 - cargo-install: suggest
--git
when the package name looks like a URL. #12575 - cargo-add: summarize the feature list when it's too long. #12662 #12702
- Shell completion for
--target
uses rustup but falls back to rustc. #12606 - Help users know possible
--target
values. #12607 - Enhanced "registry index not found" error message. #12732
- Enhanced CLI help message of
--explain
. #12592 - Enhanced deserialization errors of untagged enums with
serde-untagged
. #12574 #12581 - Enhanced the error when mismatching prerelease version candidates. #12659
- Enhanced the suggestion on ambiguous Package ID spec. #12685
- Enhanced TOML parse errors to show the context. #12556
- Enhanced filesystem error by adding wrappers around
std::fs::metadata
. #12636 - Enhanced resolver version mismatch warning. #12573
- Use clap to suggest alternative argument for unsupported arguments. #12529 #12693 #12723
- Removed redundant information from cargo new/init
--help
output. #12594 - Console output and styling tweaks. #12578 #12655 #12593
Fixed
- Use full target spec for
cargo rustc --print --target
. #12743 - Copy PDBs also for EFI targets. #12688
- Fixed resolver behavior being independent of package order. #12602
- Fixed unnecessary clean up of
profile.release.package."*"
forcargo remove
. #12624
Nightly only
-Zasymmetric-token
: Created dedicated unstable flag for asymmetric-token support. #12551-Zasymmetric-token
: Improved logout message for asymmetric tokens. #12587-Zmsrv-policy
: Very preliminary MSRV resolver support. #12560-Zscript
: Hack in code fence support. #12681-Zbindeps
: Support dependencies from registries. #12421
Documentation
- ❗ Policy change: Checking
Cargo.lock
into version control is now the default choice, even for libraries. Lockfile and CI integration documentations are also expanded. Policy docs, Lockfile docs, CI docs, #12382 #12630 - SemVer: Update documentation about removing optional dependencies. #12687
- Contrib: Add process for security responses. #12487
- cargo-publish: warn about upload timeout. #12733
- mdbook: use AND search when having multiple terms. #12548
- Established publish best practices #12745
- Clarify caret requirements. #12679
- Clarify how
version
works forgit
dependencies. #12270 - Clarify and differentiate defaults for split-debuginfo. #12680
- Added missing
strip
entries indev
andrelease
profiles. #12748
Internal
- Updated to
curl-sys
0.4.66, which corresponds to curl 8.3.0. #12718 - Updated to
gitoxide
0.54.1. #12731 - Updated to
git2
0.18.0, which corresponds to libgit2 1.7.1. #12580 - Updated to
cargo_metadata
0.17.0. #12758 - Updated target-arch-aware crates to support mips r6 targets #12720
- publish.py: Remove obsolete
sleep()
calls. #12686 - Define
{{command}}
for use in src/doc/man/includes #12570 - Set tracing target
network
for networking messages. #12582 - cargo-test-support: Add
with_stdout_unordered
. #12635 - dep: Switch from
termcolor
toanstream
. #12751 - Put
Source
trait undercargo::sources
. #12527 - SourceId: merge
name
andalt_registry_key
into one enum. #12675 - TomlManifest: fail when package_root is not a directory. #12722
- util: enhanced doc of
network::retry
doc. #12583 - refactor: Pull out cargo-add MSRV code for reuse #12553
- refactor(install): Move value parsing to clap #12547
- Fixed spurious errors with networking tests. #12726
- Use a more compact relative-time format for
CARGO_LOG
internal logging. #12542 - Use newer std API for cleaner code. #12559 #12604 #12615 #12631
- Buffer console status messages. #12727
- Use enum to describe index summaries to provide a richer information when summaries are not available for resolution. #12643
- Use shortest path for resolving the path from the given dependency up to the root. #12678
- Read/write the encoded
cargo update --precise
in the same place #12629 - Set MSRV for internal packages. #12381
- ci: Update Renovate schema #12741
- ci: Ignore patch version in MSRV #12716
Cargo 1.73 (2023-10-05)
Added
- Print environment variables for
cargo run/bench/test
in extra verbose mode-vv
. #12498 - Display package versions on Cargo timings graph. #12420
Changed
- ❗️ Cargo now bails out when using
cargo::
in custom build scripts. This is a preparation for an upcoming change in build script invocations. #12332 - ❗️
cargo login
no longer accept any token after the--
syntax. Arguments after--
are now reserved in the preparation of the new credential provider feature. This introduces a regression that overlooks thecargo login -- <token>
support in previous versions. #12499 - Make Cargo
--help
easier to browse. #11905 - Prompt the use of
--nocapture
flag ifcargo test
process is terminated via a signal. #12463 - Preserve jobserver file descriptors on the rustc invocation for getting target information. #12447
- Clarify in
--help
thatcargo test --all-targets
excludes doctests. #12422 - Normalize
cargo.toml
toCargo.toml
on publish, and warn on other cases ofCargo.toml
. #12399
Fixed
- Only skip mtime check on
~/.cargo/{git,registry}
. #12369 - Fixed
cargo doc --open
crash on WSL2. #12373 - Fixed panic when enabling
http.debug
for certain strings. #12468 - Fixed
cargo remove
incorrectly removing used patches. #12454 - Fixed crate checksum lookup query should match on semver build metadata. #11447
- Fixed printing multiple warning messages for unused fields in
[registries]
table. #12439
Nightly only
- 🔥 The
-Zcredential-process
has been reimplemented with a clearer way to communicate with different credential providers. Several built-in providers are also added to Cargo. docs #12334 #12396 #12424 #12440 #12461 #12469 #12483 #12499 #12507 #12512 #12518 #12521 #12526
Some notable changes:- Renamed
credential-process
tocredential-provider
in Cargo configurations. - New JSON protocol for communicating with external credential providers via stdin/stdout.
- The GNOME Secert provider now dynamically loads
libsecert
. - The 1password provider is no longer built-in.
- Changed the unstable key for asymmetric tokens from
registry-auth
tocredential-process
.
- Renamed
- ❗️ Removed
--keep-going
flag support fromcargo test
andcargo bench
. #12478 #12492 - Fixed invalid package names generated by
-Zscript
. #12349 -Zscript
now errors out on unsupported commands —publish
andpackage
. #12350- Encode URL params correctly for source ID in Cargo.lock. #12280
- Replaced invalid
panic_unwind
std feature withpanic-unwind
. #12364 -Zlints
: doctest extraction should respect[lints]
. #12501
Documentation
- SemVer: Adding a section for changing the alignment, layout, or size of a well-defined type. #12169
- Use heading attributes to control the fragment. #12339
- Use "number" instead of "digit" when explaining Cargo's use of semver. #12340
- contrib: Add some more detail about how publishing works. #12344
- Clarify "Package ID" and "Source ID" in
cargo metadata
are opaque strings. #12313 - Clarify that
rerun-if-env-changed
doesn't monitor the environment variables it set for crates and build script. #12482 - Clarify that multiple versions that differ only in the metadata tag are disallowed on crates.io. #12335
- Clarify
lto
setting passing-Clinker-plugin-lto
. #12407 - Added
profile.strip
to configuration and environment variable docs. #12337 #12408 - Added docs for artifact JSON debuginfo levels. #12376
- Added a notice for the backward compatible
.cargo/credential
file existence. #12479 - Raised the awareness of
resolver = 2
used inside workspaces. #12388 - Replaced
master
branch by default branch in documentation. #12435
Internal
- Updated to
criterion
0.5.1. #12338 - Updated to
curl-sys
0.4.65, which corresponds to curl 8.2.1. #12406 - Updated to
indexmap
v2. #12368 - Updated to
miow
0.6.0, which drops old versions ofwindows-sys
. #12453 - ci: automatically test new packages by using
--workspace
. #12342 - ci: automatically update dependencies monthly with Renovate. #12341 #12466
- ci: rewrote
xtask-bump-check
for respecting semver by adoptingcargo-semver-checks
. #12395 #12513 #12508 - Rearranged and renamed test directories #12397 #12398
- Migrated from
log
totracing
. #12458 #12488 - Track
--help
output in tests. #11912 - Cleaned up and shared package metadata within workspace. #12352
crates-io
: expose HTTP headers andError
type. #12310- For
cargo update
, caught CLI flags conflict between--aggressive
and--precise
in clap. #12428 - Several fixes for either making Cargo testsuite pass on nightly or in
rust-lang/rust
. #12413 #12416 #12429 #12450 #12491 #12500
Cargo 1.72 (2023-08-24)
Added
- ❗ Enable
-Zdoctest-in-workspace
by default. When running each documentation test, the working directory is set to the root directory of the package the test belongs to. docs #12221 #12288 - Add support of the "default" keyword to reset previously set
build.jobs
parallelism back to the default. #12222
Changed
- 🚨 CVE-2023-40030: Malicious dependencies can inject arbitrary JavaScript into cargo-generated timing reports. To mitigate this, feature name validation check is now turned into a hard error. The warning was added in Rust 1.49. These extended characters aren't allowed on crates.io, so this should only impact users of other registries, or people who don't publish to a registry. #12291
- Cargo now warns when an edition 2021 package is in a virtual workspace and
workspace.resolver
is not set. It is recommended to set the resolver version for workspaces explicitly. #10910 - Set IBM AIX shared libraries search path to
LIBPATH
. #11968 - Don't pass
-C debuginfo=0
to rustc as it is the default value. #12022 #12205 - Added a message on reusing previous temporary path on
cargo install
failures. #12231 - Added a message when
rustup
override shorthand is put in a wrong position. #12226 - Respect scp-like URL as much as possible when fetching nested submodules. #12359 #12411
Fixed
cargo clean
usesremove_dir_all
as a fallback to resolve race conditions. #11442- Reduced the chance Cargo re-formats the user's
[features]
table. #12191 - Fixed nested Git submodules not able to fetch. #12244
Nightly only
- 🔥 The
-Zscript
is an experimental feature to add unstable support for single-file packages in Cargo, so we can explore the design and resolve questions with an implementation to collect feedback on. (eRFC 3424) docs #12245 #12255 #12258 #12262 #12268 #12269 #12281 #12282 #12283 #12284 #12287 #12289 #12303 #12305 #12308 - Automatically inherit workspace lints when running
cargo new
/cargo init
. #12174 - Removed
-Zjobserver-per-rustc
again. #12285 - Added
.toml
file extension restriction for-Zconfig-include
. #12298 - Added
-Znext-lockfile-bump
to prepare for the next lockfile bump. #12279 #12302
Documentation
- Added a description of
Cargo.lock
conflicts in the Cargo FAQ. #12185 - Added a small note about indexes ignoring SemVer build metadata. #12206
- Added doc comments for types and friends in
cargo::sources
module. #12192 #12239 #12247 - Added more documentation for
Source
download functions. #12319 - Added READMEs for the credential helpers. #12322
- Fixed version requirement example in Dependency Resolution. #12267
- Clarify the default behavior of cargo-install. #12276
- Clarify the use of "default" branch instead of
main
by default. #12251 - Provide guidance on version requirements. #12323
Internal
- Updated to
gix
0.45 for multi-round pack negotiations. #12236 - Updated to
curl-sys
0.4.63, which corresponds to curl 8.1.2. #12218 - Updated to
openssl
0.10.55. #12300 - Updated several dependencies. #12261
- Removed unused features from
windows-sys
dependency. #12176 - Refactored compiler invocations. #12211
- Refactored git and registry sources, and registry data. #12203 #12197 #12240 #12248
- Lexicographically order
-Z
flags. #12182 #12223 #12224 - Several Cargo's own test infra improvements and speed-ups. #12184 #12188 #12189 #12194 #12199
- Migrated print-ban from test to clippy #12246
- Switched to
OnceLock
for interning uses. #12217 - Removed a unnecessary
.clone
. #12213 - Don't try to compile
cargo-credential-gnome-secret
on non-Linux platforms. #12321 - Use macro to remove duplication of workspace inheritable fields getters. #12317
- Extracted and rearranged registry API items to their own modules. #12290
- Show a better error when container tests fail. #12264
Cargo 1.71.1 (2023-08-03)
Fixed
- 🚨 CVE-2023-38497: Cargo 1.71.1 or later respects umask when extracting crate archives. It also purges the caches it tries to access if they were generated by older Cargo versions.
Cargo 1.71 (2023-07-13)
Added
- Allowed named debuginfo options in Cargo.toml. docs #11958
- Added
workspace_default_members
to the output ofcargo metadata
. #11978 - Automatically inherit workspace fields when running
cargo new
/cargo init
. #12069
Changed
- ❗ Optimized the usage under
rustup
. When Cargo detects it will runrustc
pointing a rustup proxy, it'll try bypassing the proxy and use the underlying binary directly. There are assumptions around the interaction with rustup andRUSTUP_TOOLCHAIN
. However, it's not expected to affect normal users. #11917 - ❗ When querying a package, Cargo tries only the original name, all hyphens, and all underscores to handle misspellings. Previously, Cargo tried each combination of hyphens and underscores, causing excessive requests to crates.io. #12083
- ❗ Disallow
RUSTUP_HOME
andRUSTUP_TOOLCHAIN
in the[env]
configuration table. This is considered to be not a use case Cargo would like to support, since it will likely cause problems or lead to confusion. #12101 #12107 - Better error message when getting an empty dependency table in Cargo.toml. #11997
- Better error message when empty dependency was specified in Cargo.toml. #12001
--help
text is now wrapping for readability on narrow screens. #12013- Tweaked the order of arguments in
--help
text to clarify role of--bin
. #12157 rust-version
is included incargo publish
requests to registries. #12041
Fixed
- Corrected the bug report URL for
cargo clippy --fix
. #11882 - Cargo now applies
[env]
to rust invocations for target info discovery. #12029 - Fixed tokens not redacted in http debug when using HTTP/2. #12095
- Fixed
-C debuginfo
not passed in some situation, leading to build cache miss. #12165 - Fixed the ambiguity when
cargo install
found packages with the same name. The ambiguity happened in a situation like a package depending on old versions of itself. #12015 - Fixed a false positive that
cargo package
checks for conflict files. #12135 - Fixed
dep/feat
syntax not working when co-exist withdep:
syntax, and trying to enable features of an optional dependency. #12130 - Fixed
cargo tree
not handling the output with-e no-proc-macro
correctly. #12044 - Warn instead of error in
cargo package
on emptyreadme
orlicense-file
in Cargo.toml. #12036 - Fixed when an HTTP proxy is in use and the Cargo executable links to a certain version of system libcurl, CURL connections might fail. Affected libcurl versions: 7.87.0, 7.88.0, 7.88.1. #12234 #12242
Nightly only
- 🔥 The
-Zgitoxide
feature now supports shallow clones and fetches for dependencies and registry indexes. docs #11840 - 🔥 The
-Zlints
feature enables configuring lints rules in Cargo.toml docs #12148 #12168 - The
-Zbuild-std
breakage of missing features innightly-2023-05-04
has been fixed innightly-2023-05-05
. #12088 - Recompile on profile rustflags changes. #11981
- Added
-Zmsrv-policy
feature flag placeholder. #12043 cargo add
now considersrust-version
when selecting packages with-Zmsrv-policy
. #12078
Documentation
- Added Cargo team charter. docs #12010
- SemVer: Adding
#[non_exhaustive]
on existing items is a breaking change. #10877 - SemVer: It is not a breaking change to make an unsafe function safe. #12116
- SemVer: changing MSRV is generally a minor change. #12122
- Clarify when and how to
cargo yank
. #11862 - Clarify that crates.io doesn't link to docs.rs right away. #12146
- Clarify documentation around test target setting. #12032
- Specify
rust_version
in Index format. #12040 - Specify
msg
in owner-remove registry API response. #12068 - Added more documentation for artifact-dependencies. #12110
- Added doc comments for
Source
and build script for cargo-the-library. #12133 #12153 #12159 - Several typo and broken link fixes. #12018 #12020 #12049 #12067 #12073 #12143
- home: clarify the behavior on each platform #12047
Internal
- Updated to
linux-raw-sys
0.3.2 #11998 - Updated to
git2
0.17.1, which corresponds to libgit2 1.6.4. #12096 - Updated to
windows-sys
0.48.0 #12021 - Updated to
libc
0.2.144 #12014 #12098 - Updated to
openssl-src
111.25.3+1.1.1t #12005 - Updated to
home
0.5.5 #12037 - Enabled feature
Win32_System_Console
feature since it is used. #12016 - Cargo is now a Cargo workspace. We dogfood ourselves finally! #11851 #11994 #11996 #12024 #12025 #12057
- 🔥 A new, straightforward issue labels system for Cargo contributors. docs #11995 #12002 #12003
- Allow win/mac credential managers to build on all platforms. #11993 #12027
- Use
openssl
only on non-Windows platforms. #11979 - Use restricted Damerau-Levenshtein algorithm to provide typo suggestions. #11963
- Added a new xtask
cargo build-man
. #12048 - Added a new xtask
cargo stale-label
. #12051 - Added a new xtask
cargo unpublished
. #12039 #12045 #12085 - CI: check if any version bump needed for member crates. #12126
- Fixed some test infra issues. #11976 #12026 #12055 #12117
Cargo 1.70 (2023-06-01)
Added
- 🎉 Added
cargo logout
command for removing an API token from the registry locally. docs #11919 #11950 - Added
--ignore-rust-version
flag tocargo install
. #11859 - The
CARGO_PKG_README
environment variable is now set to the path to the README file when compiling a crate. #11645 - Cargo now displays richer information of Cargo target failed to compile. #11636
Changed
- 🎉 The
sparse
protocol is now the default protocol for crates.io! (RFC 2789) (docs) #11791 #11783 - ❗
cargo login
andcargo logout
now uses the registry specified inregistry.default
. This was an unintentional regression. #11949 cargo update
accurately showsDowngrading
status when downgrading dependencies. #11839- Added more information to HTTP errors to help with debugging. #11878
- Added delays to network retries in Cargo. #11881
- Refined
cargo publish
message when waiting for a publish complete. #11713 - Better error message when
cargo install
from a git repository but found multiple packages. #11835
Fixed
- Removed duplicates of possible values in
--charset
option ofcargo tree
. #11785 - Fixed
CARGO_CFG_
vars for configs defined both with and without value. #11790 - Broke endless loop on cyclic features in added dependency in
cargo add
. #11805 - Don't panic when [
patch
] involved in dependency resolution results in a conflict. #11770 - Fixed credential token format validation. #11951
- Added the missing token format validation on publish. #11952
- Fixed case mismatches when looking up env vars in the Config snapshot. #11824
cargo new
generates the correct.hgignore
aligning semantics with other VCS ignore files. #11855- Stopped doing unnecessary fuzzy registry index queries. This significantly
reduces the amount of HTTP requests to remote registries for crates
containing
-
or_
in their names. #11936 #11937
Nightly only
- Added
-Zdirect-minimal-versions
. This behaves like-Zminimal-versions
but only for direct dependencies. (docs) #11688 - Added
-Zgitoxide
which switches allgit fetch
operation in Cargo to usegitoxide
crate. This is still an MVP but could improve the performance up to 2 times. (docs) #11448 #11800 #11822 #11830 - Removed
-Zjobserver-per-rustc
. Its rustc counterpart never got landed. #11764
Documentation
- Cleaned-up unstable documentation. #11793
- Enhanced the documentation of timing report with graphs. #11798
- Clarified requirements about the state of the registry index after publish. #11926
- Clarified docs on
-C
that it appears before the command. #11947 - Clarified working directory behaviour for
cargo test
,cargo bench
andcargo run
. #11901 - Fixed the doc of
registries.name.index
configuration. #11880 - Notice for potential unexpected shell expansions in help text of
cargo-add
. #11826 - Updated external-tools JSON docs. #11918
- Call out the differences between the index JSON and the API or metadata. #11927
- Consistently use
@
when mentioning pkgid format. #11956 - Enhanced Cargo Contributor Guide. #11825 #11842 #11869 #11876
- Moved a part of Cargo Contributor Guide to Cargo API documentation. docs #11809 #11841 #11850 #11870
- Cargo team now arranges office hours! #11903
Internal
- Switched to
sha2
crate for SHA256 calculation. #11795 #11807 - Switched benchsuite to the index archive. #11933
- Updated to
base64
0.21.0. #11796 - Updated to
curl-sys
0.4.61, which corresponds to curl 8.0.1. #11871 - Updated to
proptest
1.1.0. #11886 - Updated to
git2
0.17.0, which corresponds to libgit2 1.6.3. #11928 - Updated to
clap
4.2. #11904 - Integrated
cargo-deny
in Cargo its own CI pipeline. #11761 - Made non-blocking IO calls more robust. #11624
- Dropped
derive
feature fromserde
incargo-platform
. #11915 - Replaced
std::fs::canonicalize
with a more robusttry_canonicalize
. #11866 - Enabled clippy warning on
disallowed_methods
forstd::env::var
and friends. #11828
Cargo 1.69 (2023-04-20)
Added
- Cargo now suggests
cargo fix
orcargo clippy --fix
when compilation warnings are auto-fixable. #11558 - Cargo now suggests
cargo add
if you try to install a library crate. #11410 - Cargo now sets the
CARGO_BIN_NAME
environment variable also for binary examples. #11705
Changed
- ❗ When
default-features
is set to false of a workspace dependency, and an inherited dependency of a member hasdefault-features = true
, Cargo will enable default features of that dependency. #11409 - ❗ Deny
CARGO_HOME
in[env]
configuration table. Cargo itself doesn't pick up this value, but recursive calls to cargo would, which was not intended. #11644 - ❗ Debuginfo for build dependencies is now off if not explicitly set. This is expected to improve the overall build time. #11252
- Cargo now emits errors on invalid alphanumeric characters in a registry token. #11600
cargo add
now checks only the order of[dependencies]
without considering[dependencies.*]
. #11612- Cargo now respects the new jobserver IPC style in GNU Make 4.4, by updating
its dependency
jobserver
. #11767 cargo install
now reports required features when no binary meets its requirements. #11647
Fixed
- Uplifted
.dwp
DWARF package file next to the executable for debuggers to locate them. #11572 - Fixed build scripts triggering recompiles when a
rerun-if-changed
points to a directory whose mtime is not preserved by the filesystem. #11613 - Fixed panics when using dependencies from
[workspace.dependencies]
for[patch]
. This usage is not supposed to be supported. #11565 #11630 - Fixed
cargo report
saving the same future-incompat reports multiple times. #11648 - Fixed the incorrect inference of a directory ending with
.rs
as a file. #11678 - Fixed
.cargo-ok
file being truncated wrongly, preventing from using a dependency. #11665 #11724
Nightly only
-Zrustdoc-scrape-example
must fail with bad build script. #11694- Updated 1password credential manager integration to the version 2 CLI. #11692
- Emit an error message for transitive artifact dependencies with targets the package doesn't directly interact with. #11643
- Added
-C
flag for changing current dir before build starts. #10952
Documentation
- Clarified the difference between
CARGO_CRATE_NAME
andCARGO_PKG_NAME
. #11576 - Added links to the Target section of the glossary for occurrences of target triple. #11603
- Described how the current resolver sometimes duplicates dependencies. #11604
- Added a note about verifying your email address on crates.io. #11620
- Mention current default value in
publish.timeout
docs. #11652 - More doc comments for
cargo::core::compiler
modules. #11669 #11703 #11711 #11758 - Added more guidance on how to implement unstable features. #11675
- Fixed unstable chapter layout for
codegen-backend
. #11676 - Add a link to LTO doc. #11701
- Added documentation for the configuration discovery of
cargo install
to the man pages #11763 - Documented
-F
flag as an alias for--features
incargo add
. #11774
Internal
- Disable network SSH tests on Windows. #11610
- Made some blocking tests non-blocking. #11650
- Deny warnings in CI, not locally. #11699
- Re-export
cargo_new::NewProjectKind
as public. #11700 - Made dependencies in alphabetical order. #11719
- Switched some tests from
build
tocheck
. #11725 - Consolidated how Cargo reads environments variables internally. #11727 #11754
- Fixed tests with nondeterministic ordering #11766
- Added a test to verify the intermediate artifacts persist in the temp directory. #11771
- Updated cross test instructions for aarch64-apple-darwin. #11663
- Updated to
toml
v0.6 andtoml_edit
v0.18 for TOML manipulations. #11618 - Updated to
clap
v4.1.3. #11619 - Replaced
winapi
withwindows-sys
crate for Windows bindings. #11656 - Reused
url
crate for percent encoding instead ofpercent-encoding
. #11750 - Cargo contributors can benefit from smart punctuations when writing
documentations, e.g.,
---
is auto-converted into an em dash. (docs) #11646 #11715 - Cargo's CI pipeline now covers macOS on nightly. #11712
- Re-enabled some clippy lints in Cargo itself. #11722
- Enabled sparse protocol in Cargo's CI. #11632
- Pull requests in Cargo now get autolabelled for label
A-*
andCommand-*
. #11664 #11679
Cargo 1.68.2 (2023-03-28)
- Updated the GitHub RSA SSH host key bundled within cargo. The key was rotated by GitHub on 2023-03-24 after the old one leaked. #11883
- Added support for SSH known hosts marker
@revoked
. #11635 - Marked the old GitHub RSA host key as revoked. This will prevent Cargo from accepting the leaked key even when trusted by the system. #11889
Cargo 1.68 (2023-03-09)
Added
- 🎉 The new "sparse" protocol has been stabilized. It should provide a significant performance improvement when accessing crates.io. (RFC 2789) (docs) #11224 #11480 #11733 #11756
- 🎉
home
crate is now a subcrate inrust-lang/cargo
repository. Welcome! #11359 #11481 - Long diagnostic messages now can be truncated to be more readable. #11494
- Shows the progress of crates.io index update even when
net.git-fetch-with-cli
enabled. #11579 cargo build --verbose
tells you more about why it recompiles. #11407- Cargo's file locking mechanism now supports Solaris by using
fcntl
. #11439 #11474 - Added a new SemVer compatibility rule explaining the expectations around diagnostic lints #11596
cargo vendor
generates a different source replacement entry for each revision from the same git repository. #10690- Cargo contributors can relabel issues via triagebot. doc #11498
- Cargo contributors can write tests in containers. #11583
Changed
- Cargo now by default saves credentials to
.cargo/credentials.toml
. If.cargo/credentials
exists, writes to it for backward compatibility reasons. #11533 - To prevent sensitive data from being logged, Cargo introduces a new wrapper type internally. #11545
- Several documentation improvements. #11475 #11504 #11516 #11517 #11568 #11586 #11592
Fixed
- ❗
cargo package
andcargo publish
now respects workspace'sCargo.lock
. This is an expected behavior but previously got overlooked. #11477 - Fixed
cargo vendor
failing on resolving git dependencies inherited from a workspace. #11414 cargo install
can now correctly install root package whenworkspace.default-members
is specified. #11067- Fixed panic on target specific dependency errors. #11541
- Shows
--help
if there is no man page for a subcommand. #11473 - Setting
target.cfg(…).rustflags
shouldn't erasebuild.rustdocflags
. #11323 - Unsupported
profile.split-debuginfo
options are now ignored, which previously made Cargo fail to compile on certain platforms. #11347 #11633 - Don't panic in Windows headless session with really long file names. #11759
Nightly only
- Implemented a initial support of asymmetric token authentication for registries. (RFC 3231) (docs) #10771
- Do not error for
auth-required: true
without-Z sparse-registry
#11661 - Supports
codegen-backend
andrustflags
in profiles in config file. #11562 - Suggests
cargo clippy --fix
when warnings/errors could be fixed with clippy. #11399 - Fixed artifact deps not working when target field specified coexists with
optional = true
. #11434 - Make Cargo distinguish
Unit
s with and without artifact targets. #11478 cargo metadata
supports artifact dependencies. #11550- Allows builds of some crate to fail during optional doc-scraping. #11450
- Add warning if potentially-scrapable examples are skipped due to dev-dependencies. #11503
- Don't scrape examples from library targets by default. #11499
- Fixed examples of proc-macro crates being scraped for examples. #11497
Cargo 1.67 (2023-01-26)
Added
cargo remove
now cleans up the referenced dependency of the root workspace manifest,profile
,patch
, andreplace
sections after a successful removal of a dependency. #11194 #11242 #11351cargo package
andcargo publish
now report total and compressed crate size after packaging. #11270
Changed
- ❗ Cargo now reuses the value of
$CARGO
if it's already set in the environment, and forwards the value when executing external subcommands and build scripts. #11285 - ❗ Cargo now emits an error when running
cargo update --precise
without a-p
flag. #11349 - ❗ Cargo now emits an error if there are multiple registries in the configuration with the same index URL. #10592
- Cargo now is aware of compression ratio when extracting crate files. This relaxes the hard size limit introduced in 1.64.0 to mitigate zip bomb attack. #11337
- Cargo now errors out when
cargo fix
on a git repo with uncommitted changes. #11400 - Cargo now warns when
cargo tree -i <spec>
cannot find any package. #11377 - Cargo now warns when running
cargo new/init
andPATH
env separator is in the project path. #11318 - Better error messages when multiple packages were found and
cargo add/remove
gets confused. #11186 #11375 - A better error message when
cargo init
but existing ignore files aren't UTF-8. #11321 - A better error message for
cargo install .
. #11401 - A better warning when the same file path found in multiple build targets. #11299
- Updated the internal HTTP library libcurl with various fixes and updates. #11307 #11326
Fixed
- Fixed
cargo clean
for removing fingerprints and build script artifacts of only the requested package #10621 - Fixed
cargo install --index
not working when configregistry.default
is set. #11302 - Fixed git2 safe-directory accidentally disabled when no network configuration was found. #11366
- Migrate from crate
atty
to resolve potential soundness issue. #11420 - Cleans stale git temp files left when libgit2 indexing is interrupted. #11308
Nightly only
- Suggests
cargo fix
when some compilation warnings/errors can be auto-fixed. #10989 #11368 - Changed
rustdoc-scrape-examples
to be a target-level configuration. #10343 #11425 #11430 #11445 - Propagates change of artifact bin dependency to its parent fingerprint. #11353
- Fixed
wait-for-publish
to work with sparse registry. #11356 #11327 #11388 - Stores the
sparse+
prefix in theSourceId
for sparse registries #11387 #11403 - Implemented alternative registry authentication support. (RFC 3139) (docs) #10592
- Added documentation of config option
registries.crates-io.protocol
. #11350
Cargo 1.66.1 (2023-01-10)
Fixed
- 🚨 CVE-2022-46176: Added validation of SSH host keys for git URLs. See the docs for more information on how to configure the known host keys.
Cargo 1.66 (2022-12-15)
Added
- 🎉 Added
cargo remove
command for removing dependencies fromCargo.toml
. docs #11059 #11099 #11193 #11204 #11227 - Added support for git dependencies having git submodules with relative paths. #11106
- Cargo now sends requests with a
Accept-Encoding
header to registries. #11292 - Cargo now forwards non-UTF8 arguments to external subcommands. #11118
Changed
- ❗ Disambiguate source replacements from various angles.
RFC-3289
#10907
- When the crates-io source is replaced, the user is required to specify which registry to use with
--registry <NAME>
when performing an API operation. - Publishing to source-replaced crates.io is no longer permitted using the crates.io token (
registry.token
). - In source replacement, the
replace-with
key can reference the name of an alternative registry in the[registries]
table.
- When the crates-io source is replaced, the user is required to specify which registry to use with
- ❗
cargo publish
now blocks until it sees the published package in the index. #11062 #11210 #11216 #11255 - Cargo now uses the clap v4 library for command-line argument parsing. #11116 #11119 #11159 #11190 #11239 #11280
- Cargo now only warns on a user-defined alias shadowing an external command. #11170
- Several documentation improvements. #10770 #10938 #11082 #11093 #11157 #11185 #11207 #11219 #11240 #11241 #11282
Fixed
- ❗ Config file loaded via
cargo --config <file>
now takes priority over environment variables. This is a documented behaviour but the old implementation accidentally got it wrong. #11077 - ❗ Cargo collects rustflags in
target.cfg(…).rustflags
more correctly and warns if that's not enough for convergence. #11114 - Final artifacts not removed by linker should be removed before a compilation gets started. #11122
cargo add
now reports unknown features in a more discoverable manner. #11098- Cargo now reports command aliasing failure with more error contexts. #11087
- A better error message when
cargo login
prompt receives empty input. #11145 - A better error message for fields with wrong types where workspace inheritance is supported. #11113
- A better error message when mixing feature syntax
dep:
with/
. #11172 - A better error message when publishing but
package.publish
isfalse
in the manifest. #11280
Nightly only
- Added new config option
publish.timeout
behind-Zpublish-timeout
. docs #11230 - Added retry support to sparse registries. #11069
- Fixed sparse registry lockfile urls containing
registry+sparse+
. #11177 - Add new config option
registries.crates-io.protocol
for controlling crates.io protocol. #11215 - Removed
sparse+
prefix for index.crates.io. #11247 - Fixed publishing with a dependency on a sparse registry. #11268
- Fixed confusing error messages when using
-Zsparse-registry
. #11283 - Fixed 410 gone response handling for sparse registries. #11286
Cargo 1.65 (2022-11-03)
Added
- External subcommands can now inherit jobserver file descriptors from Cargo. #10511
- Added an API documentation for private items in cargo-the-library. See https://doc.rust-lang.org/nightly/nightly-rustc/cargo. #11019
Changed
- Cargo now stops adding its bin path to
PATH
if it's already there. #11023 - Improved the performance of Cargo build scheduling by sorting the queue of pending jobs. #11032
- Improved the performance fetching git dependencies from GitHub even
when using a partial hash in the
rev
field. #10807 - Cargo now uses git2 v0.15 and libgit2-sys v0.14, which bring several compatibility fixes with git's new behaviors. #11004
- Registry index files are cached in a more granular way based on content hash. #11044
- Cargo now uses the standard library's
std::thread::scope
instead of thecrossbeam
crate for spawning scoped threads. #10977 - Cargo now uses the standard library's
available_parallelism
instead of thenum_cpus
crate for determining the default parallelism. #10969 - Cargo now guides you how to solve it when seeing an error message of
rust-version
requirement not satisfied. #10891 - Cargo now tells you more about possible causes and how to fix it when a subcommand cannot be found. #10924
- Cargo now lists available target names when a given Cargo target cannot be found. #10999
cargo update
now warns if--precise
is given without--package
flag. This will become a hard error after a transition period. #10988 #11011cargo bench
andcargo test
now report a more precise test execution error right after a test fails. #11028cargo add
now tells you for which version the features are added. #11075- Call out that non-ASCII crate names are not supported by Rust anymore. #11017
- Enhanced the error message when in the manifest a field is expected to be an array but a string is used. #10944
Fixed
- Removed the restriction on file locking supports on platforms other than Linux. #10975
- Fixed incorrect OS detection by bumping os_info to 3.5.0. #10943
- Scanning the package directory now ignores errors from broken but excluded symlink files. #11008
- Fixed deadlock when build scripts are waiting for input on stdin. #11257
Nightly
- Progress indicator for sparse registries becomes more straightforward. #11068
Cargo 1.64 (2022-09-22)
Added
- 🎉 Packages can now inherit settings from the workspace so that the settings
can be centralized in one place. See
workspace.package
andworkspace.dependencies
for more details on how to define these common settings. #10859 - Added the
--crate-type
flag tocargo rustc
to override the crate type. #10838 - Cargo commands can now accept multiple
--target
flags to build for multiple targets at once, and thebuild.target
config option may now take an array of multiple targets. #10766 - The
--jobs
argument can now take a negative number to count backwards from the max CPUs. #10844
Changed
- Bash completion of
cargo install --path
now supports path completion. #10798 - Significantly improved the performance fetching git dependencies from GitHub
when using a hash in the
rev
field. #10079 - Published packages will now include the resolver setting from the workspace to ensure that they use the same resolver when used in isolation. #10911 #10961 #10970
cargo add
will now updateCargo.lock
. #10902- The path in the config output of
cargo vendor
now translates backslashes to forward slashes so that the settings should work across platforms. #10668 - The
workspace.default-members
setting now allows a value of"."
in a non-virtual workspace to refer to the root package. #10784
Fixed
- 🚨 CVE-2022-36113: Extracting malicious crates can corrupt arbitrary files. #11089 #11088
- 🚨 CVE-2022-36114: Extracting malicious crates can fill the file system. #11089 #11088
- The
os
output incargo --version --verbose
now supports more platforms. #10802 - Cached git checkouts will now be rebuilt if they are corrupted. This may
happen when using
net.git-fetch-with-cli
and interrupting the clone process. #10829 - Fixed panic in
cargo add --offline
. #10817
Nightly only
- Fixed deserialization of unstable
check-cfg
inconfig.toml
. #10799
Cargo 1.63 (2022-08-11)
Added
- 🎉 Added the
--config
CLI option to pass config options directly on the CLI. #10755 - The
CARGO_PKG_RUST_VERSION
environment variable is now set when compiling a crate if the manifest has therust-version
field set. #10713
Changed
- A warning is emitted when encountering multiple packages with the same name
in a git dependency. This will ignore packages with
publish=false
. #10701 #10767 - Change tracking now uses the contents of a
.json
target spec file instead of its path. This should help avoid rebuilds if the path changes. #10746 - Git dependencies with a submodule configured with the
update=none
strategy in.gitmodules
is now honored, and the submodule will not be fetched. #10717 - Crate files now use a more recent date (Jul 23, 2006 instead of Nov 29, 1973) for deterministic behavior. #10720
- The initial template used for
cargo new
now includes a slightly more realistic test structure that hasuse super::*;
in the test module. #10706 - Updated the internal HTTP library libcurl with various small fixes and updates. #10696
Fixed
- Fix zsh completions for
cargo add
andcargo locate-project
#10810 #10811 - Fixed
-p
being ignored withcargo publish
in the root of a virtual workspace. Some additional checks were also added to generate an error if multiple packages were selected (previously it would pick the first one). #10677 - The human-readable executable name is no longer displayed for
cargo test
when using JSON output. #10691
Nightly only
- Added
-Zcheck-cfg=output
to support build-scripts declaring their supported set ofcfg
values withcargo:rustc-check-cfg
. #10539 -Z sparse-registry
now uses https://index.crates.io/ when accessing crates-io. #10725- Fixed formatting of
.workspace
key incargo add
for workspace inheritance. #10705 - Sparse HTTP registry URLs must now end with a
/
. #10698 - Fixed issue with
cargo add
and workspace inheritance of thedefault-features
key. #10685
Cargo 1.62 (2022-06-30)
Added
- 🎉 Added the
cargo add
command for adding dependencies toCargo.toml
from the command-line. docs #10472 #10577 #10578 - Package ID specs now support
name@version
syntax in addition to the previousname:version
to align with the behavior incargo add
and other tools.cargo install
andcargo yank
also now support this syntax so the version does not need to passed as a separate flag. #10582 #10650 #10597 - Added the CLI option
-F
as an alias of--features
. #10576 - The
git
andregistry
directories in Cargo's home directory (usually~/.cargo
) are now marked as cache directories so that they are not included in backups or content indexing (on Windows). #10553 - Added the
--version
flag tocargo yank
to replace the--vers
flag to be consistent withcargo install
. #10575 - Added automatic
@
argfile support, which will use "response files" if the command-line torustc
exceeds the operating system's limit. #10546 cargo clean
now has a progress bar (if it takes longer than half a second). #10236
Changed
cargo install
no longer generates an error if no binaries were found to install (such as missing required features). #10508cargo test
now passes--target
torustdoc
if the specified target is the same as the host target. #10594cargo doc
now automatically passes-Arustdoc::private-intra-doc-links
when documenting a binary (which automatically includes--document-private-items
). Theprivate-intra-doc-links
lint is only relevant when not documenting private items, which doesn't apply to binaries. #10142- The length of the short git hash in the
cargo --version
output is now fixed to 9 characters. Previously the length was inconsistent between different platforms. #10579 - Attempting to publish a package with a
Cargo.toml.orig
file will now result in an error. The filename would otherwise conflict with the automatically-generated file. #10551
Fixed
- The
build.dep-info-basedir
configuration setting now properly supports the use of..
in the path to refer to a parent directory. #10281 - Fixed regression in automatic detection of the default number of CPUs to use on systems using cgroups v1. #10737 #10739
Nightly only
cargo fetch
now works with-Zbuild-std
to fetch the standard library's dependencies. #10129- Added support for workspace inheritance. docs #10584 #10568 #10565 #10564 #10563 #10606 #10548 #10538
- Added
-Zcheck-cfg
which adds various forms of validatingcfg
expressions for unknown names and values. docs #10486 #10566 - The
--config
CLI option no longer allows setting a registry token. #10580 - Fixed issues with proc-macros and
-Z rustdoc-scrape-examples
. #10549 #10533
Cargo 1.61 (2022-05-19)
Added
Changed
cargo test --no-run
will now display the path to the test executables. #10346cargo tree --duplicates
no longer reports dependencies that are shared between the host and the target as duplicates. #10466- Updated to the 1.4.2 release of libgit2 which brings in several fixes #10442 #10479
cargo vendor
no longer allows multiple values for--sync
, you must pass multiple--sync
flags instead. #10448- Warnings are now issued for manifest keys that have mixed both underscore
and dash variants (such as specifying both
proc_macro
andproc-macro
) #10316 - Cargo now uses the standard library's
available_parallelism
instead of thenum_cpus
crate for determining the default parallelism. #10427 cargo search
terms are now highlighted. #10425
Fixed
- Paths passed to VCS tools like
hg
are now added after--
to avoid conflict with VCS flags. #10483 - Fixed the
http.timeout
configuration value to actually work. #10456 - Fixed issues with
cargo rustc --crate-type
not working in some situations. #10388
Nightly only
- Added
-Z check-cfg-features
to enable compile-time checking of features #10408 - Added
-Z bindeps
to support binary artifact dependencies (RFC-3028) #9992 -Z multitarget
is now supported in thebuild.target
config value with an array. #10473- Added
--keep-going
flag which will continue compilation even if one crate fails to compile. #10383 - Start work on inheriting manifest values in a workspace. #10497 #10517
- Added support for sparse HTTP registries. #10470 #10064
- Fixed panic when artifact target is used for
[target.'cfg(<target>)'.dependencies]
#10433 - Fixed host flags to pass to build scripts (
-Z target-applies-to-host
) #10395 - Added
-Z check-cfg-features
support for rustdoc #10428
Cargo 1.60 (2022-04-07)
Added
- 🎉 Added the
dep:
prefix in the[features]
table to refer to an optional dependency. This allows creating feature names with the same name as a dependency, and allows for "hiding" optional dependencies so that they do not implicitly expose a feature name. docs #10269 - 🎉 Added the
dep-name?/feature-name
syntax to the[features]
table to only enable the featurefeature-name
if the optional dependencydep-name
is already enabled by some other feature. docs #10269 - 🎉 Added
--timings
option to generate an HTML report about build timing, concurrency, and CPU use. docs #10245 - Added the
"v"
and"features2"
fields to the registry index. The"v"
field provides a method for compatibility with future changes to the index. docs #10269 - Added bash completion for
cargo clippy
#10347 - Added bash completion for
cargo report
#10295 - Added support to build scripts for
rustc-link-arg-tests
,rustc-link-arg-examples
, andrustc-link-arg-benches
. docs #10274
Changed
- Cargo now uses the clap 3 library for command-line argument parsing. #10265
- The
build.pipelining
config option is now deprecated, pipelining will now always be enabled. #10258 cargo new
will now generate a.gitignore
which only ignoresCargo.lock
in the root of the repo, instead of any directory. #10379- Improved startup time of bash completion. #10365
- The
--features
flag is now honored when used with the--all-features
flag, which allows enabling features from other packages. #10337 - Cargo now uses a different TOML parser. This should not introduce any
user-visible changes. This paves the way to support format-preserving
programmatic modification of TOML files for supporting
cargo add
and other future enhancements. #10086 - Setting a library to emit both a
dylib
andcdylib
is now an error, as this combination is not supported. #10243 cargo --list
now includes thehelp
command. #10300
Fixed
- Fixed running
cargo doc
on examples with dev-dependencies. #10341 - Fixed
cargo install --path
for a path that is relative to a directory outside of the workspace in the current directory. #10335 cargo test TEST_FILTER
should no longer build binaries that are explicitly disabled withtest = false
. #10305- Fixed regression with
term.verbose
withoutterm.quiet
, and vice versa. #10429 #10436
Nightly only
- Added
rustflags
option to a profile definition. #10217 - Changed
--config
to only support dotted keys. #10176 - Fixed profile
rustflags
not being gated in profile overrides. #10411 #10413
Cargo 1.59 (2022-02-24)
Added
- 🎉 The
strip
option can now be specified in a profile to specify the behavior for removing symbols and debug information from binaries. docs #10088 #10376 - 🎉 Added future incompatible reporting.
This provides reporting for when a future change in
rustc
may cause a package or any of its dependencies to stop building. docs #10165 - SSH authentication on Windows now supports ssh-agent. docs #10248
- Added
term.quiet
configuration option to enable the--quiet
behavior from a config file. docs #10152 - Added
-r
CLI option as an alias for--release
. #10133
Changed
- Scanning the package directory should now be resilient to errors, such as filesystem loops or access issues. #10188 #10214 #10286
cargo help <alias>
will now show the target of the alias. #10193- Removed the deprecated
--host
CLI option. #10145 #10327 - Cargo should now report its version to always be in sync with
rustc
. #10178 - Added EOPNOTSUPP to ignored file locking errors, which is relevant to BSD operating systems. #10157
Fixed
- macOS: Fixed an issue where running an executable would sporadically be killed by the kernel (likely starting in macOS 12). #10196
- Fixed so that the
doc=false
setting is honored in the[lib]
definition of a dependency. #10201 #10324 - The
"executable"
field in the JSON option was incorrectly including the path toindex.html
when documenting a binary. It is now null. #10171 - Documenting a binary now waits for the package library to finish documenting before starting. This fixes some race conditions if the binary has intra-doc links to the library. #10172
- Fixed panic when displaying help text to a closed pipe. #10164
Nightly only
- Added the
--crate-type
flag tocargo rustc
. #10093
Cargo 1.58 (2022-01-13)
Added
- Added
rust_version
field to package data incargo metadata
. #9967 - Added
--message-format
option tocargo install
. #10107
Changed
- A warning is now shown when an alias shadows an external command. #10082
- Updated curl to 7.80.0. #10040 #10106
Fixed
- Doctests now include rustc-link-args from build scripts. #9916
- Fixed
cargo tree
entering an infinite loop with cyclical dev-dependencies. Fixed an edge case where the resolver would fail to handle a cyclical dev-dependency with a feature. #10103 - Fixed
cargo clean -p
when the directory path contains glob characters. #10072 - Fixed debug builds of
cargo
which could panic when downloading a crate when the server has a redirect with a non-empty body. #10048
Nightly only
- Make future-incompat-report output more user-friendly. #9953
- Added support to scrape code examples from the
examples
directory to be included in the documentation. docs #9525 #10037 #10017 - Fixed
cargo report future-incompatibilities
to check stdout if it supports color. #10024
Cargo 1.57 (2021-12-02)
Added
- 🎉 Added custom named profiles. This also changes the
test
andbench
profiles to inherit their settings fromdev
andrelease
, and Cargo will now only use a single profile during a given command instead of using different profiles for dependencies and cargo-targets. docs #9943 - The
rev
option for a git dependency now supports git references that start withrefs/
. An example where this can be used is to depend on a pull request from a service like GitHub before it is merged. #9859 - Added
path_in_vcs
field to the.cargo_vcs_info.json
file. docs #9866
Changed
- ❗
RUSTFLAGS
is no longer set for build scripts. This change was made in 1.55, but the release notes did not highlight this change. Build scripts should useCARGO_ENCODED_RUSTFLAGS
instead. See the documentation for more details. - The
cargo version
command now includes some extra information. #9968 - Updated libgit2 to 1.3 which brings in a number of fixes and changes to git handling. #9963 #9988
- Shell completions now include shorthand b/r/c/d subcommands. #9951
cargo update --precise
now allows specifying a version without semver metadata (stuff after+
in the version number). #9945- zsh completions now complete
--example
names. #9939 - The progress bar now differentiates when building unittests. #9934
- Some backwards-compatibility support for invalid TOML syntax has been removed. #9932
- Reverted the change from 1.55 that triggered an error for dependency specifications that did not include any fields. #9911
Fixed
- Removed a log message (from
CARGO_LOG
) that may leak tokens. #9873 cargo fix
will now avoid writing fixes to the global registry cache. #9938- Fixed
-Z help
CLI option when used with a shorthand alias (b/c/r/d). #9933
Nightly only
Cargo 1.56 (2021-10-21)
Added
- 🎉 Cargo now supports the 2021 edition. More information may be found in the edition guide. #9800
- 🎉 Added the
rust-version
field toCargo.toml
to specify the minimum supported Rust version, and the--ignore-rust-version
command line option to override it. #9732 - Added the
[env]
table to config files to specify environment variables to set. docs #9411 [patch]
tables may now be specified in config files. docs #9839cargo doc
now supports the--example
and--examples
flags. #9808- 🎉 Build scripts can now pass additional linker arguments for binaries or all linkable targets. docs #9557
- Added support for the
-p
flag forcargo publish
to publish a specific package in a workspace.cargo package
also now supports-p
and--workspace
. #9559 - Added documentation about third-party registries. #9830
- Added the
{sha256-checksum}
placeholder for URLs in a registryconfig.json
. docs #9801 - Added a warning when a dependency does not have a library. #9771
Changed
- Doc tests now support the
-q
flag to show terse test output. #9730 features
used in a[replace]
table now issues a warning, as they are ignored. #9681- Changed so that only
wasm32-unknown-emscripten
executables are built without a hash in the filename. Previously it was allwasm32
targets. Additionally, allapple
binaries are now built with a hash in the filename. This allows multiple copies to be cached at once, and matches the behavior on other platforms (exceptmsvc
). #9653 cargo new
now generates an example that doesn't generate a warning with clippy. #9796cargo fix --edition
now only applies edition-specific lints. #9846- Improve resolver message to include dependency requirements. #9827
cargo fix
now has more debug logging available with theCARGO_LOG
environment variable. #9831- Changed
cargo fix --edition
to emit a warning when on the latest stable edition when running on stable instead of generating an error. #9792 cargo install
will now determine all of the packages to install before starting the installation, which should help with reporting errors without partially installing. #9793- The resolver report for
cargo fix --edition
now includes differences for dev-dependencies. #9803 cargo fix
will now show better diagnostics for abnormal errors fromrustc
. #9799- Entries in
cargo --list
are now deduplicated. #9773 - Aliases are now included in
cargo --list
. #9764
Fixed
- Fixed panic with build-std of a proc-macro. #9834
- Fixed running
cargo
recursively from proc-macros while runningcargo fix
. #9818 - Return an error instead of a stack overflow for command alias loops. #9791
- Updated to curl 7.79.1, which will hopefully fix intermittent http2 errors. #9937
Nightly only
- Added
[future-incompat-report]
config section. #9774 - Fixed value-after-table error with custom named profiles. #9789
- Added the
different-binary-name
feature to support specifying a non-rust-identifier for a binary name. docs #9627 - Added a profile option to select the codegen backend. docs #9118
Cargo 1.55 (2021-09-09)
Added
- The package definition in
cargo metadata
now includes the"default_run"
field from the manifest. #9550 - ❗ Build scripts now have access to the following environment variables:
RUSTC_WRAPPER
,RUSTC_WORKSPACE_WRAPPER
,CARGO_ENCODED_RUSTFLAGS
.RUSTFLAGS
is no longer set for build scripts; they should useCARGO_ENCODED_RUSTFLAGS
instead. docs #9601 - Added
cargo d
as an alias forcargo doc
. #9680 - Added
{lib}
to thecargo tree --format
option to display the library name of a package. #9663 - Added
members_mut
method to theWorkspace
API. #9547
Changed
- If a build command does not match any targets when using the
--all-targets
,--bins
,--tests
,--examples
, or--benches
flags, a warning is now displayed to inform you that there were no matching targets. #9549 - The way
cargo init
detects whether or not existing source files represent a binary or library has been changed to respect the command-line flags instead of trying to guess which type it is. #9522 - Registry names are now displayed instead of registry URLs when possible. #9632
- Duplicate compiler diagnostics are no longer shown. This can often happen
with
cargo test
which builds multiple copies of the same code in parallel. This also updates the warning summary to provide more context. #9675 - The output for warnings or errors is now improved to be leaner, cleaner, and show more context. #9655
- Network send errors are now treated as "spurious" which means they will be retried. #9695
- Git keys (
branch
,tag
,rev
) on a non-git dependency are now an error. Additionally, specifying bothgit
andpath
is now an error. #9689 - Specifying a dependency without any keys is now an error. #9686
- The resolver now prefers to use
[patch]
table entries of dependencies when possible. #9639 - Package name typo errors in dependencies are now displayed aligned with the original to help make it easier to see the difference. #9665
- Windows platforms may now warn on environment variables that have the wrong case. #9654
features
used in a[patch]
table now issues a warning, as they are ignored. #9666- The
target
directory is now excluded from content indexing on Windows. #9635 - When
Cargo.toml
is not found, the error message now detects if it was misnamed with a lowercasec
to suggest the correct form. #9607 - Building
diesel
with the new resolver displays a compatibility notice. #9602 - Updated the
opener
dependency, which handles opening a web browser, which includes several changes, such as new behavior when run on WSL, and using the systemxdg-open
on Linux. #9583 - Updated to libcurl 7.78. #9809 #9810
Fixed
- Fixed dep-info files including non-local build script paths. #9596
- Handle "jobs = 0" case in cargo config files #9584
- Implement warning for ignored trailing arguments after
--
#9561 - Fixed rustc/rustdoc config values to be config-relative. #9566
cargo fix
now supports rustc's suggestions with multiple spans. #9567cargo fix
now fixes each target serially instead of in parallel to avoid problems with fixing the same file concurrently. #9677- Changes to the target
linker
config value now trigger a rebuild. #9647 - Git unstaged deleted files are now ignored when using the
--allow-dirty
flag withcargo publish
orcargo package
. #9645
Nightly only
- Enabled support for
cargo fix --edition
for 2021. #9588 - Several changes to named profiles. #9685
- Extended instructions on what to do when running
cargo fix --edition
on the 2021 edition. #9694 - Multiple updates to error messages using nightly features to help better explain the situation. #9657
- Adjusted the edition 2021 resolver diff report. #9649
- Fixed error using
cargo doc --open
withdoc.extern-map
. #9531 - Unified weak and namespaced features. #9574
- Various updates to future-incompatible reporting. #9606
[env]
environment variables are not allowed to set vars set by Cargo. #9579
Cargo 1.54 (2021-07-29)
Added
- Fetching from a git repository (such as the crates.io index) now displays the network transfer rate. #9395
- Added
--prune
option forcargo tree
to limit what is displayed. #9520 - Added
--depth
option forcargo tree
to limit what is displayed. #9499 - Added
cargo tree -e no-proc-macro
to hide procedural macro dependencies. #9488 - Added
doc.browser
config option to set which browser to open withcargo doc --open
. #9473 - Added
CARGO_TARGET_TMPDIR
environment variable set for integration tests & benches. This provides a temporary or "scratch" directory in thetarget
directory for tests and benches to use. #9375
Changed
--features
CLI flags now provide typo suggestions with the new feature resolver. #9420- Cargo now uses a new parser for SemVer versions. This should behave mostly the same as before with some minor exceptions where invalid syntax for version requirements is now rejected. #9508
- Mtime handling of
.crate
published packages has changed slightly to avoid mtime values of 0. This was causing problems with lldb which refused to read those files. #9517 - Improved performance of git status check in
cargo package
. #9478 cargo new
with fossil now places the ignore settings in the new repository instead of usingfossil settings
to set them globally. This also includes several other cleanups to make it more consistent with other VCS configurations. #9469rustc-cdylib-link-arg
applying transitively displays a warning that this was not intended, and may be an error in the future. #9563
Fixed
- Fixed
package.exclude
inCargo.toml
using inverted exclusions (!somefile
) when not in a git repository or when vendoring a dependency. #9186 - Dep-info files now adjust build script
rerun-if-changed
paths to be absolute paths. #9421 - Fixed a bug when with resolver = "1" non-virtual package was allowing unknown features. #9437
- Fixed an issue with the index cache mishandling versions that only
differed in build metadata (such as
110.0.0
and110.0.0+1.1.0f
). #9476 - Fixed
cargo install
with a semver metadata version. #9467
Nightly only
- Added
report
subcommand, and changedcargo describe-future-incompatibilitie
tocargo report future-incompatibilities
. #9438 - Added a
[host]
table to the config files to be able to set build flags for host target. Also addedtarget-applies-to-host
to control how the[target]
tables behave. #9322 - Added some validation to build script
rustc-link-arg-*
instructions to return an error if the target doesn't exist. #9523 - Added
cargo:rustc-link-arg-bin
instruction for build scripts. #9486
Cargo 1.53 (2021-06-17)
Added
Changed
- 🔥 Cargo now supports git repositories where the default
HEAD
branch is not "master". This also includes a switch to the version 3Cargo.lock
format which can handle default branches correctly. #9133 #9397 #9384 #9392 - 🔥 macOS targets now default to
unpacked
split-debuginfo. #9298 - ❗ The
authors
field is no longer included inCargo.toml
for new projects. #9282 cargo update
may now work with the--offline
flag. #9279cargo doc
will now erase thedoc
directory when switching between different toolchain versions. There are shared, unversioned files (such as the search index) that can become broken when using different versions. #8640 #9404- Improved error messages when path dependency/workspace member is missing. #9368
Fixed
- Fixed
cargo doc
detecting if the documentation needs to be rebuilt when changing some settings such as features. #9419 cargo doc
now deletes the output directory for the package before running rustdoc to clear out any stale files. #9419- Fixed the
-C metadata
value to always include all information for all builds. Previously, in some situations, the hash only included the package name and version. This fixes some issues, such as incremental builds with split-debuginfo on macOS corrupting the incremental cache in some cases. #9418 - Fixed man pages not working on Windows if
man
is inPATH
. #9378 - The
rustc
cache is now aware ofRUSTC_WRAPPER
andRUSTC_WORKSPACE_WRAPPER
. #9348 - Track the
CARGO
environment variable in the rebuild fingerprint if the code usesenv!("CARGO")
. #9363
Nightly only
- Fixed config includes not working. #9299
- Emit note when
--future-incompat-report
had nothing to report. #9263 - Error messages for nightly features flags (like
-Z
andcargo-features
) now provides more information. #9290 - Added the ability to set the target for an individual package in
Cargo.toml
. docs #9030 - Fixed build-std updating the index on every build. #9393
-Z help
now displays all the-Z
options. #9369- Added
-Zallow-features
to specify which nightly features are allowed to be used. #9283 - Added
cargo config
subcommand. #9302
Cargo 1.52 (2021-05-06)
Added
Changed
- Build scripts are now forbidden from setting
RUSTC_BOOTSTRAP
on stable. #9181 #9385 - crates.io now supports SPDX 3.11 licenses. #9209
- An error is now reported if
CARGO_TARGET_DIR
is an empty string. #8939 - Doc tests now pass the
--message-format
flag into the test so that the "short" format can now be used for doc tests. #9128 cargo test
now prints a clearer indicator of which target is currently running. #9195- The
CARGO_TARGET_<TRIPLE>
environment variable will now issue a warning if it is using lowercase letters. #9169
Fixed
- Fixed publication of packages with metadata and resolver fields in
Cargo.toml
. #9300 #9304 - Fixed logic for determining prefer-dynamic for a dylib which differed in a workspace vs a single package. #9252
- Fixed an issue where exclusive target-specific dependencies that overlapped across dependency kinds (like regular and build-dependencies) would incorrectly include the dependencies in both. #9255
- Fixed panic with certain styles of Package IDs when passed to the
-p
flag. #9188 - When running cargo with output not going to a TTY, and with the progress bar and color force-enabled, the output will now correctly clear the progress line. #9231
- Error instead of panic when JSON may contain non-utf8 paths. #9226
- Fixed a hang that can happen on broken stderr. #9201
- Fixed thin-local LTO not being disabled correctly when
lto=off
is set. #9182
Nightly only
- The
strip
profile option now supportstrue
andfalse
values. #9153 cargo fix --edition
now displays a report when switching to 2021 if the new resolver changes features. #9268- Added
[patch]
table support in.cargo/config
files. #9204 - Added
cargo describe-future-incompatibilities
for generating a report on dependencies that contain future-incompatible warnings. #8825 - Added easier support for testing the 2021 edition. #9184
- Switch the default resolver to "2" in the 2021 edition. #9184
cargo fix --edition
now supports 2021. #9184- Added
--print
flag tocargo rustc
to pass along torustc
to display information from rustc. #9002 - Added
-Zdoctest-in-workspace
for changing the directory where doctests are run versus where they are compiled. #9105 - Added support for an
[env]
section in.cargo/config.toml
to set environment variables when running cargo. #9175 - Added a schema field and
features2
field to the index. #9161 - Changes to JSON spec targets will now trigger a rebuild. #9223
Cargo 1.51 (2021-03-25)
Added
- 🔥 Added the
split-debuginfo
profile option. docs #9112 - Added the
path
field tocargo metadata
for the package dependencies list to show the path for "path" dependencies. #8994 - 🔥 Added a new feature resolver, and new CLI feature flag behavior. See the
new features
and resolver
documentation for the
resolver = "2"
option. See the CLI and resolver 2 CLI options for the new CLI behavior. And, finally, see RFC 2957 for a detailed look at what has changed. #8997
Changed
cargo install --locked
now emits a warning ifCargo.lock
is not found. #9108- Unknown or ambiguous package IDs passed on the command-line now display suggestions for the correct package ID. #9095
- Slightly optimize
cargo vendor
#8937 #9131 #9132
Fixed
- Fixed environment variables and cfg settings emitted by a build script that
are set for
cargo test
andcargo run
when the build script runs multiple times during the same build session. #9122 - Fixed a panic with
cargo doc
and the new feature resolver. This also introduces some heuristics to try to avoid path collisions withrustdoc
by only documenting one variant of a package if there are multiple (such as multiple versions, or the same package shared for host and target platforms). #9077 - Fixed a bug in Cargo's cyclic dep graph detection that caused a stack overflow. #9075
- Fixed build script
links
environment variables (DEP_*
) not showing up for testing packages in some cases. #9065 - Fixed features being selected in a nondeterministic way for a specific
scenario when building an entire workspace with all targets with a
proc-macro in the workspace with
resolver="2"
. #9059 - Fixed to use
http.proxy
setting in~/.gitconfig
. #8986 - Fixed --feature pkg/feat for V1 resolver for non-member. #9275 #9277
- Fixed panic in
cargo doc
when there are colliding output filenames in a workspace. #9276 #9277 - Fixed
cargo install
from exiting with success if one of several packages did not install successfully. #9185 #9196 - Fix panic with doc collision orphan. #9142 #9196
Nightly only
- Removed the
publish-lockfile
unstable feature, it was stabilized without the need for an explicit flag 1.5 years ago. #9092 - Added better diagnostics, help messages, and documentation for nightly
features (such as those passed with the
-Z
flag, or specified withcargo-features
inCargo.toml
). #9092 - Added support for Rust edition 2021. #8922
- Added support for the
rust-version
field in project metadata. #8037 - Added a schema field to the index. #9161 #9196
Cargo 1.50 (2021-02-11)
Added
- Added the
doc
field tocargo metadata
, which indicates if a target is documented. #8869 - Added
RUSTC_WORKSPACE_WRAPPER
, an alternate RUSTC wrapper that only runs for the local workspace packages, and caches its artifacts independently of non-wrapped builds. #8976 - Added
--workspace
tocargo update
to update only the workspace members, and not their dependencies. This is particularly useful if you update the version inCargo.toml
and want to updateCargo.lock
without running any other commands. #8725
Changed
.crate
files uploaded to a registry are now built with reproducible settings, so that the same.crate
file created on different machines should be identical. #8864- Git dependencies that specify more than one of
branch
,tag
, orrev
are now rejected. #8984 - The
rerun-if-changed
build script directive can now point to a directory, in which case Cargo will check if any file in that directory changes. #8973 - If Cargo cannot determine the username or email address,
cargo new
will no longer fail, and instead create an empty authors list. #8912 - The progress bar width has been reduced to provide more room to display the crates currently being built. #8892
cargo new
will now supportincludeIf
directives in.gitconfig
to match the correct directory when determining the username and email address. #8886
Fixed
- Fixed
cargo metadata
andcargo tree
to only download packages for the requested target. #8987 - Updated libgit2, which brings in many fixes, particularly fixing a zlib error that occasionally appeared on 32-bit systems. #8998
- Fixed stack overflow with a circular dev-dependency that uses the
links
field. #8969 - Fixed
cargo publish
failing on some filesystems, particularly 9p on WSL2. #8950
Nightly only
- Allow
resolver="1"
to specify the original feature resolution behavior. #8857 - Added
-Z extra-link-arg
which adds thecargo:rustc-link-arg-bins
andcargo:rustc-link-arg
build script options. docs #8441 - Implemented external credential process support, and added
cargo logout
. (RFC 2730) (docs) #8934 - Fix panic with
-Zbuild-std
and no roots. #8942 - Set docs.rs as the default extern-map for crates.io #8877
Cargo 1.49 (2020-12-31)
Added
- Added
homepage
anddocumentation
fields tocargo metadata
. #8744 - Added the
CARGO_PRIMARY_PACKAGE
environment variable which is set when runningrustc
if the package is one of the "root" packages selected on the command line. #8758 - Added support for Unix-style glob patterns for package and target selection
flags on the command-line (such as
-p 'serde*'
or--test '*'
). #8752
Changed
- Computed LTO flags are now included in the filename metadata hash so that
changes in LTO settings will independently cache build artifacts instead of
overwriting previous ones. This prevents rebuilds in some situations such as
switching between
cargo build
andcargo test
in some circumstances. #8755 cargo tree
now displays(proc-macro)
next to proc-macro packages. #8765- Added a warning that the allowed characters for a feature name have been
restricted to letters, digits,
_
,-
, and+
to accommodate future syntax changes. This is still a superset of the allowed syntax on crates.io, which requires ASCII. This is intended to be changed to an error in the future. #8814 -p
without a value will now print a list of workspace package names. #8808- Add period to allowed feature name characters. #8932 #8943
Fixed
- Fixed building a library with both "dylib" and "rlib" crate types with LTO enabled. #8754
- Fixed paths in Cargo's dep-info files. #8819
- Fixed inconsistent source IDs in
cargo metadata
for git dependencies that explicitly specifybranch="master"
. #8824 - Fixed re-extracting dependencies which contained a
.cargo-ok
file. #8835
Nightly only
- Fixed a panic with
cargo doc -Zfeatures=itarget
in some situations. #8777 - New implementation for namespaced features, using the syntax
dep:serde
. docs #8799 - Added support for "weak" dependency features, using the syntax
dep_name?/feat_name
, which will enable a feature for a dependency without also enabling the dependency. #8818 - Fixed the new feature resolver downloading extra dependencies that weren't strictly necessary. #8823
Cargo 1.48 (2020-11-19)
Added
- Added
term.progress
configuration option to control when and how the progress bar is displayed. docs #8165 - Added
--message-format plain
option tocargo locate-project
to display the project location without JSON to make it easier to use in a script. #8707 - Added
--workspace
option tocargo locate-project
to display the path to the workspace manifest. #8712 - A new contributor guide has been added for contributing to Cargo itself. This is published at https://rust-lang.github.io/cargo/contrib/. #8715
- Zsh
--target
completion will now complete with the built-in rustc targets. #8740
Changed
Fixed
- Fixed
cargo new
creating a fossil repository to properly ignore thetarget
directory. #8671 - Don't show warnings about the workspace in the current directory when using
cargo install
of a remote package. #8681 - Automatically reinitialize the index when an "Object not found" error is encountered in the git repository. #8735
- Updated libgit2, which brings in several fixes for git repository handling. #8778 #8780
Nightly only
- Fixed
cargo install
so that it will ignore the[unstable]
table in local config files. #8656 - Fixed nondeterministic behavior of the new feature resolver. #8701
- Fixed running
cargo test
on a proc-macro with the new feature resolver under a specific combination of circumstances. #8742
Cargo 1.47 (2020-10-08)
Added
cargo doc
will now include the package's version in the left sidebar. #8509- Added the
test
field tocargo metadata
targets. #8478 - Cargo's man pages are now displayed via the
cargo help
command (such ascargo help build
). #8456 #8577 - Added new documentation chapters on how dependency resolution works and SemVer compatibility, along with suggestions on how to version your project and work with dependencies. #8609
Changed
- The comments added to
.gitignore
when it is modified have been tweaked to add some spacing. #8476 cargo metadata
output should now be sorted to be deterministic. #8489- By default, build scripts and proc-macros are now built with
opt-level=0
and the default codegen units, even in release mode. #8500 workspace.default-members
is now filtered byworkspace.exclude
. #8485workspace.members
globs now ignore non-directory paths. #8511- git zlib errors now trigger a retry. #8520
- "http" class git errors now trigger a retry. #8553
- git dependencies now override the
core.autocrlf
git configuration value to ensure they behave consistently across platforms, particularly when vendoring git dependencies on Windows. #8523 - If
Cargo.lock
needs to be updated, then it will be automatically transitioned to the new V2 format. This format removes the[metadata]
table, and should be easier to merge changes in source control systems. This format was introduced in 1.38, and made the default for new projects in 1.41. #8554 - Added preparation for support of git repositories with a non-"master"
default branch. Actual support will arrive in a future version. This
introduces some warnings:
- Warn if a git dependency does not specify a branch, and the default branch on the repository is not "master". In the future, Cargo will fetch the default branch. In this scenario, the branch should be explicitly specified.
- Warn if a workspace has multiple dependencies to the same git repository,
one without a
branch
and one withbranch="master"
. Dependencies should all use one form or the other. #8522
- Warnings are now issued if a
required-features
entry lists a feature that does not exist. #7950 - Built-in aliases are now included in
cargo --list
. #8542 cargo install
with a specific version that has been yanked will now display an error message that it has been yanked, instead of "could not find". #8565cargo publish
with a package that has thepublish
field set to a single registry, and no--registry
flag has been given, will now publish to that registry instead of generating an error. #8571
Fixed
- Fixed issue where if a project directory was moved, and one of the
build scripts did not use the
rerun-if-changed
directive, then that build script was being rebuilt when it shouldn't. #8497 - Console colors should now work on Windows 7 and 8. #8540
- The
CARGO_TARGET_{triplet}_RUNNER
environment variable will now correctly override the config file instead of trying to merge the commands. #8629 - Fixed LTO with doctests. #8657 #8658
Nightly only
- Added support for
-Z terminal-width
which tellsrustc
the width of the terminal so that it can format diagnostics better. docs #8427 - Added ability to configure
-Z
unstable flags in config files via the[unstable]
table. docs #8393 - Added
-Z build-std-features
flag to set features for the standard library. docs #8490
Cargo 1.46 (2020-08-27)
Added
- The
dl
key inconfig.json
of a registry index now supports the replacement markers{prefix}
and{lowerprefix}
to allow spreading crates across directories similar to how the index itself is structured. docs #8267 - Added new environment variables that are set during compilation:
- If the value for
readme
is not specified inCargo.toml
, it is now automatically inferred from the existence of a file namedREADME
,README.md
, orREADME.txt
. This can be suppressed by settingreadme = false
. #8277 cargo install
now supports the--index
flag to install directly from an index. #8344- Added the
metadata
table to theworkspace
definition inCargo.toml
. This can be used for arbitrary data similar to thepackage.metadata
table. #8323 - Added the
--target-dir
flag tocargo install
to set the target directory. #8391 - Changes to environment variables used by the
env!
oroption_env!
macros are now automatically detected to trigger a rebuild. #8421 - The
target
directory now includes theCACHEDIR.TAG
file which is used by some tools to exclude the directory from backups. #8378 - Added docs about rustup's
+toolchain
syntax. #8455
Changed
- A warning is now displayed if a git dependency includes a
#
fragment in the URL. This was potentially confusing because Cargo itself displays git URLs with this syntax, but it does not have any meaning outside of theCargo.lock
file, and would not work properly. #8297 - Various optimizations and fixes for bitcode embedding and LTO. #8349
- Reduced the amount of data fetched for git dependencies. If Cargo knows the branch or tag to fetch, it will now only fetch that branch or tag instead of all branches and tags. #8363
- Enhanced git fetch error messages. #8409
.crate
files are now generated with GNU tar format instead of UStar, which supports longer file names. #8453
Fixed
- Fixed a rare situation where an update to
Cargo.lock
failed once, but then subsequent runs allowed it proceed. #8274 - Removed assertion that Windows dylibs must have a
.dll
extension. Some custom JSON spec targets may change the extension. #8310 - Updated libgit2, which brings in a fix for zlib errors for some remote git servers like googlesource.com. #8320
- Fixed the GitHub fast-path check for up-to-date git dependencies on non-master branches. #8363
- Fixed issue when enabling a feature with
pkg/feature
syntax, andpkg
is an optional dependency, but also a dev-dependency, and the dev-dependency appears before the optional normal dependency in the registry summary, then the optional dependency would not get activated. #8395 - Fixed
clean -p
deleting the build directory if there is a test namedbuild
. #8398 - Fixed indentation of multi-line Cargo error messages. #8409
- Fixed issue where the automatic inclusion of the
--document-private-items
flag for rustdoc would override any flags passed to thecargo rustdoc
command. #8449 - Cargo will now include a version in the hash of the fingerprint directories to support backwards-incompatible changes to the fingerprint structure. #8473 #8488
Nightly only
- Added
-Zrustdoc-map
feature which provides external mappings for rustdoc (such as https://docs.rs/ links). docs #8287 - Fixed feature calculation when a proc-macro is declared in
Cargo.toml
with an underscore (likeproc_macro = true
). #8319 - Added support for setting
-Clinker
with-Zdoctest-xcompile
. #8359 - Fixed setting the
strip
profile field in config files. #8454
Cargo 1.45 (2020-07-16)
Added
Changed
-
Changed official documentation to recommend
.cargo/config.toml
filenames (with the.toml
extension)..toml
extension support was added in 1.39. #8121 -
The
registry.index
config value is no longer allowed (it has been deprecated for 4 years). #7973 -
An error is generated if both
--index
and--registry
are passed (previously--index
was silently ignored). #7973 -
The
registry.token
config value is no longer used with the--index
flag. This is intended to avoid potentially leaking the crates.io token to another registry. #7973 -
Added a warning if
registry.token
is used with source replacement. It is intended this will be an error in future versions. #7973 -
Windows GNU targets now copy
.dll.a
import library files for DLL crate types to the output directory. #8141 -
Dylibs for all dependencies are now unconditionally copied to the output directory. Some obscure scenarios can cause an old dylib to be referenced between builds, and this ensures that all the latest copies are used. #8139
-
package.exclude
can now match directory names. If a directory is specified, the entire directory will be excluded, and Cargo will not attempt to inspect it further. Previously Cargo would try to check every file in the directory which could cause problems if the directory contained unreadable files. #8095 -
When packaging with
cargo publish
orcargo package
, Cargo can use git to guide its decision on which files to include. Previously this git-based logic required aCargo.toml
file to exist at the root of the repository. This is no longer required, so Cargo will now use git-based guidance even if there is not aCargo.toml
in the root of the repository. #8095 -
While unpacking a crate on Windows, if it fails to write a file because the file is a reserved Windows filename (like "aux.rs"), Cargo will display an extra message to explain why it failed. #8136
-
Failures to set mtime on files are now ignored. Some filesystems did not support this. #8185
-
Certain classes of git errors will now recommend enabling
net.git-fetch-with-cli
. #8166 -
When doing an LTO build, Cargo will now instruct rustc not to perform codegen when possible. This may result in a faster build and use less disk space. Additionally, for non-LTO builds, Cargo will instruct rustc to not embed LLVM bitcode in libraries, which should decrease their size. #8192 #8226 #8254
-
The implementation for
cargo clean -p
has been rewritten so that it can more accurately remove the files for a specific package. #8210 -
The way Cargo computes the outputs from a build has been rewritten to be more complete and accurate. Newly tracked files will be displayed in JSON messages, and may be uplifted to the output directory in some cases. Some of the changes from this are:
.exp
export files on Windows MSVC dynamic libraries are now tracked.- Proc-macros on Windows track import/export files.
- All targets (like tests, etc.) that generate separate debug files (pdb/dSYM) are tracked.
- Added .map files for wasm32-unknown-emscripten.
- macOS dSYM directories are tracked for all dynamic libraries (dylib/cdylib/proc-macro) and for build scripts.
There are a variety of other changes as a consequence of this:
- Binary examples on Windows MSVC with a hyphen will now show up twice in
the examples directory (
foo_bar.exe
andfoo-bar.exe
). Previously Cargo just renamed the file instead of hard-linking it. - Example libraries now follow the same rules for hyphen/underscore translation as normal libs (they will now use underscores).
-
Cargo attempts to scrub any secrets from the debug log for HTTP debugging. #8222
-
Context has been added to many of Cargo's filesystem operations, so that error messages now provide more information, such as the path that caused the problem. #8232
-
Several commands now ignore the error if stdout or stderr is closed while it is running. For example
cargo install --list | grep -q cargo-fuzz
would previously sometimes panic becausegrep -q
may close stdout before the command finishes. Regular builds continue to fail if stdout or stderr is closed, matching the behavior of many other build systems. #8236 -
If
cargo install
is given an exact version, like--version=1.2.3
, it will now avoid updating the index if that version is already installed, and exit quickly indicating it is already installed. #8022 -
Changes to the
[patch]
section will now attempt to automatically updateCargo.lock
to the new version. It should now also provide better error messages for the rare cases where it is unable to automatically update. #8248
Fixed
- Fixed copying Windows
.pdb
files to the output directory when the filename contained dashes. #8123 - Fixed error where Cargo would fail when scanning if a package is inside a git repository when any of its ancestor paths is a symlink. #8186
- Fixed
cargo update
with an unused[patch]
so that it does not get stuck and refuse to update. #8243 - Fixed a situation where Cargo would hang if stderr is closed, and the compiler generated a large number of messages. #8247
- Fixed backtraces on macOS not showing filenames or line numbers. As a consequence of this, binary executables on apple targets do not include a hash in the filename in Cargo's cache. This means Cargo can only track one copy, so if you switch features or rustc versions, Cargo will need to rebuild the executable. #8329 #8335
- Fixed fingerprinting when using lld on Windows with a dylib. Cargo was erroneously thinking the dylib was never fresh. #8290 #8335
Nightly only
- Fixed passing the full path for
--target
torustdoc
when using JSON spec targets. #8094 -Cembed-bitcode=no
renamed to-Cbitcode-in-rlib=no
#8134- Added new
resolver
field toCargo.toml
to opt-in to the new feature resolver. #8129 -Zbuild-std
no longer treats std dependencies as "local". This means that it won't use incremental compilation for those dependencies, removes them from dep-info files, and caps lints at "allow". #8177- Added
-Zmultitarget
which allows multiple--target
flags to build the same thing for multiple targets at once. docs #8167 - Added
strip
option to the profile to remove symbols and debug information. docs #8246 - Fixed panic with
cargo tree --target=all -Zfeatures=all
. #8269
Cargo 1.44 (2020-06-04)
Added
- 🔥 Added the
cargo tree
command. docs #8062 - Added warnings if a package has Windows-restricted filenames (like
nul
,con
,aux
,prn
, etc.). #7959 - Added a
"build-finished"
JSON message when compilation is complete so that tools can detect when they can stop listening for JSON messages with commands likecargo run
orcargo test
. #8069
Changed
- Valid package names are now restricted to Unicode XID identifiers. This is
mostly the same as before, except package names cannot start with a number
or
-
. #7959 cargo new
andinit
will warn or reject additional package names (reserved Windows names, reserved Cargo directories, non-ASCII names, conflicting std names likecore
, etc.). #7959- Tests are no longer hard-linked into the output directory (
target/debug/
). This ensures tools will have access to debug symbols and execute tests in the same way as Cargo. Tools should use JSON messages to discover the path to the executable. #7965 - Updating git submodules now displays an "Updating" message for each submodule. #7989
- File modification times are now preserved when extracting a
.crate
file. This reverses the change made in 1.40 where the mtime was not preserved. #7935 - Build script warnings are now displayed separately when the build script fails. #8017
- Removed the
git-checkout
subcommand. #8040 - The progress bar is now enabled for all unix platforms. Previously it was only Linux, macOS, and FreeBSD. #8054
- Artifacts generated by pre-release versions of
rustc
now share the same filenames. This means that changing nightly versions will not leave stale files in the build directory. #8073 - Invalid package names are rejected when using renamed dependencies. #8090
- Added a certain class of HTTP2 errors as "spurious" that will get retried. #8102
- Allow
cargo package --list
to succeed, even if there are other validation errors (such asCargo.lock
generation problem, or missing dependencies). #8175 #8215
Fixed
- Cargo no longer buffers excessive amounts of compiler output in memory. #7838
- Symbolic links in git repositories now work on Windows. #7996
- Fixed an issue where
profile.dev
was not loaded from a config file withcargo test
when thedev
profile was not defined inCargo.toml
. #8012 - When a binary is built as an implicit dependency of an integration test,
it now checks
dep_name/feature_name
syntax inrequired-features
correctly. #8020 - Fixed an issue where Cargo would not detect that an executable (such as an integration test) needs to be rebuilt when the previous build was interrupted with Ctrl-C. #8087
- Protect against some (unknown) situations where Cargo could panic when the system monotonic clock doesn't appear to be monotonic. #8114
- Fixed panic with
cargo clean -p
if the package has a build script. #8216
Nightly only
- Fixed panic with new feature resolver and required-features. #7962
- Added
RUSTC_WORKSPACE_WRAPPER
environment variable, which provides a way to wraprustc
for workspace members only, and affects the filename hash so that artifacts produced by the wrapper are cached separately. This usage can be seen on nightly clippy withcargo clippy -Zunstable-options
. #7533 - Added
--unit-graph
CLI option to display Cargo's internal dependency graph as JSON. #7977 - Changed
-Zbuild_dep
to-Zhost_dep
, and added proc-macros to the feature decoupling logic. #8003 #8028 - Fixed so that
--crate-version
is not automatically passed when the flag is found inRUSTDOCFLAGS
. #8014 - Fixed panic with
-Zfeatures=dev_dep
andcheck --profile=test
. #8027 - Fixed panic with
-Zfeatures=itarget
with certain host dependencies. #8048 - Added support for
-Cembed-bitcode=no
, which provides a performance boost and disk-space usage reduction for non-LTO builds. #8066 -Zpackage-features
has been extended with several changes intended to make it easier to select features on the command-line in a workspace. #8074
Cargo 1.43 (2020-04-23)
Added
- 🔥 Profiles may now be specified in config files (and environment variables). docs #7823
- ❗ Added
CARGO_BIN_EXE_<name>
environment variable when building integration tests. This variable contains the path to any[[bin]]
targets in the package. Integration tests should use theenv!
macro to determine the path to a binary to execute. docs #7697
Changed
cargo install --git
now honors workspaces in a git repository. This allows workspace settings, like[patch]
,[replace]
, or[profile]
to be used. #7768cargo new
will now runrustfmt
on the new files to pick up rustfmt settings liketab_spaces
so that the new file matches the user's preferred indentation settings. #7827- Environment variables printed with "very verbose" output (
-vv
) are now consistently sorted. #7877 - Debug logging for fingerprint rebuild-detection now includes more information. #7888 #7890 #7952
- Added warning during publish if the license-file doesn't exist. #7905
- The
license-file
file is automatically included during publish, even if it is not explicitly listed in theinclude
list or is in a location outside of the root of the package. #7905 CARGO_CFG_DEBUG_ASSERTIONS
andCARGO_CFG_PROC_MACRO
are no longer set when running a build script. These were inadvertently set in the past, but had no meaning as they were always true. Additionally,cfg(proc-macro)
is no longer supported in atarget
expression. #7943 #7970
Fixed
- Global command-line flags now work with aliases (like
cargo -v b
). #7837 - Required-features using dependency syntax (like
renamed_dep/feat_name
) now handle renamed dependencies correctly. #7855 - Fixed a rare situation where if a build script is run multiple times during the same build, Cargo will now keep the results separate instead of losing the output of the first execution. #7857
- Fixed incorrect interpretation of environment variable
CARGO_TARGET_*_RUNNER=true
as a boolean. Also improved related env var error messages. #7891 - Updated internal libgit2 library, bringing various fixes to git support. #7939
cargo package
/cargo publish
should no longer buffer the entire contents of each file in memory. #7946- Ignore more invalid
Cargo.toml
files in a git dependency. Cargo currently walks the entire repo to find the requested package. Certain invalid manifests were already skipped, and now it should skip all of them. #7947
Nightly only
- Added
build.out-dir
config variable to set the output directory. #7810 - Added
-Zjobserver-per-rustc
feature to support improved performance for parallel rustc. #7731 - Fixed filename collision with
build-std
and crates likecc
. #7860 -Ztimings
will now save its report even if there is an error. #7872- Updated
--config
command-line flag to support taking a path to a config file to load. #7901 - Added new feature resolver. #7820
- Rustdoc docs now automatically include the version of the package in the
side bar (requires
-Z crate-versions
flag). #7903
Cargo 1.42 (2020-03-12)
Added
- Added documentation on git authentication. #7658
- Bitbucket Pipeline badges are now supported on crates.io. #7663
cargo vendor
now accepts the--versioned-dirs
option to force it to always include the version number in each package's directory name. #7631- The
proc_macro
crate is now automatically added to the extern prelude for proc-macro packages. This means thatextern crate proc_macro;
is no longer necessary for proc-macros. #7700
Changed
- Emit a warning if
debug_assertions
,test
,proc_macro
, orfeature=
is used in acfg()
expression. #7660 - Large update to the Cargo documentation, adding new chapters on Cargo targets, workspaces, and features. #7733
- Windows:
.lib
DLL import libraries are now copied next to the dll for all Windows MSVC targets. Previously it was only supported forpc-windows-msvc
. This adds DLL support foruwp-windows-msvc
targets. #7758 - The
ar
field in the[target]
configuration is no longer read. It has been ignored for over 4 years. #7763 - Bash completion file simplified and updated for latest changes. #7789
- Credentials are only loaded when needed, instead of every Cargo command. #7774
Fixed
- Removed
--offline
empty index check, which was a false positive in some cases. #7655 - Files and directories starting with a
.
can now be included in a package by adding it to theinclude
list. #7680 - Fixed
cargo login
removing alternative registry tokens when previous entries existed in the credentials file. #7708 - Fixed
cargo vendor
from panicking when used with alternative registries. #7718 - Fixed incorrect explanation in the fingerprint debug log message. #7749
- A
[source]
that is defined multiple times will now result in an error. Previously it was randomly picking a source, which could cause non-deterministic behavior. #7751 dep_kinds
incargo metadata
are now de-duplicated. #7756- Fixed packaging where
Cargo.lock
was listed in.gitignore
in a subdirectory inside a git repository. Previously it was assumingCargo.lock
was at the root of the repo. #7779 - Partial file transfer errors will now cause an automatic retry. #7788
- Linux: Fixed panic if CPU iowait stat decreases. #7803
- Fixed using the wrong sysroot for detecting host compiler settings when
--sysroot
is passed in viaRUSTFLAGS
. #7798
Nightly only
build-std
now uses--extern
instead of--sysroot
to find sysroot packages. #7699- Added
--config
command-line option to set config settings. #7649 - Added
include
config setting which allows including another config file. #7649 - Profiles in config files now support any named profile. Previously it was limited to dev/release. #7750
Cargo 1.41 (2020-01-30)
Added
- 🔥 Cargo now uses a new
Cargo.lock
file format. This new format should support easier merges in source control systems. Projects using the old format will continue to use the old format, only newCargo.lock
files will use the new format. #7579 - 🔥
cargo install
will now upgrade already installed packages instead of failing. #7560 - 🔥 Profile overrides have been added. This allows overriding profiles for individual dependencies or build scripts. See the documentation for more. #7591
- Added new documentation for build scripts. #7565
- Added documentation for Cargo's JSON output. #7595
- Significant expansion of config and environment variable documentation. #7650
- Add back support for
BROWSER
environment variable forcargo doc --open
. #7576 - Added
kind
andplatform
for dependencies incargo metadata
. #7132 - The
OUT_DIR
value is now included in thebuild-script-executed
JSON message. #7622
Changed
cargo doc
will now document private items in binaries by default. #7593- Subcommand typo suggestions now include aliases. #7486
- Tweak how the "already existing..." comment is added to
.gitignore
. #7570 - Ignore
cargo login
text from copy/paste in token. #7588 - Windows: Ignore errors for locking files when not supported by the filesystem. #7602
- Remove
**/*.rs.bk
from.gitignore
. #7647
Fixed
- Fix unused warnings for some keys in the
build
config section. #7575 - Linux: Don't panic when parsing
/proc/stat
. #7580 - Don't show canonical path in
cargo vendor
. #7629
Nightly only
Cargo 1.40 (2019-12-19)
Added
- Added
http.ssl-version
config option to control the version of TLS, along with min/max versions. #7308 - 🔥 Compiler warnings are now cached on disk. If a build generates warnings, re-running the build will now re-display the warnings. #7450
- Added
--filter-platform
option tocargo metadata
to narrow the nodes shown in the resolver graph to only packages included for the given target triple. #7376
Changed
- Cargo's "platform"
cfg
parsing has been extracted into a separate crate namedcargo-platform
. #7375 - Dependencies extracted into Cargo's cache no longer preserve mtimes to reduce syscall overhead. #7465
- Windows: EXE files no longer include a metadata hash in the filename. This helps with debuggers correlating the filename with the PDB file. #7400
- Wasm32:
.wasm
files are no longer treated as an "executable", allowingcargo test
andcargo run
to work properly with the generated.js
file. #7476 - crates.io now supports SPDX 3.6 licenses. #7481
- Improved cyclic dependency error message. #7470
- Bare
cargo clean
no longer locks the package cache. #7502 cargo publish
now allows dev-dependencies without a version key to be published. A git or path-only dev-dependency will be removed from the package manifest before uploading. #7333--features
and--no-default-features
in the root of a virtual workspace will now generate an error instead of being ignored. #7507- Generated files (like
Cargo.toml
andCargo.lock
) in a package archive now have their timestamp set to the current time instead of the epoch. #7523 - The
-Z
flag parser is now more strict, rejecting more invalid syntax. #7531
Fixed
- Fixed an issue where if a package had an
include
field, andCargo.lock
in.gitignore
, and a binary or example target, and theCargo.lock
exists in the current project, it would fail to publish complaining theCargo.lock
was dirty. #7448 - Fixed a panic in a particular combination of
[patch]
entries. #7452 - Windows: Better error message when
cargo test
orrustc
crashes in an abnormal way, such as a signal or seg fault. #7535
Nightly only
- The
mtime-on-use
feature may now be enabled via theunstable.mtime_on_use
config option. #7411 - Added support for named profiles. #6989
- Added
-Zpanic-abort-tests
to allow building and running tests with the "abort" panic strategy. #7460 - Changed
build-std
to use--sysroot
. #7421 - Various fixes and enhancements to
-Ztimings
. #7395 #7398 #7397 #7403 #7428 #7429 - Profile overrides have renamed the syntax to be
[profile.dev.package.NAME]
. #7504 - Fixed warnings for unused profile overrides in a workspace. #7536
Cargo 1.39 (2019-11-07)
Added
- Config files may now use the
.toml
filename extension. #7295 - The
--workspace
flag has been added as an alias for--all
to help avoid confusion about the meaning of "all". #7241 - The
publish
field has been added tocargo metadata
. #7354
Changed
- Display more information if parsing the output from
rustc
fails. #7236 - TOML errors now show the column number. #7248
cargo vendor
no longer deletes files in thevendor
directory that starts with a.
. #7242cargo fetch
will now show manifest warnings. #7243cargo publish
will now check git submodules if they contain any uncommitted changes. #7245- In a build script,
cargo:rustc-flags
now allows-l
and-L
flags without spaces. #7257 - When
cargo install
replaces an older version of a package it will now delete any installed binaries that are no longer present in the newly installed version. #7246 - A git dependency may now also specify a
version
key when published. Thegit
value will be stripped from the uploaded crate, matching the behavior ofpath
dependencies. #7237 - The behavior of workspace default-members has changed. The default-members now only applies when running Cargo in the root of the workspace. Previously it would always apply regardless of which directory Cargo is running in. #7270
- libgit2 updated pulling in all upstream changes. #7275
- Bump
home
dependency for locating home directories. #7277 - zsh completions have been updated. #7296
- SSL connect errors are now retried. #7318
- The jobserver has been changed to acquire N tokens (instead of N-1), and
then immediately acquires the extra token. This was changed to accommodate
the
cc
crate on Windows to allow it to release its implicit token. #7344 - The scheduling algorithm for choosing which crate to build next has been changed. It now chooses the crate with the greatest number of transitive crates waiting on it. Previously it used a maximum topological depth. #7390
- RUSTFLAGS are no longer incorporated in the metadata and filename hash, reversing the change from 1.33 that added it. This means that any change to RUSTFLAGS will cause a recompile, and will not affect symbol munging. #7459
Fixed
- Git dependencies with submodules with shorthand SSH URLs (like
git@github.com/user/repo.git
) should now work. #7238 - Handle broken symlinks when creating
.dSYM
symlinks on macOS. #7268 - Fixed issues with multiple versions of the same crate in a
[patch]
table. #7303 - Fixed issue with custom target
.json
files where a substring of the name matches an unsupported crate type (like "bin"). #7363 - Fixed issues with generating documentation for proc-macro crate types. #7159
- Fixed hang if Cargo panics within a build thread. #7366
- Fixed rebuild detection if a
build.rs
script issues differentrerun-if
directives between builds. Cargo was erroneously causing a rebuild after the change. #7373 - Properly handle canonical URLs for
[patch]
table entries, preventing the patch from working after the first time it is used. #7368 - Fixed an issue where integration tests were waiting for the package binary to finish building before starting their own build. They now may build concurrently. #7394
- Fixed accidental change in the previous release on how
--features a b
flag is interpreted, restoring the original behavior where this is interpreted as--features a
along with the argumentb
passed to the command. To pass multiple features, use quotes around the features to pass multiple features like--features "a b"
, or use commas, or use multiple--features
flags. #7419
Nightly only
- Basic support for building the standard library directly from Cargo has been added. (docs) #7216
- Added
-Ztimings
feature to generate an HTML report on the time spent on individual compilation steps. This also may output completion steps on the console and JSON data. (docs) #7311 - Added ability to cross-compile doctests. (docs) #6892
Cargo 1.38 (2019-09-26)
Added
- 🔥 Cargo build pipelining has been enabled by default to leverage more idle CPU parallelism during builds. #7143
- The
--message-format
option to Cargo can now be specified multiple times and accepts a comma-separated list of values. In addition to the previous values it also now acceptsjson-diagnostic-short
andjson-diagnostic-rendered-ansi
which configures the output coming from rustc injson
message mode. #7214 - Cirrus CI badges are now supported on crates.io. #7119
- A new format for
Cargo.lock
has been introduced. This new format is intended to avoid source-control merge conflicts more often, and to generally make it safer to merge changes. This new format is not enabled at this time, though Cargo will use it if it sees it. At some point in the future, it is intended that this will become the default. #7070 - Progress bar support added for FreeBSD. #7222
Changed
- The
-q
flag will no longer suppress the root error message for an error from Cargo itself. #7116 - The Cargo Book is now published with mdbook 0.3 providing a number of formatting fixes and improvements. #7140
- The
--features
command-line flag can now be specified multiple times. The list of features from all the flags are joined together. #7084 - Package include/exclude glob-vs-gitignore warnings have been removed. Packages may now use gitignore-style matching without producing any warnings. #7170
- Cargo now shows the command and output when parsing
rustc
output fails when queryingrustc
for information likecfg
values. #7185 cargo package
/cargo publish
now allows a symbolic link to a git submodule to include that submodule. #6817- Improved the error message when a version requirement does not match any versions, but there are pre-release versions available. #7191
Fixed
- Fixed using the wrong directory when updating git repositories when using
the
git-fetch-with-cli
config option, and theGIT_DIR
environment variable is set. This may happen when running cargo from git callbacks. #7082 - Fixed dep-info files being overwritten for targets that have separate debug
outputs. For example, binaries on
-apple-
targets with.dSYM
directories would overwrite the.d
file. #7057 - Fix
[patch]
table not preserving "one major version per source" rule. #7118 - Ignore
--remap-path-prefix
flags for the metadata hash in thecargo rustc
command. This was causing the remap settings to inadvertently affect symbol names. #7134 - Fixed cycle detection in
[patch]
dependencies. #7174 - Fixed
cargo new
leaving behind a symlink on Windows whencore.symlinks
git config is true. Also adds a number of fixes and updates from upstream libgit2. #7176 - macOS: Fixed setting the flag to mark the
target
directory to be excluded from backups. #7192 - Fixed
cargo fix
panicking under some situations involving multi-byte characters. #7221
Nightly only
- Added
cargo fix --clippy
which will apply machine-applicable fixes from Clippy. #7069 - Added
-Z binary-dep-depinfo
flag to add change tracking for binary dependencies like the standard library. #7137 #7219 cargo clippy-preview
will always run, even if no changes have been made. #7157- Fixed exponential blowup when using
CARGO_BUILD_PIPELINING
. #7062 - Fixed passing args to clippy in
cargo clippy-preview
. #7162
Cargo 1.37 (2019-08-15)
Added
- Added
doctest
field tocargo metadata
to determine if a target's documentation is tested. #6953 #6965 - 🔥 The
cargo vendor
command is now built-in to Cargo. This command may be used to create a local copy of the sources of all dependencies. #6869 - 🔥 The "publish lockfile" feature is now stable. This feature will
automatically include the
Cargo.lock
file when a package is published if it contains a binary executable target. By default, Cargo will ignoreCargo.lock
when installing a package. To force Cargo to use theCargo.lock
file included in the published package, usecargo install --locked
. This may be useful to ensure thatcargo install
consistently reproduces the same result. It may also be useful when a semver-incompatible change is accidentally published to a dependency, providing a way to fall back to a version that is known to work. #7026 - 🔥 The
default-run
feature has been stabilized. This feature allows you to specify which binary executable to run by default withcargo run
when a package includes multiple binaries. Set thedefault-run
key in the[package]
table inCargo.toml
to the name of the binary to use by default. #7056
Changed
cargo package
now verifies that build scripts do not create empty directories. #6973- A warning is now issued if
cargo doc
generates duplicate outputs, which causes files to be randomly stomped on. This may happen for a variety of reasons (renamed dependencies, multiple versions of the same package, packages with renamed libraries, etc.). This is a known bug, which needs more work to handle correctly. #6998 - Enabling a dependency's feature with
--features foo/bar
will no longer compile the current crate with thefoo
feature iffoo
is not an optional dependency. #7010 - If
--remap-path-prefix
is passed via RUSTFLAGS, it will no longer affect the filename metadata hash. #6966 - libgit2 has been updated to 0.28.2, which Cargo uses to access git repositories. This brings in hundreds of changes and fixes since it was last updated in November. #7018
- Cargo now supports absolute paths in the dep-info files generated by rustc. This is laying the groundwork for tracking binaries, such as libstd, for rebuild detection. (Note: this contains a known bug.) #7030
Fixed
- Fixed how zsh completions fetch the list of commands. #6956
- "+ debuginfo" is no longer printed in the build summary when
debug
is set to 0. #6971 - Fixed
cargo doc
with an example configured withdoc = true
to document correctly. #7023 - Don't fail if a read-only lock cannot be acquired in CARGO_HOME. This helps
when CARGO_HOME doesn't exist, but
--locked
is used which means CARGO_HOME is not needed. #7149 - Reverted a change in 1.35 which released jobserver tokens when Cargo blocked on a lock file. It caused a deadlock in some situations. #7204
Nightly only
- Added compiler message
caching.
The
-Z cache-messages
flag makes cargo cache the compiler output so that future runs can redisplay previous warnings. #6933 -Z mtime-on-use
no longer touches intermediate artifacts. #7050
Cargo 1.36 (2019-07-04)
Added
- Added more detailed documentation on target auto-discovery. #6898
- 🔥 Stabilize the
--offline
flag which allows using cargo without a network connection. #6934 #6871
Changed
publish = ["crates-io"]
may be added to the manifest to restrict publishing to crates.io only. #6838- macOS: Only include the default paths if
DYLD_FALLBACK_LIBRARY_PATH
is not set. Also, remove/lib
from the default set. #6856 cargo publish
will now exit early if the login token is not available. #6854- HTTP/2 stream errors are now considered "spurious" and will cause a retry. #6861
- Setting a feature on a dependency where that feature points to a required dependency is now an error. Previously it was a warning. #6860
- The
registry.index
config value now supports relativefile:
URLs. #6873 - macOS: The
.dSYM
directory is now symbolically linked next to example binaries without the metadata hash so that debuggers can find it. #6891 - The default
Cargo.toml
template for now projects now includes a comment providing a link to the documentation. #6881 - Some improvements to the wording of the crate download summary. #6916 #6920
- ✨ Changed
RUST_LOG
environment variable toCARGO_LOG
so that user code that uses thelog
crate will not display cargo's debug output. #6918 Cargo.toml
is now always included when packaging, even if it is not listed inpackage.include
. #6925- Package include/exclude values now use gitignore patterns instead of glob patterns. #6924
- Provide a better error message when crates.io times out. Also improve error messages with other HTTP response codes. #6936
Performance
- Resolver performance improvements for some cases. #6853
- Optimized how cargo reads the index JSON files by caching the results. #6880 #6912 #6940
- Various performance improvements. #6867
Fixed
- More carefully track the on-disk fingerprint information for dependencies. This can help in some rare cases where the build is interrupted and restarted. #6832
cargo run
now correctly passes non-UTF8 arguments to the child process. #6849- Fixed bash completion to run on bash 3.2, the stock version in macOS. #6905
- Various fixes and improvements to zsh completion. #6926 #6929
- Fix
cargo update
ignoring-p
arguments if theCargo.lock
file was missing. #6904
Nightly only
- Added
-Z install-upgrade
feature to track details about installed crates and to update them if they are out-of-date. #6798 - Added the
public-dependency
feature which allows tracking public versus private dependencies. #6772 - Added build pipelining via the
build.pipelining
config option (CARGO_BUILD_PIPELINING
env var). #6883 - The
publish-lockfile
feature has had some significant changes. The default is nowtrue
, theCargo.lock
will always be published for binary crates. TheCargo.lock
is now regenerated during publishing.cargo install
now ignores theCargo.lock
file by default, and requires--locked
to use the lock file. Warnings have been added if yanked dependencies are detected. #6840
Cargo 1.35 (2019-05-23)
Added
- Added the
rustc-cdylib-link-arg
key for build scripts to specify linker arguments for cdylib crates. #6298
Changed
- When passing a test filter, such as
cargo test foo
, don't build examples (unless they settest = true
). #6683 - Forward the
--quiet
flag fromcargo test
to the libtest harness so that tests are actually quiet. #6358 - The verification step in
cargo package
that checks if any files are modified is now stricter. It uses a hash of the contents instead of checking filesystem mtimes. It also checks all files in the package. #6740 - Jobserver tokens are now released whenever Cargo blocks on a file lock. #6748
- Issue a warning for a previous bug in the TOML parser that allowed multiple table headers with the same name. #6761
- Removed the
CARGO_PKG_*
environment variables from the metadata hash and added them to the fingerprint instead. This means that when these values change, stale artifacts are not left behind. Also added the "repository" value to the fingerprint. #6785 cargo metadata
no longer shows anull
field for a dependency without a library inresolve.nodes.deps
. The dependency is no longer shown. #6534cargo new
will no longer include an email address in theauthors
field if it is set to the empty string. #6802cargo doc --open
now works when documenting multiple packages. #6803cargo install --path P
now loads the.cargo/config
file from the directory P. #6805- Using semver metadata in a version requirement (such as
1.0.0+1234
) now issues a warning that it is ignored. #6806 cargo install
now rejects certain combinations of flags where some flags would have been ignored. #6801- Resolver performance improvements for some cases. #6776
Fixed
- Fixed running separate commands (such as
cargo build
thencargo test
) where the second command could use stale results from a build script. #6720 - Fixed
cargo fix
not working properly if a.gitignore
file that matched the root package directory. #6767 - Fixed accidentally compiling a lib multiple times if
panic=unwind
was set in a profile. #6781 - Paths to JSON files in
build.target
config value are now canonicalized to fix building dependencies. #6778 - Fixed re-running a build script if its compilation was interrupted (such as if it is killed). #6782
- Fixed
cargo new
initializing a fossil repo. #6792 - Fixed supporting updating a git repo that has a force push when using the
git-fetch-with-cli
feature.git-fetch-with-cli
also shows more error information now when it fails. #6800 --example
binaries built for the WASM target are fixed to no longer include a metadata hash in the filename, and are correctly emitted in thecompiler-artifact
JSON message. #6812
Nightly only
cargo clippy-preview
is now a built-in cargo command. #6759- The
build-override
profile setting now includes proc-macros and their dependencies. #6811 - Optional and target dependencies now work better with
-Z offline
. #6814
Cargo 1.34 (2019-04-11)
Added
- 🔥 Stabilized support for alternate registries. #6654
- Added documentation on using builds.sr.ht Continuous Integration with Cargo. #6565
Cargo.lock
now includes a comment at the top that it is@generated
. #6548- Azure DevOps badges are now supported. #6264
- Added a warning if
--exclude
flag specifies an unknown package. #6679
Changed
cargo test --doc --no-run
doesn't do anything, so it now displays an error to that effect. #6628- Various updates to bash completion: add missing options and commands,
support libtest completions, use rustup for
--target
completion, fallback to filename completion, fix editing the command line. #6644 - Publishing a crate with a
[patch]
section no longer generates an error. The[patch]
section is removed from the manifest before publishing. #6535 build.incremental = true
config value is now treated the same asCARGO_INCREMENTAL=1
, previously it was ignored. #6688- Errors from a registry are now always displayed regardless of the HTTP response code. #6771
Fixed
- Fixed bash completion for
cargo run --example
. #6578 - Fixed a race condition when using a local registry and running multiple cargo commands at the same time that build the same crate. #6591
- Fixed some flickering and excessive updates of the progress bar. #6615
- Fixed a hang when using a git credential helper that returns incorrect credentials. #6681
- Fixed resolving yanked crates with a local registry. #6750
Nightly only
- Added
-Z mtime-on-use
flag to cause the mtime to be updated on the filesystem when a crate is used. This is intended to be able to track stale artifacts in the future for cleaning up unused files. #6477 #6573 - Added experimental
-Z dual-proc-macros
to build proc macros for both the host and the target. #6547
Cargo 1.33 (2019-02-28)
Added
compiler-artifact
JSON messages now include an"executable"
key which includes the path to the executable that was built. #6363- The man pages have been rewritten, and are now published with the web documentation. #6405
cargo login
now displays a confirmation after saving the token. #6466- A warning is now emitted if a
[patch]
entry does not match any package. #6470 cargo metadata
now includes thelinks
key for a package. #6480- "Very verbose" output with
-vv
now displays the environment variables that cargo sets when it runs a process. #6492 --example
,--bin
,--bench
, or--test
without an argument now lists the available targets for those options. #6505- Windows: If a process fails with an extended status exit code, a human-readable name for the code is now displayed. #6532
- Added
--features
,--no-default-features
, and--all-features
flags to thecargo package
andcargo publish
commands to use the given features when verifying the package. #6453
Changed
- If
cargo fix
fails to compile the fixed code, the rustc errors are now displayed on the console. #6419 - Hide the
--host
flag fromcargo login
, it is unused. #6466 - Build script fingerprints now include the rustc version. #6473
- macOS: Switched to setting
DYLD_FALLBACK_LIBRARY_PATH
instead ofDYLD_LIBRARY_PATH
. #6355 RUSTFLAGS
is now included in the metadata hash, meaning that changing the flags will not overwrite previously built files. #6503- When updating the crate graph, unrelated yanked crates were erroneously
removed. They are now kept at their original version if possible. This was
causing unrelated packages to be downgraded during
cargo update -p somecrate
. #5702 - TOML files now support the 0.5 TOML syntax.
Fixed
cargo fix
will now ignore suggestions that modify multiple files. #6402cargo fix
will now only fix one target at a time, to deal with targets which share the same source files. #6434- Fixed bash completion showing the list of cargo commands. #6461
cargo init
will now avoid creating duplicate entries in.gitignore
files. #6521- Builds now attempt to detect if a file is modified in the middle of a compilation, allowing you to build again and pick up the new changes. This is done by keeping track of when the compilation starts not when it finishes. Also, #5919 was reverted, meaning that cargo does not treat equal filesystem mtimes as requiring a rebuild. #6484
Nightly only
- Allow using registry names in
[patch]
tables instead of just URLs. #6456 cargo metadata
added theregistry
key for dependencies. #6500- Registry names are now restricted to the same style as
package names (alphanumeric,
-
and_
characters). #6469 cargo login
now displays the/me
URL from the registry config. #6466cargo login --registry=NAME
now supports interactive input for the token. #6466- Registries may now elide the
api
key fromconfig.json
to indicate they do not support API access. #6466 - Fixed panic when using
--message-format=json
with metabuild. #6432 - Fixed detection of publishing to crates.io when using alternate registries. #6525
Cargo 1.32 (2019-01-17)
Added
- Registries may now display warnings after a successful publish. #6303
- Added a glossary to the documentation. #6321
- Added the alias
c
forcargo check
. #6218
Changed
- 🔥 HTTP/2 multiplexing is now enabled by default. The
http.multiplexing
config value may be used to disable it. #6271 - Use ANSI escape sequences to clear lines instead of spaces. #6233
- Disable git templates when checking out git dependencies, which can cause problems. #6252
- Include the
--update-head-ok
git flag when using thenet.git-fetch-with-cli
option. This can help prevent failures when fetching some repositories. #6250 - When extracting a crate during the verification step of
cargo package
, the filesystem mtimes are no longer set, which was failing on some rare filesystems. #6257 crate-type = ["proc-macro"]
is now treated the same asproc-macro = true
inCargo.toml
. #6256- An error is raised if
dependencies
,features
,target
, orbadges
is set in a virtual workspace. Warnings are displayed ifreplace
orpatch
is used in a workspace member. #6276 - Improved performance of the resolver in some cases. #6283 #6366
.rmeta
files are no longer hard-linked into the base target directory (target/debug
). #6292- A warning is issued if multiple targets are built with the same output filenames. #6308
- When using
cargo build
(without--release
) benchmarks are now built using the "test" profile instead of "bench". This makes it easier to debug benchmarks, and avoids confusing behavior. #6309 - User aliases may now override built-in aliases (
b
,r
,t
, andc
). #6259 - Setting
autobins=false
now disables auto-discovery of inferred targets. #6329 cargo verify-project
will now fail on stable if the project uses unstable features. #6326- Platform targets with an internal
.
within the name are now allowed. #6255 cargo clean --release
now only deletes the release directory. #6349
Fixed
- Avoid adding extra angle brackets in email address for
cargo new
. #6243 - The progress bar is disabled if the CI environment variable is set. #6281
- Avoid retaining all rustc output in memory. #6289
- If JSON parsing fails, and rustc exits nonzero, don't lose the parse failure message. #6290
- Fixed renaming a project directory with build scripts. #6328
- Fixed
cargo run --example NAME
to work correctly if the example setscrate_type = ["bin"]
. #6330 - Fixed issue with
cargo package
git discovery being too aggressive. The--allow-dirty
now completely disables the git repo checks. #6280 - Fixed build change tracking for
[patch]
deps which resulted incargo build
rebuilding when it shouldn't. #6493
Nightly only
- Allow usernames in registry URLs. #6242
- Added
"compile_mode"
key to the build-plan JSON structure to be able to distinguish running a custom build script versus compiling the build script. #6331 --out-dir
no longer copies over build scripts. #6300
Cargo 1.31 (2018-12-06)
Added
- 🔥 Stabilized support for the 2018 edition. #5984 #5989
- 🔥 Added the ability to rename dependencies in Cargo.toml. #6319
- 🔥 Added support for HTTP/2 pipelining and multiplexing. Set the
http.multiplexing
config value to enable. #6005 - Added
http.debug
configuration value to debug HTTP connections. UseCARGO_HTTP_DEBUG=true RUST_LOG=cargo::ops::registry cargo build
to display the debug information. #6166 CARGO_PKG_REPOSITORY
environment variable is set with the repository value fromCargo.toml
when building . #6096
Changed
cargo test --doc
now rejects other flags instead of ignoring them. #6037cargo install
ignores~/.cargo/config
. #6026cargo version --verbose
is now the same ascargo -vV
. #6076- Comments at the top of
Cargo.lock
are now preserved. #6181 - When building in "very verbose" mode (
cargo build -vv
), build script output is prefixed with the package name and version, such as[foo 0.0.1]
. #6164 - If
cargo fix --broken-code
fails to compile after fixes have been applied, the files are no longer reverted and are left in their broken state. #6316
Fixed
- Windows: Pass Ctrl-C to the process with
cargo run
. #6004 - macOS: Fix bash completion. #6038
- Support arbitrary toolchain names when completing
+toolchain
in bash completion. #6038 - Fixed edge cases in the resolver, when backtracking on failed dependencies. #5988
- Fixed
cargo test --all-targets
running lib tests three times. #6039 - Fixed publishing renamed dependencies to crates.io. #5993
- Fixed
cargo install
on a git repo with multiple binaries. #6060 - Fixed deeply nested JSON emitted by rustc being lost. #6081
- Windows: Fix locking msys terminals to 60 characters. #6122
- Fixed renamed dependencies with dashes. #6140
- Fixed linking against the wrong dylib when the dylib existed in both
target/debug
andtarget/debug/deps
. #6167 - Fixed some unnecessary recompiles when
panic=abort
is used. #6170
Nightly only
- Added
--registry
flag tocargo install
. #6128 - Added
registry.default
configuration value to specify the default registry to use if--registry
flag is not passed. #6135 - Added
--registry
flag tocargo new
andcargo init
. #6135
Cargo 1.30 (2018-10-25)
Added
- 🔥 Added an animated progress bar shows progress during building. #5995
- Added
resolve.nodes.deps
key tocargo metadata
, which includes more information about resolved dependencies, and properly handles renamed dependencies. #5871 - When creating a package, provide more detail with
-v
when failing to discover if files are dirty in a git repository. Also fix a problem with discovery on Windows. #5858 - Filters like
--bin
,--test
,--example
,--bench
, or--lib
can be used in a workspace without selecting a specific package. #5873 cargo run
can be used in a workspace without selecting a specific package. #5877cargo doc --message-format=json
now outputs JSON messages from rustdoc. #5878- Added
--message-format=short
to show one-line messages. #5879 - Added
.cargo_vcs_info.json
file to.crate
packages that captures the current git hash. #5886 - Added
net.git-fetch-with-cli
configuration option to use thegit
executable to fetch repositories instead of using the built-in libgit2 library. #5914 - Added
required-features
tocargo metadata
. #5902 cargo uninstall
within a package will now uninstall that package. #5927- Added
--allow-staged
flag tocargo fix
to allow it to run if files are staged in git. #5943 - Added
net.low-speed-limit
config value, and also honornet.timeout
for http operations. #5957 - Added
--edition
flag tocargo new
. #5984 - Temporarily stabilized 2018 edition support for the duration of the beta. #5984 #5989
- Added support for
target.'cfg(…)'.runner
config value to specify the run/test/bench runner for targets that use config expressions. #5959
Changed
- Windows:
cargo run
will not kill child processes when the main process exits. #5887 - Switched to the
opener
crate to open a web browser withcargo doc --open
. This should more reliably select the system-preferred browser on all platforms. #5888 - Equal file mtimes now cause a target to be rebuilt. Previously only if files were strictly newer than the last build would it cause a rebuild. #5919
- Ignore
build.target
config value when runningcargo install
. #5874 - Ignore
RUSTC_WRAPPER
forcargo fix
. #5983 - Ignore empty
RUSTC_WRAPPER
. #5985
Fixed
- Fixed error when creating a package with an edition field in
Cargo.toml
. #5908 - More consistently use relative paths for path dependencies in a workspace. #5935
cargo fix
now always runs, even if it was run previously. #5944- Windows: Attempt to more reliably detect terminal width. msys-based terminals are forced to 60 characters wide. #6010
- Allow multiple target flags with
cargo doc --document-private-items
. 6022