biucingcli 0.9.1__py3-none-any.whl

biucingcli/template_data/web-service/template/cmd/server/main.go

@@ -0,0 +1,50 @@
+package main
+
+import (
+	"context"
+	"log"
+	"net"
+	"os"
+	"os/signal"
+	"syscall"
+	"time"
+
+	"{{MODULE_NAME}}/internal/config"
+	"{{MODULE_NAME}}/internal/router"
+	serverruntime "{{MODULE_NAME}}/internal/runtime"
+)
+
+func main() {
+	if len(os.Args) == 3 && os.Args[1] == "healthcheck" {
+		ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
+		defer cancel()
+		if err := serverruntime.CheckHealth(ctx, os.Args[2]); err != nil {
+			log.Fatal(err)
+		}
+		return
+	}
+
+	cfg, err := config.Load()
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	listener, err := net.Listen("tcp", ":"+cfg.Service.Port)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
+	defer stop()
+
+	server := serverruntime.NewHTTPServer(cfg, router.New(cfg))
+	log.Printf("starting %s on :%s", cfg.Service.Name, cfg.Service.Port)
+	if err := serverruntime.Serve(
+		ctx,
+		server,
+		listener,
+		time.Duration(cfg.Server.ShutdownTimeoutSeconds)*time.Second,
+	); err != nil {
+		log.Fatal(err)
+	}
+}

biucingcli/template_data/web-service/template/compose.dev.yaml

