Merge remote-tracking branch 'upstream/v3' into v3

.github/workflows/job_coverage.yml

@@ -3,14 +3,16 @@ name: coverage
 on:
   push:
     branches: [ main, v3, v4 ]
+    paths-ignore:
+      - '.github/**'
+      - '.gitea/**'
   pull_request:
     branches: [ main, v3, v4 ]
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
 
 jobs:
 
   build:
+    if: github.server_url != 'https://github.com'
     runs-on: ubuntu-latest
     steps:
     - name: checkout code
@@ -22,7 +24,7 @@ jobs:
       uses: actions/setup-go@v5
       with:
         cache-dependency-path: "**/*.sum"
-        go-version: 'stable' 
+        go-version: 'stable'
 
     - name: test coverage
       run: |

.github/workflows/job_lint.yml

@@ -3,27 +3,27 @@ name: lint
 on:
   pull_request:
     types: [opened, reopened, synchronize]
-    branches:
+    branches: [ master, v3, v4 ]
-      - master
+    paths-ignore:
-      - v3
+      - '.github/**'
-      - v4
+      - '.gitea/**'
 
 jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - name: checkout code
+    - name: checkout code
-        uses: actions/checkout@v4
+      uses: actions/checkout@v4
-        with:
+      with:
-          filter: 'blob:none'
+        filter: 'blob:none'
-      - name: setup go
+    - name: setup go
-        uses: actions/setup-go@v5
+      uses: actions/setup-go@v5
-        with:
+      with:
-          cache-dependency-path: "**/*.sum"
+        cache-dependency-path: "**/*.sum"
-          go-version: 'stable'
+        go-version: 'stable'
-      - name: setup deps
+    - name: setup deps
-        run: go get -v ./...
+      run: go get -v ./...
-      - name: run lint
+    - name: run lint
-        uses: golangci/golangci-lint-action@v6
+      uses: golangci/golangci-lint-action@v6
-        with:
+      with:
-          version: 'latest'
+        version: 'latest'

.github/workflows/job_test.yml

@@ -3,15 +3,12 @@ name: test
 on:
   pull_request:
     types: [opened, reopened, synchronize]
-    branches:
+    branches: [ master, v3, v4 ]
-    - master
-    - v3
-    - v4
   push:
-    branches:
+    branches: [ master, v3, v4 ]
-    - master
+    paths-ignore:
-    - v3
+      - '.github/**'
-    - v4
+      - '.gitea/**'
 
 jobs:
   test:

.github/workflows/job_tests.yml

@@ -3,51 +3,48 @@ name: test
 on:
   pull_request:
     types: [opened, reopened, synchronize]
-    branches:
+    branches: [ master, v3, v4 ]
-      - master
-      - v3
-      - v4
   push:
-    branches:
+    branches: [ master, v3, v4 ]
-      - master
+    paths-ignore:
-      - v3
+      - '.github/**'
-      - v4
+      - '.gitea/**'
 
 jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - name: checkout code
+    - name: checkout code
-        uses: actions/checkout@v4
+      uses: actions/checkout@v4
-        with:
+      with:
-          filter: 'blob:none'
+        filter: 'blob:none'
-      - name: checkout tests
+    - name: checkout tests
-        uses: actions/checkout@v4
+      uses: actions/checkout@v4
-        with:
+      with:
-          ref: master
+        ref: master
-          filter: 'blob:none'
+        filter: 'blob:none'
-          repository: unistack-org/micro-tests
+        repository: unistack-org/micro-tests
-          path: micro-tests
+        path: micro-tests
-      - name: setup go
+    - name: setup go
-        uses: actions/setup-go@v5
+      uses: actions/setup-go@v5
-        with:
+      with:
-          cache-dependency-path: "**/*.sum"
+        cache-dependency-path: "**/*.sum"
-          go-version: 'stable'
+        go-version: 'stable'
-      - name: setup go work
+    - name: setup go work
-        env:
+      env:
-          GOWORK: ${{ github.workspace }}/go.work
+        GOWORK: ${{ github.workspace }}/go.work
-        run: |
+      run: |
-          go work init
+        go work init
-          go work use .
+        go work use .
-          go work use micro-tests
+        go work use micro-tests
-      - name: setup deps
+    - name: setup deps
-        env:
+      env:
-          GOWORK: ${{ github.workspace }}/go.work
+        GOWORK: ${{ github.workspace }}/go.work
-        run: go get -v ./...
+      run: go get -v ./...
-      - name: run tests
+    - name: run tests
-        env:
+      env:
-          INTEGRATION_TESTS: yes
+        INTEGRATION_TESTS: yes
-          GOWORK: ${{ github.workspace }}/go.work
+        GOWORK: ${{ github.workspace }}/go.work
-        run: |
+      run: |
-          cd micro-tests
+        cd micro-tests
-          go test -mod readonly -v ./... || true
+        go test -mod readonly -v ./... || true

tracer/memory/memory.go

@@ -46,6 +46,10 @@ func (s memoryStringer) String() string {
 	return s.s
 }
 
+func (t *Tracer) Enabled() bool {
+	return t.opts.Enabled
+}
+
 func (t *Tracer) Flush(_ context.Context) error {
 	return nil
 }

tracer/noop.go

@@ -18,6 +18,10 @@ func (t *noopTracer) Spans() []Span {
 	return t.spans
 }
 
+func (t *noopTracer) Enabled() bool {
+	return t.opts.Enabled
+}
+
 func (t *noopTracer) Start(ctx context.Context, name string, opts ...SpanOption) (context.Context, Span) {
 	options := NewSpanOptions(opts...)
 	span := &noopSpan{

tracer/options.go

@@ -142,6 +142,8 @@ type Options struct {
 	Name string
 	// ContextAttrFuncs contains funcs that provides tracing
 	ContextAttrFuncs []ContextAttrFunc
+	// Enabled specify trace status
+	Enabled bool
 }
 
 // Option func signature
@@ -181,6 +183,7 @@ func NewOptions(opts ...Option) Options {
 		Logger:           logger.DefaultLogger,
 		Context:          context.Background(),
 		ContextAttrFuncs: DefaultContextAttrFuncs,
+		Enabled:          true,
 	}
 	for _, o := range opts {
 		o(&options)
@@ -194,3 +197,10 @@ func Name(n string) Option {
 		o.Name = n
 	}
 }
+
+// Disabled disable tracer
+func Disabled(b bool) Option {
+	return func(o *Options) {
+		o.Enabled = !b
+	}
+}

tracer/tracer.go

@@ -51,6 +51,8 @@ type Tracer interface {
 	// Extract(ctx context.Context)
 	// Flush flushes spans
 	Flush(ctx context.Context) error
+	// Enabled returns tracer status
+	Enabled() bool
 }
 
 type Span interface {

util/buffer/seeker_buffer.go

@@ -67,6 +67,12 @@ func (b *SeekerBuffer) Close() error {
 	return nil
 }
 
+// Reset clears all the data out of the buffer and sets the read position to 0.
+func (b *SeekerBuffer) Reset() {
+	b.data = nil
+	b.pos = 0
+}
+
 // Len returns the length of data remaining to be read.
 func (b *SeekerBuffer) Len() int {
 	return len(b.data[b.pos:])