@mikeyt23/node-cli-utils 2.0.19 → 2.0.21

package/dist/cjs/dotnetUtils.d.ts

@@ -1,4 +1,5 @@
-export { getLatestNugetPackageVersion } from './NugetUtility.js';
+export { getInstalledSdkVersions, isSdkMajorVersionInstalled, isSdkMajorVersionOrGreaterInstalled } from './DotnetSdkUtility.js';
+export { getLatestNugetPackageVersion, getLatestMajorNugetPackageVersion } from './NugetUtility.js';
 /**
  * Runs dotnet build on the specified project.
  * @param projectPath Path to project file (like .csproj) or directory of project to build
@@ -13,20 +14,111 @@ export declare function dotnetBuild(projectPath: string): Promise<void>;
  * @param cwd Optionally run the command from another current working directory
  */
 export declare function dotnetPublish(projectPath?: string, configuration?: string, outputDir?: string, cwd?: string): Promise<void>;
+export interface EnsureDotnetToolOptions {
+    /** Defaults to `false`. */
+    global: boolean;
+    /** Optionally specify a dotnet version instead of using the latest installed version. */
+    dotnetMajorVersion?: number;
+    /**
+     * Current working directory to run the commands. Defaults to process current working directory.
+     *
+     * **Note:** this option is only relevant if the `global` option is `false`.
+     * */
+    cwd: string;
+}
 /**
- * Install or update a global dotnet tool.
- * @param toolName The name of the dotnet global tool
+ * Installs or updates a dotnet CLI tool. Only supports dotnet 5+. Runs a combination of `dotnet --list-sdks`, `dotnet new tool-manifest`,
+ * `dotnet tool uninstall` and `dotnet tool install`. Nuget.org will be queried to determine the latest compatible version of the tool for your
+ * latest installed dotnet SDK version, or the dotnet SDK version specified in options (the version passed in options must also be installed).
+ *
+ * Defaults that can be overridden with options ({@link EnsureDotnetToolOptions}):
+ * - Local install
+ * - Uses latest installed dotnet SDK version
+ * - Runs in the current working directory
+ *
+ * For local installs, a new tool manifest will be created with the command `dotnet new tool-manifest` if it doesn't already exist. Note that dotnet
+ * searches up the directory tree until it finds a tool manifest.
+ *
+ * If the tool is already installed and the version installed is newer (because an older dotnet version was specified in the options), the installed
+ * version will be overwritten with the latest compatible version for the dotnet version specified in the options rather than trying to simply run the
+ * `dotnet tool update` command, which would throw an error in this scenario.
+ *
+ * Docs for dotnet tools: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
+ *
+ * Docs for `dotnet tool install`: https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-tool-install
  */
-export declare function installOrUpdateDotnetGlobalTool(toolName: string): Promise<void>;
+export declare function ensureDotnetTool(toolName: string, options?: Partial<EnsureDotnetToolOptions>): Promise<void>;
 /**
- * Spawns a process that runs the necessary commands to install or update the dotnet-ef tool globally on the system.
+ * Runs `dotnet new tool-manifest` if `./.config/dotnet-tools.json` does not exist. Uses the current working directory.
+ *
+ * The tool manifest is required when installing local dotnet tools. Note that dotnet searches up the directory tree
+ * for a tool manifest, so tools can be installed in a solution root directory and be picked up by dotnet when run
+ * in subdirectories.
  */
-export declare function installOrUpdateDotnetEfTool(): Promise<void>;
-export declare function installOrUpdateReportGeneratorTool(): Promise<void>;
+export declare function ensureDotnetToolManifest(cwd?: string): Promise<void>;
+/**
+ * Ensures the latest version of `dotnet-reportgenerator-globaltool` is installed as a "dotnet local tool" in the current
+ * working directory with the latest version that is compatible with the latest dotnet SDK version currently installed.
+ *
+ * This package is used to convert code coverage data into a human-readable report: https://github.com/danielpalme/ReportGenerator
+ *
+ * Unsure why the name of the tool has "global" in it - it is neither local nor global (can be installed as either).
+ *
+ * Use {@link ensureDotnetTool} directly for different options.
+ */
+export declare function ensureReportGeneratorTool(): Promise<void>;
 /**
  * Spawns a process that runs the following commands to clean and re-install the dotnet dev certs:
  * - dotnet dev-certs https --clean
  * - dotnet dev-certs https -t
  */
 export declare function configureDotnetDevCerts(): Promise<void>;
