Add errors helper package

.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "docker"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/release-drafter.yml

@@ -0,0 +1,19 @@
+categories:
+  - title: '🚀 Features'
+    labels:
+      - 'feature'
+      - 'feat'
+      - 'enhancement'
+  - title: '🐛 Bug Fixes'
+    labels:
+      - 'fix'
+      - 'bugfix'
+      - 'bug'
+  - title: '🧰 Maintenance'
+    labels:
+      - 'chore'
+      - 'dependencies'
+template: |
+  # What’s Changed
+
+  $CHANGES

.github/workflows/mergedtomain-workflow.yaml

@@ -0,0 +1,35 @@
+name: Merged to Main
+on:
+  pull_request:
+    types: [ closed ]
+    branches: [ 'main' ]
+
+permissions:
+  contents: read
+
+jobs:
+  MergedtoMain:
+    if: github.event.pull_request.merged == true
+    name: Merged to Main
+    runs-on: ubuntu-latest
+    permissions:
+      # write permission is required to create a github release
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Extract build info
+        id: extract_build_info
+        run: |
+          echo "commit_short=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
+
+      - name: Update Release Draft
+        uses: release-drafter/release-drafter@v6
+        with:
+          disable-autolabeler: true
+          commitish: main
+          publish: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/pr-workflow.yaml

@@ -0,0 +1,43 @@
+name: PR Workflow
+on:
+  pull_request:
+    types: [ synchronize, opened, reopened]
+    branches: [ 'main' ]
+
+permissions:
+    contents: read
+
+jobs:
+  linter:
+    name: Linter
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '^1.23'
+          cache: false
+
+      - name: Check Go Formatting
+        run: |
+          files=$(gofmt -l .) && echo $files && [ -z "$files" ]
+
+      - name: Golang CI Lint
+        uses: golangci/golangci-lint-action@v6
+
+  unit-tests:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '^1.23'
+
+      - name: Unit tests
+        run: |
+          make test_unit

.github/workflows/release-workflow.yaml

@@ -0,0 +1,43 @@
+name: Release
+on:
+  push:
+    branches:
+      - 'releases/**'
+
+permissions:
+  contents: read
+
+jobs:
+  Release:
+    name: Release Workflow
+    runs-on: ubuntu-latest
+    permissions:
+      # write permission is required to create a github release
+      contents: write
+      pull-requests: write
+      id-token: write  # needed for cosign keyless signing with OIDC
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Extract build info
+        id: extract_build_info
+        run: |
+          echo "tag=${GITHUB_REF##*/}" >> $GITHUB_OUTPUT
+          echo "commit_short=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
+
+      - name: Tag Release
+        shell: bash
+        run: |
+          git tag ${{ steps.extract_build_info.outputs.tag }}
+          git push origin ${{ steps.extract_build_info.outputs.tag }}
+
+      - name: Publish Release Notes
+        uses: release-drafter/release-drafter@v6
+        with:
+          disable-autolabeler: true
+          commitish: ${{ github.ref }}
+          tag: ${{ steps.extract_build_info.outputs.tag }}
+          publish: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,7 +1,11 @@
 # If you prefer the allow list template instead of the deny list, see community template:
 # https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
 #
+# IDE files
+.idea/
+.vscode/
 # Binaries for programs and plugins
+bin/
 *.exe
 *.exe~
 *.dll

.golangci.yaml

@@ -0,0 +1,33 @@
+run:
+  timeout: 10m
+issues:
+  exclude-files:
+  - "generated.*\\.go$"
+linters:
+  enable:
+  - gci
+  - goconst
+  - gofmt
+  - goimports
+  - unparam
+  - importas
+  - bodyclose
+  - containedctx
+  - contextcheck
+  - errorlint
+  - nilerr
+  - promlinter
+  - sloglint
+  - testifylint
+  - unparam
+  - usestdlibvars
+linters-settings:
+  gci:
+    sections:
+    - standard # Standard section: captures all standard packages.
+    - default # Default section: contains all imports that could not be matched to another section type.
+    - prefix(github.com/qdrant) # Custom section: groups all imports with the specified Prefix.
+  importas:
+    alias:
+    - pkg: ^k8s\.io/apimachinery/pkg/apis/(\w+)/(v[\w\d]+)$
+      alias: $1$2

