Replace "go-swagger" by "openapi-generator".

Author: v0ctor

.gitignore

@@ -1,3 +1,2 @@
 .DS_Store
-.env
-.gobincache/
+/.env

.openapi-generator-ignore

@@ -0,0 +1,8 @@
+# Already part of the project
+/.gitignore
+/api/openapi.yaml
+/README.md
+
+# Unwanted
+/.travis.yml
+/git_push.sh

.openapi-generator/config.yaml

@@ -0,0 +1,11 @@
+generatorName: go
+
+gitHost: github.com
+gitUserId: netbox-community
+gitRepoId: go-netbox/v3
+
+packageName: netbox
+
+additionalProperties:
+  disallowAdditionalPropertiesIfNotPresent: "false"
+  packageVersion: "3"

Dockerfile

@@ -1,12 +1,10 @@
-ARG GO_VERSION=1.20.1
-ARG ALPINE_VERSION=3.17
-ARG GOIMPORTS_VERSION=0.6.0
-ARG DELVE_VERSION=1.20.1
-ARG SWAGGER_VERSION=0.30.4
+ARG GO_VERSION=1.21.0-alpine3.18
+ARG GOIMPORTS_VERSION=0.12.0
+ARG DELVE_VERSION=1.21.0
 
 
 ## Base image
-FROM golang:${GO_VERSION}-alpine${ALPINE_VERSION} AS base
+FROM golang:${GO_VERSION} AS base
 
 WORKDIR /go/src/app
 
@@ -18,7 +16,6 @@ FROM base AS development
 
 ARG GOIMPORTS_VERSION
 ARG DELVE_VERSION
-ARG SWAGGER_VERSION
 
 RUN apk add \
         bash \
@@ -28,8 +25,7 @@ RUN apk add \
         python3 \
         zsh \
  && go install golang.org/x/tools/cmd/goimports@v${GOIMPORTS_VERSION} \
- && go install github.com/go-delve/delve/cmd/dlv@v${DELVE_VERSION} \
- && go install github.com/go-swagger/go-swagger/cmd/swagger@v${SWAGGER_VERSION}
+ && go install github.com/go-delve/delve/cmd/dlv@v${DELVE_VERSION}
 
 ARG USER_ID=1000
 ENV USER_NAME=default

Makefile

@@ -33,8 +33,10 @@ shell:
 build:
 	$(EXEC) ./scripts/set-versions.sh $(NETBOX_VERSION) $(NETBOX_DOCKER_VERSION)
 	./scripts/fetch-spec.sh $$(cat api/netbox_version) $$(cat api/netbox_docker_version)
-	$(EXEC) ./scripts/generate-code.sh
+	./scripts/generate-code.sh
+	$(EXEC) go mod tidy
+	$(EXEC) goimports -w .
 
 .PHONY: test
 test:
-	$(EXEC) go test ./... -tags=integration
+	$(EXEC) go test -v ./...

assets/copyright_header.txt

@@ -2,25 +2,8 @@
 
 set -euo pipefail
 
-export SRC_DIR='./netbox'
-
-# Prepare environment
-rm -rf netbox/client netbox/models
-go mod download
-
-# Run pre-generation hooks
-for SCRIPT in scripts/pre-generation/*; do
-  "${SCRIPT}"
-done
-
-# Generate code
-swagger generate client -f api/openapi.json --target="${SRC_DIR}" --copyright-file=assets/copyright_header.txt
-go mod tidy
-
-# Run post-generation hooks
-for SCRIPT in scripts/post-generation/*; do
-  "${SCRIPT}"
-done
-
-# Format generated code and fix imports
-goimports -w "${SRC_DIR}"
+docker run --rm -v "${PWD}:/local" openapitools/openapi-generator-cli:v6.6.0 generate \
+    --config /local/.openapi-generator/config.yaml \
+    --input-spec /local/api/openapi.yaml \
+    --output /local \
+    --http-user-agent go-netbox/$(cat api/netbox_version)