The API is one of the main components in Wharf. Its purpose is mainly a CRUD interface on top of the database that the other components in Wharf interact with.
-
HTTP API using the gin-gonic/gin web framework.
-
Swagger documentation generated using swaggo/swag and hosted using swaggo/gin-swagger.
-
Database ORM using gorm.io/gorm.
The wharf-api program can be configured via environment variables and through
optional config files. See the docs on the Config type over at:
https://pkg.go.dev/github.com/iver-wharf/wharf-api#Config
-
Install Go 1.18 or later: https://golang.org/
-
Install dependencies using GNU Make or GNUWin32
$ make deps -
Generate the Swagger files (this has to be redone each time the swaggo documentation comments has been altered):
$ make swag -
Start hacking with your favorite tool. For example VS Code, GoLand, Vim, Emacs, or whatnot.
Replace the "v2.0.0" in make docker version=v2.0.0 with the new version. Full
documentation can be found at Releasing a new version.
Below are just how to create the Docker images using GNU Make or GNUWin32:
$ make docker version=v2.0.0
STEP 1: FROM golang:1.18 AS build
STEP 2: WORKDIR /src
--> Using cache de3476fd68836750f453d9d4e7b592549fa924c14e68c9b80069881de8aacc9b
--> de3476fd688
STEP 3: ENV GO111MODULE=on
--> Using cache 4f47a95d0642dcaf5525ee1f19113f97911b1254889c5f2ce29eb6f034bd550b
--> 4f47a95d064
STEP 4: RUN go get -u github.com/swaggo/swag/cmd/swag@v1.7.0
...
Push the image by running:
docker push quay.io/iver-wharf/wharf-api:latest
docker push quay.io/iver-wharf/wharf-api:v2.0.0make deps # download linting dependencies
make lint
make lint-go # only lint Go code
make lint-md # only lint Markdown filesSome errors can be fixed automatically. Keep in mind that this updates the files in place.
make lint-fix
make lint-fix-go # only lint and fix Go files
make lint-fix-md # only lint and fix Markdown filesMaintained by Iver. Licensed under the MIT license.