Method compileFile

src/main/java/net/starlark/java/syntax/Program.java:95–130

Resolves a file syntax tree in the specified environment and compiles it to a Program. This operation mutates the syntax tree, both by resolving identifiers and recording local variables, and in case of error, by appending to file.errors(). @throws SyntaxError.Exception in case of resolutio

(StarlarkFile file, Resolver.Module env)

   *     contained syntax scan/parse errors. Resolution errors are added to {@code file.errors()}.
   */
  public static Program compileFile(StarlarkFile file, Resolver.Module env)
      throws SyntaxError.Exception {
    Resolver.resolveFile(file, env);
    if (!file.ok()) {
      throw new SyntaxError.Exception(file.errors());
    }

    // Extract load statements.
    ImmutableList.Builder<String> loads = ImmutableList.builder();
    ImmutableList.Builder<Location> loadLocations = ImmutableList.builder();
    for (Statement stmt : file.getStatements()) {
      if (stmt instanceof LoadStatement load) {
        String module = load.getImport().getValue();
        loads.add(module);
        loadLocations.add(load.getImport().getLocation());
      }
    }

    // Find unused doc comments.
    ImmutableMap<String, DocComments> docCommentsMap = ImmutableMap.copyOf(file.docCommentsMap);
    HashSet<Comment> usedDocCommentLines = new HashSet<>();
    for (DocComments docComments : docCommentsMap.values()) {
      usedDocCommentLines.addAll(docComments.getLines());
    }
    ImmutableList<Comment> unusedDocCommentLines =
        file.getComments().stream()
            .filter(c -> c.hasDocCommentPrefix() && !usedDocCommentLines.contains(c))
            .collect(toImmutableList());

    return new Program(
        file.getResolvedFunction(),
        loads.build(),
        loadLocations.build(),
        docCommentsMap,
        unusedDocCommentLines);
  }

  /**
   * Resolves an expression syntax tree in the specified environment and compiles it to a Program.