cargo/ops/
mod.rs

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