Feat/pgx client rework

.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+
+updates:
+  - package-ecosystem: "gomod"
+    directories:
+      - "/"
+      - "/extra/*"
+      - "/examples/*"
+    schedule:
+      interval: "weekly"
+    ignore:
+      # Local modules are resolved through go.work during repository builds.
+      - dependency-name: "github.com/mkbeh/xpg"
+      - dependency-name: "github.com/mkbeh/xpg/*"
+    groups:
+      go-dependencies:
+        patterns:
+          - "*"
+        group-by: dependency-name
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/scripts/create-go-workspace.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ -n "${GITHUB_WORKSPACE:-}" ]]; then
+  root="${GITHUB_WORKSPACE}"
+else
+  root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+fi
+
+include_examples=false
+
+for arg in "$@"; do
+  case "${arg}" in
+    --with-examples)
+      include_examples=true
+      ;;
+    *)
+      echo "unknown argument: ${arg}" >&2
+      exit 2
+      ;;
+  esac
+done
+
+cd "${root}"
+
+rm -f go.work go.work.sum
+
+modules=(.)
+
+while IFS= read -r -d '' mod; do
+  modules+=("$(dirname "${mod}")")
+done < <(find ./extra -name go.mod -type f -print0 2>/dev/null | sort -z)
+
+if [[ "${include_examples}" == "true" ]]; then
+  while IFS= read -r -d '' mod; do
+    modules+=("$(dirname "${mod}")")
+  done < <(find ./examples -name go.mod -type f -print0 2>/dev/null | sort -z)
+fi
+
+# The workspace is ephemeral in CI and local-only for development.
+GOWORK=off go work init "${modules[@]}"
+
+# Local modules may already require release versions such as v0.1.0 while the
+# corresponding tags do not exist yet. Bind those exact requirements to the
+# current checkout so all Go tooling, including go/packages-based linters,
+# resolves the unpublished modules locally.
+while read -r module version; do
+  [[ -n "${module}" && -n "${version}" ]] || continue
+
+  case "${module}" in
+    github.com/mkbeh/xpg)
+      local_dir="."
+      ;;
+    github.com/mkbeh/xpg/*)
+      local_dir="./${module#github.com/mkbeh/xpg/}"
+      ;;
+    *)
+      continue
+      ;;
+  esac
+
+  if [[ -f "${root}/${local_dir#./}/go.mod" ]]; then
+    GOWORK="${root}/go.work" go work edit \
+      -replace="${module}@${version}=${local_dir}"
+  fi
+done < <(
+  {
+    printf '%s\0' ./go.mod
+
+    find ./extra ./examples \
+      -name go.mod -type f -print0 2>/dev/null || true
+  } |
+  while IFS= read -r -d '' mod; do
+    awk '
+      $1 == "require" &&
+      $2 ~ /^github\.com\/mkbeh\/xpg(\/.*)?$/ &&
+      $3 ~ /^v[0-9]/ {
+        print $2, $3
+        next
+      }
+
+      $1 ~ /^github\.com\/mkbeh\/xpg(\/.*)?$/ &&
+      $2 ~ /^v[0-9]/ {
+        print $1, $2
+      }
+    ' "${mod}"
+  done |
+  sort -u
+)
+
+echo "Created temporary Go workspace at ${root}/go.work"
+
+if [[ "${WORKSPACE_DEBUG:-false}" == "true" ]]; then
+  GOWORK="${root}/go.work" go work edit -json
+fi

.github/workflows/codecov.yml

@@ -0,0 +1,60 @@
+name: Coverage
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  GOTOOLCHAIN: local
+  CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+jobs:
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up Go
+        uses: actions/setup-go@v7
+        with:
+          go-version-file: go.mod
+          check-latest: true
+          cache-dependency-path: |
+            go.sum
+            extra/**/go.mod
+
+      - name: Set up Task
+        uses: go-task/setup-task@v2
+
+      - name: Create temporary Go workspace
+        run: bash .github/scripts/create-go-workspace.sh
+
+      - name: Run coverage
+        env:
+          GOWORK: ${{ github.workspace }}/go.work
+        run: task coverage
+
+      - name: Upload coverage to Codecov
+        if: env.CODECOV_TOKEN != ''
+        uses: codecov/codecov-action@v7
+        with:
+          token: ${{ env.CODECOV_TOKEN }}
+          files: ./coverage.out
+          disable_search: true
+          fail_ci_if_error: true

.github/workflows/lint.yml

@@ -0,0 +1,123 @@
+name: Lint
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  GOTOOLCHAIN: local
+
+jobs:
+  modules:
+    name: Discover modules
+    runs-on: ubuntu-latest
+
+    outputs:
+      modules: ${{ steps.modules.outputs.modules }}
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Discover Go modules
+        id: modules
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          modules="$(
+            {
+              printf '.\n'
+
+              find ./extra ./examples \
+                -name go.mod \
+                -type f \
+                -print |
+                while IFS= read -r mod; do
+                  dirname "${mod#./}"
+                done
+            } |
+              sort |
+              jq -R -s -c 'split("\n")[:-1]'
+          )"
+
+          echo "modules=${modules}" >> "${GITHUB_OUTPUT}"
+
+  lint:
+    name: Lint (${{ matrix.module }})
+    needs:
+      - modules
+
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    strategy:
+      fail-fast: false
+      matrix:
+        module: ${{ fromJSON(needs.modules.outputs.modules) }}
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up Go
+        uses: actions/setup-go@v7
+        with:
+          go-version-file: go.mod
+          check-latest: true
+          cache-dependency-path: |
+            go.sum
+            extra/**/go.mod
+            examples/**/go.mod
+
+      - name: Create temporary Go workspace
+        run: bash .github/scripts/create-go-workspace.sh --with-examples
+
+      - name: Verify workspace resolution
+        env:
+          GOWORK: ${{ github.workspace }}/go.work
+        run: |
+          set -euo pipefail
+
+          test "$(go env GOWORK)" = "${GITHUB_WORKSPACE}/go.work"
+
+          go list -m \
+            -f '{{if .Main}}{{.Path}} => {{.Dir}}{{end}}' \
+            all |
+            sed '/^$/d'
+
+      - name: Run golangci-lint
+        uses: golangci/golangci-lint-action@v9
+        env:
+          GOWORK: ${{ github.workspace }}/go.work
+        with:
+          version: v2.13.1
+          working-directory: ${{ matrix.module }}
+          args: >-
+            --config=${{ github.workspace }}/.golangci.yml
+            --timeout=5m
+            --modules-download-mode=readonly
+
+  result:
+    name: Lint
+    if: always()
+    needs:
+      - lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Check lint jobs
+        run: test "${{ needs.lint.result }}" = "success"