win-get-updates 0.0.2 → 0.0.4

package/.github/workflows/lint-and-format.yml

@@ -16,9 +16,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: 'lts/*'
       - name: Install dependencies

package/.github/workflows/publish.yml

@@ -12,11 +12,11 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
-          node-version: '24'
+          node-version: 'lts/*'
           registry-url: 'https://registry.npmjs.org'
       - run: npm ci
       - run: npm publish

package/README.md

@@ -2,12 +2,28 @@
 
 Third party CLI frontend for [winget](https://en.wikipedia.org/wiki/Windows_Package_Manager) update runs. It lets you interactively choose which package to install.
 
+<img src="./pics/example.jpg" alt="Example screenshot of win-get-updates in action" width="650px" />
+
 ## Requirements
 
 Windows with [winget](https://en.wikipedia.org/wiki/Windows_Package_Manager) installed. Supposed to run on cmd.exe.
 
+## Install
+
+```
+npm install -g win-get-updates
+```
+
 ## Run
 
+### Global
+
+```
+wgu
+```
+
+### Local development
+
 ```
 node src\cli.js
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "win-get-updates",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Third party CLI frontend for winget update runs.",
   "repository": {
     "type": "git",

package/src/index.js

@@ -1,9 +1,9 @@
-import { getUpdateCandidateIds, runUpdates } from './lib/winget.js';
+import { getUpdateCandidates, runUpdates } from './lib/winget.js';
 import { interactiveSelect } from './lib/menu.js';
 import WGU_VERSION from './lib/version.js';
 import { askPermissionToContinue } from './lib/console_commons.js';
 import { assertWindows, assertWingetAvailable } from './lib/os.js';
-
+import { getWindowsUserLang } from './lib/wgu_i18n.js';
 /**
  * Main application logic
  * @param {Object} options - Configuration options
@@ -30,17 +30,18 @@ export async function main({ stdout = process.stdout, stderr = process.stderr }
     });
 
     console.log(`This is WGU v${WGU_VERSION}`);
+    console.log('Detected Windows User language:', getWindowsUserLang());
     console.log('');
 
     console.log('Retrieving list of updatable packages..');
-    const candidateIds = getUpdateCandidateIds();
+    const candidates = getUpdateCandidates();
 
-    if (candidateIds.length === 0) {
+    if (candidates.length === 0) {
       console.log('No packages available to update.');
       return 0;
     }
 
-    const selectedIds = await interactiveSelect(candidateIds);
+    const selectedIds = await interactiveSelect(candidates);
 
     if (selectedIds.length === 0) {
       console.log('Exiting without performing updates.');

package/src/lib/menu.js

@@ -18,8 +18,10 @@ export async function interactiveSelect(items) {
     let activeLine = 0;
 
     // Display initial menu
-    for (const item of items) {
-      console.log(`[ ] ${item}`);
+    for (let i = 0; i < items.length; i++) {
+      const item = items[i];
+      console.log(`[x] ${item.id} ${item.currentVersion} -> ${item.availableVersion}`);
+      selectedLines.set(i, true);
     }
     console.log('');
     console.log("Use Up/Down arrows to navigate, Space to toggle selection, 'y' to confirm, 'q' to quit.");
@@ -78,7 +80,7 @@ export async function interactiveSelect(items) {
 
         // Sort selected line numbers and get corresponding items
         const selectedIndices = Array.from(selectedLines.keys()).sort((a, b) => a - b);
-        const selectedItems = selectedIndices.map((idx) => items[idx]);
+        const selectedItems = selectedIndices.map((idx) => items[idx].id);
         resolve(selectedItems);
       } else if (str === 'q' || str === 'Q' || (key && key.name === 'escape')) {
         // Quit without selection

package/src/lib/system.js

@@ -0,0 +1,28 @@
+import { spawnSync } from 'node:child_process';
+
+/**
+ * Spawns a synchronous child process to run a command with the given arguments.
+ *
+ * @param {string} cmd - The command to run.
+ * @param {string[]} args - The list of string arguments.
+ * @param {boolean} [inheritStdio=false] - Whether to inherit stdio from the parent process.
+ * @returns {string} The standard output from the command.
+ * @throws {Error} If the process fails to start or exits with a non-zero status code.
+ */
+export function spawnSyncProcess(cmd, args, inheritStdio = false) {
+  const stdio = inheritStdio ? 'inherit' : 'pipe';
+  const child = spawnSync(cmd, args, { shell: false, stdio, encoding: 'utf8' });
+
+  const stdout = child.stdout || '';
+  const stderr = child.stderr || '';
+
+  if (child.error) {
+    throw new Error(`Cmd failed with: ${child.error.message}`);
+  }
+
+  if (child.status !== 0) {
+    throw new Error(`Cmd exited with code ${child.status}${stderr ? `: ${stderr}` : ''}`);
+  }
+
+  return stdout;
+}

package/src/lib/version.js

@@ -1,2 +1,2 @@
-const WGU_VERSION = '0.0.2';
+const WGU_VERSION = '0.0.4';
 export default WGU_VERSION;

package/src/lib/wgu_i18n.js

@@ -0,0 +1,43 @@
+import { spawnSyncProcess } from './system.js';
+
+export const WINGET_COLS = Object.freeze({
+  NAME: 'name_col',
+  ID: 'id_col',
+  VERSION: 'version_col',
+  AVAILABLE: 'available_col',
+  SOURCE: 'source_col',
+});
+
+// Winget table column names
+const col_names = {
+  name_col: { en: 'Name', de: 'Name' },
+  id_col: { en: 'ID', de: 'ID' },
+  version_col: { en: 'Version', de: 'Version' },
+  available_col: { en: 'Available', de: 'Verfügbar' },
+  source_col: { en: 'Source', de: 'Quelle' },
+};
+
+/**
+ * Returns the localized string for the given name and locale.
+ * Falls back to 'en' if not found, or returns the key if missing.
+ * @param {string} key - The string key
+ * @param {string} locale - The locale code (e.g. 'en', 'de')
+ * @returns {string}
+ */
+export function getColName(key, locale) {
+  if (col_names[key]) {
+    return col_names[key][locale] || col_names[key].en;
+  }
+  throw new Error(`Missing localization for key: ${key}`);
+}
+
+export function getWindowsUserLang() {
+  let windowsUserLangTag = 'en-US';
+  try {
+    windowsUserLangTag = spawnSyncProcess('powershell', ['-c', '(Get-WinUserLanguageList)[0].LanguageTag'])?.trim();
+  } catch (err) {
+    console.debug(`Could not determine Windows user language, defaulting to ${windowsUserLangTag}:`, err.message);
+  }
+
+  return new Intl.Locale(windowsUserLangTag).language;
+}

package/src/lib/winget.js

@@ -1,19 +1,21 @@
-import { spawnSync } from 'node:child_process';
+import { getColName, getWindowsUserLang, WINGET_COLS } from './wgu_i18n.js';
+import { spawnSyncProcess } from './system.js';
 
 /**
  * Retrieves a list of package IDs that can be updated via winget
  * @returns {string[]} Array of package IDs
  * @throws {Error} If winget command fails or returns empty output
  */
-export function getUpdateCandidateIds() {
-  const NAME_COL = 'Name';
-  const ID_COL = 'ID';
-  const VERSION_COL = 'Version';
-  const tableHeaderRegex = new RegExp(`.*${NAME_COL}\\s+${ID_COL}\\s+${VERSION_COL}.*`);
-
-  // Get winget upgrade list
-  const wgOutput = execWinget(['upgrade', '--include-unknown']);
-
+export function getUpdateCandidates() {
+  const locale = getWindowsUserLang();
+  const NAME_COL_NAME = getColName(WINGET_COLS.NAME, locale);
+  const ID_COL_NAME = getColName(WINGET_COLS.ID, locale);
+  const VERSION_COL_NAME = getColName(WINGET_COLS.VERSION, locale);
+  const AVAILABLE_COL_NAME = getColName(WINGET_COLS.AVAILABLE, locale);
+  const SOURCE_COL_NAME = getColName(WINGET_COLS.SOURCE, locale);
+  const tableHeaderRegex = new RegExp(`.*${NAME_COL_NAME}\\s+${ID_COL_NAME}\\s+${VERSION_COL_NAME}\\s+${AVAILABLE_COL_NAME}\\s+${SOURCE_COL_NAME}.*`);
+
+  const wgOutput = spawnSyncProcess('winget', ['upgrade', '--include-unknown']);
   if (!wgOutput || wgOutput.trim().length === 0) {
     throw new Error('winget update command failed or returned empty output');
   }
@@ -29,36 +31,37 @@ export function getUpdateCandidateIds() {
   if (tableHeaderIndex === -1) {
     throw new Error('Could not find table header in winget output');
   }
-  // Find column positions
-  const namePos = lines[tableHeaderIndex].indexOf(NAME_COL);
-  const idPos = lines[tableHeaderIndex].indexOf(ID_COL);
-  const versionPos = lines[tableHeaderIndex].indexOf(VERSION_COL);
-  if (namePos === -1 || idPos === -1 || versionPos === -1) {
+  const headerLine = lines[tableHeaderIndex].trim();
+  const posOffset = headerLine.indexOf(NAME_COL_NAME);
+  const idPos = headerLine.indexOf(ID_COL_NAME) - posOffset;
+  const versionPos = headerLine.indexOf(VERSION_COL_NAME) - posOffset;
+  const availablePos = headerLine.indexOf(AVAILABLE_COL_NAME) - posOffset;
+  const sourcePos = headerLine.indexOf(SOURCE_COL_NAME) - posOffset;
+  if (posOffset === -1 || idPos === -1 || versionPos === -1 || availablePos === -1 || sourcePos === -1) {
     throw new Error('Could not find expected column headers in winget output');
   }
 
-  // Calculate column positions relative to start of each line
-  const packageIdStartPos = idPos - namePos;
-  const packageIdColLength = versionPos - idPos;
+  const idColLength = versionPos - idPos;
+  const versionColLength = availablePos - versionPos;
+  const availableColLength = sourcePos - availablePos;
 
   const packageListStartLineIndex = tableHeaderIndex + 2; // Skip header and separator line
-  const packageIds = [];
+  const candidates = [];
 
-  // Extract package IDs from each line
   for (let i = packageListStartLineIndex; i < outputLineCount; i++) {
     const line = lines[i];
     if (!line || line.trim().length === 0) {
       continue;
     }
-
-    const packageId = line.substring(packageIdStartPos, packageIdStartPos + packageIdColLength).trim();
-
-    if (packageId) {
-      packageIds.push(packageId);
+    const id = line.substring(idPos, idPos + idColLength).trim();
+    const currentVersion = line.substring(versionPos, versionPos + versionColLength).trim();
+    const availableVersion = line.substring(availablePos, availablePos + availableColLength).trim();
+    if (id) {
+      candidates.push({ id, currentVersion, availableVersion });
     }
   }
 
-  return packageIds;
+  return candidates;
 }
 
 /**
@@ -71,14 +74,14 @@ export async function runUpdates(ids, errorHandler = async (_id, _err) => false)
     console.log(`Updating package: ${id}`);
     // prettier-ignore
     try {
-      execWinget([
+      spawnSyncProcess('winget', [
         'upgrade',
         '-i',
         '--id',
         id,
         '--accept-source-agreements',
         '--accept-package-agreements'
-      ], { inheritStdio: true });
+      ], true);
       console.log(`Package ${id} updated successfully.`);
     } catch (err) {
       // eslint-disable-next-line no-await-in-loop
@@ -88,29 +91,3 @@ export async function runUpdates(ids, errorHandler = async (_id, _err) => false)
     }
   }
 }
-
-/**
- * Synchronously executes winget command and returns stdout
- * @param {string[]} args - Command arguments
- * @param {Object} options - Execution options
- * @param {boolean} options.inheritStdio - Whether to inherit stdio
- * @returns {string} Command stdout
- * @throws {Error} If command fails
- */
-function execWinget(args, { inheritStdio = false } = {}) {
-  const stdio = inheritStdio ? 'inherit' : 'pipe';
-  const child = spawnSync('winget', args, { shell: false, stdio, encoding: 'utf8' });
-
-  const stdout = child.stdout || '';
-  const stderr = child.stderr || '';
-
-  if (child.error) {
-    throw new Error(`Failed to execute winget: ${child.error.message}`);
-  }
-
-  if (child.status !== 0) {
-    throw new Error(`winget exited with code ${child.status}${stderr ? `: ${stderr}` : ''}`);
-  }
-
-  return stdout;
-}