+declare const targetFrameworkMonikersImmutable: readonly ["netcoreapp1.0", "netcoreapp1.1", "netcoreapp2.0", "netcoreapp2.1", "netcoreapp2.2", "netcoreapp3.0", "netcoreapp3.1", "net5.0", "net6.0", "net7.0", "net8.0", "netstandard1.0", "netstandard1.1", "netstandard1.2", "netstandard1.3", "netstandard1.4", "netstandard1.5", "netstandard1.6", "netstandard2.0", "netstandard2.1", "net11", "net20", "net35", "net40", "net403", "net45", "net451", "net452", "net46", "net461", "net462", "net47", "net471", "net472", "net48", "netcore", "netcore45", "netcore451", "netmf", "sl4", "sl5", "wp", "wp7", "wp75", "wp8", "wp81", "wpa81", "uap", "uap10.0", "net5.0-windows", "net6.0-android", "net6.0-ios", "net6.0-maccatalyst", "net6.0-macos", "net6.0-tvos", "net6.0-windows", "net7.0-android", "net7.0-ios", "net7.0-maccatalyst", "net7.0-macos", "net7.0-tvos", "net7.0-windows", "net8.0", "net8.0-android", "net8.0-browser", "net8.0-ios", "net8.0-maccatalyst", "net8.0-macos", "net8.0-tvos", "net8.0-windows"];
+/**
+ * Type guard for valid .net framework TFMs (target framework moniker).
+ *
+ * See https://learn.microsoft.com/en-us/dotnet/standard/frameworks
+ */
+export type TargetFrameworkMoniker = typeof targetFrameworkMonikersImmutable[number];
+/**
+ * Scraped from https://learn.microsoft.com/en-us/dotnet/standard/frameworks.
+ * No intention to actually support operations for all of these, but having a list allows checking if a string
+ * is a valid TFM (target framework moniker) - see type guard: {@link TargetFrameworkMoniker}.
+ *
+ * @example
+ * ```
+ * const isValidTfm = targetFrameworkMonikers.includes(someStringVar)
+ * ```
+ */
+export declare const targetFrameworkMonikers: string[];
+export declare function isValidTargetFrameworkMoniker(targetFrameworkMoniker: string): boolean;
+declare const dotnetCoreTargetFrameworkMonikersImmutable: readonly ["net5.0", "net6.0", "net7.0", "net8.0"];
+/**
+ * Type guard for {@link dotnetCoreTargetFrameworkMonikers}.
+ */
+export type DotnetCoreTargetFrameworkMoniker = typeof dotnetCoreTargetFrameworkMonikersImmutable[number];
+/**
+ * Subset of {@link targetFrameworkMonikers} with modern dotnet core versions.
+ *
+ * Most of my scripting will only support modern versions of dotnet core, so this will often be used for checks instead of the full list.
+ */
+export declare const dotnetCoreTargetFrameworkMonikers: string[];
+/**
+ * Check if a string is a valid TFM (Target Framework Moniker) in the form "netX.Y" where X is a number >= 5 and Y is any number.
+ * @param targetFrameworkMoniker The dotnet target framework moniker to check.
+ * @returns `true` if the string is a properly formatted "netX.Y" TFM, `false` otherwise
+ */
+export declare function isTfmNet5Plus(targetFrameworkMoniker: string): boolean;
+/**
+ * Simple helper method to convert one of the newer dotnet core TFM's to the major SDK version number in a safe way.
+ */
+export declare function netCoreTfmToSdkMajorVersion(tfm: TargetFrameworkMoniker): number;
+/**
+ * Get sorted SDK version numbers for dotnet core 5+ (from {@link dotnetCoreTargetFrameworkMonikers}).
+ */
+export declare function getDotnetCoreSdkVersions(): number[];
+/**
+ * Simple helper method to convert an SDK version to the TFM (target framework moniker). Only supporting new dotnet core versions.
+ */
+export declare function sdkVersionToTfm(sdkVersion: number): TargetFrameworkMoniker;
 //# sourceMappingURL=dotnetUtils.d.ts.map

