OpenAPITools / OpenAPITools/openapi-generator
[BUG] Issue with `bin/utils/export_docs_generators.sh`
Open
Nobody has claimed this yet.
Issue: Bug
- Dominant language
- Java
- Stars
- 26.8k
- Forks
- 7.7k
- PR merge metrics
- PR metrics pending
Description
Description
Run ./bin/utils/export_docs_generators.sh, which shows the following issues (partial result):
# START SCRIPT: ./bin/utils/export_generator.sh erlang-proper
java.io.FileNotFoundException: docs/generators/erlang-proper.md (Is a directory)
at java.io.FileOutputStream.open0(Native Method)
at java.io.FileOutputStream.open(FileOutputStream.java:270)
at java.io.FileOutputStream.<init>(FileOutputStream.java:213)
at java.io.FileOutputStream.<init>(FileOutputStream.java:162)
at org.openapitools.codegen.cmd.ConfigHelp.run(ConfigHelp.java:72)
at org.openapitools.codegen.OpenAPIGenerator.main(OpenAPIGenerator.java:62)
./bin/utils/export_generator.sh: line 19: docs/generators/erlang-proper.md: Is a directory
# START SCRIPT: ./bin/utils/export_generator.sh erlang-server
# START SCRIPT: ./bin/utils/export_generator.sh flash
# START SCRIPT: ./bin/utils/export_generator.sh scala-finch
# START SCRIPT: ./bin/utils/export_generator.sh go
# START SCRIPT: ./bin/utils/export_generator.sh go-server
# START SCRIPT: ./bin/utils/export_generator.sh go-gin-server
# START SCRIPT: ./bin/utils/export_generator.sh graphql-schema
java.io.FileNotFoundException: docs/generators/graphql-schema.md (Is a directory)
at java.io.FileOutputStream.open0(Native Method)
at java.io.FileOutputStream.open(FileOutputStream.java:270)
at java.io.FileOutputStream.<init>(FileOutputStream.java:213)
at java.io.FileOutputStream.<init>(FileOutputStream.java:162)
at org.openapitools.codegen.cmd.ConfigHelp.run(ConfigHelp.java:72)
at org.openapitools.codegen.OpenAPIGenerator.main(OpenAPIGenerator.java:62)
./bin/utils/export_generator.sh: line 19: docs/generators/graphql-schema.md: Is a directory
# START SCRIPT: ./bin/utils/export_generator.sh graphql-server
java.io.FileNotFoundException: docs/generators/graphql-server.md (Is a directory)
at java.io.FileOutputStream.open0(Native Method)
at java.io.FileOutputStream.open(FileOutputStream.java:270)
at java.io.FileOutputStream.<init>(FileOutputStream.java:213)
at java.io.FileOutputStream.<init>(FileOutputStream.java:162)
at org.openapitools.codegen.cmd.ConfigHelp.run(ConfigHelp.java:72)
at org.openapitools.codegen.OpenAPIGenerator.main(OpenAPIGenerator.java:62)
./bin/utils/export_generator.sh: line 19: docs/generators/graphql-server.md: Is a directory
openapi-generator version
latest master
Suggest a fix
If anyone wants to help with this issue, please reply to let us know.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Run bin/utils/export_docs_generators.sh and inspect bin/utils/export_generator.sh, especially line 19, along with the affected paths under docs/generators/. Compare the generated output paths with existing directories, then rerun the export script and confirm it completes without directory-related errors.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java, shell
- Domain
- documentation, tooling
- Issue type
- Bug
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100