add: use example of this lib

example/client/kitex_client.json

@@ -0,0 +1,46 @@
+{
+    "ClientName/ServiceName": {
+        "timeout": {
+            "*": {
+                "conn_timeout_ms": 100,
+                "rpc_timeout_ms": 2000
+            }
+        },
+        "circuitbreaker": {
+            "Echo": {
+                "enable": true,
+                "err_rate": 0.3,
+                "min_sample": 100
+            }
+        },
+        "retry": {
+            "*": {
+                "enable": true,
+                "type": 0,
+                "failure_policy": {
+                    "stop_policy": {
+                        "max_retry_times": 3,
+                        "max_duration_ms": 2000,
+                        "cb_policy": {
+                            "error_rate": 0.2
+                        }
+                    }
+                }
+            },
+            "Echo": {
+                "enable": true,
+                "type": 1,
+                "backup_policy": {
+                    "retry_delay_ms": 200,
+                    "stop_policy": {
+                        "max_retry_times": 2,
+                        "max_duration_ms": 1000,
+                        "cb_policy": {
+                            "error_rate": 0.3
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

example/client/main.go

@@ -0,0 +1,79 @@
+// Copyright 2023 CloudWeGo Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package main
+
+import (
+	"context"
+	"log"
+	"os"
+	"os/signal"
+	"time"
+
+	"github.com/cloudwego/kitex-examples/kitex_gen/api"
+	"github.com/cloudwego/kitex-examples/kitex_gen/api/echo"
+	kitexclient "github.com/cloudwego/kitex/client"
+	"github.com/cloudwego/kitex/pkg/klog"
+	fileclient "github.com/kitex-contrib/config-file/client"
+	"github.com/kitex-contrib/config-file/filewatcher"
+)
+
+const (
+	filepath    = "kitex_client.json"
+	key         = "ClientName/ServiceName"
+	serviceName = "ServiceName"
+	clientName  = "echo"
+)
+
+func main() {
+	klog.SetLevel(klog.LevelDebug)
+
+	// create a file watcher object
+	fw, err := filewatcher.NewFileWatcher(filepath)
+	if err != nil {
+		panic(err)
+	}
+	// start watching file changes
+	if err = fw.StartWatching(); err != nil {
+		panic(err)
+	}
+
+	go func() {
+		sig := make(chan os.Signal, 1)
+		signal.Notify(sig, os.Interrupt, os.Kill)
+		<-sig
+		fw.StopWatching()
+		os.Exit(1)
+	}()
+
+	client, err := echo.NewClient(
+		serviceName,
+		kitexclient.WithHostPorts("0.0.0.0:8888"),
+		kitexclient.WithSuite(fileclient.NewSuite(serviceName, key, fw)),
+	)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	for {
+		req := &api.Request{Message: "my request"}
+		resp, err := client.Echo(context.Background(), req)
+		if err != nil {
+			klog.Errorf("take request error: %v", err)
+		} else {
+			klog.Infof("receive response %v", resp)
+		}
+		time.Sleep(time.Second * 10)
+	}
+}

example/go.mod

@@ -0,0 +1,55 @@
+module github.com/kitex-contrib/examples/config/file
+
+go 1.19
+
+require (
+	github.com/cloudwego/kitex v0.8.0
+	github.com/cloudwego/kitex-examples v0.2.3
+	github.com/kitex-contrib/config-file v1.0.0
+)
+
+replace github.com/kitex-contrib/config-file => ../.
+
+require (
+	github.com/apache/thrift v0.16.0 // indirect
+	github.com/bytedance/gopkg v0.0.0-20230728082804-614d0af6619b // indirect
+	github.com/bytedance/sonic v1.10.2 // indirect
+	github.com/chenzhuoyu/base64x v0.0.0-20230717121745-296ad89f973d // indirect
+	github.com/chenzhuoyu/iasm v0.9.1 // indirect
+	github.com/choleraehyq/pid v0.0.17 // indirect
+	github.com/cloudwego/configmanager v0.2.0 // indirect
+	github.com/cloudwego/dynamicgo v0.1.6 // indirect
+	github.com/cloudwego/fastpb v0.0.4 // indirect
+	github.com/cloudwego/frugal v0.1.12 // indirect
+	github.com/cloudwego/localsession v0.0.2 // indirect
+	github.com/cloudwego/netpoll v0.5.1 // indirect
+	github.com/cloudwego/thriftgo v0.3.3 // indirect
+	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
+	github.com/fatih/structtag v1.2.0 // indirect
+	github.com/fsnotify/fsnotify v1.7.0 // indirect
+	github.com/golang/protobuf v1.5.3 // indirect
+	github.com/google/pprof v0.0.0-20230509042627-b1315fad0c5a // indirect
+	github.com/iancoleman/strcase v0.2.0 // indirect
+	github.com/jhump/protoreflect v1.8.2 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.4 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/gls v0.0.0-20220109145502-612d0167dce5 // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/oleiade/lane v1.0.1 // indirect
+	github.com/pmezard/go-difflib v1.0.0 // indirect
+	github.com/stretchr/testify v1.8.4 // indirect
+	github.com/tidwall/gjson v1.14.4 // indirect
+	github.com/tidwall/match v1.1.1 // indirect
+	github.com/tidwall/pretty v1.2.0 // indirect
+	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
+	golang.org/x/arch v0.2.0 // indirect
+	golang.org/x/net v0.17.0 // indirect
+	golang.org/x/sync v0.3.0 // indirect
+	golang.org/x/sys v0.13.0 // indirect
+	golang.org/x/text v0.13.0 // indirect
+	google.golang.org/genproto v0.0.0-20231012201019-e917dd12ba7a // indirect
+	google.golang.org/protobuf v1.31.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+	sigs.k8s.io/yaml v1.4.0 // indirect
+)