New release: Spoon 6.2.0 is here

[surli]

We will soon release a new version of Spoon.
There's some new contributors on this release so kudos for them to bring some help on this project :)

Here's the final changelog:

New features

• Add support to change the destination file on disk for modules, packages and types. (PR: Review: feat: be able to change the destination of each created file #1610)
• Add CtScanner#scan(Map) for a better EarlyTerminatingScanner. (PR: review: feat: CtScanner#scan of Collection and Map #1805)
• Add support for paths for all elements from model root (CtElement#getPath). (PR: feat: Adds unique serializable path for each CtElement from Root Element. #1874)
• One could add a type member that already exists (equals but not same) and modify it afterwards. (PR: feat: one could add a type member that already exists (equals but not same) and modify it afterwards #1864)
• Add method CtMethod#getTopDefinitions. (PR: feat: add method CtMethod#getTopDefinitions #1844)
• Add Refactoring#copyType and #copyMethod for advanced cloning. (PR: feature: add methods Refactoring#copyType and Refactoring#copyMethod #1884)
• All RoleHandlers supports set/add/remove. (PR: feature: All RoleHandlers supports set/add/remove #1793)
• Add methods getRoleHandlers(Class), forEachRoleHandler, getRoleHandlerWrtParent in RoleHandlerHelper. (PR: feature: RoleHandlerHelper#getRoleHandlers(Class), forEachRoleHandler, getParentRoleHandler #1794)
• SpoonModelTree GUI can be created with a custom root element. (PR: feature: SpoonModelTree can be created with custom root element #1799)
• Add support for clone process customization with CloneHelper#addClone. (PR: feature: CloneHelper#addClone - support of clone process customization #1802)
• Spoon Filter implements java.util.function.Predicate. (PR: feature: Spoon Filter implements java.util.function.Predicate #1798)

Bug Fixes

• GetDocComment returns the complete Javadoc comment, incl. tags. (PR: review fix: getDocComment returns the complete Javadoc comment, incl. tags #1822)
• Add RoleHandler setter for SUPER_TYPE and INTERFACE. (PR: fix: RoleHandler setter for SUPER_TYPE and INTERFACE #1890)
• CtCatchVariable#multiType role TYPE changed to MULTI_TYPE. (PR: fix: CtCatchVariable#multiType role TYPE changed to MULTI_TYPE #1877)
• Fully comply with the contract of CtScannerTest#testScannerCallsAllProperties. (PR: fix: fully comply with the contract of CtScannerTest#testScannerCallsAllProperties #1870)
• Change how DJPP prints "return" so that it's checkstyle-compliant. (PR: fix: change how DJPP prints "return" so that it's checkstyle-compliant #1871)
• Unsettable properties are now really unsettable, and there is a test for this. (PR: review: fix: Unsettable properties sets no value or sets different primary value #1893)
• Fix equality for assignments. (PR: fix EqualsChecker for assignments #1845)
• GetDocComment() returns asterisk (*) and spaces before comment. (PR: fix: getDocComment() returns asterisk (*) and spaces before comment #1841)
• Small bugs in MethodTypingContext and CtTypeReference. (PR: fix some small bugs #1838)
• ClassTypingContext resolveTypeParameter can gracefully handle outer parameters. (PR: fix: ClassTypingContext resolveTypeParameter of outer parameters #1837)
• Fix StringIndexOutOfBoundsException in CtJavadoc#getShortDescription. (PR: fix: CtJavadoc#getShortDescription #1827)
• TypeFactory#get(qualifiedName) for class names containing $. (PR: refactor(TypeFactory#get(String qualifiedName)): Look for type in factory.Package() first, and not at the end. Workaround for #1889 #1891)
• Stackoverflow on AbstractTypingContext. (PR: review: fix: stackoverflow on AbstractTypingContext #1817)
• NPE when using MavenLauncher on module containing dependency with variable. (PR: review fix: NPE when using MavenLauncher on module containing dependency with variable #1810)
• Undo feature: Spoon Filter implements java.util.function.Predicate #1798 for backward compatibility. (PR: fix: Filter and Predicate #1811)
• Filter extends Predicate is now working with projects in JDK7. (PR: review fix: Filter extends Predicate is now working with projects in JDK7 #1808)
• Shadow classes should be interpreted according to their kind (enum, interface, etc). (PR: fix: Shadow classes should be interpreted according to their kind (enum, interface, etc) #1806)
• Easier specification of template parameters (without annotations). (PR: fix: detection of TemplateParameter in Parameters#isParameterSource #1801)
• DefaultJavaPrettyPrinter prints an ERROR comment instead of raising an exception when a field is missing in the model. (PR: fix: DefaultJavaPrettyPrinter prints an ERROR comment instead of failure #1797)
• Various fixes in VisitorPartialEvaluator. (PR: fix: VisitorPartialEvaluator #1800)
• DefaultJavaPrettyPrinter exposes the tokenWriter for subclasses. (PR: feature: DefaultJavaPrettyPrinter#getPrinterTokenWriter #1796)
• ParentFunction doesn't fail on null parent. (PR: fix: ParentFunction - doesn't fail on null parent #1795)
• Add generic typing to TypeFactory constants. (PR: fix: TypeFactory type arguments of constants #1792)
• serialization: SourcePosition#getFile() after deserialization. (PR: fix getFile() for serialization #1847)
• Fix order of type members. (PR: Review: fix order of type members #1787)

Documentation

• Add missing javadoc. (PR: doc: add missing javadoc on public methods #1843)
• Add missing Javadoc in ModelsUtils. (PR: doc: add missing Javadoc in ModelsUtils #1860)
• Missing documentation in public methods used for pretty-printing. (PR: doc: add missing documentation in public methods used for pretty-printing #1854)
• Another set of Javadoc comments for public methods. (PR: doc: another set of Javadoc comments for public methods #1856)
• Add API documentation to interface JavaReflectionVisitor. (PR: doc: add API documentation to interface JavaReflectionVisitor #1850)
• Add doc for public method in RtMethod. (PR: doc: add doc for public method in RtMethod #1858)
• Fix Javadoc (incorrect starting tag). (PR: doc: fix Javadoc (incorrect starting tag) #1839)
• Fix missing javadoc. (PR: doc: fix missing javadoc in FineModelChangeListener #1840)
• Improve Javadoc of #getAllMethods. (PR: doc: improve Javadoc of #getAllMethods #1836)
• Improves the documentation of getOverridingExecutable. (PR: doc: improves the documentation of getOverridingExecutable #1828)
• Bump Spoon number in doc. (PR: doc: Bump Spoon number in doc #1790)

Refactoring

• Improve Meta-Metamodel classes in src/test. (PR: refactor: improve meta-metamodel classes about Spoon types and roles #1894)
• Refactor cloning code to increase extendability. (PR: review: refactor: refactor cloning code to increase extendability #1878)
• Remove CtParameterReferenceImpl#declaringExecutable. (PR: refactor: remove CtParameterReferenceImpl#declaringExecutable #1875)
• Push down the equality checking code in EqualsVisitor. (PR: refactor: push down the equality checking code in EqualsVisitor #1853)
• Hide some methods that are clearly meant to be package visible. (PR: refactor: hide some methods that are clearly meant to be package visible #1855)
• Internal utility type in JDTTreeBuilder should be package-visible. (PR: refactor: internal utility type in JDTTreeBuilder should be package-visible #1848)
• Package-visible class CommentHelper should have package-visible methods. (PR: refactor: package-visible class CommentHelper should have package-visible methods #1849)
• Remove wrong comments and unused imports. (PR: just removed some wrong comments and unused imports #1803)
• prettyprinter: Restore DJPP#writeHeaders that clients can override. (PR: refactor: restore DJPP#writeHeaders that clients can override #1866)

Tests

• architecture: All public API methods should be documented with Javadoc. (PR: test: all public API methods should be documented with Javadoc #1867)
• Fix CI failure due to interaction between feat: one could add a type member that already exists (equals but not same) and modify it afterwards #1864 and Review: fix order of type members #1787. (PR: test: fix CI failure due to interaction between #1864 and #1787 #1868)
• Move metamodel related method to class SpoonMetaModel for better discoverability. (PR: test: move metamodel related method to class SpoonMetaModel for better discoverability #1851)
• Add method ModelUtils#getOptimizedString for handling EOL, TAB, etc in assertions. (PR: test feature: ModelUtils#getOptimizedString #1804)

Chores

• Enable unchecked compiler warnings. (PR: chore: enable unchecked compiler warnings #1886)
• Enables incremental compilation. (PR: chore: enables incremental compilation #1885)
• Fix javadoc linter config in pom.xml. (PR: chore: fix javadoc linter config in pom.xml #1881)
• Add Eclipse's .checkstyle to .gitignore. (PR: chore: Eclipse .checkstyle ignored by git #1882)
• Add a script to update pom.xml for running pit-descartes. (PR: review chore: Add a script to update pom.xml for running pit-descartes #1820)
• Add CI script to check whether Spoon compiles with Maven 3.3.9. (PR: review chore: Check if Spoon compile with Maven 3.3.9 #1815)
• revapi: Fix revapi commenting bot. (PR: Review: chore: fix revapi commenting bot #1863)
• Prepare for next development iteration.

Authors

Name	Nb Commit
Martin Monperrus	30
Pavel Vojtechovsky	21
Simon Urli	9
Egor18	4
Nicolas Harrand	2
Thomas Durieux	1
Shantanu	1

[monperrus]

yeah!

[surli]

Spoon 6.2.0 has just been released. It will be available in few times from Maven Central. I just updated the changelog. Thanks everyone :)

[pvojtechovsky]

Thank You Simon for taking care about spoon infrastructure and releases!