@mrselva/attendance 1.0.0 → 1.1.0

package/README.md

@@ -29,7 +29,7 @@ attendance
 
 ## ✨ Features
 
-- **Zero Configuration**: Automatically discovers `.xlsx` or `.xls` spreadsheets in `./input` or the current working directory.
+- **Zero Configuration & Auto-Import**: If no file is in `./input/`, an OS file picker dialog pops up so you can simply click your spreadsheet (from Downloads or anywhere), and it automatically imports it into `./input/`! Drag & drop file paths into the terminal is also supported.
 - **Interactive CLI Wizard**: Clean, color-coded terminal prompts to pick verticals and date ranges.
 - **Comprehensive Vertical Support**: Detects lab vertical sheets:
   - `AD`: AI & Data Science Lab

package/index.js

@@ -15,6 +15,7 @@
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
+const { execFileSync } = require('child_process');
 const xlsx = require('xlsx');
 const AdmZip = require('adm-zip');
 
@@ -387,6 +388,128 @@ function parseArgs() {
   return flags;
 }
 
+// Clean user input file path (strip quotes and shell prefixes)
+function cleanPath(input) {
+  if (!input) return '';
+  let str = input.trim();
+  if (str.startsWith('&')) {
+    str = str.slice(1).trim();
+  }
+  if ((str.startsWith('"') && str.endsWith('"')) || (str.startsWith("'") && str.endsWith("'"))) {
+    str = str.slice(1, -1).trim();
+  }
+  return str;
+}
+
+// Open native OS file picker dialog
+function openFileDialog() {
+  const platform = process.platform;
+  try {
+    if (platform === 'win32') {
+      const psScript = `
+Add-Type -AssemblyName System.Windows.Forms
+$dlg = New-Object System.Windows.Forms.OpenFileDialog
+$dlg.Filter = 'Excel Files (*.xlsx;*.xls)|*.xlsx;*.xls|All Files (*.*)|*.*'
+$dlg.Title = 'Select Attendance Spreadsheet'
+$dlg.RestoreDirectory = $true
+$result = $dlg.ShowDialog()
+if ($result -eq [System.Windows.Forms.DialogResult]::OK) {
+    Write-Output $dlg.FileName
+}
+`;
+      const output = execFileSync('powershell.exe', ['-NoProfile', '-STA', '-Command', psScript], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+        timeout: 180000
+      });
+      return output ? output.trim() : null;
+    } else if (platform === 'darwin') {
+      const appleScript = 'POSIX path of (choose file with prompt "Select Attendance Spreadsheet" of type {"xlsx", "xls"})';
+      const output = execFileSync('osascript', ['-e', appleScript], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore']
+      });
+      return output ? output.trim() : null;
+    } else {
+      const output = execFileSync('zenity', ['--file-selection', '--file-filter=Excel files | *.xlsx *.xls', '--title=Select Attendance Spreadsheet'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore']
+      });
+      return output ? output.trim() : null;
+    }
+  } catch (e) {
+    return null;
+  }
+}
+
+// Copy / import a selected spreadsheet into ./input/
+function importFileToInput(srcPath) {
+  ensureDirs();
+  const fileName = path.basename(srcPath);
+  const destPath = path.join(INPUT_DIR, fileName);
+
+  if (path.resolve(srcPath) !== path.resolve(destPath)) {
+    try {
+      fs.copyFileSync(srcPath, destPath);
+      logSuccess(`Imported "${fileName}" into ./input/ folder!`);
+      return {
+        name: fileName,
+        fullPath: destPath,
+        relativePath: path.join('input', fileName)
+      };
+    } catch (err) {
+      logWarn(`Could not copy into ./input/ (${err.message}). Reading from original location.`);
+      return {
+        name: fileName,
+        fullPath: srcPath,
+        relativePath: srcPath
+      };
+    }
+  }
+
+  return {
+    name: fileName,
+    fullPath: destPath,
+    relativePath: path.relative(process.cwd(), destPath) || path.join('input', fileName)
+  };
+}
+
+// Interactive prompt for file selection when needed
+async function promptForFile(lines) {
+  logHeader('Select Attendance Spreadsheet');
+  console.log('No attendance spreadsheet selected yet.');
+  console.log('Please choose how you want to select your Excel file (.xlsx / .xls):\n');
+  console.log(`  [${colors.bold}1${colors.reset}] ${colors.green}Browse file${colors.reset} (Opens file picker window to click your file) [Default]`);
+  console.log(`  [${colors.bold}2${colors.reset}] ${colors.cyan}Enter or drag & drop file path here${colors.reset}`);
+
+  while (true) {
+    const choice = (await askQuestion(lines, `\nChoose option [1 or 2] (default: 1): `)).trim();
+
+    if (choice === '2') {
+      const manual = await askQuestion(lines, 'Enter or drag & drop file path: ');
+      const cleaned = cleanPath(manual);
+      if (cleaned && fs.existsSync(cleaned) && fs.statSync(cleaned).isFile()) {
+        const ext = path.extname(cleaned).toLowerCase();
+        if (ext === '.xlsx' || ext === '.xls') {
+          return cleaned;
+        } else {
+          logWarn(`"${cleaned}" is not an Excel spreadsheet (.xlsx / .xls).`);
+        }
+      } else {
+        logError(`File not found at: "${cleaned}". Please check the path and try again.`);
+      }
+    } else {
+      console.log(`${colors.dim}Opening file picker dialog... Please select your file in the window.${colors.reset}`);
+      const picked = openFileDialog();
+      if (picked && fs.existsSync(picked) && fs.statSync(picked).isFile()) {
+        return picked;
+      }
+      logWarn('No file was selected in the dialog.');
+      console.log(`You can try browsing again [1], or enter/drag & drop the file path directly [2]:`);
+    }
+  }
+}
+
 // Interactive prompt helper
 async function askQuestion(lineIterator, promptText) {
   process.stdout.write(promptText);
@@ -437,38 +560,53 @@ Running without options launches the interactive CLI wizard.
   if (flags.file) {
     const directPath = path.resolve(process.cwd(), flags.file);
     const inInputPath = path.join(INPUT_DIR, flags.file);
+    let resolvedSrc = null;
     if (fs.existsSync(directPath) && fs.statSync(directPath).isFile()) {
-      selectedFileObj = { name: path.basename(directPath), fullPath: directPath, relativePath: flags.file };
+      resolvedSrc = directPath;
     } else if (fs.existsSync(inInputPath) && fs.statSync(inInputPath).isFile()) {
-      selectedFileObj = { name: path.basename(inInputPath), fullPath: inInputPath, relativePath: path.join('input', flags.file) };
+      resolvedSrc = inInputPath;
     } else {
       logError(`Specified file "${flags.file}" was not found.`);
       rl.close();
       process.exit(1);
     }
+    selectedFileObj = importFileToInput(resolvedSrc);
   } else {
     const inputFiles = findInputFiles();
-    if (inputFiles.length === 0) {
-      logError(`No Excel spreadsheets (.xlsx / .xls) found in: ${INPUT_DIR} or current directory.`);
-      console.log(`\n${colors.yellow}Please place your attendance sheet (e.g. 2024-28_SoI_Attendance_Sheet.xlsx) in the 'input' folder or current directory and run this script again.${colors.reset}\n`);
-      rl.close();
-      process.exit(1);
-    }
 
-    if (inputFiles.length > 1) {
+    if (inputFiles.length === 0) {
+      // Auto prompt to browse or drag & drop when input/ is empty
+      const chosen = await promptForFile(lines);
+      selectedFileObj = importFileToInput(chosen);
+    } else if (inputFiles.length === 1) {
+      logInfo(`Found existing attendance spreadsheet: ${colors.bold}${inputFiles[0].relativePath}${colors.reset}`);
+      console.log(`  [${colors.bold}1${colors.reset}] Use this spreadsheet [Default]`);
+      console.log(`  [${colors.bold}2${colors.reset}] Choose/import a different file`);
+      const pick = (await askQuestion(lines, `\nSelect option [1 or 2] (default: 1): `)).trim();
+      if (pick === '2') {
+        const chosen = await promptForFile(lines);
+        selectedFileObj = importFileToInput(chosen);
+      } else {
+        selectedFileObj = inputFiles[0];
+      }
+    } else {
       logHeader('Select Input Attendance File');
       inputFiles.forEach((fileObj, idx) => {
         console.log(`  [${colors.bold}${idx + 1}${colors.reset}] ${fileObj.relativePath}`);
       });
-      const ans = await askQuestion(lines, `\nSelect file [1-${inputFiles.length}] (default: 1): `);
-      const num = parseInt(ans.trim(), 10);
-      if (!isNaN(num) && num >= 1 && num <= inputFiles.length) {
-        selectedFileObj = inputFiles[num - 1];
+      console.log(`  [${colors.bold}N${colors.reset}] ${colors.cyan}Import a new spreadsheet${colors.reset} (Browse or drag & drop)`);
+      const ans = (await askQuestion(lines, `\nSelect file [1-${inputFiles.length}] or N (default: 1): `)).trim();
+      if (ans.toUpperCase() === 'N') {
+        const chosen = await promptForFile(lines);
+        selectedFileObj = importFileToInput(chosen);
       } else {
-        selectedFileObj = inputFiles[0];
+        const num = parseInt(ans, 10);
+        if (!isNaN(num) && num >= 1 && num <= inputFiles.length) {
+          selectedFileObj = inputFiles[num - 1];
+        } else {
+          selectedFileObj = inputFiles[0];
+        }
       }
-    } else {
-      selectedFileObj = inputFiles[0];
     }
   }
 

package/package.json

@@ -1,19 +1,25 @@
 {
   "name": "@mrselva/attendance",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Extract vertical attendance data and export into DigiCampus Excel templates with ZIP archive",
   "main": "index.js",
   "scripts": {
     "start": "node index.js"
   },
-  "keywords": ["attendance", "digicampus", "excel", "cli", "npx"],
+  "keywords": [
+    "attendance",
+    "digicampus",
+    "excel",
+    "cli",
+    "npx"
+  ],
   "author": "mrselva",
   "license": "ISC",
   "publishConfig": {
     "access": "public"
   },
   "bin": {
-    "attendance": "./index.js"
+    "attendance": "index.js"
   },
   "files": [
     "index.js",