.pre-commit-config.yaml

@@ -0,0 +1,11 @@
+repos:
+  - repo: https://github.com/golangci/golangci-lint
+    rev: v1.55.2
+    hooks:
+      - id: golangci-lint-full
+  - repo: https://github.com/tekwizely/pre-commit-golang
+    rev: v1.0.0-rc.1
+    hooks:
+      - id: go-mod-tidy-repo
+      - id: go-fmt
+      - id: go-test-repo-mod

Makefile

@@ -0,0 +1,59 @@
+## Location to install dependencies to
+LOCALBIN ?= $(shell pwd)/bin
+$(LOCALBIN):
+	mkdir -p $(LOCALBIN)
+
+## Tool Binaries
+GO_IMPORTS ?= $(LOCALBIN)/goimports
+GCI ?= $(LOCALBIN)/gci
+
+# Get the currently used golang install path (in GOPATH/bin, unless GOBIN is set)
+ifeq (,$(shell go env GOBIN))
+GOBIN=$(shell go env GOPATH)/bin
+else
+GOBIN=$(shell go env GOBIN)
+endif
+
+# Setting SHELL to bash allows bash commands to be executed by recipes.
+# Options are set to exit when a recipe line exits non-zero or a piped command fails.
+SHELL = /usr/bin/env bash -o pipefail
+.SHELLFLAGS = -ec
+
+.PHONY: help
+help: ## Display this help.
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_0-9-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+##@ Development
+
+.PHONY: go_fmt
+go_fmt: ## Run go fmt against code.
+	gofmt -w -s .
+
+.PHONY: fmt_imports
+fmt_imports: $(GCI) ## Run goimports against code.
+	$(GCI) write ./ --skip-generated -s standard -s default -s 'prefix(github.com/qdrant)'
+
+.PHONY: fmt
+format: go_fmt fmt_imports ## Format the code.
+
+fmt: format ## Format the code.
+
+.PHONY: vet
+vet: ## Run go vet against code.
+	go vet ./...
+
+lint: $(GCI) ## Run linters.
+	bash -c 'files=$$(gofmt -l .) && echo $$files && [ -z "$$files" ]'
+	golangci-lint run
+
+.PHONY: test_unit
+test_unit: ## Run unit tests.
+	go test ./... -coverprofile cover.out
+
+$(GO_IMPORTS): $(LOCALBIN)
+	GOBIN=$(LOCALBIN) go install golang.org/x/tools/cmd/goimports@latest
+
+$(GCI): $(LOCALBIN)
+	GOBIN=$(LOCALBIN) go install github.com/daixiang0/gci@latest
+
+

examples/errors/main.go

@@ -0,0 +1,43 @@
+package main
+
+import (
+	"errors"
+	"fmt"
+	"log/slog"
+
+	errhelper "github.com/qdrant/go-commons/pkg/errors"
+)
+
+func main() {
+	// call some function that produces error
+	err := someCodeProducesError()
+	if err != nil {
+		// log the error with context
+		slog.Error(fmt.Sprintf("something went wrong: %s", err.Error()), errhelper.GetMetadata(err)...)
+	}
+}
+
+func someCodeProducesError() error {
+	// root wrapper that include function name as context
+	errMetadata := errhelper.Metadata{"function", "someCodeProducesError"}
+
+	// another block of code that can produce error
+	err := doSomething()
+	if err != nil {
+		// wrap the error with additional context
+		// the resulting error will include the context from root wrapper and this wrapper
+		return errhelper.WithMetadata(err, errMetadata.Extend("key1", "value1")...)
+	}
+
+	// this will only wrap error with root wrapper context
+	return errhelper.WithMetadata(errors.New("foo"), errMetadata...)
+}
+
+func doSomething() error {
+	// simulate an error
+	return errhelper.WithMetadata(
+		errors.New("bar"),
+		"function", "doSomething",
+		"key2", "value2",
+	)
+}

go.mod

@@ -0,0 +1,11 @@
+module github.com/qdrant/go-commons
+
+go 1.24.0
+
+require github.com/stretchr/testify v1.10.0
+
+require (
+	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/pmezard/go-difflib v1.0.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)

go.sum

@@ -0,0 +1,10 @@
+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/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/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
+github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+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.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=