Use jgen.sh which is the upgraded version of app-gen written in Java
What is app-gen
app-gen is a general purpose code generator. app-gen can be used to generate all kinds of code. Specifically, it is used to generate chenile code.
app-gen is a set of code generation utilities. They use the concept of blueprints. Blue prints contain a template for code along with code naming conventions etc. app-gen can be used as a framework to generate a Chenile module. app-gen can also be used to do code generation outside of Chenile.
Chenile recommends multiple types of modules:
- Service Modules - both API and service which are used to expose a service via HTTP
- Workflow modules - which support a workflow oriented service via HTTP
- Deploy modules (Or Mini Monoliths)- that support a deployment. The service modules contain code for one service whilst the deploy modules package multiple service modules and generate a Spring Boot deployment that can be executed.
app-gen generates these modules automatically with hooks to Chenile and compliant to Chenile best practices.
Why app-gen
It is highly recommended that developers must use app-gen to generate Chenile modules due to the following reasons:
- Chenile makes extensive recommendations around the structure of modules. app-gen automatically generates the modules in compliance to those recommendations.
- app-gen evolves as the recommendations evolve. Hence by using app-gen, you are guaranteed to remain up to date in your adherence to Chenile recommendations.
- By generating Makefile, BDD, etc. app-gen ensures that you leverage Chenile features fully.
- Boiler plate code is automatically minimized.
How to use app-gen?
app-gen provides a wrapper program gen.sh that can be used to generate the boiler plate code. It has straight forward options to choose between the different types of modules, provide an interface file or workflow file and then choose the URLS. We will discuss these in more detail in the respective module sections.