OpenAPI Forge - Java
This repository is the Java generator for the OpenAPI Forge, see that repository for usage instructions:
https://github.com/ScottLogic/openapi-forge
Configuration
OpenAPI Forge is opinionated in its approach, we don't provide a vast range of configuration options, just the essentials! You can list the generator-specific configuration options by running the generate-options command as follows:
% openapi-forge generator-options openapi-forge-java
This generator has a number of additional options which can be supplied when executing the 'forge' command.
Options:
--generator.package <value> The package for the generated classes.
Development
Running
To run this generator, you also need to have [OpenAPI Forge] installed, or the repository checked out. Assuming you have it installed as a global module, you can run this generator as follows:
$ openapi-forge forge
\ https://petstore3.swagger.io/api/v3/openapi.json
\ .
\ -o api
This generates an API from the Pet Store swagger definition, using the generator within the current folder (.), outputting the results to the api folder.
Testing
The standard test script is used to execute the BDD-style tests against this generator.
npm run test
The script expects that the openapi-forge project (which is where the BDD feature files are located) is checked out at the same folder-level as this project. In-depth documentation can be found at features/README.md.
Linting
Two scripts are available to help you find linting errors:
npm run lint:check:all
This runs eslint in check mode which will raise errors found but not try and fix them. This is also ran on a PR and a push to main. It will fail if any errors were found.
npm run lint:write:all
This runs eslint in write mode which will raise errors found and try to fix them.