Common Library for Go

Installation

go get -u github.com/common-library/go

Features

• ai
  • gemini
• archive
  • gzip
  • tar
  • zip
• aws
  • Amazon DynamoDB
  • Amazon S3
• command line
  • arguments
  • flag
• data structure
  • Deque
  • Queue
• database
  • Elasticsearch v7/v8
  • MongoDB
  • Prometheus
  • Redis
  • SQL
    • DynamoDB
    • Microsoft SQL Server
    • MySQL
    • Oracle
    • Postgres
    • SQLite
• event
  • cloudevents
• file
• grpc
• http
• json
• kubernetes
  • resource
    • client
    • custom resource
    • custom resource definition
• lock
• log
• long polling
• security
  • crypto
    • dsa
    • ecdsa
    • ed25519
    • rsa
• socket
• storage
  • MinIO
• utility

Test and Coverage

• prepare
  • Amazon
    • DynamoDB
      • docker run --name dynamodb --detach --publish 8000:8000 --env "-jar DynamoDBLocal.jar -sharedDb -inMemory" amazon/dynamodb-local:2.4.0
    • S3
      • docker run --name s3mock --detach --publish 9090:9090 -p 9191:9191 adobe/s3mock:3.7.3
  • Elasticsearch v7
    • docker run --name elasticsearch-v7 --detach --publish 19200:9200 -p 19300:9300 --env discovery.type=single-node --env ES_JAVA_OPTS="-Xms500m -Xmx500m" elasticsearch:7.17.21
  • Elasticsearch v8
    • docker network create elastic
    • docker run --name elasticsearch-v8 --net elastic --detach --publish 29200:9200 -p 29300:9300 --env discovery.type=single-node --env ES_JAVA_OPTS="-Xms500m -Xmx500m" --env xpack.security.enabled=false elasticsearch:8.13.0
  • MongoDB
    • docker run --name mongodb --detach --publish 27017:27017 mongo:7.0.9
  • Redis
    • docker run --name redis --detach --publish 6379:6379 redis:7.2.4
  • SQL
    • Amazon DynamoDB
      • docker run --name dynamodb --detach --publish 8000:8000 --env "-jar DynamoDBLocal.jar -sharedDb -inMemory" amazon/dynamodb-local:2.4.0
    • MySQL
      • docker run --name mysql --detach --publish 3306:3306 --env MYSQL_ROOT_PASSWORD=root mysql:8.4.0
    • Postgres
      • 'docker run --name postgres --detach --publish 5432:5432 --env POSTGRES_PASSWORD=postgres postgres:16.2-alpine'
• Test
  • go clean -testcache && go test -cover ./...
• Coverage
  • make coverage file
    • go clean -testcache && go test -coverprofile=coverage.out -cover ./...
  • convert coverage file to html file
    • go tool cover -html=./coverage.out -o ./coverage.html

How to add grpc

• create protobuf IDL(Interface Definition Language) file
  • see grpc/sample/sample.proto
• convert IDL file to code
  • go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.31.0
  • go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.3.0
  • wget https://github.com/protocolbuffers/protobuf/releases/download/v3.20.3/protoc-3.20.3-linux-x86_64.zip
  • unzip protoc-3.20.3-linux-x86_64.zip -d protoc/
  • protoc/bin/protoc --go_out=. --go_opt=paths=source_relative --go-grpc_out=. --go-grpc_opt=paths=source_relative grpc/sample/sample.proto
• implement functions defined in IDL file
  • implement to satisfy implementServer interface
  • see grpc/sample/Server.go
  • see grpc/sample/Server_test.go