ci(Makefile): added help and descriptions to targets (#3964)
This commit is contained in:
		
							
								
								
									
										42
									
								
								Makefile
									
									
									
									
									
								
							
							
						
						
									
										42
									
								
								Makefile
									
									
									
									
									
								
							@ -8,6 +8,7 @@ TESTFOLDER := $(shell $(GO) list ./... | grep -E 'gin$$|binding$$|render$$' | gr
 | 
				
			|||||||
TESTTAGS ?= ""
 | 
					TESTTAGS ?= ""
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.PHONY: test
 | 
					.PHONY: test
 | 
				
			||||||
 | 
					# Run tests to verify code functionality.
 | 
				
			||||||
test:
 | 
					test:
 | 
				
			||||||
	echo "mode: count" > coverage.out
 | 
						echo "mode: count" > coverage.out
 | 
				
			||||||
	for d in $(TESTFOLDER); do \
 | 
						for d in $(TESTFOLDER); do \
 | 
				
			||||||
@ -30,10 +31,12 @@ test:
 | 
				
			|||||||
	done
 | 
						done
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.PHONY: fmt
 | 
					.PHONY: fmt
 | 
				
			||||||
 | 
					# Ensure consistent code formatting.
 | 
				
			||||||
fmt:
 | 
					fmt:
 | 
				
			||||||
	$(GOFMT) -w $(GOFILES)
 | 
						$(GOFMT) -w $(GOFILES)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.PHONY: fmt-check
 | 
					.PHONY: fmt-check
 | 
				
			||||||
 | 
					# format (check only).
 | 
				
			||||||
fmt-check:
 | 
					fmt-check:
 | 
				
			||||||
	@diff=$$($(GOFMT) -d $(GOFILES)); \
 | 
						@diff=$$($(GOFMT) -d $(GOFILES)); \
 | 
				
			||||||
	if [ -n "$$diff" ]; then \
 | 
						if [ -n "$$diff" ]; then \
 | 
				
			||||||
@ -43,31 +46,36 @@ fmt-check:
 | 
				
			|||||||
	fi;
 | 
						fi;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.PHONY: vet
 | 
					.PHONY: vet
 | 
				
			||||||
 | 
					# Examine packages and report suspicious constructs if any.
 | 
				
			||||||
vet:
 | 
					vet:
 | 
				
			||||||
	$(GO) vet $(VETPACKAGES)
 | 
						$(GO) vet $(VETPACKAGES)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.PHONY: lint
 | 
					.PHONY: lint
 | 
				
			||||||
 | 
					# Inspect source code for stylistic errors or potential bugs.
 | 
				
			||||||
lint:
 | 
					lint:
 | 
				
			||||||
	@hash golint > /dev/null 2>&1; if [ $$? -ne 0 ]; then \
 | 
						@hash golint > /dev/null 2>&1; if [ $$? -ne 0 ]; then \
 | 
				
			||||||
		$(GO) get -u golang.org/x/lint/golint; \
 | 
							$(GO) get -u golang.org/x/lint/golint; \
 | 
				
			||||||
	fi
 | 
						fi
 | 
				
			||||||
	for PKG in $(PACKAGES); do golint -set_exit_status $$PKG || exit 1; done;
 | 
						for PKG in $(PACKAGES); do golint -set_exit_status $$PKG || exit 1; done;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.PHONY: misspell-check
 | 
					 | 
				
			||||||
misspell-check:
 | 
					 | 
				
			||||||
	@hash misspell > /dev/null 2>&1; if [ $$? -ne 0 ]; then \
 | 
					 | 
				
			||||||
		$(GO) get -u github.com/client9/misspell/cmd/misspell; \
 | 
					 | 
				
			||||||
	fi
 | 
					 | 
				
			||||||
	misspell -error $(GOFILES)
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
.PHONY: misspell
 | 
					.PHONY: misspell
 | 
				
			||||||
 | 
					# Correct commonly misspelled English words in source code.
 | 
				
			||||||
misspell:
 | 
					misspell:
 | 
				
			||||||
	@hash misspell > /dev/null 2>&1; if [ $$? -ne 0 ]; then \
 | 
						@hash misspell > /dev/null 2>&1; if [ $$? -ne 0 ]; then \
 | 
				
			||||||
		$(GO) get -u github.com/client9/misspell/cmd/misspell; \
 | 
							$(GO) get -u github.com/client9/misspell/cmd/misspell; \
 | 
				
			||||||
	fi
 | 
						fi
 | 
				
			||||||
	misspell -w $(GOFILES)
 | 
						misspell -w $(GOFILES)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					.PHONY: misspell-check
 | 
				
			||||||
 | 
					# misspell (check only).
 | 
				
			||||||
 | 
					misspell-check:
 | 
				
			||||||
 | 
						@hash misspell > /dev/null 2>&1; if [ $$? -ne 0 ]; then \
 | 
				
			||||||
 | 
							$(GO) get -u github.com/client9/misspell/cmd/misspell; \
 | 
				
			||||||
 | 
						fi
 | 
				
			||||||
 | 
						misspell -error $(GOFILES)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.PHONY: tools
 | 
					.PHONY: tools
 | 
				
			||||||
 | 
					# Install tools (golint and misspell).
 | 
				
			||||||
tools:
 | 
					tools:
 | 
				
			||||||
	@if [ $(GO_VERSION) -gt 15 ]; then \
 | 
						@if [ $(GO_VERSION) -gt 15 ]; then \
 | 
				
			||||||
		$(GO) install golang.org/x/lint/golint@latest; \
 | 
							$(GO) install golang.org/x/lint/golint@latest; \
 | 
				
			||||||
@ -76,3 +84,23 @@ tools:
 | 
				
			|||||||
		$(GO) install golang.org/x/lint/golint; \
 | 
							$(GO) install golang.org/x/lint/golint; \
 | 
				
			||||||
		$(GO) install github.com/client9/misspell/cmd/misspell; \
 | 
							$(GO) install github.com/client9/misspell/cmd/misspell; \
 | 
				
			||||||
	fi
 | 
						fi
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					.PHONY: help
 | 
				
			||||||
 | 
					# Help.
 | 
				
			||||||
 | 
					help:
 | 
				
			||||||
 | 
						@echo ''
 | 
				
			||||||
 | 
						@echo 'Usage:'
 | 
				
			||||||
 | 
						@echo ' make [target]'
 | 
				
			||||||
 | 
						@echo ''
 | 
				
			||||||
 | 
						@echo 'Targets:'
 | 
				
			||||||
 | 
						@awk '/^[a-zA-Z\-\0-9]+:/ { \
 | 
				
			||||||
 | 
						helpMessage = match(lastLine, /^# (.*)/); \
 | 
				
			||||||
 | 
							if (helpMessage) { \
 | 
				
			||||||
 | 
								helpCommand = substr($$1, 0, index($$1, ":")-1); \
 | 
				
			||||||
 | 
								helpMessage = substr(lastLine, RSTART + 2, RLENGTH); \
 | 
				
			||||||
 | 
								printf " - \033[36m%-20s\033[0m %s\n", helpCommand, helpMessage; \
 | 
				
			||||||
 | 
							} \
 | 
				
			||||||
 | 
						} \
 | 
				
			||||||
 | 
						{ lastLine = $$0 }' $(MAKEFILE_LIST)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					.DEFAULT_GOAL := help
 | 
				
			||||||
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user