Function recurseThroughFileTree

lib/file-tree.js:116–225

(directory)

  //recurseThroughFileTree is called and passed the object that exists at fileTree
  function recurseThroughFileTree(directory) {
    //Loop through files and fill files property array
    //fs.readdir reads the contents of a directory
    //entire directory exists at directory.path
    fs.readdir(directory.path, (err, files) => {

      //I'm not sure what the purpose of pending is
      pending += files.length;

      //this conditional is assessing pending after it's decremented to see if it's a false/falsy value
      //should only be true after being decremented several times
      if (!--pending) {
        //if it is, we call writeFileSync and pass the file stored at projInfoPath 
        //we write the stringified value of projInfo to whatever file exists at projInfoPath
        fs.writeFileSync(projInfoPath, JSON.stringify(projInfo));
        //inputted callback to getTree is then fired and passed the fileTree object
        callback(fileTree);
      }
      //files is an array of files that exist in the directory passed to the fs.readdir method
      //forEach is used to iterate over that array
      files.forEach((file) => {
        //filePath uses path.join() to join the path and file names together
        const filePath = path.join(directory.path, file);
        //fs.stat is a method that checks for file details associated with the inputted file
        //if status is good, it's details are available at the 'stats' variable
        fs.stat(filePath, (err, stats) => {
          if (err) {
            //this conditional is assessing pending after it's decremented to see if it's a false/falsy value
            //should only be true after being decremented several times
            if (!--pending) {
              //if it is, we call writeFileSync and pass the file stored at projInfoPath 
              //we write the stringified value of projInfo to whatever file exists at projInfoPath
              fs.writeFileSync(projInfoPath, JSON.stringify(projInfo));
              //inputted callback to getTree is then fired and passed the fileTree object
              callback(fileTree);
            }
          }
          //checks if stats is true or truthy & stats.isFile() resolves to true
          if (stats && stats.isFile()) {
            //insertSorted pushes an object into the directory.files array
            //object pushed into the array has the following parameters:
            //path, type, name, ext, id
            insertSorted(new File(filePath, file, getFileExt), directory.files);
            //checks if the filePath is the same as the resolved value as path.join(...) & if the file contains the text of webpack.config.js
            if (filePath === path.join(projInfo.rootPath, file) && file.search(/webpack.config.js/) !== -1) {
              //if it does, then we invoke the readFile method to access the data in the file
              fs.readFile(filePath, { encoding: 'utf-8' }, (err, data) => {
                //created a regExp to check for a pattern that matches entry...
                const regExp = new RegExp('entry(.*?),', 'g');
                //file is stringified and then searched for the match assigned to the regExp
                let entry = JSON.stringify(data).match(regExp);

                //?????
                let reactEntry = String(entry[0].split('\'')[1]);
                //reactEntry property inside of the projInfo object is updated to the resolved value of path.join(...)
                projInfo.reactEntry = path.join(projInfo.rootPath, reactEntry);
              })
            }