flightctl-python-client/Makefile at main · flightctl/flightctl-python-client · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
# Python package version. Override on generate:
#   make generate-client VERSION=1.3.0
VERSION ?= 1.3.0
GENERATOR_VERSION = 7.17.0
COMMON_PROPS = packageName=flightctl,useOneOfDiscriminatorLookup=true,packageVersion=$(VERSION),removeEnumValuePrefix=false
GIT_USER = flightctl
GIT_REPO = python-client
# Required: flightctl/flightctl release tag.
# Example: make fetch-specs FLIGHTCTL_VERSION=v1.3.0
FLIGHTCTL_REPO = https://raw.githubusercontent.com/flightctl/flightctl
FLIGHTCTL_VERSION ?=
SPEC_FILES = \
	api/core/v1beta1/openapi.yaml \
	api/core/v1alpha1/openapi.yaml \
	api/imagebuilder/v1alpha1/openapi.yaml

.PHONY: generate-client generate-core generate-v1alpha1 generate-imagebuilder bundle-specs fetch-specs fix-enum-number-prefix

# Fetch OpenAPI specs from a specific flightctl/flightctl version
fetch-specs:
	@if [ -z "$(FLIGHTCTL_VERSION)" ]; then \
		echo "FLIGHTCTL_VERSION is required (flightctl/flightctl release tag)."; \
		echo "Example: make fetch-specs FLIGHTCTL_VERSION=v1.3.0"; \
		exit 1; \
	fi
	@for f in $(SPEC_FILES); do \
		echo "Fetching $$f from flightctl/flightctl@$(FLIGHTCTL_VERSION)"; \
		mkdir -p $$(dirname $$f); \
		curl -fsSL "$(FLIGHTCTL_REPO)/$(FLIGHTCTL_VERSION)/$$f" -o $$f; \
	done
	@echo "Fetched specs from flightctl/flightctl@$(FLIGHTCTL_VERSION)"

# Rewrite Enum.NUMBER_PascalCase -> Enum.PascalCase in generated Python.
# Spec defaults stay intact so wire values match the Go server.
fix-enum-number-prefix:
	python3 scripts/fix-enum-number-prefix.py

# Bundle specs (resolve $refs into self-contained files)
bundle-specs:
	@mkdir -p api/bundled
	npx @redocly/cli bundle api/core/v1beta1/openapi.yaml -o api/bundled/core-v1beta1.yaml
	npx @redocly/cli bundle api/core/v1alpha1/openapi.yaml -o api/bundled/core-v1alpha1.yaml
	npx @redocly/cli bundle api/imagebuilder/v1alpha1/openapi.yaml -o api/bundled/imagebuilder-v1alpha1.yaml

# Core v1beta1
generate-core: bundle-specs
	npx @openapitools/openapi-generator-cli version-manager set $(GENERATOR_VERSION)
	npx @openapitools/openapi-generator-cli generate \
		-g python \
		-i api/bundled/core-v1beta1.yaml \
		-o . \
		--skip-validate-spec \
		--additional-properties=$(COMMON_PROPS) \
		--git-user-id $(GIT_USER) \
		--git-repo-id $(GIT_REPO)
	$(MAKE) fix-enum-number-prefix

# Core v1alpha1
generate-v1alpha1: bundle-specs
	npx @openapitools/openapi-generator-cli version-manager set $(GENERATOR_VERSION)
	npx @openapitools/openapi-generator-cli generate \
		-g python \
		-i api/bundled/core-v1alpha1.yaml \
		-o . \
		--skip-validate-spec \
		--additional-properties=packageName=flightctl.v1alpha1,useOneOfDiscriminatorLookup=true,generateSourceCodeOnly=true,packageVersion=$(VERSION),removeEnumValuePrefix=false \
		--git-user-id $(GIT_USER) \
		--git-repo-id $(GIT_REPO)
	$(MAKE) fix-enum-number-prefix

# ImageBuilder v1alpha1
generate-imagebuilder: bundle-specs
	npx @openapitools/openapi-generator-cli version-manager set $(GENERATOR_VERSION)
	npx @openapitools/openapi-generator-cli generate \
		-g python \
		-i api/bundled/imagebuilder-v1alpha1.yaml \
		-o . \
		--skip-validate-spec \
		--additional-properties=packageName=flightctl.imagebuilder,useOneOfDiscriminatorLookup=true,generateSourceCodeOnly=true,packageVersion=$(VERSION),removeEnumValuePrefix=false \
		--git-user-id $(GIT_USER) \
		--git-repo-id $(GIT_REPO)
	$(MAKE) fix-enum-number-prefix

generate-client:
	@echo "Generating Python client package Version=$(VERSION)"
	$(MAKE) VERSION=$(VERSION) generate-core generate-v1alpha1 generate-imagebuilder