Changelog
Cargo 1.86 (2025-04-03)
Added
Changed
Fixed
- The rerun-if-env-changedbuild script instruction can now correctly detect changes in the[env]configuration table. #14756
- cargo-package: Verify the VCS status of symlinks when they point to paths outside the current package root. #14981
Nightly only
- cargo-util-schemas: Correct and update the JSON Schema #15000
Documentation
Internal
- cargo-test-macro: Remove condition on RUSTUP_WINDOWS_PATH_ADD_BIN#15017
- test: Clean up shallow fetch tests #15002
- test: Fix https::self_signed_should_failfor macos #15016
- Update to libgit2 1.9. #15018
- Update dependencies: update rust crate itertools to 0.14.0 #14996 #14998 #15012
Cargo 1.85 (2025-02-20)
Added
- 🎉 Cargo now supports the 2024 edition. More information is available in the edition guide. #14828
- cargo-tree: The --depthflag now acceptsworkspace, which shows only dependencies that are members of the current workspace. #14928
- Build scripts now receive a new environment variable, CARGO_CFG_FEATURE, which contains each activated feature of the package being built. #14902
- perf: Dependency resolution is now faster due to a more efficient hash for ActivationsKey#14915
Changed
- ❗️ cargo-rustc: Trailing flags now have higher precedence. This behavior was nightly-only since 1.83 and is now stabilized. #14900
- ❗️ Cargo now uses a cross-platform hash algorithm from rustc-stable-hash. As a result, the hash part of paths to dependency caches (e.g.,$CARGO_HOME/registry/index/index.crates.io-<hash>) will change. This will trigger re-downloads of registry indices and.cratetarballs, as well as re-cloning of Git dependencies. #14917
- Added a future-incompatibility warning for keywords in cfgs in Cargo.toml and Cargo configuration.cfgs with keywords likecfg(true)andcfg(false)were incorrectly accepted. For backward compatibility, support for raw identifiers has been introduced; for example, usecfg(r#true)instead. #14671
- Dependency resolution now provides richer error messages explaining why some versions were rejected, unmatched, or invalid.
 #14897 #14921 #14923 #14927
- cargo-doc: improve the error message when --opening a doc while no doc generated. #14969
- cargo-package: warn if symlinks checked out as plain text files #14994
- cargo-package: Shows dirty file paths relative to the Git working directory. #14968 #14970
Fixed
- Set GIT_DIRto ensure compatibility with bare repositories fornet.git-fetch-with-cli=true. #14860
- Fixed workspace Cargo.toml modification didn’t invalidate build cache. #14973
- Prevented build caches from being discarded after changes to RUSTFLAGS. #14830 #14898
- cargo-add: Don’t select yanked versions when normalizing names. #14895
- cargo-fix: Migrate workspace dependencies to the 2024 edition also for virtual manifests. #14890
- cargo-package: Verify the VCS status of package.readmeandpackage.license-filewhen they point to paths outside the current package root. #14966
- cargo-package: assure possibly blocking non-files (like FIFOs) won’t be picked up for publishing. #14977
Nightly only
- path-bases: Support bases in- [patch]es in virtual manifests #14931
- unit-graph: Use the configured shell to print output. #14926
- -Zbuild-std: Check if the build target supports- stdby probing the- metadata.stdfield in the target spec JSON. #14183 #14938 #14899
- -Zbuild-std: always link to std when testing proc-macros. #14850 #14861
- -Zbuild-std: clean up build-std tests #14943 #14933 #14896
- -Zbuild-std: Hash relative paths to std workspace instead of absolute paths. #14951
- -Zpackage-workspace: Allow dry-run of a non-bumped workspace. #14847
- -Zscript: Allow adding/removing dependencies from cargo scripts #14857
- -Zscript: Migrate cargo script manifests across editions #14864
- -Zscript: Don’t override the release profile. #14925
- -Ztrim-paths: Use- Path::pushto construct the- remap-path-prefixflag. #14908
Documentation
- Clarify how cargo::metadataenv var is selected. #14842
- cargo-info: Remove references to the default registry in cargo-infodocs #14880
- contrib: add missing argument to Rustup Cargo workaround #14954
- SemVer: Add section on RPIT capturing #14849
Internal
- Add the testcfg as a well known cfg before of compiler change. #14963
- Enable triagebot merge conflict notifications #14972
- Limit release trigger to 0.*tags #14940
- Simplify SourceIDHash. #14800
- build-rs: Automatically emits rerun-if-env-changedwhen accessing environment variables Cargo sets for build script executions. #14911
- build-rs: Correctly refer to the item in assert #14913
- build-rs: Add the ‘error’ directive #14910
- build-rs: Remove meaningless ‘cargo_cfg_debug_assertions’ #14901
- cargo-package: split cargo_packageto modules #14959 #14982
- cargo-test-support: requiresattribute accepts string literals for cmds #14875
- cargo-test-support: Switch from ‘exec_with_output’ to ‘run’ #14848
- cargo-test-support: track caller for .cratefile publish verification #14992
- test: Verify -Cmetadatadirectly, not through-Cextra-filename#14846
- test: ensure PGO works #14859 #14874 #14887
- Update dependencies. #14867 #14871 #14878 #14879 #14975
Cargo 1.84 (2025-01-09)
Added
- 🎉 Stabilize resolver v3, a.k.a the MSRV-aware dependency resolver.
The stabilization includes package.resolver = "3"in Cargo.toml, and the[resolver]table in Cargo configuration. (RFC 3537) (manifest docs) (config docs) #14639 #14662 #14711 #14725 #14748 #14753 #14754
- Added a new build script invocation cargo::error=MESSAGEto report error messages. (docs) #14743
Changed
- ❗️ cargo-publish: Always include Cargo.lock in published crates.
Originally it was only included for packages that have executables or examples
for use with cargo install. #14815
- Dependency resolver performance improvements, including shared caching, reduced iteration overhead, and removing redundant fetches and clones. #14663 #14690 #14692 #14694
- Deprecate cargo verify-project. #14736
- Add source replacement info when no matching package found during dependency resolving. #14715
- Hint for using crates-iowhen[patch.crates.io]found. #14700
- Normalize source paths of Cargo targets for better diagnostics. #14497 #14750
- Allow registries to omit empty/default fields in index metadata JSON. Due to backward compatibility, crates.io continues to emit them. #14838 #14839
- cargo-doc: display env vars in extra verbose mode. #14812
- cargo-fix: replace special-case handling of duplicate insert-only replacement. #14765 #14782
- cargo-remove: when a dependency is not found, try suggesting other dependencies with similar names. #14818
- git: skip unnecessary submodule validations for fresh checkouts on Git dependencies. #14605
- git: Enhanced the error message for fetching Git dependencies when refspec not found. #14806
- git: Pass --no-tagsby default to git CLI whennet.git-fetch-with-cli = true. #14688
Fixed
- Fixed old Cargos failing to read the newer format of dep-info in build caches. #14751 #14745
- Fixed rebuild detection not respecting changes in the [env]table. #14701 #14730
- cargo-fix: Added transactional semantics to rustfixto keep code fix in a valid state when multiple suggestions contain overlapping spans. #14747
Nightly only
- The unstable environment variable CARGO_RUSTC_CURRENT_DIRhas been removed. #14799
- 🔥 Cargo now includes an experimental JSON Schema file for Cargo.tomlin the source code. It helps external tools validate or auto-complete the schema of the manifest. (manifest.schema.json) #14683
- 🔥 Zroot-dir: A new unstable-Zroot-dirflag to configure the path from which rustc should be invoked. (docs) #14752
- 🔥 -Zwarnings: A new unstable feature to control how Cargo handles warnings via thebuild.warningsconfiguration field. (docs) #14388 #14827 #14836
- edition2024: Verify 2024 edition / resolver=3 doesn’t affect resolution #14724
- native-completions: Include descriptions in zsh #14726
- -Zbindeps: Fix panic when running cargo tree on a package with a cross compiled bindep #14593
- -Zbindeps: download targeted transitive deps of with artifact deps’ target platform #14723
- -Zbuild-std: Remove the requirement for- --target. #14317
- -Zpackage-workspace: Support package selection options, such as- --exclude, in- cargo publish#14659
- -Zscript: Remove support for accepting- Cargo.toml. #14670
- -Zscript: Change config paths to only check- CARGO_HOME#14749
- -Zscript: Update the frontmatter parser for RFC 3503. #14792
Documentation
- Clarify the meaning of --testsand--benchesflags. #14675
- Clarify tools should only interpret messages with a line starting with {as JSON. #14677
- Clarify what is and isn’t included by cargo package#14684
- Document official external commands: cargo-clippy,cargo-fmt, andcargo-miri. #14669 #14805
- Enhance documentation on environment variables #14676
- Simplify English used in documentations. #14825 #14829
- A new doc page for deprecated and removed commands. #14739
- cargo-test-support: Document Execsassertions based on port effort #14793
Internal
- 🎉 Migrate build-rscrate to therust-lang/cargorepository as an intentional artifact of the Cargo team. #14786 #14817
- Enable transfer feature in triagebot #14777
- clone-on-write when needed for InternedString #14808
- ci: Switch CI from bors to merge queue #14718
- ci: make the lint-docsjob required #14797
- ci: Check for clippy correctness#14796
- ci: Switch matchPackageNames to matchDepNames for renovate #14704
- fingerprint: Track the intent for each use of UnitHash#14826
- fingerprint: Add more metadata to rustc_fingerprint. #14761
- test: Migrate remaining snapshotting to snapbox #14642 #14760 #14781 #14785 #14790
- Update dependencies. #14668 #14705 #14762 #14766 #14772
Cargo 1.83 (2024-11-28)
Added
- --timingsHTML output can now auto-switch between light and dark color schemes based on browser preference. #14588
- Introduced a new CARGO_MANIFEST_PATHenvironment variable, similar toCARGO_MANIFEST_DIRbut pointing directly to the manifest file. #14404
- manifest: Added package.autolib, allowing[lib]auto-discovery to be disabled. #14591
Changed
- ❗️ Lockfile format v4 is now the default for creating/updating a lockfile.
Rust toolchains 1.78+ support lockfile v4.
For compatibility with earlier MSRV,
consdier setting the package.rust-versionto 1.82 or earlier. #14595
- ❗️ cargo-package: When using the --packageflag, only the specified packages are packaged. Previously, the package in the current working directory was automatically selected for packaging. #14488
- cargo-publish: Now fails fast if the package version is already published. #14448
- Improved error messages for missing features. #14436
- Log details of rustcinvocation failure if no errors are seen #14453
- Uplifted windows-gnullvmimport libraries, aligning them withwindows-gnu. #14451
- Suggest cargo infocommand in thecargo searchresult #14537
- Enhanced dependency update status messages, now displaying updates (compatible, incompatible, direct-dep) in different colors, along with messages and MSRVs. #14440 #14457 #14459 #14461 #14471 #14568
- The Lockingstatus message no longer displays workspace members. #14445
Fixed
- Prevented duplicate library search environment variables when calling cargorecursively. #14464
- Don’t double-warn about $CARGO_HOME/confignot having.tomlextension. #14579
- Correct diagnostic count message when using --message-format json. #14598
- cargo-add: Perform fuzzy searches when translating package names #13765
- cargo-new: only auto-add new packages to the workspace relative to the manifest, rather than the current directory. #14505
- cargo-rustc: Fixed parsing of comma-separated values in the --crate-typeflag. #14499
- cargo-vendor: trusts the crate version only when it originates from registries. This causes git dependencies to be re-vendored even if they haven’t changed. #14530
- cargo-publish: Downgrade version-exists error to warning on dry-run #14742 #14744
Nightly only
- ❗️ cargo-rustc: give trailing flags higher precedence on nightly.
The nightly gate will be removed after a few releases.
Please give feedback if it breaks any workflow.
A temporary environment variable __CARGO_RUSTC_ORIG_ARGS_PRIO=1is provided to opt-out of the behavior. #14587
- 🔥 cargo-install: a new --dry-runflag without actually installing binaries. #14280
- 🔥 native-completions: moves the handwritten shell completion scripts to Rust native, making it easier for us to add, extend, and test new completions. (docs) #14493 #14531 #14532 #14533 #14534 #14535 #14536 #14546 #14547 #14548 #14552 #14557 #14558 #14563 #14564 #14573 #14590 #14592 #14653 #14656
- 🔥 -Zchecksum-freshness: replace the use of file mtimes in cargo’s rebuild detection with a file checksum algorithm. This is most useful on systems with a poor mtime implementation, or in CI/CD. (docs) #14137
- cargo-update: Add matches_prereleasesemantic #14305
- build-plan: document it as being deprecated. #14657
- edition2024: Remove implicit feature removal from 2024 edition. #14630
- lockfile-path: implies- --lockedon- cargo install. #14556
- open-namespaces: Allow open namespaces in- PackageIdSpecs #14467
- path-bases:- cargo [add|remove|update]support #14427
- -Zmsrv-policy: determine the workspace’s MSRV by the most number of MSRVs within it. #14569
- -Zpackage-workspace: allows to publish multiple crates in a workspace, even if they have inter-dependencies. (docs) #14433 #14496
- -Zpublic-dependency: Include public/private dependency status in- cargo metadata#14504
- -Zpublic-dependency: Don’t require MSRV bump #14507
Documentation
- 🎉 New chapter about the uses, support expectations, and management of
package.rust-versiona.k.a MSRV. (docs) #14619 #14636
- Clarify target.'cfg(...)'doesn’t respect cfg from build script #14312
- Clarify [[bin]]target auto-discovery can besrc/main.rsand/or insrc/bin/#14515
- Disambiguate the use of ‘target’ in the feature resolver v2 doc. #14540
- Make --config <PATH>more prominent #14631
- Minor re-grouping of pages. #14620
- contrib: Update docs for how cargo is published #14539
- contrib: Declare support level for each crate in Cargo’s Charter / crate docs #14600
- contrib: Declare new Intentional Artifacts as ‘small’ changes #14599
Internal
- Cleanup duplicated check-cfg lint logic #14567
- Fix elided lifetime due to nightly rustc changes #14487
- Improved error reporting when a feature is not found in activated_features. #14647
- cargo-info: Use the shell.noteto print the note #14554
- ci: bump CI tools #14503 #14628
- perf: zero-copy deserialization for compiler messages when possible #14608
- resolver: Add more SAT resolver tests #14583 #14614
- test: Migrated more tests to snapbox #14576 #14577
- Update dependencies. #14475 #14478 #14489 #14607 #14624 #14632
Cargo 1.82 (2024-10-17)
Added
Changed
- ❗️ Doctest respects Cargo’s color options by passing --colorto rustdoc invocations. #14425
- Improved error message for missing both [package]and[workspace]in Cargo.toml. #14261
- Enumerate all possible values of profile.*.debugfor the error message. #14413
Fixed
- Use longhand gitoxide path-spec patterns. Previously the implementation used
shorthand pathspecs, which could produce invalid syntax, for example, if the
path to the manifest file contained a leading _underscore #14380
- cargo-package: fix failures on bare commit git repo. #14359
- cargo-publish: Don’t strip non-dev features for renamed dependencies from the HTTP JSON body sent to the registry. The bug only affected third-party registries. #14325 #14327
- cargo-vendor: don’t copy source files of excluded Cargo targets when vendoring. #14367
Nightly only
- 🔥 lockfile-path: Added--lockfile-pathflag that allows specifying a path to the lockfile other than the default path<workspace_root>/Cargo.lock. (docs) #14326 #14417 #14423 #14424
- 🔥 path-bases: Introduced a table of path “bases” in Cargo configuration files that can be used to prefix the paths of path dependencies and patch entries. (RFC 3529) (docs) #14360
- 🔥 -Zpackage-workspace: Enhanced the experience ofcargo package --workspacewhen there are dependencies between crates in the workspace. Crates in a workspace are no longer required to publish to actual registries. This is a step toward supportingcargo publish --workspace. #13947 #14408 #14340
- cargo-update: Limit pre-release match semantics to use only on OptVersionReq::Req#14412
- edition2024: Revert “fix: Ensure dep/feature activates the dependency on 2024”. #14295
- update-breaking: Improved error message when- update --breakinghas an invalid spec #14279
- update-breaking: Don’t downgrade on prerelease- VersionReqwhen updating with- --breaking#14250
- -Zbuild-std: remove hack on creating virtual std workspace #14358 #14370
- -Zmsrv-policy: Adjust MSRV resolve config field name / values. The previous placeholder- resolver.something-like-precedenceis now renamed to- resolver.incompatible-rust-versions. #14296
- -Zmsrv-policy: : Report when incompatible-rust-version packages are selected #14401
- -Ztarget-applies-to-host: Fixed passing of links-overrides with target-applies-to-host and an implicit target #14205
- -Ztarget-applies-to-host:- -Cmetadataincludes whether extra rustflags is same as host #14432
- -Ztrim-paths: rustdoc supports trim-paths for diagnostics #14389
Documentation
- Convert comments to doc comments for Workspace. #14397
- Fix MSRV indicator for workspace.packageandworkspace.dependencies. #14400
- FAQ: remove outdated Cargo offline usage section. #14336
Internal
- Enhanced cargo-test-supportusability and documentation. #14266 #14268 #14269 #14270 #14272
- Made summary sync by using Arc instead of Rc #14260
- Used Rcinstead ofArcfor storing rustflags #14273
- Removed rustc probe for --check-cfgsupport #14302
- Renamed ‘resolved’ to ‘normalized’ for all manifest normalization related items. #14342
- cargo-util-schemas: Added TomlPackage::new,DefaultforTomlWorkspace#14271
- ci: Switch macos aarch64 to nightly #14382
- mdman: Normalize newlines when rendering options #14428
- perf: dont call wrap in a no-op source_id::with*#14318
- test: Migrated more tests to snapbox #14242 #14244 #14293 #14297 #14319 #14402 #14410
- test: don’t rely on absence of RUST_BACKTRACE#14441
- test: Use gmake on AIX #14323
- Updated to gix0.64.0 #14332
- Updated to rusqlite0.32.0 #14334
- Updated to windows-sys0.59 #14335
- Update dependencies. #14299 #14303 #14324 #14329 #14331 #14391
Cargo 1.81 (2024-09-05)
Added
Changed
- ❗️ cargo-package: Disallow package.license-fileandpackage.readmepointing to non-existent files during packaging. #13921
- ❗️ cargo-package: generated .cargo_vcs_info.jsonis always included, even when--allow-dirtyis passed. #13960
- ❗️ Disallow passing --release/--debugflag along with the--profileflag. #13971
- ❗️ Remove lib.pluginkey support in Cargo.toml. Rust plugin support has been deprecated for four years and was removed in 1.75.0. #13902 #14038
- Make the calculation of -Cmetadatafor rustc consistent across platforms. #14107
- Emit a warning when editionis unset, even when MSRV is unset. #14110
Fixed
- Fix a proc-macro example from a dependency affecting feature resolution. #13892
- Don’t warn on duplicate packages from using ‘..’. #14234
- Don’t duon every git source load. #14252
- Don’t warn about unreferenced duplicate packages #14239
- cargo-publish: Don’t strip non-dev features for renamed dependencies from the HTTP JSON body sent to the registry. The bug only affected third-party registries. #14328
- cargo-vendor: don’t copy source files of excluded Cargo targets when vendoring. #14368
Nightly only
- 🔥 update-breaking: Add--breakingtocargo update, allowing upgrading dependencies to breaking versions. docs #13979 #14047 #14049
- --artifact-dir: Rename- --out-dirto- --artifact-dir. The- --out-dirflag is kept for compatibility and may be removed when the feature gets stabilized. #13809
- edition2024: Ensure unused optional dependencies fire for shadowed dependencies. #14028
- edition2024: Address problems with implicit -> explicit feature migration #14018
- -Zcargo-lints: Add- unknown_lintsto lints list. #14024
- -Zcargo-lints: Add tooling to document lints. #14025
- -Zcargo-lints: Keep lints updated and sorted. #14030
- -Zconfig-include: Allow enabling- config-includefeature in config. #14196
- -Zpublic-dependency: remove some legacy public dependency code from the resolver #14090
- -Ztarget-applies-to-host: Pass rustflags to artifacts built with implicit targets when using target-applies-to-host #13900 #14201
- cargo-update: Track the behavior of --precise <prerelease>. #14013
Documentation
- Clarify CARGO_CFG_TARGET_FAMILYis multi-valued. #14165
- Document CARGO_CFG_TARGET_ABI#14164
- Document MSRV for each manifest field and build script invocations. #14224
- Remove duplicate stripsection. #14146
- Update summary of Cargo configuration to include missing keys. #14145
- Update index of Cargo documentation. #14228
- Don’t mention non-existent workspace.badgesfield. #14042
- contrib: Suggest atomic commits with separate test commits. #14014
- contrib: Document how to write an RFC for Cargo. #14222
- contrib: Improve triage instructions #14052
Internal
- cargo-package: Change verification order during packaging. #14074
- ci: Add workflow to publish Cargo automatically #14202
- ci: bump CI tools #14062 #14257
- registry: Add local registry overlays. #13926
- registry: move get_source_idout of registry #14218
- resolver: Simplify checking for dependency cycles #14089
- rustfix: Add CodeFix::apply_solutionand implClone#14092
- source: Clean up after PathSource/RecursivePathSourcesplit #14169 #14231
- Remove the temporary __CARGO_GITOXIDE_DISABLE_LIST_FILESenvironment variable. #14036
- Simplify checking feature syntax #14106
- Dont make new constant InternedStringin hot path #14211
- Use std::fs::absoluteinstead of reimplementing it #14075
- Remove unecessary feature activations from cargo. #14122 #14160
- Revert #13630 as rustc ignores -C stripon MSVC. #14061
- test: Allow unexpected_builtin_cfgslint inuser_specific_cfgstest #14153
- test: Add cargo_test to test-support prelude #14243
- test: migrate Cargo testsuite to snapbox. For the complete list of migration pull requests, see #14039
- Updated to gix0.64.0 #14431
- Update dependencies. #13995 #13998 #14037 #14063 #14067 #14174 #14186 #14254
Cargo 1.80 (2024-07-25)
Added
- 
🎉 Stabilize -Zcheck-cfg! This by default enables rustc’s checking of conditional compilation at compile time, which verifies that the crate is correctly handling conditional compilation for different target platforms or features. Internally, cargo will be passing a new command line option--check-cfgto all rustc and rustdoc invocations.A new build script invocation cargo::rustc-check-cfg=CHECK_CFGis added along with this stabilization, as a way to add custom cfgs to the list of expected cfg names and values.If a build script is not an option for your package, Cargo provides a config [lints.rust.unexpected_cfgs.check-cfg]to add known custom cfgs statically.(RFC 3013) (docs) #13571 #13865 #13869 #13884 #13913 #13937 #13958 
- 
🎉 cargo-update: Allows --preciseto specify a yanked version of a package, and will update the lockfile accordingly. #13974
Changed
- ❗️ manifest: Disallow [badges]to inherit from[workspace.package.badges]. This was considered a bug. Keep in mind that[badges]is effectively deprecated. #13788
- build-script: Suggest old syntax based on MSRV. #13874
- cargo-add: Avoid escaping double quotes by using string literals. #14006
- cargo-clean: Performance improvements for cleaning specific packages via -pflag. #13818
- cargo-new: Use i32rather thanusizeas the “default integer” in library template. #13939
- cargo-package: Warn, rather than fail, if a Cargo target is excluded during packaging. #13713
- manifest: Warn, not error, on unsupported lint tool in the [lints]table. #13833
- perf: Avoid inferring when Cargo targets are known. #13849
- Populate git information when building Cargo from Rust’s source tarball. #13832
- Improve the error message when deserializing Cargo configuration from partial environment variables. #13956
Fixed
- resolver: Make path dependencies with the same name stay locked. #13572
- cargo-add: Preserve file permissions on Unix during write_atomic. #13898
- cargo-clean: Remove symlink directory on Windows. #13910
- cargo-fix: Don’t fix into the standard library. #13792
- cargo-fix: Support IPv6-only networks. #13907
- cargo-new: Don’t say we’re adding to a workspace when a regular package is in the root. #13987
- cargo-vendor: Silence the warning about forgetting the vendoring. #13886
- cargo-publish/cargo-vendor: Ensure targets in generated Cargo.toml are in a deterministic order. #13989 #14004
- cargo-credential-libsecret: Load libsecretby itsSONAME,libsecret-1.so.0. #13927
- Don’t panic when an alias doesn’t include a subcommand. #13819
- Workaround copying file returning EAGAIN on ZFS on macOS. #13845
- Fetch specific commits even if the GitHub fast path fails. #13946 #13969
- Distinguish Cargo config from different environment variables that share the same prefix. #14000
Nightly only
- -Zcargo-lints: Don’t always inherit workspace lints. #13812
- -Zcargo-lints: Add a test to ensure cap-lints works. #13829
- -Zcargo-lints: Error when unstable lints are specified but not enabled. #13805
- -Zcargo-lints: Add cargo-lints to unstable docs. #13881
- -Zcargo-lints: Refactor cargo lint tests. #13880
- -Zcargo-lints: Remove ability to specify- -in lint name. #13837
- -Zscript: Remove unstable rejected frontmatter syntax for cargo script. The only allowed frontmatter syntax now is- ---. #13861 #13893
- -Zbindeps: Build only the specified artifact library when multiple types are available. #13842
- -Zmsrv-policy: Treat unset MSRV as compatible. #13791
- -Zgit/- -Zgitoxide: Default configuration to be obtained from both environment variables and Cargo configuration. #13687
- -Zpublic-dependency: Don’t lose ‘public’ when inheriting a dependency. #13836
- edition2024: Disallow ignored- default-featureswhen inheriting. #13839
- edition2024: Validate crate-types/proc-macro for bin like other Cargo targets. #13841
Documentation
- cargo-package: Clarify no guarantee of VCS provenance. #13984
- cargo-metadata: Clarify dash replacement rule in Cargo target names. #13887
- config: Fix wrong type of rustc-flagsin build script overrides. #13957
- resolver: Add README for resolver-tests. #13977
- contrib: Update UI example code in contributor guide. #13864
- Fix libcurl proxy documentation link. #13990
- Add missing CARGO_MAKEFLAGSenv for plugins. #13872
- Include CircleCI reference in the Continuous Integration chapter. #13850
Internal
- ci: Don’t check cargoagainst beta channel. #13827
- test: Set safe.directory for git repo in apache container. #13920
- test: Silence warnings running embedded unittests. #13929
- test: Update test formatting due to nightly rustc changes. #13890 #13901 #13964
- test: Make git::use_the_clitest truly locale independent. #13935
- cargo-test-support: Transition direct assertions from cargo-test-support to snapbox. #13980
- cargo-test-support: Auto-redact elapsed time. #13973
- cargo-test-support: Clean up unnecessary uses of match_exact. #13879
- Split RecursivePathSourceout ofPathSource. #13993
- Adjust custom errors from cert-check due to libgit2 1.8 change. #13970
- Move diagnostic printing to Shell. #13813
- Update dependencies. #13834 #13840 #13948 #13963 #13976
Cargo 1.79 (2024-06-13)
Added
- 🎉 cargo addrespectspackage.rust-versiona.k.a. MSRV when adding new dependencies. The behavior can be overridden by specifying a version requirement, or passing the--ignore-rust-versionflag. (RFC 3537) #13608
- A new Lockingstatus 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 -vVinvocation 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.nameis inferred frompackage.name. This change aligns to the documented behavior. One caveat is that JSON messages emitted by Cargo, like viacargo metadataor--message-format=json, will start reporting underscore lib names. #12783
- Switch to gitoxidefor listing files. This improves the performance of build script andcargo docfor computing cache freshness, as well as fixes some subtle bugs forcargo publish. #13592 #13696 #13704 #13777
- Warn on -Zlintsbeing passed and no longer necessary. #13632
- Warn on unused workspace.dependencieskeys on virtual workspaces. #13664
- Emit 1.77 build script syntax error only when msrv is incompatible. #13808
- Don’t warn on lints.rust.unexpected_cfgs.check-cfg. #13925
- cargo-init: don’t assign target.namein 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 --docflag under “Target Selection”. #13756
Fixed
- Ensure --config net.git-fetch-with-cli=trueis respected. #13992 #13997
- 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
- 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 nounsetmode. #13686
- Rerun build script when rustflags changed and --targetwas passed. #13560
- Fix doc collision for lib/bin with a dash in the inferred name. #13640
- 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 --packagecannot be found #13735
- credential-provider: trim newlines in tokens from stdin. #13770
Nightly only
- 🔥 cargo-update: allows --preciseto 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 #13852 #13853
- 🔥 edition2024: Add default Edition2024 to resolver v3 (MSRV-aware resolver). #13785
- edition2024: Remove underscore field support in 2024. #13783 #13798 #13800 #13804
- edition2024: Error on- [project]in Edition 2024 #13747
- -Zmsrv-policy: Respect ‘–ignore-rust-version’ #13738
- -Zmsrv-policy: Add- --ignore-rust-versionto 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 --lockedensuring that Cargo uses dependency versions in lockfile #13665
- Clarify the precedence of  RUSTC_WORKSPACE_WRAPPERandRUSTC_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-supportandcargo-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 #13950
Cargo 1.78 (2024-05-02)
Added
- Stabilize global cache data tracking. The -Zgcflag 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.unicodeis added to control the behavior manually. docs #13337
- Support target.<triple>.rustdocflagsin 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 Generatedstatuses 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/configfiles. #13349
- Don’t print rustdoc command lines on failure by default #13387
- Respect package.rust-versionwhen generating new lockfiles. #12861
- Send User-Agent: cargo/1.2.3header when communicating with remote registries. Previously it wascargo 1.2.3, which didn’t follow the HTTP specifications. #13548
- Emit a warning when package.editionfield 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 Finishedstatus 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.membersif 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_COLORin ‘–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 --preciseto specify a yanked version of a package #13333
- -Zcheck-cfg: Add- docsrscfg as a well known- --check-cfg#13383
- -Zcheck-cfg: Silently ignore- cargo::rustc-check-cfgto avoid MSRV annoyance when stabilizing- -Zcheck-cfg. #13438
- -Zmsrv-policy: Fallback to- rustc -vwhen 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-dependencyflag. #13340 #13556 #13547
- -Zpublic-dependency: test for packaging a public dependency #13536
- -Zrustdoc-map: Add all unit’s children recursively for- doc.extern-mapoption #13481 #13544
- edition2024: Enable edition migration for 2024. #13429
- open-namespaces: basic support for open namespaces (RFC 3243) (docs) #13591
Documentation
- cargo-fetch: hide cargo-fetchrecursive link in--offlineman page. #13364
- cargo-install: --listoption 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 versionfield in[package]is optional in Cargo.toml #13390
- Improve “Registry Authentication” docs #13351
- Improve “Specifying Dependencies” docs #13341
- Remove package.documentationfrom the “before publishing” list. #13398
Internal
- 🎉 Integrated tracing-chrome as a basic profiler for Cargo itself. docs #13399 #13551
- Updated to gix0.58.0 #13380
- Updated to git20.18.2 #13412
- Updated to jobserver0.1.28 #13419
- Updated to supports-hyperlinks3.0.0 #13511
- Updated to rusqlite0.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 anstyleAPI #13368 #13562
- fingerprint: remove unnecessary Option in Freshness::Dirty#13361
- fingerprint: abstract std::fsaway from on-disk index cache #13515
- mdman: Updated to pulldown-cmark0.10.0 #13517
- refactor: Renamed ConfigtoGlobalContext#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 snapbox0.5.0 #13441
- test: Verify terminal styling via snapbox’s term-svgfeature. #13461 #13465 #13520
- test: Ensure nonzero_exit_codetest isn’t affected by developersRUST_BACKTRACEsetting #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/-pflag,cargo pkgid,cargo metadata, and JSON messages from--message-format=json. #12914 #13202 #13311 #13298 #13322
- Add colors to -Zhelpconsole output #13269
- build script: Extend the build directive syntax with cargo::. #12201 #13212
Changed
- 🎉 Disabling debuginfo now implies strip = "debuginfo"(whenstripis 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 rustcstyle 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/jsononly for requests with a body payload #13264
Fixed
- jobserver: inherit jobserver from env for all kinds of runner #12776
- build script: Set OUT_DIRfor 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: --preciseaccepts 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-formatoption tocargo rustdoc, providing tools with a way to lean on rustdoc’s experimental JSON format. docs #12252 #13284 #13325
- -Zcheck-cfg: Rework- --check-cfggeneration comment #13195
- -Zcheck-cfg: Go back to passing an empty- values()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 a- publicfield. #13245
- -Zpublic-dependency: help text of- --public/- --no-publicflags for- cargo 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 dufunction 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 --pathis 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 onserdeandFromStrfor 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 gix0.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 handlebars5.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.exefor 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=devor?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-hashoption. #12968
- Displays error count with a number, even when there is only one error. #12484
- all-staticfeature now includes- vendored-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 --quietbeing 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--packageflag if it’s a valid pkgid spec. #13315 #13318
- cargo-package: Only filter out targetdirectory 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 --accountargument toop signincommand. #12985 #12986
Nightly only
- 🔥 The -Zgcflag enables garbage collection for deleting old, unused files in cargo’s cache. That is, downloaded source files and registry index under theCARGO_HOMEdirectory. 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-cfginvocations with zero features. #13011
- -Ztrim-paths: reorder- --remap-path-prefixflags for- -Zbuild-std. #13065
- -Ztrim-paths: explicitly remap current dir by using- .. #13114
- -Ztrim-paths: exercise with real world debugger. #13091 #13118
- -Zpublic-dependency: Limit- exported-private-dependencieslints to libraries. #13135
- -Zpublic-dependency: Disallow workspace-inheriting of dependency public status. #13125
- -Zpublic-dependency: Add- --publicfor- cargo 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 searchcan 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 rustfixcrate to therust-lang/cargorepository. #13005 #13042 #13047 #13048 #13050
- Updated to curl-sys0.4.70, which corresponds to curl 8.4.0. #13147
- Updated to gix-index0.27.1. #13148
- Updated to itertools0.12.0. #13086
- Updated to rusqlite0.30.0. #13087
- Updated to toml_edit0.21.0. #13088
- Updated to windows-sys0.52.0. #13089
- Updated to tracing0.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 -Zlintstable feature. #12178
- Refactored Cargo.tomlparsing code in preparation of extracting an official schema API. #12954 #12960 #12961 #12971 #13000 #13021 #13080 #13097 #13123 #13128 #13154 #13166
- Use IndexSummaryinquery{_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 homeagainst 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 optionalstests #13108
- test: Remove the deleted feature test_2018_featurefrom 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.versionfield in- Cargo.tomlis now optional and defaults to- 0.0.0. Packages without the- package.versionfield cannot be published. #12786
- Links in --timingsandcargo docoutputs are clickable on supported terminals, controllable throughterm.hyperlinksconfig 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 Generatedstatus 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 --testflag 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 searchwhencargo-<command>cannot be found. #12840
- Do not allow empty feature name. #12928
- Added unsupported short flag suggestion for --targetand--excludeflags. #12805
- Added unsupported short flag suggestion for --out-dirflag. #12755
- Added unsupported lowercase -zflag suggestion for-Zflag. #12788
- Added better suggestion for unsupported --pathflag. #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 Edition2024unstable feature. docs #12771
- 🔥 The -Ztrim-pathsfeature 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-cfgwarnings. #12884
- public-dependency: Support- publicdependency configuration with workspace deps. #12817
Documentation
- profile: add missing stripinfo. #12754
- features: a note about the new limit on number of features. #12913
- crates-io: Add doc comment for NewCratestruct. #12782
- resolver: Highlight commands to answer dep resolution questions. #12903
- cargo-bench: --benchis 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 ANDsearch 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 itertools0.11.0. #12759
- Updated to cargo_metadata0.18.0. #12758
- Updated to curl-sys0.4.68, which corresponds to curl 8.4.0. #12808
- Updated to toml0.8.2. #12760
- Updated to toml_edit0.20.2. #12761
- Updated to gixto 0.55.2 #12906
- Disabled the custom_target::custom_bin_targettest on windows-gnu. #12763
- Refactored Cargo.tomlparsing 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 PackageIDSpecsyntax #12938
- resolver: Consolidate logic in VersionPreferences#12930
- Make the SourceId::precisefield 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/checkoutaction 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-processandregistry-authhave 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-requiredfield 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-goingflag has been stabilized and is now available in each build command (exceptbenchandtest, which have--no-fail-fastinstead). (docs) #12568
- Added --dry-runflag and summary line at the end forcargo clean. #12638
- Added a short alias -nfor 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 --docis mixed with-p. #12637
- ❗ cargo-new / cargo-init no longer exclude Cargo.lockin VCS ignore files for libraries. #12382
- cargo-update: silently deprecate --aggressivein favor of the new--recursive. #12544
- cargo-update: -p/--packagecan be used as a positional argument. #12545 #12586
- cargo-install: suggest --gitwhen the package name looks like a URL. #12575
- cargo-add: summarize the feature list when it’s too long. #12662 #12702
- Shell completion for --targetuses rustup but falls back to rustc. #12606
- Help users know possible --targetvalues. #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 --helpoutput. #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.lockinto 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 versionworks forgitdependencies. #12270
- Clarify and differentiate defaults for split-debuginfo. #12680
- Added missing stripentries indevandreleaseprofiles. #12748
Internal
- Updated to curl-sys0.4.66, which corresponds to curl 8.3.0. #12718
- Updated to gitoxide0.54.1. #12731
- Updated to git20.18.0, which corresponds to libgit2 1.7.1. #12580
- Updated to cargo_metadata0.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 networkfor networking messages. #12582
- cargo-test-support: Add with_stdout_unordered. #12635
- dep: Switch from termcolortoanstream. #12751
- Put Sourcetrait undercargo::sources. #12527
- SourceId: merge nameandalt_registry_keyinto one enum. #12675
- TomlManifest: fail when package_root is not a directory. #12722
- util: enhanced doc of network::retrydoc. #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_LOGinternal 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 --precisein 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/testin 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 loginno 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 --helpeasier to browse. #11905
- Prompt the use of --nocaptureflag ifcargo testprocess is terminated via a signal. #12463
- Preserve jobserver file descriptors on the rustc invocation for getting target information. #12447
- Clarify in --helpthatcargo test --all-targetsexcludes doctests. #12422
- Normalize cargo.tomltoCargo.tomlon publish, and warn on other cases ofCargo.toml. #12399
Fixed
- Only skip mtime check on ~/.cargo/{git,registry}. #12369
- Fixed cargo doc --opencrash on WSL2. #12373
- Fixed panic when enabling http.debugfor certain strings. #12468
- Fixed cargo removeincorrectly 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-processhas 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-processtocredential-providerin 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-authtocredential-process.
 
- Renamed 
- ❗️ Removed --keep-goingflag support fromcargo testandcargo bench. #12478 #12492
- Fixed invalid package names generated by -Zscript. #12349
- -Zscriptnow errors out on unsupported commands —- publishand- package. #12350
- Encode URL params correctly for source ID in Cargo.lock. #12280
- Replaced invalid panic_unwindstd 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 metadataare opaque strings. #12313
- Clarify that rerun-if-env-changeddoesn’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 ltosetting passing-Clinker-plugin-lto. #12407
- Added profile.stripto configuration and environment variable docs. #12337 #12408
- Added docs for artifact JSON debuginfo levels. #12376
- Added a notice for the backward compatible .cargo/credentialfile existence. #12479
- Raised the awareness of resolver = 2used inside workspaces. #12388
- Replaced masterbranch by default branch in documentation. #12435
Internal
- Updated to criterion0.5.1. #12338
- Updated to curl-sys0.4.65, which corresponds to curl 8.2.1. #12406
- Updated to indexmapv2. #12368
- Updated to miow0.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-checkfor respecting semver by adoptingcargo-semver-checks. #12395 #12513 #12508
- Rearranged and renamed test directories #12397 #12398
- Migrated from logtotracing. #12458 #12488
- Track --helpoutput in tests. #11912
- Cleaned up and shared package metadata within workspace. #12352
- crates-io: expose HTTP headers and- Errortype. #12310
- For cargo update, caught CLI flags conflict between--aggressiveand--precisein 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-workspaceby 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.jobsparallelism 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.resolveris 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=0to rustc as it is the default value. #12022 #12205
- Added a message on reusing previous temporary path on cargo installfailures. #12231
- Added a message when rustupoverride shorthand is put in a wrong position. #12226
- Respect scp-like URL as much as possible when fetching nested submodules. #12359 #12411
Fixed
- cargo cleanuses- remove_dir_allas 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 -Zscriptis 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-rustcagain. #12285
- Added .tomlfile extension restriction for-Zconfig-include. #12298
- Added -Znext-lockfile-bumpto prepare for the next lockfile bump. #12279 #12302
Documentation
- Added a description of Cargo.lockconflicts 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::sourcesmodule. #12192 #12239 #12247
- Added more documentation for Sourcedownload 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 mainby default. #12251
- Provide guidance on version requirements. #12323
Internal
- Updated to gix0.45 for multi-round pack negotiations. #12236
- Updated to curl-sys0.4.63, which corresponds to curl 8.1.2. #12218
- Updated to openssl0.10.55. #12300
- Updated several dependencies. #12261
- Removed unused features from windows-sysdependency. #12176
- Refactored compiler invocations. #12211
- Refactored git and registry sources, and registry data. #12203 #12197 #12240 #12248
- Lexicographically order -Zflags. #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 OnceLockfor interning uses. #12217
- Removed a unnecessary .clone. #12213
- Don’t try to compile cargo-credential-gnome-secreton 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_membersto 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 runrustcpointing 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_HOMEandRUSTUP_TOOLCHAINin 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
- --helptext is now wrapping for readability on narrow screens. #12013
- Tweaked the order of arguments in --helptext to clarify role of--bin. #12157
- rust-versionis included in- cargo publishrequests 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 debuginfonot passed in some situation, leading to build cache miss. #12165
- Fixed the ambiguity when cargo installfound 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 packagechecks for conflict files. #12135
- Fixed dep/featsyntax not working when co-exist withdep:syntax, and trying to enable features of an optional dependency. #12130
- Fixed cargo treenot handling the output with-e no-proc-macrocorrectly. #12044
- Warn instead of error in cargo packageon emptyreadmeorlicense-filein 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 -Zgitoxidefeature now supports shallow clones and fetches for dependencies and registry indexes. docs #11840
- 🔥 The -Zlintsfeature enables configuring lints rules in Cargo.toml docs #12148 #12168
- The -Zbuild-stdbreakage of missing features innightly-2023-05-04has been fixed innightly-2023-05-05. #12088
- Recompile on profile rustflags changes. #11981
- Added -Zmsrv-policyfeature flag placeholder. #12043
- cargo addnow considers- rust-versionwhen 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_versionin Index format. #12040
- Specify msgin owner-remove registry API response. #12068
- Added more documentation for artifact-dependencies. #12110
- Added doc comments for Sourceand 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-sys0.3.2 #11998
- Updated to git20.17.1, which corresponds to libgit2 1.6.4. #12096
- Updated to windows-sys0.48.0 #12021
- Updated to libc0.2.144 #12014 #12098
- Updated to openssl-src111.25.3+1.1.1t #12005
- Updated to home0.5.5 #12037
- Enabled feature Win32_System_Consolefeature 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 opensslonly 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 logoutcommand for removing an API token from the registry locally. docs #11919 #11950
- Added --ignore-rust-versionflag tocargo install. #11859
- The CARGO_PKG_READMEenvironment 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 sparseprotocol is now the default protocol for crates.io! (RFC 2789) (docs) #11791 #11783
- ❗ cargo loginandcargo logoutnow uses the registry specified inregistry.default. This was an unintentional regression. #11949
- cargo updateaccurately shows- Downgradingstatus 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 publishmessage when waiting for a publish complete. #11713
- Better error message when cargo installfrom a git repository but found multiple packages. #11835
Fixed
- Removed duplicates of possible values in --charsetoption 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 newgenerates the correct- .hgignorealigning 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-versionsbut only for direct dependencies. (docs) #11688
- Added -Zgitoxidewhich switches allgit fetchoperation in Cargo to usegitoxidecrate. 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 -Cthat it appears before the command. #11947
- Clarified working directory behaviour for cargo test,cargo benchandcargo run. #11901
- Fixed the doc of registries.name.indexconfiguration. #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 sha2crate for SHA256 calculation. #11795 #11807
- Switched benchsuite to the index archive. #11933
- Updated to base640.21.0. #11796
- Updated to curl-sys0.4.61, which corresponds to curl 8.0.1. #11871
- Updated to proptest1.1.0. #11886
- Updated to git20.17.0, which corresponds to libgit2 1.6.3. #11928
- Updated to clap4.2. #11904
- Integrated cargo-denyin Cargo its own CI pipeline. #11761
- Made non-blocking IO calls more robust. #11624
- Dropped derivefeature fromserdeincargo-platform. #11915
- Replaced std::fs::canonicalizewith a more robusttry_canonicalize. #11866
- Enabled clippy warning on disallowed_methodsforstd::env::varand friends. #11828
Cargo 1.69 (2023-04-20)
Added
- Cargo now suggests cargo fixorcargo clippy --fixwhen compilation warnings are auto-fixable. #11558
- Cargo now suggests cargo addif you try to install a library crate. #11410
- Cargo now sets the CARGO_BIN_NAMEenvironment variable also for binary examples. #11705
Changed
- ❗ When default-featuresis 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_HOMEin[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 addnow 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 installnow reports required features when no binary meets its requirements. #11647
Fixed
- Uplifted .dwpDWARF package file next to the executable for debuggers to locate them. #11572
- Fixed build scripts triggering recompiles when a rerun-if-changedpoints 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 reportsaving the same future-incompat reports multiple times. #11648
- Fixed the incorrect inference of a directory ending with .rsas a file. #11678
- Fixed .cargo-okfile being truncated wrongly, preventing from using a dependency. #11665 #11724
Nightly only
- -Zrustdoc-scrape-examplemust 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 -Cflag for changing current dir before build starts. #10952
Documentation
- Clarified the difference between CARGO_CRATE_NAMEandCARGO_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.timeoutdocs. #11652
- More doc comments for cargo::core::compilermodules. #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 installto the man pages #11763
- Documented -Fflag as an alias for--featuresincargo 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::NewProjectKindas public. #11700
- Made dependencies in alphabetical order. #11719
- Switched some tests from buildtocheck. #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 tomlv0.6 andtoml_editv0.18 for TOML manipulations. #11618
- Updated to clapv4.1.3. #11619
- Replaced winapiwithwindows-syscrate for Windows bindings. #11656
- Reused urlcrate 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
- 🎉 homecrate is now a subcrate inrust-lang/cargorepository. 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-clienabled. #11579
- cargo build --verbosetells 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 vendorgenerates 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/credentialsexists, 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 packageandcargo publishnow respects workspace’sCargo.lock. This is an expected behavior but previously got overlooked. #11477
- Fixed cargo vendorfailing on resolving git dependencies inherited from a workspace. #11414
- cargo installcan now correctly install root package when- workspace.default-membersis specified. #11067
- Fixed panic on target specific dependency errors. #11541
- Shows --helpif there is no man page for a subcommand. #11473
- Setting target.cfg(…).rustflagsshouldn’t erasebuild.rustdocflags. #11323
- Unsupported profile.split-debuginfooptions 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: truewithout-Z sparse-registry#11661
- Supports codegen-backendandrustflagsin profiles in config file. #11562
- Suggests cargo clippy --fixwhen 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 Units with and without artifact targets. #11478
- cargo metadatasupports 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 removenow cleans up the referenced dependency of the root workspace manifest,- profile,- patch, and- replacesections after a successful removal of a dependency. #11194 #11242 #11351
- cargo packageand- cargo publishnow report total and compressed crate size after packaging. #11270
Changed
- ❗ Cargo now reuses the value of $CARGOif 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 --precisewithout a-pflag. #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 fixon 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/initandPATHenv separator is in the project path. #11318
- Better error messages when multiple packages were found and
cargo add/removegets confused. #11186 #11375
- A better error message when cargo initbut 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 cleanfor removing fingerprints and build script artifacts of only the requested package #10621
- Fixed cargo install --indexnot working when configregistry.defaultis set. #11302
- Fixed git2 safe-directory accidentally disabled when no network configuration was found. #11366
- Migrate from crate attyto resolve potential soundness issue. #11420
- Cleans stale git temp files left when libgit2 indexing is interrupted. #11308
Nightly only
- Suggests cargo fixwhen some compilation warnings/errors can be auto-fixed. #10989 #11368
- Changed rustdoc-scrape-examplesto be a target-level configuration. #10343 #11425 #11430 #11445
- Propagates change of artifact bin dependency to its parent fingerprint. #11353
- Fixed wait-for-publishto work with sparse registry. #11356 #11327 #11388
- Stores the sparse+prefix in theSourceIdfor 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 removecommand 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-Encodingheader 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-withkey 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 publishnow 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(…).rustflagsmore 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 addnow 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 loginprompt 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.publishisfalsein the manifest. #11280
Nightly only
- Added new config option publish.timeoutbehind-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.protocolfor 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 PATHif 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 revfield. #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::scopeinstead of thecrossbeamcrate for spawning scoped threads. #10977
- Cargo now uses the standard library’s available_parallelisminstead of thenum_cpuscrate for determining the default parallelism. #10969
- Cargo now guides you how to solve it when seeing an error message of
rust-versionrequirement 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 updatenow warns if- --preciseis given without- --packageflag. This will become a hard error after a transition period. #10988 #11011
- cargo benchand- cargo testnow report a more precise test execution error right after a test fails. #11028
- cargo addnow 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.packageandworkspace.dependenciesfor more details on how to define these common settings. #10859
- Added the
--crate-typeflag tocargo rustcto override the crate type. #10838
- Cargo commands can now accept multiple --targetflags to build for multiple targets at once, and thebuild.targetconfig option may now take an array of multiple targets. #10766
- The --jobsargument can now take a negative number to count backwards from the max CPUs. #10844
Changed
- Bash completion of cargo install --pathnow supports path completion. #10798
- Significantly improved the performance fetching git dependencies from GitHub
when using a hash in the revfield. #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 addwill now update- Cargo.lock. #10902
- The path in the config output of cargo vendornow translates backslashes to forward slashes so that the settings should work across platforms. #10668
- The
workspace.default-memberssetting 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 osoutput incargo --version --verbosenow supports more platforms. #10802
- Cached git checkouts will now be rebuilt if they are corrupted. This may
happen when using net.git-fetch-with-cliand interrupting the clone process. #10829
- Fixed panic in cargo add --offline. #10817
Nightly only
- Fixed deserialization of unstable check-cfginconfig.toml. #10799
Cargo 1.63 (2022-08-11)
Added
- 🎉 Added the --configCLI option to pass config options directly on the CLI. #10755
- The CARGO_PKG_RUST_VERSIONenvironment variable is now set when compiling a crate if the manifest has therust-versionfield 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 .jsontarget 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=nonestrategy in.gitmodulesis 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 newnow 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 addandcargo locate-project#10810 #10811
- Fixed -pbeing ignored withcargo publishin 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 testwhen using JSON output. #10691
Nightly only
- Added -Zcheck-cfg=outputto support build-scripts declaring their supported set ofcfgvalues withcargo:rustc-check-cfg. #10539
- -Z sparse-registrynow uses https://index.crates.io/ when accessing crates-io. #10725
- Fixed formatting of .workspacekey incargo addfor workspace inheritance. #10705
- Sparse HTTP registry URLs must now end with a /. #10698
- Fixed issue with cargo addand workspace inheritance of thedefault-featureskey. #10685
Cargo 1.62 (2022-06-30)
Added
- 🎉 Added the cargo addcommand for adding dependencies toCargo.tomlfrom the command-line. docs #10472 #10577 #10578
- Package ID specs now support name@versionsyntax in addition to the previousname:versionto align with the behavior incargo addand other tools.cargo installandcargo yankalso now support this syntax so the version does not need to passed as a separate flag. #10582 #10650 #10597
- Added the CLI option -Fas an alias of--features. #10576
- The gitandregistrydirectories 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 --versionflag tocargo yankto replace the--versflag to be consistent withcargo install. #10575
- Added automatic @argfile support, which will use “response files” if the command-line torustcexceeds the operating system’s limit. #10546
- cargo cleannow has a progress bar (if it takes longer than half a second). #10236
Changed
- cargo installno longer generates an error if no binaries were found to install (such as missing required features). #10508
- cargo testnow passes- --targetto- rustdocif the specified target is the same as the host target. #10594
- cargo docnow automatically passes- -Arustdoc::private-intra-doc-linkswhen documenting a binary (which automatically includes- --document-private-items). The- private-intra-doc-linkslint 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 --versionoutput is now fixed to 9 characters. Previously the length was inconsistent between different platforms. #10579
- Attempting to publish a package with a Cargo.toml.origfile will now result in an error. The filename would otherwise conflict with the automatically-generated file. #10551
Fixed
- The build.dep-info-basedirconfiguration 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 fetchnow works with- -Zbuild-stdto fetch the standard library’s dependencies. #10129
- Added support for workspace inheritance. docs #10584 #10568 #10565 #10564 #10563 #10606 #10548 #10538
- Added -Zcheck-cfgwhich adds various forms of validatingcfgexpressions for unknown names and values. docs #10486 #10566
- The --configCLI 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-runwill now display the path to the test executables. #10346
- cargo tree --duplicatesno 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 vendorno longer allows multiple values for- --sync, you must pass multiple- --syncflags instead. #10448
- Warnings are now issued for manifest keys that have mixed both underscore
and dash variants (such as specifying both proc_macroandproc-macro) #10316
- Cargo now uses the standard library’s available_parallelisminstead of thenum_cpuscrate for determining the default parallelism. #10427
- cargo searchterms are now highlighted. #10425
Fixed
- Paths passed to VCS tools like hgare now added after--to avoid conflict with VCS flags. #10483
- Fixed the http.timeoutconfiguration value to actually work. #10456
- Fixed issues with cargo rustc --crate-typenot working in some situations. #10388
Nightly only
- Added -Z check-cfg-featuresto enable compile-time checking of features #10408
- Added -Z bindepsto support binary artifact dependencies (RFC-3028) #9992
- -Z multitargetis now supported in the- build.targetconfig value with an array. #10473
- Added --keep-goingflag 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-featuressupport 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-namesyntax to the[features]table to only enable the featurefeature-nameif the optional dependencydep-nameis already enabled by some other feature. docs #10269
- 🎉 Added --timingsoption 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.pipeliningconfig option is now deprecated, pipelining will now always be enabled. #10258
- cargo newwill now generate a- .gitignorewhich only ignores- Cargo.lockin the root of the repo, instead of any directory. #10379
- Improved startup time of bash completion. #10365
- The --featuresflag is now honored when used with the--all-featuresflag, 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 addand other future enhancements. #10086
- Setting a library to emit both a dylibandcdylibis now an error, as this combination is not supported. #10243
- cargo --listnow includes the- helpcommand. #10300
Fixed
- Fixed running cargo docon examples with dev-dependencies. #10341
- Fixed cargo install --pathfor a path that is relative to a directory outside of the workspace in the current directory. #10335
- cargo test TEST_FILTERshould no longer build binaries that are explicitly disabled with- test = false. #10305
- Fixed regression with term.verbosewithoutterm.quiet, and vice versa. #10429 #10436
Nightly only
- Added rustflagsoption to a profile definition. #10217
- Changed --configto only support dotted keys. #10176
- Fixed profile rustflagsnot being gated in profile overrides. #10411 #10413
Cargo 1.59 (2022-02-24)
Added
- 🎉 The stripoption 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 rustcmay 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.quietconfiguration option to enable the--quietbehavior from a config file. docs #10152
- Added -rCLI 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 --hostCLI 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=falsesetting is honored in the[lib]definition of a dependency. #10201 #10324
- The "executable"field in the JSON option was incorrectly including the path toindex.htmlwhen 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-typeflag tocargo rustc. #10093
Cargo 1.58 (2022-01-13)
Added
- Added rust_versionfield to package data incargo metadata. #9967
- Added --message-formatoption 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 treeentering 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 -pwhen the directory path contains glob characters. #10072
- Fixed debug builds of cargowhich 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 examplesdirectory to be included in the documentation. docs #9525 #10037 #10017
- Fixed cargo report future-incompatibilitiesto check stdout if it supports color. #10024
Cargo 1.57 (2021-12-02)
Added
- 🎉 Added custom named profiles. This also changes the testandbenchprofiles to inherit their settings fromdevandrelease, 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 revoption 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_vcsfield to the.cargo_vcs_info.jsonfile. docs #9866
Changed
- ❗ RUSTFLAGSis 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_RUSTFLAGSinstead. See the documentation for more details.
- The cargo versioncommand 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 --precisenow allows specifying a version without semver metadata (stuff after- +in the version number). #9945
- zsh completions now complete --examplenames. #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 fixwill now avoid writing fixes to the global registry cache. #9938
- Fixed -Z helpCLI 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-versionfield toCargo.tomlto specify the minimum supported Rust version, and the--ignore-rust-versioncommand 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 #9839
- cargo docnow supports the- --exampleand- --examplesflags. #9808
- 🎉 Build scripts can now pass additional linker arguments for binaries or all linkable targets. docs #9557
- Added support for the -pflag forcargo publishto publish a specific package in a workspace.cargo packagealso now supports-pand--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 -qflag to show terse test output. #9730
- featuresused in a- [replace]table now issues a warning, as they are ignored. #9681
- Changed so that only wasm32-unknown-emscriptenexecutables are built without a hash in the filename. Previously it was allwasm32targets. Additionally, allapplebinaries 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 newnow generates an example that doesn’t generate a warning with clippy. #9796
- cargo fix --editionnow only applies edition-specific lints. #9846
- Improve resolver message to include dependency requirements. #9827
- cargo fixnow has more debug logging available with the- CARGO_LOGenvironment variable. #9831
- Changed cargo fix --editionto emit a warning when on the latest stable edition when running on stable instead of generating an error. #9792
- cargo installwill 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 --editionnow includes differences for dev-dependencies. #9803
- cargo fixwill now show better diagnostics for abnormal errors from- rustc. #9799
- Entries in cargo --listare now deduplicated. #9773
- Aliases are now included in cargo --list. #9764
Fixed
- Fixed panic with build-std of a proc-macro. #9834
- Fixed running cargorecursively 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-namefeature 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 metadatanow 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.RUSTFLAGSis no longer set for build scripts; they should useCARGO_ENCODED_RUSTFLAGSinstead. docs #9601
- Added cargo das an alias forcargo doc. #9680
- Added {lib}to thecargo tree --formatoption to display the library name of a package. #9663
- Added members_mutmethod to theWorkspaceAPI. #9547
Changed
- If a build command does not match any targets when using the
--all-targets,--bins,--tests,--examples, or--benchesflags, a warning is now displayed to inform you that there were no matching targets. #9549
- The way cargo initdetects 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 testwhich 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 bothgitandpathis 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
- featuresused in a- [patch]table now issues a warning, as they are ignored. #9666
- The targetdirectory is now excluded from content indexing on Windows. #9635
- When Cargo.tomlis not found, the error message now detects if it was misnamed with a lowercasecto suggest the correct form. #9607
- Building dieselwith the new resolver displays a compatibility notice. #9602
- Updated the openerdependency, which handles opening a web browser, which includes several changes, such as new behavior when run on WSL, and using the systemxdg-openon 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 fixnow supports rustc’s suggestions with multiple spans. #9567
- cargo fixnow fixes each target serially instead of in parallel to avoid problems with fixing the same file concurrently. #9677
- Changes to the target linkerconfig value now trigger a rebuild. #9647
- Git unstaged deleted files are now ignored when using the --allow-dirtyflag withcargo publishorcargo package. #9645
Nightly only
- Enabled support for cargo fix --editionfor 2021. #9588
- Several changes to named profiles. #9685
- Extended instructions on what to do when running cargo fix --editionon 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 --openwithdoc.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 --pruneoption forcargo treeto limit what is displayed. #9520
- Added --depthoption forcargo treeto limit what is displayed. #9499
- Added cargo tree -e no-proc-macroto hide procedural macro dependencies. #9488
- Added doc.browserconfig option to set which browser to open withcargo doc --open. #9473
- Added CARGO_TARGET_TMPDIRenvironment variable set for integration tests & benches. This provides a temporary or “scratch” directory in thetargetdirectory for tests and benches to use. #9375
Changed
- --featuresCLI 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 .cratepublished 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 newwith fossil now places the ignore settings in the new repository instead of using- fossil settingsto set them globally. This also includes several other cleanups to make it more consistent with other VCS configurations. #9469
- rustc-cdylib-link-argapplying transitively displays a warning that this was not intended, and may be an error in the future. #9563
Fixed
- Fixed package.excludeinCargo.tomlusing inverted exclusions (!somefile) when not in a git repository or when vendoring a dependency. #9186
- Dep-info files now adjust build script rerun-if-changedpaths 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.0and110.0.0+1.1.0f). #9476
- Fixed cargo installwith a semver metadata version. #9467
Nightly only
- Added reportsubcommand, and changedcargo describe-future-incompatibilitietocargo 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-hostto 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-bininstruction for build scripts. #9486
Cargo 1.53 (2021-06-17)
Added
Changed
- 🔥 Cargo now supports git repositories where the default HEADbranch is not “master”. This also includes a switch to the version 3Cargo.lockformat which can handle default branches correctly. #9133 #9397 #9384 #9392
- 🔥 macOS targets now default to unpackedsplit-debuginfo. #9298
- ❗ The authorsfield is no longer included inCargo.tomlfor new projects. #9282
- cargo updatemay now work with the- --offlineflag. #9279
- cargo docwill now erase the- docdirectory 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 docdetecting if the documentation needs to be rebuilt when changing some settings such as features. #9419
- cargo docnow deletes the output directory for the package before running rustdoc to clear out any stale files. #9419
- Fixed the -C metadatavalue 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 manis inPATH. #9378
- The rustccache is now aware ofRUSTC_WRAPPERandRUSTC_WORKSPACE_WRAPPER. #9348
- Track the CARGOenvironment variable in the rebuild fingerprint if the code usesenv!("CARGO"). #9363
Nightly only
- Fixed config includes not working. #9299
- Emit note when --future-incompat-reporthad nothing to report. #9263
- Error messages for nightly features flags (like -Zandcargo-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 helpnow displays all the- -Zoptions. #9369
- Added -Zallow-featuresto specify which nightly features are allowed to be used. #9283
- Added cargo configsubcommand. #9302
Cargo 1.52 (2021-05-06)
Added
Changed
- Build scripts are now forbidden from setting RUSTC_BOOTSTRAPon stable. #9181 #9385
- crates.io now supports SPDX 3.11 licenses. #9209
- An error is now reported if CARGO_TARGET_DIRis an empty string. #8939
- Doc tests now pass the --message-formatflag into the test so that the “short” format can now be used for doc tests. #9128
- cargo testnow 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 -pflag. #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=offis set. #9182
Nightly only
- The stripprofile option now supportstrueandfalsevalues. #9153
- cargo fix --editionnow displays a report when switching to 2021 if the new resolver changes features. #9268
- Added [patch]table support in.cargo/configfiles. #9204
- Added cargo describe-future-incompatibilitiesfor 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 --editionnow supports 2021. #9184
- Added --printflag tocargo rustcto pass along torustcto display information from rustc. #9002
- Added -Zdoctest-in-workspacefor changing the directory where doctests are run versus where they are compiled. #9105
- Added support for an [env]section in.cargo/config.tomlto set environment variables when running cargo. #9175
- Added a schema field and features2field 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-debuginfoprofile option. docs #9112
- Added the pathfield tocargo metadatafor 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 --lockednow emits a warning if- Cargo.lockis 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 testandcargo runwhen the build script runs multiple times during the same build session. #9122
- Fixed a panic with cargo docand the new feature resolver. This also introduces some heuristics to try to avoid path collisions withrustdocby 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 linksenvironment 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.proxysetting in~/.gitconfig. #8986
- Fixed –feature pkg/feat for V1 resolver for non-member. #9275 #9277
- Fixed panic in cargo docwhen there are colliding output filenames in a workspace. #9276 #9277
- Fixed cargo installfrom 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-lockfileunstable 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 -Zflag, or specified withcargo-featuresinCargo.toml). #9092
- Added support for Rust edition 2021. #8922
- Added support for the rust-versionfield in project metadata. #8037
- Added a schema field to the index. #9161 #9196
Cargo 1.50 (2021-02-11)
Added
- Added the docfield 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 --workspacetocargo updateto update only the workspace members, and not their dependencies. This is particularly useful if you update the version inCargo.tomland want to updateCargo.lockwithout running any other commands. #8725
Changed
- .cratefiles uploaded to a registry are now built with reproducible settings, so that the same- .cratefile created on different machines should be identical. #8864
- Git dependencies that specify more than one of branch,tag, orrevare now rejected. #8984
- The rerun-if-changedbuild 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 newwill 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 newwill now support- includeIfdirectives in- .gitconfigto match the correct directory when determining the username and email address. #8886
Fixed
- Fixed cargo metadataandcargo treeto 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 linksfield. #8969
- Fixed cargo publishfailing 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-argwhich adds thecargo:rustc-link-arg-binsandcargo:rustc-link-argbuild script options. docs #8441
- Implemented external credential process support, and added cargo logout. (RFC 2730) (docs) #8934
- Fix panic with -Zbuild-stdand no roots. #8942
- Set docs.rs as the default extern-map for crates.io #8877
Cargo 1.49 (2020-12-31)
Added
- Added homepageanddocumentationfields tocargo metadata. #8744
- Added the CARGO_PRIMARY_PACKAGEenvironment variable which is set when runningrustcif 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 buildandcargo testin some circumstances. #8755
- cargo treenow 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
- -pwithout 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 metadatafor git dependencies that explicitly specifybranch="master". #8824
- Fixed re-extracting dependencies which contained a .cargo-okfile. #8835
Nightly only
- Fixed a panic with cargo doc -Zfeatures=itargetin 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.progressconfiguration option to control when and how the progress bar is displayed. docs #8165
- Added --message-format plainoption tocargo locate-projectto display the project location without JSON to make it easier to use in a script. #8707
- Added --workspaceoption tocargo locate-projectto 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 --targetcompletion will now complete with the built-in rustc targets. #8740
Changed
Fixed
- Fixed cargo newcreating a fossil repository to properly ignore thetargetdirectory. #8671
- Don’t show warnings about the workspace in the current directory when using cargo installof 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 installso that it will ignore the[unstable]table in local config files. #8656
- Fixed nondeterministic behavior of the new feature resolver. #8701
- Fixed running cargo teston a proc-macro with the new feature resolver under a specific combination of circumstances. #8742
Cargo 1.47 (2020-10-08)
Added
- cargo docwill now include the package’s version in the left sidebar. #8509
- Added the testfield tocargo metadatatargets. #8478
- Cargo’s man pages are now displayed via the cargo helpcommand (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 .gitignorewhen it is modified have been tweaked to add some spacing. #8476
- cargo metadataoutput should now be sorted to be deterministic. #8489
- By default, build scripts and proc-macros are now built with opt-level=0and the default codegen units, even in release mode. #8500
- workspace.default-membersis now filtered by- workspace.exclude. #8485
- workspace.membersglobs 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.autocrlfgit configuration value to ensure they behave consistently across platforms, particularly when vendoring git dependencies on Windows. #8523
- If Cargo.lockneeds 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 branchand one withbranch="master". Dependencies should all use one form or the other. #8522
 
- Warnings are now issued if a required-featuresentry lists a feature that does not exist. #7950
- Built-in aliases are now included in cargo --list. #8542
- cargo installwith a specific version that has been yanked will now display an error message that it has been yanked, instead of “could not find”. #8565
- cargo publishwith a package that has the- publishfield set to a single registry, and no- --registryflag 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-changeddirective, 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}_RUNNERenvironment 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-widthwhich tellsrustcthe width of the terminal so that it can format diagnostics better. docs #8427
- Added ability to configure -Zunstable flags in config files via the[unstable]table. docs #8393
- Added -Z build-std-featuresflag to set features for the standard library. docs #8490
Cargo 1.46 (2020-08-27)
Added
- The dlkey inconfig.jsonof 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 readmeis 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 installnow supports the- --indexflag to install directly from an index. #8344
- Added the metadatatable to theworkspacedefinition inCargo.toml. This can be used for arbitrary data similar to thepackage.metadatatable. #8323
- Added the --target-dirflag tocargo installto 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 targetdirectory now includes theCACHEDIR.TAGfile which is used by some tools to exclude the directory from backups. #8378
- Added docs about rustup’s +toolchainsyntax. #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.lockfile, 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
- .cratefiles 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.lockfailed once, but then subsequent runs allowed it proceed. #8274
- Removed assertion that Windows dylibs must have a .dllextension. 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/featuresyntax, andpkgis 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 -pdeleting 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-itemsflag for rustdoc would override any flags passed to thecargo rustdoccommand. #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-mapfeature 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.tomlwith an underscore (likeproc_macro = true). #8319
- Added support for setting -Clinkerwith-Zdoctest-xcompile. #8359
- Fixed setting the stripprofile field in config files. #8454
Cargo 1.45 (2020-07-16)
Added
Changed
- 
Changed official documentation to recommend .cargo/config.tomlfilenames (with the.tomlextension)..tomlextension support was added in 1.39. #8121
- 
The registry.indexconfig value is no longer allowed (it has been deprecated for 4 years). #7973
- 
An error is generated if both --indexand--registryare passed (previously--indexwas silently ignored). #7973
- 
The registry.tokenconfig value is no longer used with the--indexflag. This is intended to avoid potentially leaking the crates.io token to another registry. #7973
- 
Added a warning if registry.tokenis used with source replacement. It is intended this will be an error in future versions. #7973
- 
Windows GNU targets now copy .dll.aimport 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.excludecan 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 publishorcargo package, Cargo can use git to guide its decision on which files to include. Previously this git-based logic required aCargo.tomlfile 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.tomlin 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 -phas 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: - .expexport 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.exeandfoo-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-fuzzwould previously sometimes panic becausegrep -qmay 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 installis 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.lockto 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 .pdbfiles 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 updatewith 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 --targettorustdocwhen using JSON spec targets. #8094
- -Cembed-bitcode=norenamed to- -Cbitcode-in-rlib=no#8134
- Added new resolverfield toCargo.tomlto opt-in to the new feature resolver. #8129
- -Zbuild-stdno 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 -Zmultitargetwhich allows multiple--targetflags to build the same thing for multiple targets at once. docs #8167
- Added stripoption 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 treecommand. 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 runorcargo 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 newand- initwill warn or reject additional package names (reserved Windows names, reserved Cargo directories, non-ASCII names, conflicting std names like- core, 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 .cratefile. 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-checkoutsubcommand. #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 rustcnow 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 --listto succeed, even if there are other validation errors (such asCargo.lockgeneration 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.devwas not loaded from a config file withcargo testwhen thedevprofile 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_namesyntax inrequired-featurescorrectly. #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 -pif the package has a build script. #8216
Nightly only
- Fixed panic with new feature resolver and required-features. #7962
- Added RUSTC_WORKSPACE_WRAPPERenvironment variable, which provides a way to wraprustcfor 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-graphCLI option to display Cargo’s internal dependency graph as JSON. #7977
- Changed -Zbuild_depto-Zhost_dep, and added proc-macros to the feature decoupling logic. #8003 #8028
- Fixed so that --crate-versionis not automatically passed when the flag is found inRUSTDOCFLAGS. #8014
- Fixed panic with -Zfeatures=dev_depandcheck --profile=test. #8027
- Fixed panic with -Zfeatures=itargetwith 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-featureshas 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 --gitnow honors workspaces in a git repository. This allows workspace settings, like- [patch],- [replace], or- [profile]to be used. #7768
- cargo newwill now run- rustfmton the new files to pick up rustfmt settings like- tab_spacesso 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-filefile is automatically included during publish, even if it is not explicitly listed in theincludelist or is in a location outside of the root of the package. #7905
- CARGO_CFG_DEBUG_ASSERTIONSand- CARGO_CFG_PROC_MACROare 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 a- targetexpression. #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=trueas a boolean. Also improved related env var error messages. #7891
- Updated internal libgit2 library, bringing various fixes to git support. #7939
- cargo package/- cargo publishshould no longer buffer the entire contents of each file in memory. #7946
- Ignore more invalid Cargo.tomlfiles 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-dirconfig variable to set the output directory. #7810
- Added -Zjobserver-per-rustcfeature to support improved performance for parallel rustc. #7731
- Fixed filename collision with build-stdand crates likecc. #7860
- -Ztimingswill now save its report even if there is an error. #7872
- Updated --configcommand-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-versionsflag). #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 vendornow accepts the- --versioned-dirsoption to force it to always include the version number in each package’s directory name. #7631
- The proc_macrocrate 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: .libDLL 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-msvctargets. #7758
- The arfield 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 --offlineempty 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 theincludelist. #7680
- Fixed cargo loginremoving alternative registry tokens when previous entries existed in the credentials file. #7708
- Fixed cargo vendorfrom 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_kindsin- cargo metadataare now de-duplicated. #7756
- Fixed packaging where Cargo.lockwas listed in.gitignorein a subdirectory inside a git repository. Previously it was assumingCargo.lockwas 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
--sysrootis passed in viaRUSTFLAGS. #7798
Nightly only
- build-stdnow uses- --externinstead of- --sysrootto find sysroot packages. #7699
- Added --configcommand-line option to set config settings. #7649
- Added includeconfig 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.lockfile 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.lockfiles will use the new format. #7579
- 🔥 cargo installwill 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 BROWSERenvironment variable forcargo doc --open. #7576
- Added kindandplatformfor dependencies incargo metadata. #7132
- The OUT_DIRvalue is now included in thebuild-script-executedJSON message. #7622
Changed
- cargo docwill 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 logintext from copy/paste in token. #7588
- Windows: Ignore errors for locking files when not supported by the filesystem. #7602
- Remove **/*.rs.bkfrom.gitignore. #7647
Fixed
- Fix unused warnings for some keys in the buildconfig 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-versionconfig 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-platformoption tocargo metadatato narrow the nodes shown in the resolver graph to only packages included for the given target triple. #7376
Changed
- Cargo’s “platform” cfgparsing 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: .wasmfiles are no longer treated as an “executable”, allowingcargo testandcargo runto work properly with the generated.jsfile. #7476
- crates.io now supports SPDX 3.6 licenses. #7481
- Improved cyclic dependency error message. #7470
- Bare cargo cleanno longer locks the package cache. #7502
- cargo publishnow 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
- --featuresand- --no-default-featuresin the root of a virtual workspace will now generate an error instead of being ignored. #7507
- Generated files (like Cargo.tomlandCargo.lock) in a package archive now have their timestamp set to the current time instead of the epoch. #7523
- The -Zflag parser is now more strict, rejecting more invalid syntax. #7531
Fixed
- Fixed an issue where if a package had an includefield, andCargo.lockin.gitignore, and a binary or example target, and theCargo.lockexists in the current project, it would fail to publish complaining theCargo.lockwas dirty. #7448
- Fixed a panic in a particular combination of [patch]entries. #7452
- Windows: Better error message when cargo testorrustccrashes in an abnormal way, such as a signal or seg fault. #7535
Nightly only
- The mtime-on-usefeature may now be enabled via theunstable.mtime_on_useconfig option. #7411
- Added support for named profiles. #6989
- Added -Zpanic-abort-teststo allow building and running tests with the “abort” panic strategy. #7460
- Changed build-stdto 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 .tomlfilename extension. #7295
- The --workspaceflag has been added as an alias for--allto help avoid confusion about the meaning of “all”. #7241
- The publishfield has been added tocargo metadata. #7354
Changed
- Display more information if parsing the output from rustcfails. #7236
- TOML errors now show the column number. #7248
- cargo vendorno longer deletes files in the- vendordirectory that starts with a- .. #7242
- cargo fetchwill now show manifest warnings. #7243
- cargo publishwill now check git submodules if they contain any uncommitted changes. #7245
- In a build script, cargo:rustc-flagsnow allows-land-Lflags without spaces. #7257
- When cargo installreplaces 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 versionkey when published. Thegitvalue will be stripped from the uploaded crate, matching the behavior ofpathdependencies. #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 homedependency 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 cccrate 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 .dSYMsymlinks on macOS. #7268
- Fixed issues with multiple versions of the same crate in a [patch]table. #7303
- Fixed issue with custom target .jsonfiles 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.rsscript issues differentrerun-ifdirectives 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 bflag is interpreted, restoring the original behavior where this is interpreted as--features aalong with the argumentbpassed 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--featuresflags. #7419
Nightly only
- Basic support for building the standard library directly from Cargo has been added. (docs) #7216
- Added -Ztimingsfeature 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-formatoption 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-shortandjson-diagnostic-rendered-ansiwhich configures the output coming from rustc injsonmessage mode. #7214
- Cirrus CI badges are now supported on crates.io. #7119
- A new format for Cargo.lockhas 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 -qflag 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 --featurescommand-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 rustcoutput fails when queryingrustcfor information likecfgvalues. #7185
- cargo package/- cargo publishnow 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-cliconfig option, and theGIT_DIRenvironment 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.dSYMdirectories would overwrite the.dfile. #7057
- Fix [patch]table not preserving “one major version per source” rule. #7118
- Ignore --remap-path-prefixflags for the metadata hash in thecargo rustccommand. This was causing the remap settings to inadvertently affect symbol names. #7134
- Fixed cycle detection in [patch]dependencies. #7174
- Fixed cargo newleaving behind a symlink on Windows whencore.symlinksgit config is true. Also adds a number of fixes and updates from upstream libgit2. #7176
- macOS: Fixed setting the flag to mark the targetdirectory to be excluded from backups. #7192
- Fixed cargo fixpanicking under some situations involving multi-byte characters. #7221
Nightly only
- Added cargo fix --clippywhich will apply machine-applicable fixes from Clippy. #7069
- Added -Z binary-dep-depinfoflag to add change tracking for binary dependencies like the standard library. #7137 #7219
- cargo clippy-previewwill 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 doctestfield tocargo metadatato determine if a target’s documentation is tested. #6953 #6965
- 🔥 The cargo vendorcommand 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.lockfile when a package is published if it contains a binary executable target. By default, Cargo will ignoreCargo.lockwhen installing a package. To force Cargo to use theCargo.lockfile included in the published package, usecargo install --locked. This may be useful to ensure thatcargo installconsistently 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-runfeature has been stabilized. This feature allows you to specify which binary executable to run by default withcargo runwhen a package includes multiple binaries. Set thedefault-runkey in the[package]table inCargo.tomlto the name of the binary to use by default. #7056
Changed
- cargo packagenow verifies that build scripts do not create empty directories. #6973
- A warning is now issued if cargo docgenerates 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/barwill no longer compile the current crate with thefoofeature iffoois not an optional dependency. #7010
- If --remap-path-prefixis 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 debugis set to 0. #6971
- Fixed cargo docwith an example configured withdoc = trueto 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 --lockedis 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-messagesflag makes cargo cache the compiler output so that future runs can redisplay previous warnings. #6933
- -Z mtime-on-useno longer touches intermediate artifacts. #7050
Cargo 1.36 (2019-07-04)
Added
- Added more detailed documentation on target auto-discovery. #6898
- 🔥 Stabilize the --offlineflag 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_PATHis not set. Also, remove/libfrom the default set. #6856
- cargo publishwill 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.indexconfig value now supports relativefile:URLs. #6873
- macOS: The .dSYMdirectory is now symbolically linked next to example binaries without the metadata hash so that debuggers can find it. #6891
- The default Cargo.tomltemplate 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_LOGenvironment variable toCARGO_LOGso that user code that uses thelogcrate will not display cargo’s debug output. #6918
- Cargo.tomlis now always included when packaging, even if it is not listed in- package.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 runnow 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 updateignoring-parguments if theCargo.lockfile was missing. #6904
Nightly only
- Added -Z install-upgradefeature to track details about installed crates and to update them if they are out-of-date. #6798
- Added the public-dependencyfeature which allows tracking public versus private dependencies. #6772
- Added build pipelining via the build.pipeliningconfig option (CARGO_BUILD_PIPELININGenv var). #6883
- The publish-lockfilefeature has had some significant changes. The default is nowtrue, theCargo.lockwill always be published for binary crates. TheCargo.lockis now regenerated during publishing.cargo installnow ignores theCargo.lockfile by default, and requires--lockedto 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-argkey 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 --quietflag fromcargo testto the libtest harness so that tests are actually quiet. #6358
- The verification step in cargo packagethat 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 metadatano longer shows a- nullfield for a dependency without a library in- resolve.nodes.deps. The dependency is no longer shown. #6534
- cargo newwill no longer include an email address in the- authorsfield if it is set to the empty string. #6802
- cargo doc --opennow works when documenting multiple packages. #6803
- cargo install --path Pnow loads the- .cargo/configfile 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 installnow 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 buildthencargo test) where the second command could use stale results from a build script. #6720
- Fixed cargo fixnot working properly if a.gitignorefile that matched the root package directory. #6767
- Fixed accidentally compiling a lib multiple times if panic=unwindwas set in a profile. #6781
- Paths to JSON files in build.targetconfig 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 newinitializing a fossil repo. #6792
- Fixed supporting updating a git repo that has a force push when using the
git-fetch-with-clifeature.git-fetch-with-clialso shows more error information now when it fails. #6800
- --examplebinaries built for the WASM target are fixed to no longer include a metadata hash in the filename, and are correctly emitted in the- compiler-artifactJSON message. #6812
Nightly only
- cargo clippy-previewis now a built-in cargo command. #6759
- The build-overrideprofile 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.locknow includes a comment at the top that it is- @generated. #6548
- Azure DevOps badges are now supported. #6264
- Added a warning if --excludeflag specifies an unknown package. #6679
Changed
- cargo test --doc --no-rundoesn’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 --targetcompletion, 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 = trueconfig value is now treated the same as- CARGO_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-useflag 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-macrosto build proc macros for both the host and the target. #6547
Cargo 1.33 (2019-02-28)
Added
- compiler-artifactJSON 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 loginnow displays a confirmation after saving the token. #6466
- A warning is now emitted if a [patch]entry does not match any package. #6470
- cargo metadatanow includes the- linkskey for a package. #6480
- “Very verbose” output with -vvnow displays the environment variables that cargo sets when it runs a process. #6492
- --example,- --bin,- --bench, or- --testwithout 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-featuresflags to thecargo packageandcargo publishcommands to use the given features when verifying the package. #6453
Changed
- If cargo fixfails to compile the fixed code, the rustc errors are now displayed on the console. #6419
- Hide the --hostflag fromcargo login, it is unused. #6466
- Build script fingerprints now include the rustc version. #6473
- macOS: Switched to setting DYLD_FALLBACK_LIBRARY_PATHinstead ofDYLD_LIBRARY_PATH. #6355
- RUSTFLAGSis 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 fixwill now ignore suggestions that modify multiple files. #6402
- cargo fixwill 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 initwill now avoid creating duplicate entries in- .gitignorefiles. #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 metadataadded the- registrykey for dependencies. #6500
- Registry names are now restricted to the same style as
package names (alphanumeric, -and_characters). #6469
- cargo loginnow displays the- /meURL from the registry config. #6466
- cargo login --registry=NAMEnow supports interactive input for the token. #6466
- Registries may now elide the apikey fromconfig.jsonto indicate they do not support API access. #6466
- Fixed panic when using --message-format=jsonwith 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 cforcargo check. #6218
Changed
- 🔥 HTTP/2 multiplexing is now enabled by default. The http.multiplexingconfig 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-okgit flag when using thenet.git-fetch-with-clioption. 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 as- proc-macro = truein- Cargo.toml. #6256
- An error is raised if dependencies,features,target, orbadgesis set in a virtual workspace. Warnings are displayed ifreplaceorpatchis used in a workspace member. #6276
- Improved performance of the resolver in some cases. #6283 #6366
- .rmetafiles 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=falsenow disables auto-discovery of inferred targets. #6329
- cargo verify-projectwill 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 --releasenow 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 NAMEto work correctly if the example setscrate_type = ["bin"]. #6330
- Fixed issue with cargo packagegit discovery being too aggressive. The--allow-dirtynow completely disables the git repo checks. #6280
- Fixed build change tracking for [patch]deps which resulted incargo buildrebuilding 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-dirno 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.multiplexingconfig value to enable. #6005
- Added http.debugconfiguration value to debug HTTP connections. UseCARGO_HTTP_DEBUG=true RUST_LOG=cargo::ops::registry cargo buildto display the debug information. #6166
- CARGO_PKG_REPOSITORYenvironment variable is set with the repository value from- Cargo.tomlwhen building . #6096
Changed
- cargo test --docnow rejects other flags instead of ignoring them. #6037
- cargo installignores- ~/.cargo/config. #6026
- cargo version --verboseis now the same as- cargo -vV. #6076
- Comments at the top of Cargo.lockare 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-codefails 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 +toolchainin bash completion. #6038
- Fixed edge cases in the resolver, when backtracking on failed dependencies. #5988
- Fixed cargo test --all-targetsrunning lib tests three times. #6039
- Fixed publishing renamed dependencies to crates.io. #5993
- Fixed cargo installon 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/debugandtarget/debug/deps. #6167
- Fixed some unnecessary recompiles when panic=abortis used. #6170
Nightly only
- Added --registryflag tocargo install. #6128
- Added registry.defaultconfiguration value to specify the default registry to use if--registryflag is not passed. #6135
- Added --registryflag tocargo newandcargo init. #6135
Cargo 1.30 (2018-10-25)
Added
- 🔥 Added an animated progress bar shows progress during building. #5995
- Added resolve.nodes.depskey tocargo metadata, which includes more information about resolved dependencies, and properly handles renamed dependencies. #5871
- When creating a package, provide more detail with -vwhen 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--libcan be used in a workspace without selecting a specific package. #5873
- cargo runcan be used in a workspace without selecting a specific package. #5877
- cargo doc --message-format=jsonnow outputs JSON messages from rustdoc. #5878
- Added --message-format=shortto show one-line messages. #5879
- Added .cargo_vcs_info.jsonfile to.cratepackages that captures the current git hash. #5886
- Added net.git-fetch-with-cliconfiguration option to use thegitexecutable to fetch repositories instead of using the built-in libgit2 library. #5914
- Added required-featurestocargo metadata. #5902
- cargo uninstallwithin a package will now uninstall that package. #5927
- Added --allow-stagedflag tocargo fixto allow it to run if files are staged in git. #5943
- Added net.low-speed-limitconfig value, and also honornet.timeoutfor http operations. #5957
- Added --editionflag tocargo new. #5984
- Temporarily stabilized 2018 edition support for the duration of the beta. #5984 #5989
- Added support for target.'cfg(…)'.runnerconfig value to specify the run/test/bench runner for targets that use config expressions. #5959
Changed
- Windows: cargo runwill not kill child processes when the main process exits. #5887
- Switched to the openercrate 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.targetconfig value when runningcargo install. #5874
- Ignore RUSTC_WRAPPERforcargo 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 fixnow 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