Add command to generate java models and clean

Author: rahil-c

.gitignore

@@ -42,3 +42,6 @@ target/
 demo/jars/*
 demo/notebook/.ipynb_checkpoints/*
 my_config.yaml
+
+# REST generated models
+spec/generated

spec/Makefile

@@ -25,7 +25,11 @@ PIP     := $(VENV_DIR)/bin/pip
 VALIDATOR := $(VENV_DIR)/bin/openapi-spec-validator
 SPEC    := rest-service-open-api.yaml
 
-.PHONY: all venv install lint clean
+# Configuration for model generation
+GEN_DIR     := generated
+MODEL_PKG   := org.apache.xtable.service.models
+
+.PHONY: all venv install lint clean clean-models
 
 all: lint
 
@@ -49,4 +53,20 @@ lint: install
 # Remove the virtualenv
 clean:
 	@echo "→ removing $(VENV_DIR)…"
-	rm -rf $(VENV_DIR)
+	rm -rf $(VENV_DIR)
+
+# Generate Java model classes from OpenAPI spec
+generate-models:
+	@echo "→ generating Java model classes from $(SPEC)…"
+	openapi-generator generate \
+	  -i $(SPEC) \
+	  -g java \
+	  -o $(GEN_DIR) \
+	  --model-package $(MODEL_PKG) \
+	  --global-property models,modelTests=false,modelDocs=false
+	@echo "→ models generated in $(GEN_DIR)/src/main/java/$(subst .,/,$(MODEL_PKG))"
+
+# Remove all generated model classes
+clean-models:
+	@echo "→ removing generated models in $(GEN_DIR)…"
+	rm -rf $(GEN_DIR)

spec/README.md

@@ -33,4 +33,20 @@ make lint
 if you want to wipe out the venv and start fresh run make clean
 ```sh
 make clean
+```
+
+## Generate 
+
+Note: You’ll need the OpenAPI Generator CLI installed and on your `PATH`. You can install it using Homebrew:
+```sh
+brew install openapi-generator
+```
+Then to generate the java models from the open-api spec, you can run the `generate-models` command.
+
+```sh
+make generate-models
+```
+If you would to remove the generated models, you can run the `clean-models` command:
+```sh
+make clean-models
 ```