@@ -0,0 +1,28 @@
+services:
+  app-dev:
+    build:
+      context: .
+      dockerfile: Dockerfile.dev
+      args:
+        GOPROXY: ${GOPROXY:-https://proxy.golang.org,direct}
+        GOSUMDB: ${GOSUMDB:-sum.golang.org}
+    working_dir: /workspace
+    command: air -c .air.toml
+    environment:
+      CONFIG_FILE: /workspace/configs/config.yaml
+      GOCACHE: /workspace/.cache/go-build
+      GOMODCACHE: /workspace/.cache/go-mod
+      GOLANGCI_LINT_CACHE: /workspace/.cache/golangci-lint
+    ports:
+      - "${HOST_PORT:-{{HTTP_PORT}}}:{{HTTP_PORT}}"
+    stop_grace_period: 15s
+    volumes:
+      - .:/workspace
+      - web-service-go-build:/workspace/.cache/go-build
+      - web-service-go-mod:/workspace/.cache/go-mod
+      - web-service-golangci-lint:/workspace/.cache/golangci-lint
+
+volumes:
+  web-service-go-build:
+  web-service-go-mod:
+  web-service-golangci-lint:

biucingcli/template_data/web-service/template/compose.yaml

@@ -0,0 +1,14 @@
+services:
+  {{SERVICE_NAME}}:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      args:
+        BUILDER_IMAGE: ${BUILDER_IMAGE:-golang:1.26-alpine}
+        RUNTIME_IMAGE: ${RUNTIME_IMAGE:-alpine:3.20}
+    image: ${IMAGE:-{{SERVICE_NAME}}}:${TAG:-latest}
+    ports:
+      - "${HOST_PORT:-{{HTTP_PORT}}}:{{HTTP_PORT}}"
+    environment:
+      CONFIG_FILE: /app/configs/config.yaml
+    stop_grace_period: 15s

biucingcli/template_data/web-service/template/configs/config.yaml

@@ -0,0 +1,10 @@
+service:
+  name: {{SERVICE_NAME}}
+  port: {{HTTP_PORT}}
+
+server:
+  read_timeout_seconds: 5
+  read_header_timeout_seconds: 5
+  write_timeout_seconds: 15
+  idle_timeout_seconds: 60
+  shutdown_timeout_seconds: 10

biucingcli/template_data/web-service/template/go.mod

@@ -0,0 +1,36 @@
+module {{MODULE_NAME}}
+
+go 1.26.0
+
+require (
+	github.com/gin-gonic/gin v1.10.0
+	gopkg.in/yaml.v3 v3.0.1
+)
+
+require (
+	github.com/bytedance/sonic v1.11.6 // indirect
+	github.com/bytedance/sonic/loader v0.1.1 // indirect
+	github.com/cloudwego/base64x v0.1.4 // indirect
+	github.com/cloudwego/iasm v0.2.0 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.3 // indirect
+	github.com/gin-contrib/sse v0.1.0 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-playground/validator/v10 v10.20.0 // indirect
+	github.com/goccy/go-json v0.10.2 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.7 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/pelletier/go-toml/v2 v2.2.2 // indirect
+	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
+	github.com/ugorji/go/codec v1.2.12 // indirect
+	golang.org/x/arch v0.8.0 // indirect
+	golang.org/x/crypto v0.23.0 // indirect
+	golang.org/x/net v0.25.0 // indirect
+	golang.org/x/sys v0.20.0 // indirect
+	golang.org/x/text v0.15.0 // indirect
+	google.golang.org/protobuf v1.34.1 // indirect
+)

biucingcli/template_data/web-service/template/go.sum

@@ -0,0 +1,89 @@
+github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0=
+github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4=
+github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM=
+github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
+github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y=
+github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
+github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg=
+github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0=
+github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcPfT7nKyLpA0lbSSk=
+github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
+github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
+github.com/gin-gonic/gin v1.10.0 h1:nTuyha1TYqgedzytsKYqna+DfLos46nTv2ygFy86HFU=
+github.com/gin-gonic/gin v1.10.0/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
+github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
+github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
+github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
+github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
+github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
+github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
+github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBExVwjEviJTixqxL8=
+github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM=
+github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
+github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
+github.com/google/go-cmp v0.5.5 h1:Khx7svrCpmxxtHBq5j2mp/xVjsi8hQMfNLvJFAlrGgU=
+github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
+github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
+github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM=
+github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
+github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
+github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
+github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
+github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM=
+github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
+github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
+github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
+github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
+github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
+github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE=
+github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
+golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
+golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc=
+golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
+golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI=
+golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8=
+golang.org/x/net v0.25.0 h1:d/OCCoBEUq33pjydKrGQhw7IlUPI2Oylr+8qLx49kac=
+golang.org/x/net v0.25.0/go.mod h1:JkAGAh7GEvH74S6FOH42FLoXpXbE/aqXSrIQjXgsiwM=
+golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.20.0 h1:Od9JTbYCk261bKm4M/mw7AklTlFYIa0bIp9BgSm1S8Y=
+golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/text v0.15.0 h1:h1V/4gjBv8v9cjcR6+AR5+/cIYK5N/WAgiv4xlsEtAk=
+golang.org/x/text v0.15.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+google.golang.org/protobuf v1.34.1 h1:9ddQBjfCyZPOHPUiPxpYESBLc+T8P3E+Vo4IbKZgFWg=
+google.golang.org/protobuf v1.34.1/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
+rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=

biucingcli/template_data/web-service/template/internal/config/config.go

@@ -0,0 +1,84 @@
+package config
+
+import (
+	"errors"
+	"os"
+
+	"gopkg.in/yaml.v3"
+)
+
+const defaultConfigFile = "configs/config.yaml"
+
+type Config struct {
+	Service ServiceConfig `yaml:"service"`
+	Server  ServerConfig  `yaml:"server"`
+}
+
+type ServiceConfig struct {
+	Name string `yaml:"name"`
+	Port string `yaml:"port"`
+}
+
+type ServerConfig struct {
+	ReadTimeoutSeconds       int `yaml:"read_timeout_seconds"`
+	ReadHeaderTimeoutSeconds int `yaml:"read_header_timeout_seconds"`
+	WriteTimeoutSeconds      int `yaml:"write_timeout_seconds"`
+	IdleTimeoutSeconds       int `yaml:"idle_timeout_seconds"`
+	ShutdownTimeoutSeconds   int `yaml:"shutdown_timeout_seconds"`
+}
+
+func Load() (Config, error) {
+	configFile := os.Getenv("CONFIG_FILE")
+	if configFile == "" {
+		configFile = defaultConfigFile
+	}
+
+	data, err := os.ReadFile(configFile)
+	if err != nil {
+		return Config{}, err
+	}
+
+	var cfg Config
+	if err := yaml.Unmarshal(data, &cfg); err != nil {
+		return Config{}, err
+	}
+
+	if cfg.Service.Name == "" {
+		return Config{}, errors.New("service.name is required")
+	}
+
+	if cfg.Service.Port == "" {
+		cfg.Service.Port = "{{HTTP_PORT}}"
+	}
+
+	if err := cfg.Server.applyDefaults(); err != nil {
+		return Config{}, err
+	}
+
+	return cfg, nil
+}
+
+func (cfg *ServerConfig) applyDefaults() error {
+	values := []struct {
+		name         string
+		value        *int
+		defaultValue int
+	}{
+		{"server.read_timeout_seconds", &cfg.ReadTimeoutSeconds, 5},
+		{"server.read_header_timeout_seconds", &cfg.ReadHeaderTimeoutSeconds, 5},
+		{"server.write_timeout_seconds", &cfg.WriteTimeoutSeconds, 15},
+		{"server.idle_timeout_seconds", &cfg.IdleTimeoutSeconds, 60},
+		{"server.shutdown_timeout_seconds", &cfg.ShutdownTimeoutSeconds, 10},
+	}
+
+	for _, item := range values {
+		if *item.value < 0 {
+			return errors.New(item.name + " must be greater than zero")
+		}
+		if *item.value == 0 {
+			*item.value = item.defaultValue
+		}
+	}
+
+	return nil
+}

biucingcli/template_data/web-service/template/internal/config/config_test.go

@@ -0,0 +1,88 @@
+package config
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+)
+
+func TestLoadDefaultConfig(t *testing.T) {
+	tempDir := t.TempDir()
+	configDir := filepath.Join(tempDir, "configs")
+	if err := os.MkdirAll(configDir, 0o755); err != nil {
+		t.Fatal(err)
+	}
+
+	configFile := filepath.Join(configDir, "config.yaml")
+	configData := []byte("service:\n  name: test-service\n  port: 8080\n")
+	if err := os.WriteFile(configFile, configData, 0o644); err != nil {
+		t.Fatal(err)
+	}
+
+	currentDir, err := os.Getwd()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	if err := os.Chdir(tempDir); err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() {
+		if chdirErr := os.Chdir(currentDir); chdirErr != nil {
+			t.Fatalf("restore working directory: %v", chdirErr)
+		}
+	})
+
+	cfg, err := Load()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	if cfg.Service.Name != "test-service" {
+		t.Fatalf("expected service name %q, got %q", "test-service", cfg.Service.Name)
+	}
+
+	if cfg.Service.Port != "8080" {
+		t.Fatalf("expected service port %q, got %q", "8080", cfg.Service.Port)
+	}
+	if cfg.Server.ShutdownTimeoutSeconds != 10 {
+		t.Fatalf("expected default shutdown timeout %d, got %d", 10, cfg.Server.ShutdownTimeoutSeconds)
+	}
+}
+
+func TestLoadRejectsNegativeTimeout(t *testing.T) {
+	configFile := filepath.Join(t.TempDir(), "invalid.yaml")
+	configData := []byte("service:\n  name: invalid-service\nserver:\n  shutdown_timeout_seconds: -1\n")
+	if err := os.WriteFile(configFile, configData, 0o644); err != nil {
+		t.Fatal(err)
+	}
+	t.Setenv("CONFIG_FILE", configFile)
+
+	if _, err := Load(); err == nil {
+		t.Fatal("expected a negative timeout to fail validation")
+	}
+}
+
+func TestLoadUsesConfigFileOverride(t *testing.T) {
+	tempDir := t.TempDir()
+	configFile := filepath.Join(tempDir, "override.yaml")
+	configData := []byte("service:\n  name: override-service\n  port: 9090\n")
+	if err := os.WriteFile(configFile, configData, 0o644); err != nil {
+		t.Fatal(err)
+	}
+
+	t.Setenv("CONFIG_FILE", configFile)
+
+	cfg, err := Load()
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	if cfg.Service.Name != "override-service" {
+		t.Fatalf("expected service name %q, got %q", "override-service", cfg.Service.Name)
+	}
+
+	if cfg.Service.Port != "9090" {
+		t.Fatalf("expected service port %q, got %q", "9090", cfg.Service.Port)
+	}
+}

