cargo/ops/
mod.rs

1use crate::sources::CRATES_IO_DOMAIN;
2
3pub use self::cargo_clean::{CleanContext, CleanOptions, clean};
4pub use self::cargo_compile::unit_generator::UnitGenerator;
5pub use self::cargo_compile::{CompileFilter, FilterRule, LibRule, Packages};
6pub use self::cargo_compile::{
7    CompileOptions, compile, compile_with_exec, compile_ws, create_bcx, print, resolve_all_features,
8};
9pub use self::cargo_doc::{DocOptions, OutputFormat, doc};
10pub use self::cargo_fetch::{FetchOptions, fetch};
11pub use self::cargo_install::{install, install_list};
12pub use self::cargo_new::{NewOptions, NewProjectKind, VersionControl, init, new};
13pub use self::cargo_output_metadata::{ExportInfo, OutputMetadataOptions, output_metadata};
14pub use self::cargo_package::PackageMessageFormat;
15pub use self::cargo_package::PackageOpts;
16pub use self::cargo_package::check_yanked;
17pub use self::cargo_package::package;
18pub use self::cargo_pkgid::pkgid;
19pub use self::cargo_read_manifest::read_package;
20pub use self::cargo_report::timings::ReportTimingsOptions;
21pub use self::cargo_report::timings::report_timings;
22pub use self::cargo_run::run;
23pub use self::cargo_test::{TestOptions, run_benches, run_tests};
24pub use self::cargo_uninstall::uninstall;
25pub use self::cargo_update::UpdateOptions;
26pub use self::cargo_update::generate_lockfile;
27pub use self::cargo_update::print_lockfile_changes;
28pub use self::cargo_update::update_lockfile;
29pub use self::cargo_update::upgrade_manifests;
30pub use self::cargo_update::write_manifest_upgrades;
31pub use self::common_for_install_and_uninstall::{InstallTracker, resolve_root};
32pub use self::fix::{
33    EditionFixMode, FixOptions, fix, fix_edition, fix_exec_rustc, fix_get_proxy_lock_addr,
34};
35pub use self::lockfile::{load_pkg_lockfile, resolve_to_string, write_pkg_lockfile};
36pub use self::registry::OwnersOptions;
37pub use self::registry::PublishOpts;
38pub use self::registry::RegistryCredentialConfig;
39pub use self::registry::RegistryOrIndex;
40pub use self::registry::info;
41pub use self::registry::modify_owners;
42pub use self::registry::publish;
43pub use self::registry::registry_login;
44pub use self::registry::registry_logout;
45pub use self::registry::search;
46pub use self::registry::yank;
47pub use self::resolve::{
48    WorkspaceResolve, add_overrides, get_resolved_packages, resolve_with_previous, resolve_ws,
49    resolve_ws_with_opts,
50};
51pub use self::vendor::{VendorOptions, vendor};
52
53pub mod cargo_add;
54mod cargo_clean;
55pub(crate) mod cargo_compile;
56pub mod cargo_config;
57mod cargo_doc;
58mod cargo_fetch;
59mod cargo_install;
60mod cargo_new;
61mod cargo_output_metadata;
62mod cargo_package;
63mod cargo_pkgid;
64mod cargo_read_manifest;
65pub mod cargo_remove;
66mod cargo_report;
67mod cargo_run;
68mod cargo_test;
69mod cargo_uninstall;
70mod cargo_update;
71mod common_for_install_and_uninstall;
72mod fix;
73pub(crate) mod lockfile;
74pub(crate) mod registry;
75pub(crate) mod resolve;
76pub mod tree;
77mod vendor;
78
79/// Returns true if the dependency is either git or path, false otherwise
80/// Error if a git/path dep is transitive, but has no version (registry source).
81/// This check is performed on dependencies before publishing or packaging
82fn check_dep_has_version(dep: &crate::core::Dependency, publish: bool) -> crate::CargoResult<bool> {
83    let which = if dep.source_id().is_path() {
84        "path"
85    } else if dep.source_id().is_git() {
86        "git"
87    } else {
88        return Ok(false);
89    };
90
91    if !dep.specified_req() && dep.is_transitive() {
92        let dep_version_source = dep.registry_id().map_or_else(
93            || CRATES_IO_DOMAIN.to_string(),
94            |registry_id| registry_id.display_registry_name(),
95        );
96        anyhow::bail!(
97            "all dependencies must have a version requirement specified when {}.\n\
98             dependency `{}` does not specify a version\n\
99             Note: The {} dependency will use the version from {},\n\
100             the `{}` specification will be removed from the dependency declaration.",
101            if publish { "publishing" } else { "packaging" },
102            dep.package_name(),
103            if publish { "published" } else { "packaged" },
104            dep_version_source,
105            which,
106        )
107    }
108    Ok(true)
109}