Cache: Clear cache option (#1219)

README.md

@@ -131,7 +131,9 @@ ncu "/^(?!react-).*$/" # windows
 ## Options
 
 ```text
---cache                    Cache versions to the cache file (default: false)
+--cache                    Cache versions to the cache file
+--cacheClear               Clear the default cache, or the cache file
+                           specified by --cacheFile
 --cacheExpiration <min>    Cache expiration in minutes (default: 10)
 --cacheFile <path>         Filepath for the cache file (default:
                            "~/.ncu-cache.json")

src/cli-options.ts

@@ -277,7 +277,11 @@ const cliOptions: CLIOption[] = [
   {
     long: 'cache',
     description: 'Cache versions to the cache file',
-    default: false,
+    type: 'boolean',
+  },
+  {
+    long: 'cacheClear',
+    description: 'Clear the default cache, or the cache file specified by --cacheFile',
     type: 'boolean',
   },
   {

src/index.ts

@@ -6,6 +6,7 @@ import prompts from 'prompts-ncu'
 import spawn from 'spawn-please'
 import untildify from 'untildify'
 import { cliOptionsMap } from './cli-options'
+import { cacheClear } from './lib/cache'
 import chalk, { chalkInit } from './lib/chalk'
 import doctor from './lib/doctor'
 import exists from './lib/exists'
@@ -176,6 +177,10 @@ export async function run(
 
   print(options, 'Initializing', 'verbose')
 
+  if (options.cacheClear) {
+    await cacheClear(options)
+  }
+
   if (options.packageManager === 'npm' && !options.prefix) {
     options.prefix = await packageManagers.npm.defaultPrefix!(options)
   }

src/lib/cache.ts

@@ -28,8 +28,22 @@ export const defaultCacheFilename = '.ncu-cache.json'
 export const defaultCacheFile = `~/${defaultCacheFilename}`
 export const resolvedDefaultCacheFile = path.join(os.homedir(), defaultCacheFilename)
 
+/** Resolve the cache file path based on os/homedir. */
+export function resolveCacheFile(optionsCacheFile: string) {
+  return optionsCacheFile === defaultCacheFile ? resolvedDefaultCacheFile : optionsCacheFile
+}
+
+/** Clear the default cache, or the cache file specified by --cacheFile. */
+export async function cacheClear(options: Options) {
+  if (!options.cacheFile) {
+    return
+  }
+
+  await fs.promises.rm(resolveCacheFile(options.cacheFile), { force: true })
+}
+
 /**
- * The cacher stores key (name + version) - value (new version) pairs
+ * The cacher stores key (name + target) - value (new version) pairs
  * for quick updates across `ncu` calls.
  *
  * @returns
@@ -39,7 +53,7 @@ export default async function cacher(options: Omit<Options, 'cacher'>): Promise<
     return
   }
 
-  const cacheFile = options.cacheFile === defaultCacheFile ? resolvedDefaultCacheFile : options.cacheFile
+  const cacheFile = resolveCacheFile(options.cacheFile)
   let cacheData: CacheData = {}
   const cacheUpdates: Record<string, string> = {}
 
@@ -49,7 +63,7 @@ export default async function cacher(options: Omit<Options, 'cacher'>): Promise<
     const expired = checkCacheExpiration(cacheData, options.cacheExpiration)
     if (expired) {
       // reset cache
-      fs.promises.rm(cacheFile)
+      fs.promises.rm(cacheFile, { force: true })
       cacheData = {}
     }
   } catch (error) {

src/types/RunOptions.ts

@@ -9,6 +9,9 @@ export interface RunOptions {
   /** Cache versions to the cache file */
   cache?: boolean
 
+  /** Clear the default cache, or the cache file specified by --cacheFile */
+  cacheClear?: boolean
+
   /** Cache expiration in minutes (default: 10) */
   cacheExpiration?: number
 

test/cache.test.ts

@@ -89,4 +89,30 @@ describe('cache', () => {
       rimraf.sync(resolvedDefaultCacheFile)
     }
   })
+
+  it('clears the cache file', async () => {
+    const packageData = {
+      dependencies: {
+        // major version upgrade → 2.0.0
+        'ncu-test-v2': '^1.0.0',
+        // latest: minor version upgrade → 1.1.0
+        // greatest: prerelease → 1.2.0-dev.0
+        'ncu-test-tag': '1.0.0',
+        // latest: no upgrade
+        // greatest: prerelease → 2.0.0-alpha.2
+        'ncu-test-alpha': '1.0.0',
+      },
+    }
+
+    await ncu.run({ packageData, cache: true })
+
+    await ncu.run({ packageData, cacheClear: true })
+    let noCacheFile = false
+    try {
+      await fs.stat(resolvedDefaultCacheFile)
+    } catch (error) {
+      noCacheFile = true
+    }
+    expect(noCacheFile).eq(true)
+  })
 })