Dit hoofdstuk presenteert een uitdaging: het creëren van een geavanceerde console-app genaamd DirInspect Pro. Deze app stelt je in staat om elke directory grondig te analyseren en waardevolle statistieken te verkrijgen over de bestanden en submappen.

Uitdaging

Stel je een scenario voor waarin je door een doolhof van mappen moet navigeren die essentiële bestanden en data bevatten. DirInspect Pro is je bondgenoot tijdens deze reis en biedt uitgebreide inzichten in de structuur en inhoud van de directory.

De resulterende app

Maak je klaar om de mogelijkheden van DirInspect Pro te benutten. De app voorziet je van essentiële informatie, zoals

• Het totale aantal items;
• De totale grootte van alle items;
• De naam en grootte van het grootste bestand;
• De gedetailleerde lijst van individuele bestandsnamen en groottes.

Twee paden om te kiezen

Er liggen twee paden voor je.

• Het eerste is om deze uitdaging direct aan te gaan en je vaardigheden zonder begeleiding te ontwikkelen;
• Het tweede is om een behulpzame gids te volgen die je succes garandeert.

Welk pad je ook kiest, je staat een waardevolle reis te wachten die eindigt met het maken van een boeiende en functionele console-app.

Masterplan

• Stap 1: Vereiste modules importeren;
• Stap 2: Definieer de functie getStats;
• Stap 3: Definieer de functie analyzeFile;
• Stap 4: Definieer de functie analyzeDirectory;
• Stap 5: Definieer en roep de functie main aan;
• Conclusie;
• Volledige app-code.

Stap 1: Vereiste modules importeren

Voor deze taak heb je de juiste tools nodig. Begin met het importeren van twee belangrijke modules: fs.promises voor het asynchroon beheren van het bestandssysteem en path voor het effectief omgaan met bestands- en map-paden.

const fs = require("fs").promises;
const path = require("path");

Stap 2: Definieer de getStats-functie

De asynchrone functie getStats neemt een bestand- of map-pad als argument en probeert de statistieken ervan op te halen met fs.stat.

• Bij succes retourneert het de statistieken;
• Bij een fout wordt een foutmelding gelogd en wordt null geretourneerd.

async function getStats(filePath) {
  try {
    const stats = await fs.stat(filePath);
    return stats;
  } catch (err) {
    console.error("Error getting stats:", err.message);
    return null;
  }
}

Stap 3: Definieer de analyzeFile-functie

De functie analyzeFile gebruikt de getStats-functie om statistieken voor een bestand op te halen. Als de statistieken beschikbaar zijn (niet null), retourneert deze een object met de bestandsnaam (verkregen via path.basename) en de grootte ervan.

async function analyzeFile(filePath) {
  const stats = await getStats(filePath);
  if (!stats) return null;

  return {
    name: path.basename(filePath),
    size: stats.size,
  };
}

Stap 4: Definieer de functie analyzeDirectory

De functie analyzeDirectory scant een map en verzamelt volledige statistieken over de inhoud ervan. Werking: leest alle items in de map met fs.readdir. Voor elk item:

• Bouwt het volledige pad met path.join;
• Gebruikt getStats om te detecteren of het een bestand of een map is;
• Als het een bestand is:
  • Roept analyzeFile aan om { name, size } te verkrijgen;
  • Werkt totalen, grootste bestand en de bestandslijst bij.
• Als het een map is:
  • Roept recursief analyzeDirectory aan;
  • Voegt resultaten samen met de huidige statistieken.

async function analyzeDirectory(directoryPath) {
  let totalItems = 0;
  let totalFiles = 0;
  let totalSize = 0;
  let largestFile = { name: "", size: 0 };
  let fileList = [];

  try {
    const items = await fs.readdir(directoryPath);

    for (const item of items) {
      const itemPath = path.join(directoryPath, item);
      const stats = await getStats(itemPath);
      if (!stats) continue;

      totalItems++;

      if (stats.isFile()) {
        const fileInfo = await analyzeFile(itemPath);
        if (!fileInfo) continue;

        totalFiles++;
        totalSize += fileInfo.size;

        if (fileInfo.size > largestFile.size) {
          largestFile = fileInfo;
        }

        fileList.push(fileInfo);
      } else if (stats.isDirectory()) {
        const subDirectoryStats = await analyzeDirectory(itemPath);

        totalItems += subDirectoryStats.totalItems;
        totalFiles += subDirectoryStats.totalFiles;
        totalSize += subDirectoryStats.totalSize;

        if (subDirectoryStats.largestFile.size > largestFile.size) {
          largestFile = subDirectoryStats.largestFile;
        }

        fileList = fileList.concat(subDirectoryStats.fileList);
      }
    }

    return {
      totalItems,
      totalFiles,
      totalSize,
      largestFile,
      fileList
    };
  } catch (err) {
    console.error("Error analyzing directory contents:", err.message);
    return {
      totalItems: 0,
      totalFiles: 0,
      totalSize: 0,
      largestFile: { name: "", size: 0 },
      fileList: []
    };
  }
}

