.golangci.yaml

# Copyright (c) 2026, NVIDIA CORPORATION.  All rights reserved.
#
# 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.

version: "2"

# Run configuration
run:
  go: "1.26"
  timeout: 5m
  tests: true
  modules-download-mode: readonly

# Output configuration
output:
  formats:
    text:
      path: stdout
      print-linter-name: true
      print-issued-lines: true
      colors: true
  sort-order:
    - linter
    - severity
    - file

linters:
  enable:
    # Bug detection
    - bodyclose       # HTTP response body must be closed
    - copyloopvar     # Loop variable capture issues (Go 1.22+)
    - errorlint       # Error wrapping and comparison
    # - nilerr        # Return nil after error check (disabled: intentional nil returns for skippable errors)
    - nilnil          # Nil/nil returns
    - staticcheck     # Advanced static analysis

    # Code quality
    - asciicheck      # Non-ASCII identifiers
    - dogsled         # Too many blank identifiers
    - dupl            # Duplicate code detection
    - exhaustive      # Enum exhaustiveness
    - funlen          # Function length
    # - gocognit      # Cognitive complexity (disabled: existing code exceeds threshold)
    - goconst         # Repeated strings
    - gocritic        # Opinionated checks
    - govet           # Go vet checks
    - misspell        # Spelling
    - nakedret        # Naked returns
    - prealloc        # Slice preallocation
    - revive          # Golint replacement
    - unconvert       # Unnecessary conversions
    - unparam         # Unused parameters
    - whitespace      # Whitespace issues

    # Security
    - gosec           # Security checks

    # HTTP/Context
    - contextcheck    # Context propagation in function calls
    - noctx           # HTTP requests without context

    # Dependency management
    - depguard        # Ban deprecated/unwanted packages

    # Testing
    - tparallel       # t.Parallel() usage

    # Style
    - importas        # Import aliasing

  settings:
    gosec:
      excludes:
        - G706  # Log injection: slog structured logging with key-value pairs is safe

    funlen:
      lines: 200
      statements: 70
      ignore-comments: true

    gocognit:
      min-complexity: 20

    govet:
      enable:
        - shadow

    misspell:
      mode: restricted
      locale: US
      ignore-rules:
        - Lustre

    unparam:
      check-exported: true

    whitespace:
      multi-if: true
      multi-func: true

    dupl:
      threshold: 200

    revive:
      rules:
        # Disable stuttering check - collector types intentionally include package name
        # for clarity when used together (e.g., gpu.GPUCollector, grub.GrubCollector)
        - name: exported
          disabled: false
          arguments:
            - disableStutteringCheck

    depguard:
      rules:
        main:
          list-mode: lax
          deny:
            - pkg: io/ioutil
              desc: "Deprecated since Go 1.16. Use io and os packages instead."
            - pkg: math/rand$
              desc: "Use math/rand/v2 for new code, or crypto/rand for security-sensitive code."

  exclusions:
    generated: lax
    presets:
      - comments
      - common-false-positives
      - legacy
      - std-error-handling
    rules:
      # Relaxed rules for test files
      - linters:
          - dupl
          - errcheck
          - funlen
          - gocognit
          - gocyclo
          - gosec
          - noctx
        path: _test\.go
      # SA5011 false positive: staticcheck doesn't know t.Fatal stops execution
      - linters:
          - staticcheck
        text: "SA5011"
        path: _test\.go
      # Relaxed rules for main entry points
      - linters:
          - funlen
        path: cmd/.*/main\.go
    paths:
      - third_party$
      - builtin$
      - examples$

issues:
  max-issues-per-linter: 0
  max-same-issues: 0

formatters:
  enable:
    - gofmt
    - goimports
  exclusions:
    generated: lax
    paths:
      - third_party$
      - builtin$
      - examples$