tools: add script to synch c-ares source lists

Add step to the updater script for c-ares to synchronize the list
of sources in our gyp file with the lists in c-ares' Makefiles.
PR-URL: #55445
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>

Author: richardlau

tools/dep_updaters/update-c-ares.mjs

@@ -0,0 +1,38 @@
+// Synchronize the sources for our c-ares gyp file from c-ares' Makefiles.
+import{readFileSync,writeFileSync}from'node:fs';
+import{join}from'node:path';
+
+constsrcroot=join(import.meta.dirname,'..','..');
+constoptions={encoding: 'utf8'};
+
+// Extract list of sources from the gyp file.
+constgypFile=join(srcroot,'deps','cares','cares.gyp');
+constcontents=readFileSync(gypFile,options);
+constsourcesRE=/^\s+'cares_sources_common':\s+\[\s*\n(?<files>[\s\S]*?)\s+\],$/gm;
+constsourcesCommon=sourcesRE.exec(contents);
+
+// Extract the list of sources from c-ares' Makefile.inc.
+constmakefile=join(srcroot,'deps','cares','src','lib','Makefile.inc');
+constlibSources=readFileSync(makefile,options).split('\n')
+// Extract filenames (excludes comments and variable assignment).
+.map((line)=>line.match(/^(?:.*=|\s*)?([^#\s]*)\s*\\?/)?.[1])
+// Filter out empty lines.
+.filter((line)=>line!=='')
+// Prefix with directory and format as list entry.
+.map((line)=>` 'src/lib/${line}',`);
+
+// Extract include files.
+constincludeMakefile=join(srcroot,'deps','cares','include','Makefile.am');
+constincludeSources=readFileSync(includeMakefile,options)
+.match(/include_HEADERS\s*=\s*(.*)/)[1]
+.split(/\s/)
+.map((header)=>` 'include/${header}',`);
+
+// Combine the lists. Alphabetically sort to minimize diffs.
+constfileList=includeSources.concat(libSources).sort();
+
+// Replace the list of sources.
+constnewContents=contents.replace(sourcesCommon.groups.files,fileList.join('\n'));
+if(newContents!==contents){
+writeFileSync(gypFile,newContents,options);
+}

tools/dep_updaters/update-c-ares.sh

@@ -71,6 +71,9 @@ cp "$DEPS_DIR/cares/"*.gn "$DEPS_DIR/cares/"*.gni "$WORKSPACE/cares"
 echo"Replacing existing c-ares"
 replace_dir "$DEPS_DIR/cares""$WORKSPACE/cares"
 
+echo"Updating cares.gyp"
+"$NODE""$ROOT/tools/dep_updaters/update-c-ares.mjs"
+
 # Update the version number on maintaining-dependencies.md
 # and print the new version as the last line of the script as we need
 # to add it to $GITHUB_ENV variable