Stap 5: Definieer de main-functie en roep deze aan

De main-functie is het startpunt van het script. Deze specificeert het pad van de te analyseren map (in dit geval ./docs), roept de functie analyzeDirectory aan om de statistieken van de map en de inhoud ervan te verkrijgen, en geeft vervolgens de verzamelde informatie weer. De functie drukt het volgende af:

• Het totaal aantal items;
• Het totaal aantal bestanden;
• De totale grootte;
• De details van het grootste bestand;
• De lijst van bestanden in de map.

async function main() {
  const directoryPath = "./docs";
  const directoryStats = await analyzeDirectory(directoryPath);

  console.log("Directory Analysis:");
  console.log("Total items:", directoryStats.totalItems);
  console.log("Total files:", directoryStats.totalFiles);
  console.log("Total size (bytes):", directoryStats.totalSize);
  console.log(
    "Largest file:",
    directoryStats.largestFile.name,
    "Size:",
    directoryStats.largestFile.size,
    "bytes"
  );

  console.log("\nFile List:");
  for (const file of directoryStats.fileList) {
    console.log(file.name, "Size:", file.size, "bytes");
  }
}

main();

Volledige app-code

const fs = require("fs").promises;
const path = require("path");

async function getStats(filePath) {
  try {
    const stats = await fs.stat(filePath);
    return stats;
  } catch (err) {
    console.error("Error getting stats:", err.message);
    return null;
  }
}

async function analyzeFile(filePath) {
  const stats = await getStats(filePath);
  if (!stats) return null;

  return {
    name: path.basename(filePath),
    size: stats.size
  };
}

async function analyzeDirectory(directoryPath) {
  let totalItems = 0;
  let totalFiles = 0;
  let totalSize = 0;
  let largestFile = { name: "", size: 0 };
  let fileList = [];

  try {
    const items = await fs.readdir(directoryPath);

    for (const item of items) {
      const itemPath = path.join(directoryPath, item);
      const stats = await getStats(itemPath);
      if (!stats) continue;

      totalItems++;

      if (stats.isFile()) {
        const fileInfo = await analyzeFile(itemPath);
        if (!fileInfo) continue;

        totalFiles++;
        totalSize += fileInfo.size;

        if (fileInfo.size > largestFile.size) {
          largestFile = fileInfo;
        }

        fileList.push(fileInfo);
      } else if (stats.isDirectory()) {
        const subDirectoryStats = await analyzeDirectory(itemPath);

        totalItems += subDirectoryStats.totalItems;
        totalFiles += subDirectoryStats.totalFiles;
        totalSize += subDirectoryStats.totalSize;

        if (subDirectoryStats.largestFile.size > largestFile.size) {
          largestFile = subDirectoryStats.largestFile;
        }

        fileList = fileList.concat(subDirectoryStats.fileList);
      }
    }

    return {
      totalItems,
      totalFiles,
      totalSize,
      largestFile,
      fileList
    };
  } catch (err) {
    console.error("Error analyzing directory contents:", err.message);
    return {
      totalItems: 0,
      totalFiles: 0,
      totalSize: 0,
      largestFile: { name: "", size: 0 },
      fileList: []
    };
  }
}

async function main() {
  const directoryPath = "./docs";
  const directoryStats = await analyzeDirectory(directoryPath);

  console.log("Directory Analysis:");
  console.log("Total items:", directoryStats.totalItems);
  console.log("Total files:", directoryStats.totalFiles);
  console.log("Total size (bytes):", directoryStats.totalSize);

  console.log(
    "Largest file:",
    directoryStats.largestFile.name,
    "Size:",
    directoryStats.largestFile.size,
    "bytes"
  );

  console.log("\nFile List:");
  for (const file of directoryStats.fileList) {
    console.log(file.name, "Size:", file.size, "bytes");
  }
}

main();