package/dist/cjs/dotnetUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dotnetUtils.d.ts","sourceRoot":"","sources":["../../src/dotnetUtils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAEhE;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,iBAGpD;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,GAAE,MAAa,EAAE,aAAa,GAAE,MAAkB,EAAE,SAAS,GAAE,MAAkB,EAAE,GAAG,CAAC,EAAE,MAAM,iBAY7I;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,iBAYrE;AAED;;GAEG;AACH,wBAAsB,2BAA2B,kBAEhD;AAED,wBAAsB,kCAAkC,kBAEvD;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,kBAG5C"}
+{"version":3,"file":"dotnetUtils.d.ts","sourceRoot":"","sources":["../../src/dotnetUtils.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAA;AAChI,OAAO,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAA;AAEnG;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,iBAGpD;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,GAAE,MAAa,EAAE,aAAa,GAAE,MAAkB,EAAE,SAAS,GAAE,MAAkB,EAAE,GAAG,CAAC,EAAE,MAAM,iBAY7I;AAED,MAAM,WAAW,uBAAuB;IACtC,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;SAIK;IACL,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,iBA8ElG;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,GAAE,MAAsB,iBAYzE;AA6DD;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,kBAE9C;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,kBAG5C;AAID,QAAA,MAAM,gCAAgC,y7BAuE5B,CAAA;AAEV;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,gCAAgC,CAAC,MAAM,CAAC,CAAA;AAEpF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,EAA0C,CAAA;AAEtF,wBAAgB,6BAA6B,CAAC,sBAAsB,EAAE,MAAM,WAE3E;AAED,QAAA,MAAM,0CAA0C,mDAKtC,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,OAAO,0CAA0C,CAAC,MAAM,CAAC,CAAA;AAExG;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,EAAoD,CAAA;AAE1G;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,sBAAsB,EAAE,MAAM,WAI3D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,sBAAsB,UAQtE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,aAWvC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAK1E"}

package/dist/cjs/dotnetUtils.js

@@ -1,9 +1,22 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.configureDotnetDevCerts = exports.installOrUpdateReportGeneratorTool = exports.installOrUpdateDotnetEfTool = exports.installOrUpdateDotnetGlobalTool = exports.dotnetPublish = exports.dotnetBuild = exports.getLatestNugetPackageVersion = void 0;
+exports.sdkVersionToTfm = exports.getDotnetCoreSdkVersions = exports.netCoreTfmToSdkMajorVersion = exports.isTfmNet5Plus = exports.dotnetCoreTargetFrameworkMonikers = exports.isValidTargetFrameworkMoniker = exports.targetFrameworkMonikers = exports.configureDotnetDevCerts = exports.ensureReportGeneratorTool = exports.ensureDotnetToolManifest = exports.ensureDotnetTool = exports.dotnetPublish = exports.dotnetBuild = exports.getLatestMajorNugetPackageVersion = exports.getLatestNugetPackageVersion = exports.isSdkMajorVersionOrGreaterInstalled = exports.isSdkMajorVersionInstalled = exports.getInstalledSdkVersions = void 0;
+const fs_1 = __importDefault(require("fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const DotnetSdkUtility_js_1 = require("./DotnetSdkUtility.js");
+const NugetUtility_js_1 = require("./NugetUtility.js");
 const generalUtils_js_1 = require("./generalUtils.js");
-var NugetUtility_js_1 = require("./NugetUtility.js");
-Object.defineProperty(exports, "getLatestNugetPackageVersion", { enumerable: true, get: function () { return NugetUtility_js_1.getLatestNugetPackageVersion; } });
+const toolManifestPartialPath = '.config/dotnet-tools.json';
+var DotnetSdkUtility_js_2 = require("./DotnetSdkUtility.js");
+Object.defineProperty(exports, "getInstalledSdkVersions", { enumerable: true, get: function () { return DotnetSdkUtility_js_2.getInstalledSdkVersions; } });
+Object.defineProperty(exports, "isSdkMajorVersionInstalled", { enumerable: true, get: function () { return DotnetSdkUtility_js_2.isSdkMajorVersionInstalled; } });
+Object.defineProperty(exports, "isSdkMajorVersionOrGreaterInstalled", { enumerable: true, get: function () { return DotnetSdkUtility_js_2.isSdkMajorVersionOrGreaterInstalled; } });
+var NugetUtility_js_2 = require("./NugetUtility.js");
+Object.defineProperty(exports, "getLatestNugetPackageVersion", { enumerable: true, get: function () { return NugetUtility_js_2.getLatestNugetPackageVersion; } });
+Object.defineProperty(exports, "getLatestMajorNugetPackageVersion", { enumerable: true, get: function () { return NugetUtility_js_2.getLatestMajorNugetPackageVersion; } });
 /**
  * Runs dotnet build on the specified project.
  * @param projectPath Path to project file (like .csproj) or directory of project to build
@@ -36,35 +49,176 @@ async function dotnetPublish(projectPath = './', configuration = 'Release', outp
 }
 exports.dotnetPublish = dotnetPublish;
 /**
- * Install or update a global dotnet tool.
- * @param toolName The name of the dotnet global tool
+ * Installs or updates a dotnet CLI tool. Only supports dotnet 5+. Runs a combination of `dotnet --list-sdks`, `dotnet new tool-manifest`,
+ * `dotnet tool uninstall` and `dotnet tool install`. Nuget.org will be queried to determine the latest compatible version of the tool for your
+ * latest installed dotnet SDK version, or the dotnet SDK version specified in options (the version passed in options must also be installed).
+ *
+ * Defaults that can be overridden with options ({@link EnsureDotnetToolOptions}):
+ * - Local install
+ * - Uses latest installed dotnet SDK version
+ * - Runs in the current working directory
+ *
+ * For local installs, a new tool manifest will be created with the command `dotnet new tool-manifest` if it doesn't already exist. Note that dotnet
+ * searches up the directory tree until it finds a tool manifest.
+ *
+ * If the tool is already installed and the version installed is newer (because an older dotnet version was specified in the options), the installed
+ * version will be overwritten with the latest compatible version for the dotnet version specified in the options rather than trying to simply run the
+ * `dotnet tool update` command, which would throw an error in this scenario.
+ *
+ * Docs for dotnet tools: https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools
+ *
+ * Docs for `dotnet tool install`: https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-tool-install
  */
-async function installOrUpdateDotnetGlobalTool(toolName) {
-    if (!(await (0, generalUtils_js_1.which)('dotnet')).location) {
-        throw new Error('"dotnet" is not installed');
+async function ensureDotnetTool(toolName, options) {
+    var _a;
+    (0, NugetUtility_js_1.validatePackageName)(toolName);
+    const globalInstall = (_a = options === null || options === void 0 ? void 0 : options.global) !== null && _a !== void 0 ? _a : false;
+    let cwd;
+    if (options === null || options === void 0 ? void 0 : options.cwd) {
+        cwd = options.cwd;
+        (0, generalUtils_js_1.requireValidPath)('options.cwd', cwd);
     }
-    const installed = (await (0, generalUtils_js_1.which)(toolName)).location;
-    if (installed) {
-        (0, generalUtils_js_1.log)(`${toolName} tool already installed, updating...`);
+    else {
+        cwd = process.cwd();
+    }
+    const dotnetVersions = await (0, DotnetSdkUtility_js_1.getInstalledSdkVersions)();
+    if (dotnetVersions.length === 0) {
+        throw new Error('dotnet is not installed');
+    }
+    let dotnetVersion;
+    if (options === null || options === void 0 ? void 0 : options.dotnetMajorVersion) {
+        // Use dotnet version specified in options
+        dotnetVersion = options.dotnetMajorVersion;
+        if (!dotnetVersions.some(v => v.major === dotnetVersion)) {
+            throw new Error(`Cannot install tool with options specified - dotnet version ${dotnetVersion} is not installed`);
+        }
     }
     else {
-        (0, generalUtils_js_1.log)(`${toolName} tool not installed, installing...`);
+        // Or, latest installed version
+        dotnetVersion = [...dotnetVersions].sort((a, b) => b.major - a.major)[0].major;
+    }
+    if (dotnetVersion < 5) {
+        throw new Error('Only dotnet 5 and above is supported for this utility method');
+    }
+    const tfm = sdkVersionToTfm(dotnetVersion);
+    (0, generalUtils_js_1.log)(`using dotnet version ${dotnetVersion} (TFM: ${tfm})`);
+    (0, generalUtils_js_1.log)(`ensuring dotnet tool "${toolName}" is installed ${globalInstall ? 'global' : 'local'}ly with the latest compatible version for dotnet ${dotnetVersion}`);
+    (0, generalUtils_js_1.log)(`looking up latest compatible version in Nuget repository for tool "${toolName}"`);
+    const latestToolVersion = await (0, NugetUtility_js_1.getLatestNugetPackageVersion)(toolName, tfm);
+    if (latestToolVersion === null) {
+        throw new Error(`No compatible version of ${toolName} was found for TFM ${tfm}`);
+    }
+    (0, generalUtils_js_1.log)(`found compatible tool version: ${latestToolVersion}`);
+    (0, generalUtils_js_1.log)(`checking if ${globalInstall ? 'global' : 'local'} dotnet tool is installed`);
+    const installedVersion = await getDotnetToolInstalledVersion(toolName, globalInstall, cwd);
+    const commandLocalitySwitch = globalInstall ? '--global' : '--local';
+    if (installedVersion === null) {
+        (0, generalUtils_js_1.log)(`dotnet tool is not installed, attempting to install`);
+        if (!globalInstall) {
+            await ensureDotnetToolManifest(cwd);
+        }
+        const command = `dotnet tool install ${toolName} ${commandLocalitySwitch} --version ${latestToolVersion}`;
+        (0, generalUtils_js_1.log)(`installing with command: ${command}`);
+        await (0, generalUtils_js_1.spawnAsync)('dotnet', command.split(' '), { throwOnNonZero: true, cwd: cwd });
+        (0, generalUtils_js_1.log)(`finished tool install`);
+    }
+    else {
+        (0, generalUtils_js_1.log)(`found installed dotnet tool "${toolName}" version ${installedVersion}`);
+        if (installedVersion === latestToolVersion) {
+            (0, generalUtils_js_1.log)(`the most recent version of the tool is already installed - finished`);
+            return;
+        }
+        (0, generalUtils_js_1.log)(`latest version and installed version do not match - uninstalling the existing version before re-installing`);
+        if (!globalInstall) {
+            await ensureDotnetToolManifest();
+        }
+        const uninstallCommand = `dotnet tool uninstall ${toolName} ${commandLocalitySwitch}`;
+        (0, generalUtils_js_1.log)(`uninstalling with command: ${uninstallCommand}`);
+        await (0, generalUtils_js_1.spawnAsync)('dotnet', uninstallCommand.split(' '), { throwOnNonZero: true, cwd: cwd });
+        const command = `dotnet tool install ${toolName} ${commandLocalitySwitch} --version ${latestToolVersion}`;
+        (0, generalUtils_js_1.log)(`installing with command: ${command}`);
+        await (0, generalUtils_js_1.spawnAsync)('dotnet', command.split(' '), { throwOnNonZero: true, cwd: cwd });
+        (0, generalUtils_js_1.log)(`finished tool install`);
     }
-    const args = ['tool', installed ? 'update' : 'install', '--global', toolName];
-    await (0, generalUtils_js_1.spawnAsync)('dotnet', args);
 }
-exports.installOrUpdateDotnetGlobalTool = installOrUpdateDotnetGlobalTool;
+exports.ensureDotnetTool = ensureDotnetTool;
 /**
- * Spawns a process that runs the necessary commands to install or update the dotnet-ef tool globally on the system.
+ * Runs `dotnet new tool-manifest` if `./.config/dotnet-tools.json` does not exist. Uses the current working directory.
+ *
+ * The tool manifest is required when installing local dotnet tools. Note that dotnet searches up the directory tree
+ * for a tool manifest, so tools can be installed in a solution root directory and be picked up by dotnet when run
+ * in subdirectories.
  */
-async function installOrUpdateDotnetEfTool() {
-    await installOrUpdateDotnetGlobalTool('dotnet-ef');
+async function ensureDotnetToolManifest(cwd = process.cwd()) {
+    (0, generalUtils_js_1.requireValidPath)('cwd', cwd);
+    const toolsManifestPath = node_path_1.default.join(cwd, toolManifestPartialPath);
+    (0, generalUtils_js_1.log)(`checking if tool manifest exists at ${toolsManifestPath}`);
+    const toolManifestExists = fs_1.default.existsSync(toolsManifestPath);
+    if (toolManifestExists) {
+        (0, generalUtils_js_1.log)(`tool manifest already exists`);
+    }
+    else {
+        (0, generalUtils_js_1.log)(`tool manifest does not exist, attempting to create with command: dotnet new tool-manifest`);
+        await (0, generalUtils_js_1.spawnAsync)('dotnet', ['new', 'tool-manifest'], { throwOnNonZero: true, cwd });
+        (0, generalUtils_js_1.log)(`created tool manifest at ${toolsManifestPath}`);
+    }
 }
-exports.installOrUpdateDotnetEfTool = installOrUpdateDotnetEfTool;
-async function installOrUpdateReportGeneratorTool() {
-    await installOrUpdateDotnetGlobalTool('dotnet-reportgenerator-globaltool');
+exports.ensureDotnetToolManifest = ensureDotnetToolManifest;
+async function getDotnetToolInstalledVersion(toolName, globalInstall, cwd) {
+    (0, NugetUtility_js_1.validatePackageName)(toolName);
+    (0, generalUtils_js_1.requireValidPath)('cwd', cwd);
+    const result = await (0, generalUtils_js_1.simpleSpawnAsync)('dotnet', ['tool', 'list', globalInstall ? '--global' : '--local'], { cwd: cwd });
+    const lines = result.stdoutLines;
+    if (!lines[0].startsWith('Package Id') || !lines[1].startsWith('-')) {
+        throw new Error(`Unexpected output for command "dotnet tool list": ${JSON.stringify(lines)}`);
+    }
+    if (lines.length < 3) {
+        return null;
+    }
+    const versionColumnIndex = lines[0].indexOf('Version');
+    const commandsColumnIndex = lines[0].indexOf('Commands');
+    const manifestColumnIndex = lines[0].indexOf('Manifest');
+    if (versionColumnIndex === -1) {
+        throw new Error(`Unexpectedly missing "Version" header in "dotnet tool list" output: ${JSON.stringify(lines)}`);
+    }
+    const tools = [];
+    for (let i = 2; i < lines.length; i++) {
+        const packageId = lines[i].substring(0, versionColumnIndex).trim();
+        const version = lines[i].substring(versionColumnIndex, commandsColumnIndex !== -1 ? commandsColumnIndex : lines[i].length - 1).trim();
+        const commands = commandsColumnIndex !== -1 ? lines[i].substring(commandsColumnIndex, manifestColumnIndex !== -1 ? manifestColumnIndex : lines[i].length - 1).trim() : undefined;
+        const manifest = manifestColumnIndex !== -1 ? lines[i].substring(manifestColumnIndex).trim() : undefined;
+        tools.push({
+            packageId,
+            version,
+            commands,
+            manifest
+        });
+    }
+    const match = tools.find(t => t.packageId === toolName);
+    if (match === undefined) {
+        return null;
+    }
+    // For a local install, dotnet will search up in the directory tree until it finds a ".config" directory with a tool manifest, but
+    // that might not be obvious to the caller, so log a warning with the path to the manifest that was used if it's not int the cwd.
+    if (!globalInstall && !fs_1.default.existsSync(node_path_1.default.join(cwd, toolManifestPartialPath))) {
+        (0, generalUtils_js_1.log)(`${generalUtils_js_1.Emoji.Warning} local tool install is not in the current working directory - it is listed as ${match.manifest}`);
+    }
+    return match.version;
 }
-exports.installOrUpdateReportGeneratorTool = installOrUpdateReportGeneratorTool;
+/**
+ * Ensures the latest version of `dotnet-reportgenerator-globaltool` is installed as a "dotnet local tool" in the current
+ * working directory with the latest version that is compatible with the latest dotnet SDK version currently installed.
+ *
+ * This package is used to convert code coverage data into a human-readable report: https://github.com/danielpalme/ReportGenerator
+ *
+ * Unsure why the name of the tool has "global" in it - it is neither local nor global (can be installed as either).
+ *
+ * Use {@link ensureDotnetTool} directly for different options.
+ */
+async function ensureReportGeneratorTool() {
+    await ensureDotnetTool('dotnet-reportgenerator-globaltool');
+}
+exports.ensureReportGeneratorTool = ensureReportGeneratorTool;
 /**
  * Spawns a process that runs the following commands to clean and re-install the dotnet dev certs:
  * - dotnet dev-certs https --clean
@@ -75,4 +229,155 @@ async function configureDotnetDevCerts() {
     await (0, generalUtils_js_1.spawnAsync)('dotnet', ['dev-certs', 'https', '-t']);
 }
 exports.configureDotnetDevCerts = configureDotnetDevCerts;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG90bmV0VXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZG90bmV0VXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsdURBQWtHO0FBTWxHLHFEQUFnRTtBQUF2RCwrSEFBQSw0QkFBNEIsT0FBQTtBQUVyQzs7OztHQUlHO0FBQ0ksS0FBSyxVQUFVLFdBQVcsQ0FBQyxXQUFtQjtJQUNuRCxJQUFBLGtDQUFnQixFQUFDLGFBQWEsRUFBRSxXQUFXLENBQUMsQ0FBQTtJQUM1QyxNQUFNLElBQUEsNEJBQVUsRUFBQyxRQUFRLEVBQUUsQ0FBQyxPQUFPLEVBQUUsV0FBVyxDQUFDLEVBQUUsRUFBRSxjQUFjLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQTtBQUM5RSxDQUFDO0FBSEQsa0NBR0M7QUFFRDs7Ozs7O0dBTUc7QUFDSSxLQUFLLFVBQVUsYUFBYSxDQUFDLGNBQXNCLElBQUksRUFBRSxnQkFBd0IsU0FBUyxFQUFFLFlBQW9CLFNBQVMsRUFBRSxHQUFZO0lBQzVJLElBQUEsa0NBQWdCLEVBQUMsYUFBYSxFQUFFLFdBQVcsQ0FBQyxDQUFBO0lBQzVDLElBQUEsK0JBQWEsRUFBQyxXQUFXLEVBQUUsU0FBUyxDQUFDLENBQUE7SUFDckMsSUFBQSwrQkFBYSxFQUFDLGVBQWUsRUFBRSxhQUFhLENBQUMsQ0FBQTtJQUM3QyxJQUFJLEdBQUcsRUFBRTtRQUNQLElBQUEsa0NBQWdCLEVBQUMsS0FBSyxFQUFFLEdBQUcsQ0FBQyxDQUFBO0tBQzdCO0lBQ0QsTUFBTSxJQUFJLEdBQUcsQ0FBQyxTQUFTLEVBQUUsV0FBVyxFQUFFLElBQUksRUFBRSxhQUFhLEVBQUUsSUFBSSxFQUFFLFNBQVMsQ0FBQyxDQUFBO0lBQzNFLE1BQU0sWUFBWSxHQUFHLGtCQUFrQixJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUE7SUFDdkQsTUFBTSxlQUFlLEdBQUcsR0FBRyxDQUFDLENBQUMsQ0FBQyxXQUFXLEdBQUcsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUE7SUFDbkQsSUFBQSx1QkFBSyxFQUFDLEdBQUcsWUFBWSxHQUFHLGVBQWUsRUFBRSxDQUFDLENBQUE7SUFDMUMsTUFBTSxJQUFBLDRCQUFVLEVBQUMsUUFBUSxFQUFFLElBQUksRUFBRSxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsQ0FBQyxDQUFBO0FBQ2hELENBQUM7QUFaRCxzQ0FZQztBQUVEOzs7R0FHRztBQUNJLEtBQUssVUFBVSwrQkFBK0IsQ0FBQyxRQUFnQjtJQUNwRSxJQUFJLENBQUMsQ0FBQyxNQUFNLElBQUEsdUJBQUssRUFBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLFFBQVEsRUFBRTtRQUNyQyxNQUFNLElBQUksS0FBSyxDQUFDLDJCQUEyQixDQUFDLENBQUE7S0FDN0M7SUFDRCxNQUFNLFNBQVMsR0FBRyxDQUFDLE1BQU0sSUFBQSx1QkFBSyxFQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFBO0lBQ2xELElBQUksU0FBUyxFQUFFO1FBQ2IsSUFBQSxxQkFBRyxFQUFDLEdBQUcsUUFBUSxzQ0FBc0MsQ0FBQyxDQUFBO0tBQ3ZEO1NBQU07UUFDTCxJQUFBLHFCQUFHLEVBQUMsR0FBRyxRQUFRLG9DQUFvQyxDQUFDLENBQUE7S0FDckQ7SUFDRCxNQUFNLElBQUksR0FBRyxDQUFDLE1BQU0sRUFBRSxTQUFTLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsU0FBUyxFQUFFLFVBQVUsRUFBRSxRQUFRLENBQUMsQ0FBQTtJQUM3RSxNQUFNLElBQUEsNEJBQVUsRUFBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLENBQUE7QUFDbEMsQ0FBQztBQVpELDBFQVlDO0FBRUQ7O0dBRUc7QUFDSSxLQUFLLFVBQVUsMkJBQTJCO0lBQy9DLE1BQU0sK0JBQStCLENBQUMsV0FBVyxDQUFDLENBQUE7QUFDcEQsQ0FBQztBQUZELGtFQUVDO0FBRU0sS0FBSyxVQUFVLGtDQUFrQztJQUN0RCxNQUFNLCtCQUErQixDQUFDLG1DQUFtQyxDQUFDLENBQUE7QUFDNUUsQ0FBQztBQUZELGdGQUVDO0FBRUQ7Ozs7R0FJRztBQUNJLEtBQUssVUFBVSx1QkFBdUI7SUFDM0MsTUFBTSxJQUFBLDRCQUFVLEVBQUMsUUFBUSxFQUFFLENBQUMsV0FBVyxFQUFFLE9BQU8sRUFBRSxTQUFTLENBQUMsQ0FBQyxDQUFBO0lBQzdELE1BQU0sSUFBQSw0QkFBVSxFQUFDLFFBQVEsRUFBRSxDQUFDLFdBQVcsRUFBRSxPQUFPLEVBQUUsSUFBSSxDQUFDLENBQUMsQ0FBQTtBQUMxRCxDQUFDO0FBSEQsMERBR0MifQ==
+// This immutable const is used for the type guard.
+// There is also a non-immutable array to allow something like: const isValidTfm = targetFrameworkMonikers.includes(someStringVar)
+const targetFrameworkMonikersImmutable = [
+    'netcoreapp1.0',
+    'netcoreapp1.1',
+    'netcoreapp2.0',
+    'netcoreapp2.1',
+    'netcoreapp2.2',
+    'netcoreapp3.0',
+    'netcoreapp3.1',
+    'net5.0',
+    'net6.0',
+    'net7.0',
+    'net8.0',
+    'netstandard1.0',
+    'netstandard1.1',
+    'netstandard1.2',
+    'netstandard1.3',
+    'netstandard1.4',
+    'netstandard1.5',
+    'netstandard1.6',
+    'netstandard2.0',
+    'netstandard2.1',
+    'net11',
+    'net20',
+    'net35',
+    'net40',
+    'net403',
+    'net45',
+    'net451',
+    'net452',
+    'net46',
+    'net461',
+    'net462',
+    'net47',
+    'net471',
+    'net472',
+    'net48',
+    'netcore',
+    'netcore45',
+    'netcore451',
+    'netmf',
+    'sl4',
+    'sl5',
+    'wp',
+    'wp7',
+    'wp75',
+    'wp8',
+    'wp81',
+    'wpa81',
+    'uap',
+    'uap10.0',
+    'net5.0-windows',
+    'net6.0-android',
+    'net6.0-ios',
+    'net6.0-maccatalyst',
+    'net6.0-macos',
+    'net6.0-tvos',
+    'net6.0-windows',
+    'net7.0-android',
+    'net7.0-ios',
+    'net7.0-maccatalyst',
+    'net7.0-macos',
+    'net7.0-tvos',
+    'net7.0-windows',
+    'net8.0',
+    'net8.0-android',
+    'net8.0-browser',
+    'net8.0-ios',
+    'net8.0-maccatalyst',
+    'net8.0-macos',
+    'net8.0-tvos',
+    'net8.0-windows'
+];
+/**
+ * Scraped from https://learn.microsoft.com/en-us/dotnet/standard/frameworks.
+ * No intention to actually support operations for all of these, but having a list allows checking if a string
+ * is a valid TFM (target framework moniker) - see type guard: {@link TargetFrameworkMoniker}.
+ *
+ * @example
+ * ```
+ * const isValidTfm = targetFrameworkMonikers.includes(someStringVar)
+ * ```
+ */
+exports.targetFrameworkMonikers = [...targetFrameworkMonikersImmutable];
+function isValidTargetFrameworkMoniker(targetFrameworkMoniker) {
+    return exports.targetFrameworkMonikers.includes(targetFrameworkMoniker);
+}
+exports.isValidTargetFrameworkMoniker = isValidTargetFrameworkMoniker;
+const dotnetCoreTargetFrameworkMonikersImmutable = [
+    'net5.0',
+    'net6.0',
+    'net7.0',
+    'net8.0'
+];
+/**
+ * Subset of {@link targetFrameworkMonikers} with modern dotnet core versions.
+ *
+ * Most of my scripting will only support modern versions of dotnet core, so this will often be used for checks instead of the full list.
+ */
+exports.dotnetCoreTargetFrameworkMonikers = [...dotnetCoreTargetFrameworkMonikersImmutable];
+/**
+ * Check if a string is a valid TFM (Target Framework Moniker) in the form "netX.Y" where X is a number >= 5 and Y is any number.
+ * @param targetFrameworkMoniker The dotnet target framework moniker to check.
+ * @returns `true` if the string is a properly formatted "netX.Y" TFM, `false` otherwise
+ */
+function isTfmNet5Plus(targetFrameworkMoniker) {
+    (0, generalUtils_js_1.requireString)('targetFrameworkMoniker', targetFrameworkMoniker);
+    const netFormatPattern = /^net([5-9]|\d{2,})\.\d+$/;
+    return netFormatPattern.test(targetFrameworkMoniker);
+}
+exports.isTfmNet5Plus = isTfmNet5Plus;
+/**
+ * Simple helper method to convert one of the newer dotnet core TFM's to the major SDK version number in a safe way.
+ */
+function netCoreTfmToSdkMajorVersion(tfm) {
+    if (!exports.targetFrameworkMonikers.includes(tfm)) {
+        throw new Error(`Invalid TFM: ${tfm}`);
+    }
+    if (!exports.dotnetCoreTargetFrameworkMonikers.includes(tfm)) {
+        throw new Error(`TFM "${tfm}" is not supported - this method only allows newer dotnet core versions: ${exports.dotnetCoreTargetFrameworkMonikers.join(', ')}`);
+    }
+    return parseInt(tfm[3], 10);
+}
+exports.netCoreTfmToSdkMajorVersion = netCoreTfmToSdkMajorVersion;
+/**
+ * Get sorted SDK version numbers for dotnet core 5+ (from {@link dotnetCoreTargetFrameworkMonikers}).
+ */
+function getDotnetCoreSdkVersions() {
+    const versions = [];
+    for (const tfm of exports.dotnetCoreTargetFrameworkMonikers) {
+        const dotIndex = tfm.indexOf('.');
+        if (dotIndex === -1 || !tfm.startsWith('net')) {
+            continue;
+        }
+        const numString = tfm.substring(3, dotIndex);
+        versions.push(parseInt(numString, 10));
+    }
+    return [...versions].sort((a, b) => a - b);
+}
+exports.getDotnetCoreSdkVersions = getDotnetCoreSdkVersions;
+/**
+ * Simple helper method to convert an SDK version to the TFM (target framework moniker). Only supporting new dotnet core versions.
+ */
+function sdkVersionToTfm(sdkVersion) {
+    if (typeof sdkVersion !== 'number' || sdkVersion < 5 || sdkVersion > 8) {
+        throw new Error(`Invalid SDK version: ${sdkVersion} (only supports version >= 5 and <= 8)`);
+    }
+    return `net${sdkVersion}.0`;
+}
+exports.sdkVersionToTfm = sdkVersionToTfm;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG90bmV0VXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZG90bmV0VXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBQUEsNENBQW1CO0FBQ25CLDBEQUE0QjtBQUM1QiwrREFBK0Q7QUFDL0QsdURBQXFGO0FBQ3JGLHVEQUFvSDtBQUVwSCxNQUFNLHVCQUF1QixHQUFHLDJCQUEyQixDQUFBO0FBTTNELDZEQUFnSTtBQUF2SCw4SEFBQSx1QkFBdUIsT0FBQTtBQUFFLGlJQUFBLDBCQUEwQixPQUFBO0FBQUUsMElBQUEsbUNBQW1DLE9BQUE7QUFDakcscURBQW1HO0FBQTFGLCtIQUFBLDRCQUE0QixPQUFBO0FBQUUsb0lBQUEsaUNBQWlDLE9BQUE7QUFFeEU7Ozs7R0FJRztBQUNJLEtBQUssVUFBVSxXQUFXLENBQUMsV0FBbUI7SUFDbkQsSUFBQSxrQ0FBZ0IsRUFBQyxhQUFhLEVBQUUsV0FBVyxDQUFDLENBQUE7SUFDNUMsTUFBTSxJQUFBLDRCQUFVLEVBQUMsUUFBUSxFQUFFLENBQUMsT0FBTyxFQUFFLFdBQVcsQ0FBQyxFQUFFLEVBQUUsY0FBYyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUE7QUFDOUUsQ0FBQztBQUhELGtDQUdDO0FBRUQ7Ozs7OztHQU1HO0FBQ0ksS0FBSyxVQUFVLGFBQWEsQ0FBQyxjQUFzQixJQUFJLEVBQUUsZ0JBQXdCLFNBQVMsRUFBRSxZQUFvQixTQUFTLEVBQUUsR0FBWTtJQUM1SSxJQUFBLGtDQUFnQixFQUFDLGFBQWEsRUFBRSxXQUFXLENBQUMsQ0FBQTtJQUM1QyxJQUFBLCtCQUFhLEVBQUMsV0FBVyxFQUFFLFNBQVMsQ0FBQyxDQUFBO0lBQ3JDLElBQUEsK0JBQWEsRUFBQyxlQUFlLEVBQUUsYUFBYSxDQUFDLENBQUE7SUFDN0MsSUFBSSxHQUFHLEVBQUUsQ0FBQztRQUNSLElBQUEsa0NBQWdCLEVBQUMsS0FBSyxFQUFFLEdBQUcsQ0FBQyxDQUFBO0lBQzlCLENBQUM7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

package/dist/cjs/generalUtils.d.ts

@@ -92,11 +92,21 @@ export interface WhichResult {
 export declare function sleep(ms: number): Promise<void>;
 /**
  * An extension of the built-in SpawnOptions with an extra option to specify whether a non-zero exit code should throw an error.
+ * Used with method {@link spawnAsync}.
  */
 export interface SpawnOptionsWithThrow extends SpawnOptions {
     throwOnNonZero: boolean;
     simpleErrorMsg?: string;
 }
+/**
+ * Options interface for methods {@link simpleSpawnSync}, {@link simpleSpawnAsync}, {@link simpleCmdSync} and {@link simpleCmdAsync}.
+ */
+export interface SimpleSpawnOptions {
+    /** Defaults to `true`. Note that this is the opposite of the default for {@link spawnAsync}. */
+    throwOnNonZero: boolean;
+    /** Optional current working directory. Defaults to `process.cwd()`. */
+    cwd: string;
+}
 /**
  * This is a wrapper function for NodeJS spawn. Defaults stdio to inherit so that output is visible in the console,
  * but note that this means stdout and stderr will not be available in the returned SpawnResult. To hide the output
@@ -199,10 +209,11 @@ export declare function stringToLines(str: string): string[];
  * See {@link winInstallCert} and {@link winUninstallCert} for examples of taking user input and inserting it safely into known commands.
  * @param command Command to run
  * @param args Arguments to pass to the command
+ * @param options Optional {@link SimpleSpawnOptions} options
  * @returns An object with the status code, stdout, stderr, and error (if any)
  * @throws {@link SimpleSpawnError} if the command fails and throwOnNonZero is true
  */
-export declare function simpleCmdSync(command: string, args?: string[], throwOnNonZero?: boolean): SimpleSpawnResult;
+export declare function simpleCmdSync(command: string, args?: string[], options?: Partial<SimpleSpawnOptions>): SimpleSpawnResult;
 /**
  * Runs the requested command using {@link spawnAsync} wrapped in an outer Windows CMD.exe command and returns the result with stdout split into lines.
  *
@@ -215,10 +226,11 @@ export declare function simpleCmdSync(command: string, args?: string[], throwOnN
  * See {@link winInstallCert} and {@link winUninstallCert} for examples of taking user input and inserting it safely into known commands.
  * @param command Command to run
  * @param args Arguments to pass to the command
+ * @param options Optional {@link SimpleSpawnOptions} options
  * @returns An object with the status code, stdout, stderr, and error (if any)
  * @throws {@link SimpleSpawnError} if the command fails and throwOnNonZero is true
  */
-export declare function simpleCmdAsync(command: string, args?: string[], throwOnNonZero?: boolean): Promise<SimpleSpawnResult>;
+export declare function simpleCmdAsync(command: string, args?: string[], options?: Partial<SimpleSpawnOptions>): Promise<SimpleSpawnResult>;
 /**
  * Runs the requested command using NodeJS spawnSync and returns the result with stdout split into lines.
  *
@@ -231,12 +243,13 @@ export declare function simpleCmdAsync(command: string, args?: string[], throwOn
  * See {@link winInstallCert} and {@link winUninstallCert} for examples of taking user input and inserting it safely into known commands.
  * @param command Command to run
  * @param args Arguments to pass to the command
+ * @param options Optional {@link SimpleSpawnOptions} options
  * @returns An object with the status code, stdout, stderr, and error (if any)
  * @throws {@link SimpleSpawnError} if the command fails and throwOnNonZero is true
  */
-export declare function simpleSpawnSync(command: string, args?: string[], throwOnNonZero?: boolean): SimpleSpawnResult;
+export declare function simpleSpawnSync(command: string, args?: string[], options?: Partial<SimpleSpawnOptions>): SimpleSpawnResult;
 /**
- * Runs the requested command using {@link spawnAsync} and returns the result with stdout split into lines.
+ * Runs the requested command using {@link spawnAsync} and returns the result with stdout split into non-empty lines.
  *
  * Use this for simple quick commands that don't require a lot of control.
  *
@@ -247,10 +260,11 @@ export declare function simpleSpawnSync(command: string, args?: string[], throwO
  * See {@link winInstallCert} and {@link winUninstallCert} for examples of taking user input and inserting it safely into known commands.
  * @param command Command to run
  * @param args Arguments to pass to the command
+ * @param options Optional {@link SimpleSpawnOptions} options
  * @returns An object with the status code, stdout, stderr, and error (if any)
  * @throws {@link SimpleSpawnError} if the command fails and throwOnNonZero is true
  */
-export declare function simpleSpawnAsync(command: string, args?: string[], throwOnNonZero?: boolean): Promise<SimpleSpawnResult>;
+export declare function simpleSpawnAsync(command: string, args?: string[], options?: Partial<SimpleSpawnOptions>): Promise<SimpleSpawnResult>;
 /**
  * @returns `true` if platform() is 'win32', `false` otherwise
  */