closure_make_deps.py

# Licensed to the Software Freedom Conservancy (SFC) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The SFC licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.

"""Generate a Closure deps.js file by scanning JS sources for goog.provide/require/module calls.

Replaces the Node.js closure-make-deps wrapper to avoid npm symlink issues on Windows.

Usage: closure_make_deps.py <files_list> <output> <closure_path>
  files_list   - path to a file containing one JS source path per line
  output       - path to write the generated deps.js
  closure_path - directory containing Closure Library's base.js (for computing relative paths)
"""

import os
import re
import sys

PROVIDE_RE = re.compile(r"goog\.provide\(\s*['\"]([^'\"]+)['\"]\s*\)")
MODULE_RE = re.compile(r"goog\.module\(\s*['\"]([^'\"]+)['\"]\s*\)")
REQUIRE_RE = re.compile(r"goog\.require\(\s*['\"]([^'\"]+)['\"]\s*\)")


def strip_comments(content):
    """Remove JS comments so regexes don't match goog.require() in documentation."""
    content = re.sub(r"/\*.*?\*/", "", content, flags=re.DOTALL)
    content = re.sub(r"//[^\n]*", "", content)
    return content


def parse_js_file(path):
    """Extract goog.provide, goog.module, and goog.require namespaces from a JS file."""
    with open(path, encoding="utf-8") as f:
        content = f.read()

    cleaned = strip_comments(content)

    provides = sorted(PROVIDE_RE.findall(cleaned))
    modules = sorted(MODULE_RE.findall(cleaned))
    requires = sorted(REQUIRE_RE.findall(cleaned))

    is_module = len(modules) > 0
    all_provides = sorted(set(provides + modules))

    return all_provides, requires, is_module


def main():
    if len(sys.argv) < 4:
        print(
            "Usage: closure_make_deps.py <files_list> <output> <closure_path>",
            file=sys.stderr,
        )
        sys.exit(1)

    files_list_path = sys.argv[1]
    output_path = sys.argv[2]
    closure_path = sys.argv[3]

    with open(files_list_path, encoding="utf-8") as f:
        files = [line.strip() for line in f if line.strip()]

    lines = []
    for filepath in files:
        provides, requires, is_module = parse_js_file(filepath)

        rel_path = os.path.relpath(filepath, closure_path)
        # deps.js is consumed in the browser, so always use forward slashes
        rel_path = rel_path.replace(os.sep, "/")

        provides_str = ", ".join(f"'{p}'" for p in provides)
        requires_str = ", ".join(f"'{r}'" for r in requires)

        if is_module:
            line = f"goog.addDependency('{rel_path}', [{provides_str}], [{requires_str}], {{'module': 'goog'}});"
        else:
            line = f"goog.addDependency('{rel_path}', [{provides_str}], [{requires_str}]);"

        lines.append((rel_path, line))

    # Sort by relative path for deterministic output
    lines.sort(key=lambda x: x[0])

    with open(output_path, "w", encoding="utf-8") as f:
        for _, line in lines:
            f.write(line + "\n")


if __name__ == "__main__":
    main()