go-gin-gee

README

go-gin-gee

Gee provides several services for everyday life. The project is based on Gin [1], and the structure refers to ProjectLayout [3]. Some daily scripts in the folder Scripts depend on Script [4], which can run by the command Run.

Table of Contents

• go-gin-gee
  • Install
  • Script Examples
  • API Examples
    • Save Data
  • Build
    • Linux
    • Mac
    • Windows
  • Deploy
    • Supervisor
    • Docker
      • Build
      • Run
  • Contributing
  • References

Install

git clone git@github.com:mazeyqian/go-gin-gee.git

Script Examples

Change Git name and email for different projects.

go run scripts/change-git-user/main.go -path="/Users/X/Web" -username="Your Name" -useremail="your@email.com"

Git pull all projects in a folder.

go run scripts/batch-git-pull/main.go

Transfer apple note table to markdown table.

go run scripts/transfer-notes-to-md-table/main.go

Convert Markdown text to TypeDoc comments.

go run scripts/convert-markdown-to-comments/main.go

More in folder scripts.

API Examples

Domain is https://feperf.com.

Save Data

Description:

Save the data for searching.

Path: /api/gee/create-alias2data

Method: POST

Params:

Params	Type	Description	Required
alias	string	Alias	Yes
data	string	Data	Yes
public	bool	Public	Yes

Example:

curl --location --request POST 'https://feperf.com/api/gee/create-alias2data' \
--header 'Content-Type: application/json' \
--data-raw '{
    "alias": "alias example",
    "data": "data example",
    "public": true
}'

Returns:

Params	Type	Description	Required
id	int	ID	Yes
alias	string	Alias	Yes
data	string	Data	Yes

Example:

Success:

{
    "id": 2,
    "created_at": "2023-01-07T11:14:24.572495702+08:00",
    "updated_at": "2023-01-07T11:14:24.57882362+08:00",
    "alias": "alias example",
    "data": "data example"
}

Failure:

{
    "code": 400,
    "message": "data exist"
}

Build

Default:

go build cmd/api/main.go

Linux

It's usually useful to run the command chmod u+x script-name-linux-amd64 if the permission error happens.

GOOS=linux GOARCH=amd64 go build -o dist/api-linux-amd64 cmd/api/main.go

Mac

GOOS=darwin GOARCH=amd64 go build -o dist/api-mac-darwin-amd64 cmd/api/main.go

Windows

GOOS=windows GOARCH=amd64 go build -o dist/api-windows-amd64 cmd/api/main.go

Deploy

Supervisor

[program:api]
directory=/web/go-gin-gee
command=/web/go-gin-gee/dist/api-linux-amd64 -configpath="data/config.json"
autostart=true
autorestart=true
stderr_logfile=/web/go-gin-gee/log/api.err
stdout_logfile=/web/go-gin-gee/log/api.log

Docker

Build

# Command
bash ./scripts/docker-build.sh "{RUN_FLAG}" "WECOM_ROBOT_CHECK={WECOM_ROBOT_CHECK}"

# Example
bash ./scripts/docker-build.sh "ONLY_BUILD" "WECOM_ROBOT_CHECK=b2d57746-7146-44f2-8207-86cb0ca832be"

Run

# Command
bash ./scripts/docker-run.sh "{DOCKER_HUB_REPOSITORY_TAGNAME}" "WECOM_ROBOT_CHECK={WECOM_ROBOT_CHECK}"

# Example
bash ./scripts/docker-run.sh "mazeyqian/go-gin-gee:v20230122155129-api" "WECOM_ROBOT_CHECK=b2d57746-7146-44f2-8207-86cb0ca832be"

Contributing

# All Dependences
go mod download

# Add
go get github.com/example/name

If i/o timeout, run the command to replace the proxy:

go env -w GOPROXY=https://goproxy.cn

It's necessary to run the command go run scripts/init/main.go when serving the project first.

# Serve
go run cmd/api/main.go

# Restart
# cd /web/go-gin-gee
go run scripts/restart/main.go

Visit: http://127.0.0.1:3000/api/ping.

pong/v1.0.0/2022-09-29 04:52:43

References

1. Gin Web Framework
2. lo
3. project-layout
4. script
5. go-shadowsocks2