@mrselva/attendance 1.1.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 & 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
-  - `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,15 +1,14 @@
 #!/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');
@@ -23,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 = {
@@ -201,7 +190,6 @@ function parseVerticalSheet(ws, sheetName) {
   let nameColIdx = -1;
   let emailColIdx = -1;
   let rollColIdx = -1;
-  let isKiteEmail = false;
   const dateColumns = [];
 
   // Analyze header row
@@ -215,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 {
@@ -270,7 +253,7 @@ function parseVerticalSheet(ws, sheetName) {
       name: name,
       regNo: regNo,
       rollNo: rollNo,
-      email: email || (rollNo ? `${rollNo.toLowerCase()}@kgkite.ac.in` : '')
+      email: email || ''
     });
   }
 
@@ -315,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 *']
   ];
@@ -542,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();
@@ -748,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];
@@ -789,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);
     }
@@ -808,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,15 +1,15 @@
 {
   "name": "@mrselva/attendance",
-  "version": "1.1.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",
+    "spreadsheet",
     "cli",
     "npx"
   ],