Where is the Javadoc?

The javadoc is at http://spoon.gforge.inria.fr/mvnsites/spoon-core/apidocs

Are there snapshots versions deployed somewhere?

<dependencies>
	<dependency>
		<groupId>fr.inria.gforge.spoon</groupId>
		<artifactId>spoon-core</artifactId>
		<version>10.4.3-SNAPSHOT</version>
	</dependency>
</dependencies>
<repositories>
	<repository>
      <id>spoon-snapshot</id>
      <name>Maven Repository for Spoon Snapshots</name>
      <url>https://repository.ow2.org/nexus/content/repositories/snapshots/</url>
    </repository>
</repositories>

How to access Spoon’s source code repository?

Spoon is developed on GitHub at https://github.com/INRIA/spoon/. You can browse the Spoon source using code intelligence (Go-to-definition, Find References, and Hover tooltips) at https://sourcegraph.com/github.com/INRIA/spoon.

What is the meaning of each digit in the version X.Y.Z of spoon?

  • X is the digit for the major version (major new features or major incompatible API changes).
  • Y is the digit for the minor version (bug fixes or minor API changes).
  • Z is the digit for the critical bug fixes of the current major or minor version.

Where is the Spoon metamodel?

The Spoon metamodel consists of all interfaces that are in packages spoon.reflect.declaration (structural part: classes, methods, etc.) and spoon.reflect.code (behavioral part: if, loops, etc.).

How to prevent Annotation processors from consuming the annotations that they process?

By default, whenever an Annotation Processor processes a CtElement it will consume (delete) the processed annotation from it. If you want the annotation to be kept, override the init() method from the AbstractAnnotationProcessor class, and call the protected method clearConsumedAnnotationTypes like so:

@Override
public void init() {
	super.init();
	clearConsumedAnnotationTypes();
}

How to compare and create type references in a type-safe way?

Use actual classes instead of strings.

CtTypeReference t=...
if(t.getActualClass()==int.class) { ... }
Factory f=...
t=f.Type().createReference(int.class);

How to set the JDT compiler arguments?

SpoonModelBuilder exposes a method named build(JDTBuilder). This method compiles the target source code with data specified in the JDTBuilder parameter.

final String[] builder = new JDTBuilderImpl() //
		.classpathOptions(new ClasspathOptions().classpath(TEST_CLASSPATH).bootclasspath(TEST_CLASSPATH).binaries(".").encoding("UTF-8")) //
		.complianceOptions(new ComplianceOptions().compliance(8)) //
		.annotationProcessingOptions(new AnnotationProcessingOptions().compileProcessors()) //
		.advancedOptions(new AdvancedOptions().continueExecution().enableJavadoc().preserveUnusedVars()) //
		.sources(new SourceOptions().sources(".")) //
		.build();

What does Launcher#prettyprint() do?

launcher.prettyprint prints the model on disk. The model could have been transformed or not, and is saved in an output directory which one can set up with launcher.setSourceOutputDirectory(). The default output directory is called spooned. If you want the pretty-print to the standard output (console STDOUT), use method toString instead, defined for every CtElement. Reference: https://github.com/INRIA/spoon/issues/4274