biucingcli/template_data/web-service/template/internal/handler/health.go

@@ -0,0 +1,25 @@
+package handler
+
+import (
+	"net/http"
+
+	"{{MODULE_NAME}}/internal/service"
+
+	"github.com/gin-gonic/gin"
+)
+
+type HealthHandler struct {
+	service service.HealthService
+}
+
+func NewHealthHandler(service service.HealthService) HealthHandler {
+	return HealthHandler{service: service}
+}
+
+func (handler HealthHandler) RegisterRoutes(engine *gin.Engine) {
+	engine.GET("/healthz", handler.GetHealth)
+}
+
+func (handler HealthHandler) GetHealth(ctx *gin.Context) {
+	ctx.JSON(http.StatusOK, handler.service.Status())
+}

biucingcli/template_data/web-service/template/internal/handler/ping.go

@@ -0,0 +1,25 @@
+package handler
+
+import (
+	"net/http"
+
+	"{{MODULE_NAME}}/internal/service"
+
+	"github.com/gin-gonic/gin"
+)
+
+type PingHandler struct {
+	service service.PingService
+}
+
+func NewPingHandler(service service.PingService) PingHandler {
+	return PingHandler{service: service}
+}
+
+func (handler PingHandler) RegisterRoutes(group *gin.RouterGroup) {
+	group.GET("/ping", handler.Ping)
+}
+
+func (handler PingHandler) Ping(ctx *gin.Context) {
+	ctx.JSON(http.StatusOK, handler.service.Ping())
+}

