Questo capitolo ti propone una sfida: creare un'app console avanzata chiamata DirInspect Pro. Questa applicazione ti permetterà di analizzare a fondo qualsiasi directory e ottenere statistiche dettagliate sui suoi file e sottodirectory.

Sfida

Immagina uno scenario in cui devi orientarti in un labirinto di cartelle contenenti file e dati cruciali. DirInspect Pro è il tuo alleato in questo percorso, fornendo una panoramica completa della struttura e dei contenuti della directory.

L'applicazione finale

Preparati a sfruttare le funzionalità di DirInspect Pro. L'applicazione ti fornirà informazioni fondamentali, come:

• Il numero totale di elementi;
• La dimensione complessiva di tutti gli elementi;
• Il nome e la dimensione del file più grande;
• L'elenco dettagliato dei nomi e delle dimensioni dei singoli file.

Due percorsi tra cui scegliere

Hai davanti a te due percorsi.

• Il primo consiste nell'affrontare questa sfida direttamente, affinando le tue competenze senza alcuna guida;
• Il secondo consiste nel seguire una guida utile che garantisce il successo.

Qualunque percorso tu scelga, ti aspetta un viaggio gratificante che culminerà nella creazione di un'app console coinvolgente e funzionale.

Piano principale

• Passo 1: Importazione dei moduli necessari;
• Passo 2: Definizione della funzione getStats;
• Passo 3: Definizione della funzione analyzeFile;
• Passo 4: Definizione della funzione analyzeDirectory;
• Passo 5: Definizione e invocazione della funzione main;
• Conclusione;
• Codice completo dell'app.

Passo 1: Importazione dei moduli necessari

Per intraprendere questa attività, sono necessari gli strumenti giusti. Inizia importando due moduli chiave: fs.promises per gestire il file system in modo asincrono e path per gestire efficacemente i percorsi dei file.

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

Passaggio 2: Definizione della funzione getStats

La funzione asincrona getStats accetta come argomento un percorso di file o directory e tenta di recuperare le sue statistiche utilizzando fs.stat.

• Se ha successo, restituisce le statistiche;
• In caso di errore, registra un messaggio di errore e restituisce null.

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

Passaggio 3: Definizione della funzione analyzeFile

La funzione analyzeFile utilizza la funzione getStats per ottenere le statistiche di un file. Se le statistiche sono disponibili (diverse da null), restituisce un oggetto contenente il nome del file (estratto tramite path.basename) e la sua dimensione.

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

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

Passaggio 4: Definizione della funzione analyzeDirectory

La funzione analyzeDirectory esegue la scansione di una directory e raccoglie statistiche complete sui suoi contenuti. Funzionamento: legge tutti gli elementi all'interno della directory utilizzando fs.readdir. Per ogni elemento:

• Costruisce il percorso completo con path.join;
• Utilizza getStats per rilevare se si tratta di un file o di una cartella;
• Se è un file:
  • Chiama analyzeFile per ottenere { name, size };
  • Aggiorna i totali, il file più grande e la lista dei file.
• Se è una directory:
  • Chiama ricorsivamente analyzeDirectory;
  • Unisce i risultati alle statistiche correnti.

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: []
    };
  }
}

Passaggio 5: Definizione e Invocazione della Funzione main

La funzione main rappresenta il punto di ingresso dello script. Specifica il percorso della directory da analizzare (in questo caso, ./docs), richiama la funzione analyzeDirectory per ottenere le statistiche della directory e dei suoi contenuti, e infine stampa le informazioni raccolte. La funzione visualizza:

• Numero totale di elementi;
• Numero totale di file;
• Dimensione totale;
• Dettagli sul file più grande;
• Elenco dei file nella directory.

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();

Codice Completo dell'Applicazione

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();