[NFC] Fix typos discovered by codespell in the tools directory (#23039)

% `codespell --ignore-words-list=dum,implementor,tre --write-changes
tools`
* https://pypi.org/project/codespell

Author: cclauss

tools/acorn-optimizer.mjs

@@ -397,7 +397,7 @@ function JSDCE(ast, aggressive) {
               if (elem) traverse(elem);
             }
           } else {
-            assertAt(id.type === 'Identifier', id, `expected Indentifier but found ${id.type}`);
+            assertAt(id.type === 'Identifier', id, `expected Identifier but found ${id.type}`);
             const name = id.name;
             ensureData(scopes[scopes.length - 1], name).def = 1;
           }
@@ -862,7 +862,7 @@ function emitDCEGraph(ast) {
   // must find the info we need
   assert(
     foundWasmImportsAssign,
-    'could not find the assigment to "wasmImports". perhaps --pre-js or --post-js code moved it out of the global scope? (things like that should be done after emcc runs, as they do not need to be run through the optimizer which is the special thing about --pre-js/--post-js code)',
+    'could not find the assignment to "wasmImports". perhaps --pre-js or --post-js code moved it out of the global scope? (things like that should be done after emcc runs, as they do not need to be run through the optimizer which is the special thing about --pre-js/--post-js code)',
   );
   // Read exports that were declared in extraInfo
   if (extraInfo) {
@@ -932,7 +932,7 @@ function emitDCEGraph(ast) {
           if (infos[reached]) {
             infos[reached].root = true; // in global scope, root it
           } else {
-            // An info might not exist for the identifer if it is missing, for
+            // An info might not exist for the identifier if it is missing, for
             // example, we might call Module.dynCall_vi in library code, but it
             // won't exist in a standalone (non-JS) build anyhow. We can ignore
             // it in that case as the JS won't be used, but warn to be safe.

tools/create_dom_pk_codes.py

@@ -239,7 +239,7 @@ def hash_all(k1, k2):
   return (hashes, str_to_hash)
 
 
-# Find an approprite hash function that is collision free within the set of all input strings
+# Find an appropriate hash function that is collision free within the set of all input strings
 # Try hash function format h_i = ((h_(i-1) ^ k_1) << k_2) ^ s_i, where h_i is the hash function
 # value at step i, k_1 and k_2 are the constants we are searching, and s_i is the i'th input
 # character

tools/emdwp.py

@@ -4,7 +4,7 @@
 # University of Illinois/NCSA Open Source License.  Both these licenses can be
 # found in the LICENSE file.
 
-"""Wrapper scripte around `llvm-dwp`.
+"""Wrapper script around `llvm-dwp`.
 """
 
 import sys

tools/emnm.py

@@ -4,7 +4,7 @@
 # University of Illinois/NCSA Open Source License.  Both these licenses can be
 # found in the LICENSE file.
 
-"""Wrapper scripte around `llvm-nm`.
+"""Wrapper script around `llvm-nm`.
 """
 
 import os

tools/emscripten.py

@@ -620,7 +620,7 @@ def finalize_wasm(infile, outfile, js_syms):
 
 
 def create_tsd_exported_runtime_methods(metadata):
-  # Use the TypeScript compiler to generate defintions for all of the runtime
+  # Use the TypeScript compiler to generate definitions for all of the runtime
   # exports. The JS from the library any JS docs are included in the file used
   # for generation.
   js_doc = 'var RuntimeExports = {};\n'
@@ -660,7 +660,7 @@ def create_tsd(metadata, embind_tsd):
   out = '// TypeScript bindings for emscripten-generated code.  Automatically generated at compile time.\n'
   if settings.EXPORTED_RUNTIME_METHODS:
     out += create_tsd_exported_runtime_methods(metadata)
-  # Manually generate defintions for any Wasm function exports.
+  # Manually generate definitions for any Wasm function exports.
   out += 'interface WasmModule {\n'
   for name, functype in metadata.function_exports.items():
     mangled = asmjs_mangle(name)
@@ -683,7 +683,7 @@ def create_tsd(metadata, embind_tsd):
   export_interfaces = 'WasmModule'
   if settings.EXPORTED_RUNTIME_METHODS:
     export_interfaces += ' & typeof RuntimeExports'
-  # Add in embind defintions.
+  # Add in embind definitions.
   if embind_tsd:
     export_interfaces += ' & EmbindModule'
   out += f'export type MainModule = {export_interfaces};\n'

tools/experimental/reproduceriter.py

@@ -96,7 +96,7 @@
    make a browser build, record a trace, then make a shell build and copy the trace
    there so you can run it.
 
-   The last parameter specifies what to do when the event loop is idle: We fire an event and then set onIdle (which was this function) to null, so this is a one-time occurence.
+   The last parameter specifies what to do when the event loop is idle: We fire an event and then set onIdle (which was this function) to null, so this is a one-time occurrence.
 
 Notes
 

tools/file_packager.py

@@ -501,7 +501,7 @@ def main():
         err('Error: Embedding "%s" which is not contained within the current directory '
             '"%s".  This is invalid since the current directory becomes the '
             'root that the generated code will see.  To include files outside of the current '
-            'working directoty you can use the `--preload-file srcpath@dstpath` syntax to '
+            'working directory you can use the `--preload-file srcpath@dstpath` syntax to '
             'explicitly specify the target location.' % (path, curr_abspath))
         sys.exit(1)
       file_.dstpath = abspath[len(curr_abspath) + 1:]
@@ -702,7 +702,7 @@ def generate_js(data_target, data_files, metadata):
       }\n''' % (create_preloaded if options.use_preload_plugins else create_data)
 
   if options.has_embedded and not options.obj_output:
-    err('--obj-output is recommended when using --embed.  This outputs an object file for linking directly into your application is more effecient than JS encoding')
+    err('--obj-output is recommended when using --embed.  This outputs an object file for linking directly into your application is more efficient than JS encoding')
 
   for counter, file_ in enumerate(data_files):
     filename = file_.dstpath

tools/filelock.py

@@ -301,7 +301,7 @@ def release(self, force = False):
         """
         Releases the file lock.
 
-        Please note, that the lock is only completly released, if the lock
+        Please note, that the lock is only completely released, if the lock
         counter is 0.
 
         Also note, that the lock file itself is not automatically deleted.

tools/line_endings.py

@@ -26,7 +26,7 @@ def convert_line_endings_in_file(filename, from_eol, to_eol):
 
 
 def check_line_endings(filename, expect_only=None, print_errors=True, print_info=False):
-  """Detect inconsitent/invalid line endings.
+  """Detect inconsistent/invalid line endings.
 
   This function checks and prints out the detected line endings in the given
   file. If the file only contains either Windows \\r\\n line endings or Unix \\n

tools/link.py

@@ -590,7 +590,7 @@ def set_max_memory():
     if initial_memory_known:
       settings.MAXIMUM_MEMORY = settings.INITIAL_MEMORY
 
-  # Automaticaly up the default maximum when the user requested a large minimum.
+  # Automatically up the default maximum when the user requested a large minimum.
   if 'MAXIMUM_MEMORY' not in user_settings:
     if settings.ALLOW_MEMORY_GROWTH:
       if any([settings.INITIAL_HEAP != -1 and settings.INITIAL_HEAP >= 2 * 1024 * 1024 * 1024,
@@ -667,7 +667,7 @@ def phase_linker_setup(options, state, newargs):
     options.post_js.append(utils.path_from_root('src/cpuprofiler.js'))
 
   # Unless RUNTIME_DEBUG is explicitly set then we enable it when any of the
-  # more specfic debug settings are present.
+  # more specific debug settings are present.
   default_setting('RUNTIME_DEBUG', int(settings.LIBRARY_DEBUG or
                                        settings.GL_DEBUG or
                                        settings.DYLINK_DEBUG or
@@ -1934,7 +1934,7 @@ def phase_emscript(in_wasm, wasm_target, js_syms, base_metadata):
   # Emscripten
   logger.debug('emscript')
 
-  # No need to support base64 embeddeding in wasm2js mode since
+  # No need to support base64 embedding in wasm2js mode since
   # the module is already in JS format.
   settings.SUPPORT_BASE64_EMBEDDING = settings.SINGLE_FILE and not settings.WASM2JS
 

tools/maint/README.md

@@ -1,5 +1,5 @@
 Maintenance Scripts for Emscripten Developers
 =============================================
 
-This directory contains maintentance scripts used by emscripten developers.  For
+This directory contains maintenance scripts used by emscripten developers.  For
 more information see the comments at the top of each script.

tools/maint/check_for_unused_test_files.py

@@ -81,7 +81,7 @@ def check_file(dirpath, filename):
     if ext == '.json' and grep("'" + os.path.basename(stem) + "'"):
       return
 
-  # test_asan builds it pathnames programatically based on the basename, so just
+  # test_asan builds it pathnames programmatically based on the basename, so just
   # search for the basename.
   if filename.startswith('test_asan_'):
     relpath = os.path.basename(relpath)

tools/maint/gen_sig_info.py

@@ -374,8 +374,8 @@ def extract_sig_info(sig_info, extra_settings=None, extra_cflags=None, cxx=False
 def main(args):
   parser = argparse.ArgumentParser()
   parser.add_argument('-o', '--output', default='src/library_sigs.js')
-  parser.add_argument('-r', '--remove', action='store_true', help='remove from JS library files any `__sig` entires that are part of the auto-generated file')
-  parser.add_argument('-u', '--update', action='store_true', help='update with JS library files any `__sig` entires that are part of the auto-generated file')
+  parser.add_argument('-r', '--remove', action='store_true', help='remove from JS library files any `__sig` entries that are part of the auto-generated file')
+  parser.add_argument('-u', '--update', action='store_true', help='update with JS library files any `__sig` entries that are part of the auto-generated file')
   args = parser.parse_args()
 
   print('generating signatures ...')

tools/ports/__init__.py

@@ -153,7 +153,7 @@ def get_include_dir(*parts):
 
   @staticmethod
   def install_header_dir(src_dir, target=None):
-    """Like install_headers but recusively copied all files in a directory"""
+    """Like install_headers but recursively copied all files in a directory"""
     if not target:
       target = os.path.basename(src_dir)
     dest = Ports.get_include_dir(target)
@@ -404,7 +404,7 @@ def dependency_order(port_list):
   # Perform topological sort of ports according to the dependency DAG
   port_map = {p.name: p for p in port_list}
 
-  # Perform depth first search of dependecy graph adding nodes to
+  # Perform depth first search of dependency graph adding nodes to
   # the stack only after all children have been explored.
   stack = []
   unsorted = OrderedSet(port_list)

tools/ports/sqlite3.py

@@ -3,7 +3,7 @@
 # University of Illinois/NCSA Open Source License.  Both these licenses can be
 # found in the LICENSE file.
 
-# sqlite amalgamation download URL uses relase year and tag
+# sqlite amalgamation download URL uses release year and tag
 # 2022  and (3, 38, 5) -> '/2022/sqlite-amalgamation-3380500.zip'
 VERSION = (3, 39, 0)
 VERSION_YEAR = 2022

tools/settings.py

@@ -160,7 +160,7 @@ def read_js_settings(filename, attrs):
       with open(filename) as fh:
         settings = fh.read()
       # Use a bunch of regexs to convert the file from JS to python
-      # TODO(sbc): This is kind hacky and we should probably covert
+      # TODO(sbc): This is kind hacky and we should probably convert
       # this file in format that python can read directly (since we
       # no longer read this file from JS at all).
       settings = settings.replace('//', '#')
@@ -273,7 +273,7 @@ def check_type(self, name, value):
     expected_type = self.types.get(name)
     if not expected_type:
       return
-    # Allow itegers 1 and 0 for type `bool`
+    # Allow integers 1 and 0 for type `bool`
     if expected_type == bool:
       if value in (1, 0):
         value = bool(value)

tools/shared.py

@@ -116,7 +116,7 @@ def shlex_join(cmd):
 def run_process(cmd, check=True, input=None, *args, **kw):
   """Runs a subprocess returning the exit code.
 
-  By default this function will raise an exception on failure.  Therefor this should only be
+  By default this function will raise an exception on failure.  Therefore this should only be
   used if you want to handle such failures.  For most subprocesses, failures are not recoverable
   and should be fatal.  In those cases the `check_call` wrapper should be preferred.
   """
@@ -511,7 +511,7 @@ def sanity_is_correct():
     return
 
   with cache.lock('sanity'):
-    # Check again once the cache lock as aquired
+    # Check again once the cache lock as acquired
     if sanity_is_correct():
       return
 

tools/system_libs.py

@@ -1710,7 +1710,7 @@ class libmalloc(MTLibrary):
 
   cflags = ['-fno-builtin', '-Wno-unused-function', '-Wno-unused-but-set-variable', '-Wno-unused-variable']
   # malloc/free/calloc are runtime functions and can be generated during LTO
-  # Therefor they cannot themselves be part of LTO.
+  # Therefore they cannot themselves be part of LTO.
   force_object_files = True
 
   def __init__(self, **kwargs):
@@ -1810,7 +1810,7 @@ class libmimalloc(MTLibrary):
   ]
 
   # malloc/free/calloc are runtime functions and can be generated during LTO
-  # Therefor they cannot themselves be part of LTO.
+  # Therefore they cannot themselves be part of LTO.
   force_object_files = True
 
   includes = ['system/lib/mimalloc/include']

tools/toolchain_profiler.results_template.html

@@ -631,7 +631,7 @@
           .duration(500)
           .style("opacity", 0);
     }
-    // upate the item rects
+    // update the item rects
     var rects = itemRects.selectAll('rect')
       .data(visItems, function (d) { return d.id; })
       .attr('x', function(d) { return x1(d.start); })

tools/unsafe_optimizations.mjs

@@ -75,7 +75,7 @@ function optPassRemoveRedundantOperatorNews(ast) {
         // referenced (a least in some builds).
         //
         // Another exception is made for `new WebAssembly.*` since we create and
-        // unused `WebAssembly.Memory` when probing for wasm64 fatures.
+        // unused `WebAssembly.Memory` when probing for wasm64 features.
         if (
           n.expression.callee.name !== 'Promise' &&
           n.expression.callee.object?.name !== 'WebAssembly'

tools/webassembly.py

@@ -3,7 +3,7 @@
 # University of Illinois/NCSA Open Source License.  Both these licenses can be
 # found in the LICENSE file.
 
-"""Utilties for manipulating WebAssembly binaries from python.
+"""Utilities for manipulating WebAssembly binaries from python.
 """
 
 from collections import namedtuple

tools/webidl_binder.py

@@ -693,7 +693,7 @@ def add_bounds_check_impl():
     continue
   implements[name] = [js_impl[0]]
 
-# Compute the height in the inheritance tree of each node. Note that the order of interation
+# Compute the height in the inheritance tree of each node. Note that the order of iteration
 # of `implements` is irrelevant.
 #
 # After one iteration of the loop, all ancestors of child are guaranteed to have a larger

tools/websocket_to_posix_proxy/src/websocket_to_posix_proxy.c

@@ -1599,7 +1599,7 @@ void ProcessWebSocketMessage(int client_fd, uint8_t *payload, uint64_t numBytes)
       header->function == POSIX_SOCKET_MSG_RECVMSG ||
       header->function == POSIX_SOCKET_MSG_CONNECT ||
       header->function == POSIX_SOCKET_MSG_ACCEPT) {
-    // Synchonous/blocking recv()s can halt indefinitely until a message is actually received. An application might
+    // Synchronous/blocking recv()s can halt indefinitely until a message is actually received. An application might
     // be send()ing messages in one thread while using another thread to wait for recv(). Therefore run these potentially
     // blocking recv()s in a separate thread. The nonblocking operations can run synchronously in calling thread (they could
     // also run in a background thread, but for performance, do not offload them since it is not necessary)