@mrselva/attendance 1.0.0 → 1.1.2

package/README.md

@@ -4,15 +4,15 @@
 [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](LICENSE)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen.svg)](https://nodejs.org)
 
-> An automated CLI converter that extracts vertical-wise attendance data from KG-KITE / SoI multi-sheet attendance spreadsheets, generates DigiCampus-compliant upload workbooks, and bundles them into clean ZIP archives.
+> A fast and lightweight CLI tool to extract, normalize, and export multi-sheet attendance spreadsheets into organized Excel files and ZIP archives.
 
-Run instantly with **`npx`** — no cloning or installation required!
+Run instantly with **`npx`** — no installation required!
 
 ---
 
 ## ⚡ Quick Start
 
-Open your terminal in any folder containing your attendance spreadsheet (or an `input/` folder):
+Open your terminal in any directory and run:
 
 ```bash
 npx @mrselva/attendance
@@ -29,64 +29,51 @@ attendance
 
 ## ✨ Features
 
-- **Zero Configuration**: Automatically discovers `.xlsx` or `.xls` spreadsheets in `./input` or the current working directory.
-- **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
-  - `BW`: Blockchain and Web3.0 Lab
-  - `CD`: Cloud and DevOps Lab
-  - `CS`: Cyber Security Lab
-  - `DMA`: Data & Mobile Analytics Lab
-  - `EI`: Embedded & IoT Lab
-  - `FW`: Full Stack Web Lab
-  - `SOAL`: School of AI Learning
-  - `SOP`: School of Programming
+- **Zero Configuration & Auto-Import**: If no file is in `./input/`, an interactive file picker window opens so you can select your spreadsheet directly from your computer, or drag & drop file paths into the terminal.
+- **Interactive CLI Wizard**: Clean, color-coded terminal prompts to pick sheets and date filters.
+- **Multi-Sheet Detection**: Automatically discovers all relevant sheets and rosters across the workbook.
 - **Smart Date Filtering**:
-  - Export **All recorded dates** (creates one upload file per instructional date)
-  - Export a **Single date** (e.g. `2024-09-15`)
+  - Export **All recorded dates**
+  - Export a **Single date** (e.g. `YYYY-MM-DD`)
   - Export a **Date range** (from `YYYY-MM-DD` to `YYYY-MM-DD`)
   - Export the **Latest date only**
-- **DigiCampus Compatibility**: Creates individual files with a `Students` sheet formatted with:
-  - `Email Id`
-  - `Registration Id`
-  - `Attendance *` (`PRESENT` or `ABSENT`)
-- **Status Normalization**: Accurately normalizes marks (`P`, `1`, `OD`, `ELITE` → `PRESENT`; `A`, `0`, unrecorded → `ABSENT`).
-- **Automatic ZIP Packaging**: Compresses generated files directly into `./output/<Vertical>_Attendance.zip`.
+- **Status Normalization**: Accurately normalizes attendance status (`PRESENT`, `ABSENT`, etc.) and handles blanks cleanly.
+- **Automatic ZIP Packaging**: Compresses generated export files directly into clean ZIP archives in `./output/`.
 
 ---
 
 ## 🚀 CLI Usage & Flags
 
-You can run the interactive wizard or pass non-interactive CLI flags for automation:
+Run the interactive wizard or pass flags for automation:
 
 ```bash
 # Interactive mode
 npx @mrselva/attendance
 
-# Export ALL dates for a specific vertical
-npx @mrselva/attendance -v BW -a
+# Export all dates for a specific sheet
+npx @mrselva/attendance -v SHEET_CODE -a
 
 # Export a single date
-npx @mrselva/attendance -v CD -d 2024-09-12
+npx @mrselva/attendance -v SHEET_CODE -d 2024-09-12
 
 # Export the latest date recorded
-npx @mrselva/attendance -v AD --latest
+npx @mrselva/attendance -v SHEET_CODE --latest
 
-# Process ALL verticals at once
+# Process ALL sheets at once
 npx @mrselva/attendance -v ALL -a
 
 # Specify a custom input spreadsheet file
-npx @mrselva/attendance -f "2024-28_SoI_Attendance_Sheet.xlsx" -v FW -a
+npx @mrselva/attendance -f "attendance_sheet.xlsx" -v SHEET_CODE -a
 ```
 
 ### Options Reference
 
 | Flag | Long Flag | Description |
 | :--- | :--- | :--- |
-| `-v <code\|ALL>` | `--vertical <code\|ALL>` | Vertical code (e.g. `AD`, `BW`, `CD`, `CS`, `DMA`, `EI`, `FW`, or `ALL`) |
-| `-a` | `--all` | Export all recorded instructional dates |
+| `-v <code>` | `--vertical <code>` | Sheet code or name (or `ALL`) |
+| `-a` | `--all` | Export all recorded dates |
 | `-d <date>` | `--date <YYYY-MM-DD>` | Export a specific date |
-| | `--latest` | Export the latest instructional date |
+| | `--latest` | Export the latest recorded date |
 | `-f <file>` | `--file <path>` | Specify input Excel file path or filename |
 | `-h` | `--help` | Display usage and help message |
 
@@ -96,24 +83,18 @@ npx @mrselva/attendance -f "2024-28_SoI_Attendance_Sheet.xlsx" -v FW -a
 
 ```text
 your-folder/
-├── input/                             # (Optional) Place source spreadsheets here
-│   └── 2024-28_SoI_Attendance.xlsx
-└── output/                            # Automatically generated output
-    ├── BW_Attendance.zip
-    └── CD_Attendance.zip
+├── input/                             # Place source spreadsheets here (or auto-import)
+└── output/                            # Automatically generated ZIP archives
 ```
 
-> **Note:** If an `input/` folder is not found, the CLI will look for Excel files directly in your current working directory.
-
 ---
 
 ## 🛠 Requirements
 
 - **Node.js**: `v16.0.0` or higher
-- **npm**: `v7.0.0` or higher (included with Node.js)
 
 ---
 
 ## 📄 License
 
-[ISC](LICENSE) &copy; [mrselva-eth](https://github.com/mrselva-eth)
+[ISC](LICENSE) &copy; [mrselva](https://github.com/mrselva)

package/index.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 /**
- * Attendance to DigiCampus Converter
+ * Attendance Spreadsheet Converter & Exporter
  * Single-file Node.js CLI script
  * 
  * Features:
- * - Scans ./input for attendance spreadsheets (.xlsx / .xls)
- * - Interactively prompts for vertical selection (AD, BW, CD, CS, DMA, EI, FW, etc.)
+ * - Scans ./input or current directory for attendance spreadsheets (.xlsx / .xls)
+ * - Interactively prompts for sheet/category selection
  * - Allows exporting all recorded dates, specific date, range, or latest date
- * - Generates individual DigiCampus-compliant Excel files ('Students' sheet with Email Id, Registration Id, Attendance *)
- * - Automatically packages all generated files into a ZIP archive in ./output
- * - Works both interactively (in terminal) and with optional CLI flags (--vertical, --all, etc.)
+ * - Generates individual formatted Excel files with ZIP archive in ./output
+ * - Works both interactively (in terminal) and with CLI flags (--vertical, --all, etc.)
  */
 
 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');
 
@@ -22,18 +22,8 @@ const AdmZip = require('adm-zip');
 const INPUT_DIR = path.resolve(process.cwd(), 'input');
 const OUTPUT_DIR = path.resolve(process.cwd(), 'output');
 
-// Known vertical full names mapping
-const VERTICAL_NAMES = {
-  'AD': 'AI & Data Science Lab',
-  'BW': 'Blockchain and Web3.0 Lab',
-  'CD': 'Cloud and DevOps Lab',
-  'CS': 'Cyber Security Lab',
-  'DMA': 'Data & Mobile Analytics Lab',
-  'EI': 'Embedded & IoT Lab',
-  'FW': 'Full Stack Web Lab',
-  'SOAL': 'School of AI Learning',
-  'SOP': 'School of Programming'
-};
+// Optional category/sheet code to display name mapping
+const VERTICAL_NAMES = {};
 
 // ANSI color helpers
 const colors = {
@@ -200,7 +190,6 @@ function parseVerticalSheet(ws, sheetName) {
   let nameColIdx = -1;
   let emailColIdx = -1;
   let rollColIdx = -1;
-  let isKiteEmail = false;
   const dateColumns = [];
 
   // Analyze header row
@@ -214,13 +203,8 @@ function parseVerticalSheet(ws, sheetName) {
       regColIdx = c;
     } else if (hStr.includes('student name') || hStr === 'name') {
       nameColIdx = c;
-    } else if (hStr.includes('kite email')) {
+    } else if (hStr.includes('email id') || hStr.includes('email') || hStr.includes('mail')) {
       emailColIdx = c;
-      isKiteEmail = true;
-    } else if (!isKiteEmail && (hStr.includes('email id') || hStr.includes('email'))) {
-      if (!hStr.includes('soi')) {
-        emailColIdx = c;
-      }
     } else if (hStr.includes('roll number') || hStr.includes('roll no')) {
       rollColIdx = c;
     } else {
@@ -269,7 +253,7 @@ function parseVerticalSheet(ws, sheetName) {
       name: name,
       regNo: regNo,
       rollNo: rollNo,
-      email: email || (rollNo ? `${rollNo.toLowerCase()}@kgkite.ac.in` : '')
+      email: email || ''
     });
   }
 
@@ -314,11 +298,11 @@ function parseVerticalSheet(ws, sheetName) {
   };
 }
 
-// Generate DigiCampus Excel workbook for a single date
-function generateDigiCampusWorkbook(verticalData, dateItem, rows) {
+// Generate formatted Excel workbook for a single date
+function generateExportWorkbook(verticalData, dateItem, rows) {
   const wb = xlsx.utils.book_new();
 
-  // DigiCampus Template Header
+  // Export Sheet Header
   const wsData = [
     ['Email Id', 'Registration Id', 'Attendance *']
   ];
@@ -387,6 +371,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);
@@ -419,7 +525,7 @@ Running without options launches the interactive CLI wizard.
   }
 
   console.log(`\n${colors.bold}${colors.magenta}╔═════════════════════════════════════════════════════════════════════╗`);
-  console.log(`║          KG-KITE / SoI Attendance -> DigiCampus Exporter            ║`);
+  console.log(`║               Attendance Sheet Exporter & Converter                 ║`);
   console.log(`╚═════════════════════════════════════════════════════════════════════╝${colors.reset}`);
 
   ensureDirs();
@@ -437,38 +543,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];
     }
   }
 
@@ -610,10 +731,10 @@ Running without options launches the interactive CLI wizard.
   rl.close();
 
   // Process selected verticals
-  logHeader('Processing & Generating DigiCampus Files');
+  logHeader('Processing & Generating Export Files');
 
   for (const vert of targets) {
-    console.log(`\n${colors.bold}Vertical: ${vert.sheetName} - ${vert.verticalName}${colors.reset}`);
+    console.log(`\n${colors.bold}Sheet: ${vert.sheetName}${vert.verticalName !== vert.sheetName ? ' - ' + vert.verticalName : ''}${colors.reset}`);
     console.log(`  Students: ${colors.bold}${vert.students.length}${colors.reset}`);
 
     let datesToExport = [...vert.dates];
@@ -651,7 +772,7 @@ Running without options launches the interactive CLI wizard.
 
     for (const dateItem of datesToExport) {
       const fileName = `Upload_Attendance_${vert.sheetName}_${dateItem.dateStr}.xlsx`;
-      const outWb = generateDigiCampusWorkbook(vert, dateItem, rows);
+      const outWb = generateExportWorkbook(vert, dateItem, rows);
       const fileBuffer = xlsx.write(outWb, { type: 'buffer', bookType: 'xlsx' });
       zip.addFile(fileName, fileBuffer);
     }
@@ -670,7 +791,7 @@ Running without options launches the interactive CLI wizard.
     const zipStat = fs.statSync(zipFilePath);
     const zipSizeKb = (zipStat.size / 1024).toFixed(1);
 
-    logSuccess(`Generated ZIP archive containing ${datesToExport.length} DigiCampus files:`);
+    logSuccess(`Generated ZIP archive containing ${datesToExport.length} export files:`);
     console.log(`   ${colors.bold}${colors.green}${zipFilePath}${colors.reset} (${zipSizeKb} KB)`);
   }
 

package/package.json

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