story(issue-91): grpc implement a builder and run func (#92)

Author: Zaba505

README.md

@@ -2,7 +2,7 @@
 
 [![Go Reference](https://pkg.go.dev/badge/github.com/z5labs/humus.svg)](https://pkg.go.dev/github.com/z5labs/humus)
 [![Go Report Card](https://goreportcard.com/badge/github.com/z5labs/humus)](https://goreportcard.com/report/github.com/z5labs/humus)
-![Coverage](https://img.shields.io/badge/Coverage-76.3%25-brightgreen)
+![Coverage](https://img.shields.io/badge/Coverage-78.2%25-brightgreen)
 [![build](https://github.com/z5labs/humus/actions/workflows/build.yaml/badge.svg)](https://github.com/z5labs/humus/actions/workflows/build.yaml)
 
 **humus one stop shop framework for all Z5Labs projects in Go.**

example/grpc/petstore/app/app.go

@@ -0,0 +1,28 @@
+// Copyright (c) 2025 Z5Labs and Contributors
+//
+// This software is released under the MIT License.
+// https://opensource.org/licenses/MIT
+
+package app
+
+import (
+	"context"
+
+	"github.com/z5labs/humus/example/grpc/petstore/pet/registrar"
+	"github.com/z5labs/humus/example/internal/pet"
+	"github.com/z5labs/humus/grpc"
+)
+
+type Config struct {
+	grpc.Config `config:",squash"`
+}
+
+func Init(ctx context.Context, cfg Config) (*grpc.Api, error) {
+	store := pet.NewStore()
+
+	api := grpc.NewApi()
+
+	registrar.Register(api, store)
+
+	return api, nil
+}

example/grpc/petstore/config.yaml

@@ -0,0 +1,5 @@
+# Copyright (c) 2025 Z5Labs and Contributors
+# 
+# This software is released under the MIT License.
+# https://opensource.org/licenses/MIT
+

example/grpc/petstore/main.go

@@ -0,0 +1,21 @@
+// Copyright (c) 2025 Z5Labs and Contributors
+//
+// This software is released under the MIT License.
+// https://opensource.org/licenses/MIT
+
+package main
+
+import (
+	"bytes"
+	_ "embed"
+
+	"github.com/z5labs/humus/example/grpc/petstore/app"
+	"github.com/z5labs/humus/grpc"
+)
+
+//go:embed config.yaml
+var configBytes []byte
+
+func main() {
+	grpc.Run(bytes.NewReader(configBytes), app.Init)
+}

example/grpc/petstore/pet/registrar/registrar.go

@@ -0,0 +1,58 @@
+// Copyright (c) 2025 Z5Labs and Contributors
+//
+// This software is released under the MIT License.
+// https://opensource.org/licenses/MIT
+
+package registrar
+
+import (
+	"context"
+
+	"github.com/z5labs/humus/example/grpc/petstore/petpb"
+	"github.com/z5labs/humus/example/internal/pet"
+	"github.com/z5labs/humus/internal/ptr"
+
+	"google.golang.org/grpc"
+)
+
+type Store interface {
+	Register(context.Context, *pet.RegisterRequest) (*pet.RegisterResponse, error)
+}
+
+type Registrar struct {
+	petpb.UnimplementedRegistrarServer
+
+	store Store
+}
+
+func Register(sr grpc.ServiceRegistrar, store Store) {
+	r := &Registrar{
+		store: store,
+	}
+
+	petpb.RegisterRegistrarServer(sr, r)
+}
+
+func (r *Registrar) RegisterPet(ctx context.Context, req *petpb.RegisterPetRequest) (*petpb.RegisterPetResponse, error) {
+	registerResp, err := r.store.Register(ctx, &pet.RegisterRequest{
+		Age:   req.GetAge(),
+		Name:  req.GetName(),
+		Kind:  req.GetKind().String(),
+		Breed: req.GetBreed(),
+		Fur: pet.FurDesc{
+			Kind:  req.GetFur().GetKind().String(),
+			Color: req.GetFur().GetColor(),
+		},
+	})
+	if err != nil {
+		return nil, err
+	}
+
+	builder := petpb.RegisterPetResponse_builder{
+		Id: ptr.Ref(registerResp.ID),
+	}
+	if len(registerResp.TempName) > 0 {
+		builder.TempName = ptr.Ref(registerResp.TempName)
+	}
+	return builder.Build(), nil
+}