[GROOVY-11269] GroovyClassDoc has empty 'enumConstants' when call method GroovyDocParser.getClassDocsFromSingleSource(...)

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.5.12, 3.0.17
• Fix Version/s: 4.0.18, 5.0.0-alpha-5
• Component/s: parser
• Assignee: Paul King
• Reporter: Dmitry
• Created: 05/Jan/24 17:22
• Updated: 05/Mar/24 01:53
• Resolved: 13/Jan/24 22:45

Description

https://issues.apache.org/jira/browse/GROOVY-10886
https://issues.apache.org/jira/browse/GROOVY-11130

In our project we try to update gradle from 6.8.2 to 8.2.1.
And gradle 6.8.2 -> use groovy 2.5.12
But gradle 8.2.1 -> use groovy 3.0.17

How we parse java/groovy files now ->
59 line 

private Map<String, GroovyClassDoc> parseGroovy(String src, String packagePath, String file)

https://github.com/ishgroup/oncourse/blob/main/buildSrc/apidoc/src/main/groovy/au/com/ish/docs/DslGroovyRootDocBuilder.groovy

 

But it doesn't work for gradle 8.2.1 (groovy 3.0.17).
After discussion this issue in these tasks:
https://issues.apache.org/jira/browse/GROOVY-10886
https://issues.apache.org/jira/browse/GROOVY-11130
I try to use GroovyDocParser from org.codehaus.groovy.tools.groovydoc.antlr4

private Map<String, GroovyClassDoc> parseGroovy(String src, String packagePath, String file)
      throws RecognitionException, TokenStreamException {

   GroovyDocParser groovyDocParser = new GroovyDocParser(links, properties)
   def GroovyClassDocMap = groovyDocParser.getClassDocsFromSingleSource(packagePath, file, src)
   return GroovyClassDocMap
}

 

And It seems to work. But I found this problem:

When I parse groovy enums, GroovyClassDoc has empty 'enumConstants' and all enum values are in 'fields'.

But our old implementation has: