[ 
https://issues.apache.org/jira/browse/SOLR-16346?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17608862#comment-17608862
 ] 

Kevin Risden commented on SOLR-16346:
-------------------------------------

Interestingly - I don't see what [~mdrob] is seeing in the build :/ I added 
`--info` to see what was going on and doesn't give a ton more insight.

{code:java}
./gradlew :solr:core:analyzeClassesDependencies --info
...
> Task :solr:core:analyzeClassesDependencies
Caching disabled for task ':solr:core:analyzeClassesDependencies' because:
  Build cache is disabled
Task ':solr:core:analyzeClassesDependencies' is not up-to-date because:
  Output property 'logFilePath' file 
/Users/risdenk/repos/apache/solr/solr/core/build/reports/dependency-analyze/analyzeClassesDependencies.log
 has been removed.
Analyzing dependencies of main classesDirs for [require: [configuration 
':solr:core:compileClasspath'], allowedToUse: [configuration 
':solr:core:permitUsedUndeclared'], allowedToDeclare: [configuration 
':solr:core:permitUnusedDeclared']]
Built artifact class map with 0 hits and 116 misses; cache size is 116
:solr:core:analyzeClassesDependencies (Thread[Execution worker for ':' Thread 
3,5,main]) completed. Took 1.428 secs.

BUILD SUCCESSFUL in 18s
12 actionable tasks: 10 executed, 2 up-to-date
Watched directory hierarchies: [/Users/risdenk/repos/apache/solr]
{code}


> Generate (and use) OpenAPI spec for v2 APIs
> -------------------------------------------
>
>                 Key: SOLR-16346
>                 URL: https://issues.apache.org/jira/browse/SOLR-16346
>             Project: Solr
>          Issue Type: Improvement
>      Security Level: Public(Default Security Level. Issues are Public) 
>          Components: v2 API
>    Affects Versions: main (10.0)
>            Reporter: Jason Gerlowski
>            Priority: Major
>          Time Spent: 1h 50m
>  Remaining Estimate: 0h
>
> An integration with [OpenAPI|https://www.openapis.org/] and its tooling has a 
> lot to offer Solr.  Once generated, an OpenAPI specification can be used to:
> * [generate clients|https://github.com/OpenAPITools/openapi-generator] for 
> multiple programming languages
> * power a web UI to document and help users craft API calls (e.g. 
> [redoc|https://github.com/Redocly/redoc]
> * [detect breaking API changes|https://github.com/Azure/openapi-diff] across 
> releases.
> Of course, these benefits are only useful if we take pains to document our 
> API inputs and outputs (probably with annotations that live directly in our 
> Java code).  But I think there's enough upside to be worth that trouble.
> This ticket aims to cover integrating OpenAPI into our gradle build, so that 
> a single task can be used to generate an OpenAPI spec.  (It might also make 
> sense to use this ticket to cover generating client bindings for one or more 
> languages.)



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org
For additional commands, e-mail: issues-h...@solr.apache.org

Reply via email to