feat: suggest deno install --entrypoint instead of deno cache (#25228)

Hides `deno cache` from `--help` output.

---------

Signed-off-by: Asher Gomez <ashersaupingomez@gmail.com>
Co-authored-by: Bartek Iwańczuk <biwanczuk@gmail.com>

cli/args/flags.rs

@@ -1651,7 +1651,8 @@ Future runs of this module will trigger no downloads or compilation unless --rel
 
 <y>Read more:</> <c>https://docs.deno.com/go/cache</>"),
     UnstableArgsConfig::ResolutionOnly,
-  )
+)
+  .hide(true)
   .defer(|cmd| {
     compile_args(cmd)
       .arg(check_arg(false))

cli/args/lockfile.rs

@@ -246,7 +246,7 @@ impl CliLockfile {
       // has an extra newline at the end
       let diff = diff.trim_end();
       Err(deno_core::anyhow::anyhow!(
-        "The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.\nchanges:\n{diff}"
+        "The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.\nchanges:\n{diff}"
       ))
     } else {
       Ok(())

cli/lsp/language_server.rs

@@ -240,7 +240,7 @@ impl LanguageServer {
     }
   }
 
-  /// Similar to `deno cache` on the command line, where modules will be cached
+  /// Similar to `deno install --entrypoint` on the command line, where modules will be cached
   /// in the Deno cache, including any of their dependencies.
   pub async fn cache(
     &self,

tests/ffi/tests/ffi_types.ts

@@ -1,6 +1,6 @@
 // Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
 // deno-lint-ignore-file
-// Only for testing types. Invoke with `deno cache`
+// Only for testing types. Invoke with `deno install --entrypoint`
 
 const remote = Deno.dlopen("dummy_lib.so", {
   method1: { parameters: ["usize", "bool"], result: "void" },

tests/integration/npm_tests.rs

@@ -1821,7 +1821,10 @@ fn reload_info_not_found_cache_but_exists_remote() {
   {
     // create it
     temp_dir.write("deno.json", r#"{}"#);
-    test_context.new_command().args("cache main.ts").run();
+    test_context
+      .new_command()
+      .args("install --entrypoint main.ts")
+      .run();
     assert!(temp_dir.path().join("deno.lock").exists());
 
     // remove a version found in the lockfile

tests/specs/lockfile/frozen_lockfile/frozen_new_dep_cache.out

@@ -1,4 +1,4 @@
-error: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  4 | -    "npm:@denotest/add@1": "1.0.0"
  4 | +    "npm:@denotest/add@1": "1.0.0",

tests/specs/lockfile/frozen_lockfile/frozen_new_dep_dynamic_http.out

@@ -1,5 +1,5 @@
 Download http://localhost:4545/welcome.ts
-error: Uncaught (in promise) TypeError: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: Uncaught (in promise) TypeError: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
 10 | -  }
 10 | +  },

tests/specs/lockfile/frozen_lockfile/frozen_new_dep_dynamic_jsr.out

@@ -1,7 +1,7 @@
 Download http://127.0.0.1:4250/@denotest/add/meta.json
 Download http://127.0.0.1:4250/@denotest/add/1.0.0_meta.json
 Download http://127.0.0.1:4250/@denotest/add/1.0.0/mod.ts
-error: Uncaught (in promise) TypeError: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: Uncaught (in promise) TypeError: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  4 | -    "npm:@denotest/add@1": "1.0.0"
  4 | +    "jsr:@denotest/add@1": "1.0.0",

tests/specs/lockfile/frozen_lockfile/frozen_new_dep_dynamic_npm.out

@@ -1,5 +1,5 @@
 Download http://localhost:4260/@denotest/subtract
-error: Uncaught (in promise) TypeError: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: Uncaught (in promise) TypeError: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  4 | -    "npm:@denotest/add@1": "1.0.0"
  4 | +    "npm:@denotest/add@1": "1.0.0",

tests/specs/lockfile/frozen_lockfile/frozen_new_dep_jsr_cache.out

@@ -1,4 +1,4 @@
-error: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  4 | -    "jsr:@denotest/add@1": "1.0.0"
  5 | -  },

tests/specs/lockfile/frozen_lockfile/frozen_new_dep_jsr_run.out

@@ -1,6 +1,6 @@
 Download http://127.0.0.1:4250/@denotest/add/0.2.0_meta.json
 Download http://127.0.0.1:4250/@denotest/add/0.2.0/mod.ts
-error: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  4 | -    "jsr:@denotest/add@1": "1.0.0"
  5 | -  },

tests/specs/lockfile/frozen_lockfile/frozen_new_dep_run.out

@@ -1,5 +1,5 @@
 Download http://localhost:4260/@denotest/subtract
-error: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  4 | -    "npm:@denotest/add@1": "1.0.0"
  4 | +    "npm:@denotest/add@1": "1.0.0",

tests/specs/lockfile/frozen_lockfile/frozen_package_json_changed.out

@@ -1,5 +1,5 @@
 Download http://localhost:4260/@denotest/bin
-error: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  4 | -    "npm:@denotest/add@1": "1.0.0"
  4 | +    "npm:@denotest/add@1": "1.0.0",

tests/specs/lockfile/frozen_lockfile/frozen_package_json_changed_install.out

@@ -1,4 +1,4 @@
-error: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  4 | -    "npm:@denotest/add@1": "1.0.0"
  4 | +    "npm:@denotest/add@1": "1.0.0",

tests/specs/lockfile/frozen_lockfile/no_lockfile_run.out

@@ -1,5 +1,5 @@
 Download http://localhost:4260/@denotest/add
-error: The lockfile is out of date. Run `deno cache --frozen=false`, `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
+error: The lockfile is out of date. Run `deno install --frozen=false`, or rerun with `--frozen=false` to update it.
 changes:
  1 | -
  1 | +{