Method Detail

• compile

  public static com.google.common.base.Optional<CompiledTemplates> compile(TemplateRegistry registry,
                                                           boolean developmentMode,
                                                           ErrorReporter reporter)

  Compiles all the templates in the given registry.

  Parameters:

  registry - All the templates to compile

  developmentMode - Whether or not we are in development mode. In development mode we compile classes lazily

  reporter - The error reporter

  Returns:

  CompiledTemplates or absent() if compilation fails, in which case errors will have been reported to the error reporter.

• compileToJar

  public static void compileToJar(TemplateRegistry registry,
                  ErrorReporter reporter,
                  com.google.common.io.ByteSink sink)
                           throws IOException

  Compiles all the templates in the given registry to a jar file written to the given output stream.

  If errors are encountered, the error reporter will be updated and we will return. The contents of any data written to the sink at that point are undefined.

  Parameters:

  registry - All the templates to compile

  reporter - The error reporter

  sink - The output sink to write the JAR to.

  Throws:

  IOException

• writeSrcJar

  public static void writeSrcJar(TemplateRegistry registry,
                 com.google.common.collect.ImmutableMap<String,SoyFileSupplier> files,
                 com.google.common.io.ByteSink sink)
                          throws IOException

  Writes the source files out to a -src.jar. This places the soy files at the same classpath relative location as their generated classes. Ultimately this can be used by debuggers for source level debugging.

  It is a little weird that the relative locations of the generated classes are not identical to the input source files. This is due to the disconnect between java packages and soy namespaces. We should consider using the soy namespace directly as a java package in the future.

  Parameters:

  registry - All the templates in the current compilation unit

  files - The source files by file path

  sink - The source to write the jar file

  Throws:

  IOException