biucingcli/template_data/web-service/template/internal/handler/user.go

@@ -0,0 +1,40 @@
+package handler
+
+import (
+	"net/http"
+
+	"{{MODULE_NAME}}/internal/service"
+
+	"github.com/gin-gonic/gin"
+)
+
+type UserHandler struct {
+	service service.UserService
+}
+
+func NewUserHandler(service service.UserService) UserHandler {
+	return UserHandler{service: service}
+}
+
+func (handler UserHandler) RegisterRoutes(group *gin.RouterGroup) {
+	group.GET("/users", handler.ListUsers)
+	group.GET("/users/:id", handler.GetUser)
+}
+
+func (handler UserHandler) ListUsers(ctx *gin.Context) {
+	ctx.JSON(http.StatusOK, gin.H{
+		"items": handler.service.ListUsers(),
+	})
+}
+
+func (handler UserHandler) GetUser(ctx *gin.Context) {
+	user, found := handler.service.GetUser(ctx.Param("id"))
+	if !found {
+		ctx.JSON(http.StatusNotFound, gin.H{
+			"error": "user not found",
+		})
+		return
+	}
+
+	ctx.JSON(http.StatusOK, user)
+}

biucingcli/template_data/web-service/template/internal/model/health.go

@@ -0,0 +1,6 @@
+package model
+
+type HealthResponse struct {
+	Service string `json:"service"`
+	Status  string `json:"status"`
+}

biucingcli/template_data/web-service/template/internal/model/ping.go

@@ -0,0 +1,7 @@
+package model
+
+type PingResponse struct {
+	Service string `json:"service"`
+	Message string `json:"message"`
+	Version string `json:"version"`
+}

biucingcli/template_data/web-service/template/internal/model/user.go

@@ -0,0 +1,7 @@
+package model
+
+type User struct {
+	ID    string `json:"id"`
+	Name  string `json:"name"`
+	Email string `json:"email"`
+}

biucingcli/template_data/web-service/template/internal/repository/.gitkeep

@@ -0,0 +1 @@
+

biucingcli/template_data/web-service/template/internal/repository/user.go

