refactor: add lazy init example

.github/workflows/go.yml

@@ -13,11 +13,7 @@ jobs:
       fail-fast: false
       matrix:
         version: ["1.23.x", "1.22.x"]
-    services:
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
+
     steps:
       - name: Check out repository
         uses: actions/checkout@v4

example_test.go

@@ -20,7 +20,9 @@ func Example_helloWorld() {
 		return nil
 	})
 	// Output:
+	// helloWorld init
 	// Hello, World!
+	// helloWorld shutdown
 }
 
 func Example_callComponent() {
@@ -29,7 +31,9 @@ func Example_callComponent() {
 		return nil
 	})
 	// Output:
+	// helloWorld init
 	// Hello, World!
+	// helloWorld shutdown
 }
 
 func Example_mockComponent() {
@@ -52,8 +56,10 @@ func Example_config() {
 		return nil
 	}, kod.WithConfigFile("./examples/helloworld/config.toml"))
 	// Output:
+	// helloWorld init
 	// globalConfig
 	// Hello, World!config
+	// helloWorld shutdown
 }
 
 func Example_log() {
@@ -73,6 +79,8 @@ func Example_log() {
 	}
 
 	// Output:
+	// helloWorld init
+	// helloWorld shutdown
 	// 3
 	// INFO Hello, World!
 	// WARN Hello, World!
@@ -92,9 +100,11 @@ func Example_interceptor() {
 		return nil
 	}, kod.WithInterceptors(interceptor))
 	// Output:
+	// helloWorld init
 	// Before call
 	// Hello, World!
 	// After call
+	// helloWorld shutdown
 }
 
 func Example_builtinInterceptor() {
@@ -103,15 +113,19 @@ func Example_builtinInterceptor() {
 		return nil
 	}, kod.WithInterceptors(krecovery.Interceptor(), ktrace.Interceptor(), kmetric.Interceptor()))
 	// Output:
+	// helloWorld init
 	// Hello, World!
+	// helloWorld shutdown
 }
 
 func Example_test() {
 	kod.RunTest(&testing.T{}, func(ctx context.Context, t *helloworld.App) {
 		t.HelloWorld.Get().SayHello(ctx)
 	})
 	// Output:
+	// helloWorld init
 	// Hello, World!
+	// helloWorld shutdown
 }
 
 func Example_testWithMockComponent() {
@@ -125,3 +139,18 @@ func Example_testWithMockComponent() {
 	// Output:
 	// Nothing printed from mock
 }
+
+func Example_lazyInit() {
+	kod.Run(context.Background(), func(ctx context.Context, t *helloworld.App) error {
+		t.HelloBob.Get().SayHello(ctx)
+		t.HelloWorld.Get().SayHello(ctx)
+		return nil
+	})
+	// Output:
+	// helloWorld init
+	// lazyHelloBob init
+	// Hello, Bob!
+	// Hello, World!
+	// lazyHelloBob shutdown
+	// helloWorld shutdown
+}

examples/helloworld/helloworld.go

@@ -12,13 +12,43 @@ type App struct {
 	kod.WithGlobalConfig[Config]
 
 	HelloWorld kod.Ref[HelloWorld]
+	HelloBob   kod.Ref[HelloBob]
 }
 
 type helloWorld struct {
 	kod.Implements[HelloWorld]
 	kod.WithConfig[Config]
 }
 
+func (h *helloWorld) Init(ctx context.Context) error {
+	fmt.Println("helloWorld init")
+	return nil
+}
+
 func (h *helloWorld) SayHello(ctx context.Context) {
 	fmt.Println("Hello, World!" + h.Config().Name)
 }
+
+func (h *helloWorld) Shutdown(ctx context.Context) error {
+	fmt.Println("helloWorld shutdown")
+	return nil
+}
+
+type lazyHelloBob struct {
+	kod.Implements[HelloBob]
+	kod.LazyInit
+}
+
+func (h *lazyHelloBob) Init(ctx context.Context) error {
+	fmt.Println("lazyHelloBob init")
+	return nil
+}
+
+func (h *lazyHelloBob) SayHello(ctx context.Context) {
+	fmt.Println("Hello, Bob!")
+}
+
+func (h *lazyHelloBob) Shutdown(ctx context.Context) error {
+	fmt.Println("lazyHelloBob shutdown")
+	return nil
+}