@@ -0,0 +1,37 @@
+package repository
+
+import "{{MODULE_NAME}}/internal/model"
+
+type UserRepository interface {
+	List() []model.User
+	GetByID(id string) (model.User, bool)
+}
+
+type inMemoryUserRepository struct {
+	users []model.User
+}
+
+func NewUserRepository() UserRepository {
+	return inMemoryUserRepository{
+		users: []model.User{
+			{ID: "u_001", Name: "Ada Lovelace", Email: "ada@example.com"},
+			{ID: "u_002", Name: "Alan Turing", Email: "alan@example.com"},
+		},
+	}
+}
+
+func (repository inMemoryUserRepository) List() []model.User {
+	users := make([]model.User, len(repository.users))
+	copy(users, repository.users)
+	return users
+}
+
+func (repository inMemoryUserRepository) GetByID(id string) (model.User, bool) {
+	for _, user := range repository.users {
+		if user.ID == id {
+			return user, true
+		}
+	}
+
+	return model.User{}, false
+}

biucingcli/template_data/web-service/template/internal/router/router.go

@@ -0,0 +1,28 @@
+package router
+
+import "{{MODULE_NAME}}/internal/config"
+import "{{MODULE_NAME}}/internal/handler"
+import "{{MODULE_NAME}}/internal/repository"
+import "{{MODULE_NAME}}/internal/service"
+
+import "github.com/gin-gonic/gin"
+
+func New(cfg config.Config) *gin.Engine {
+	engine := gin.Default()
+
+	healthService := service.NewHealthService(cfg.Service.Name)
+	healthHandler := handler.NewHealthHandler(healthService)
+	healthHandler.RegisterRoutes(engine)
+
+	apiGroup := engine.Group("/api/v1")
+	pingService := service.NewPingService(cfg.Service.Name)
+	pingHandler := handler.NewPingHandler(pingService)
+	pingHandler.RegisterRoutes(apiGroup)
+
+	userRepository := repository.NewUserRepository()
+	userService := service.NewUserService(userRepository)
+	userHandler := handler.NewUserHandler(userService)
+	userHandler.RegisterRoutes(apiGroup)
+
+	return engine
+}

biucingcli/template_data/web-service/template/internal/runtime/server.go

@@ -0,0 +1,76 @@
+package runtime
+
+import (
+	"context"
+	"errors"
+	"net"
+	"net/http"
+	"time"
+
+	"{{MODULE_NAME}}/internal/config"
+)
+
+func NewHTTPServer(cfg config.Config, handler http.Handler) *http.Server {
+	return &http.Server{
+		Addr:              ":" + cfg.Service.Port,
+		Handler:           handler,
+		ReadTimeout:       time.Duration(cfg.Server.ReadTimeoutSeconds) * time.Second,
+		ReadHeaderTimeout: time.Duration(cfg.Server.ReadHeaderTimeoutSeconds) * time.Second,
+		WriteTimeout:      time.Duration(cfg.Server.WriteTimeoutSeconds) * time.Second,
+		IdleTimeout:       time.Duration(cfg.Server.IdleTimeoutSeconds) * time.Second,
+	}
+}
+
+func CheckHealth(ctx context.Context, url string) error {
+	request, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
+	if err != nil {
+		return err
+	}
+	response, err := http.DefaultClient.Do(request)
+	if err != nil {
+		return err
+	}
+	defer response.Body.Close()
+	if response.StatusCode != http.StatusOK {
+		return errors.New("health endpoint returned " + response.Status)
+	}
+	return nil
+}
+
+func Serve(
+	ctx context.Context,
+	server *http.Server,
+	listener net.Listener,
+	shutdownTimeout time.Duration,
+) error {
+	serveErr := make(chan error, 1)
+	go func() {
+		serveErr <- server.Serve(listener)
+	}()
+
+	select {
+	case err := <-serveErr:
+		if errors.Is(err, http.ErrServerClosed) {
+			return nil
+		}
+		return err
+	case <-ctx.Done():
+	}
+
+	shutdownCtx, cancel := context.WithTimeout(context.Background(), shutdownTimeout)
+	defer cancel()
+
+	if err := server.Shutdown(shutdownCtx); err != nil {
+		closeErr := server.Close()
+		if closeErr != nil && !errors.Is(closeErr, http.ErrServerClosed) {
+			return errors.Join(err, closeErr)
+		}
+		return err
+	}
+
+	err := <-serveErr
+	if errors.Is(err, http.ErrServerClosed) {
+		return nil
+	}
+	return err
+}