Updating supported versions of Golang

.circleci/config.yml

@@ -1,3 +1,4 @@
+---
 # We use github actions to test the code on windows and linux amd64. Circleci is used for linux arm64.
 #
 version: 2.1
@@ -9,7 +10,7 @@ executors:
   linux_arm64:
     description: "arm64"
     machine:
-      image: ubuntu-2004:202101-01
+      image: ubuntu-2004:2022.04.1
     resource_class: arm.medium
 
 commands:
@@ -18,7 +19,7 @@ commands:
       version:
         type: string
     steps:
-      - os-detect/init # this setup the '$SUDO' variable
+      - os-detect/init  # this setup the '$SUDO' variable
       - run:
           name: "install Golang linux"
           command: |
@@ -72,4 +73,12 @@ workflows:
       - tests_arm64:
           matrix:
             parameters:
-              go-version: ["1.13", "1.14", "1.15", "1.16", "1.17"]
+              go-version:
+                - "1.13"
+                - "1.14"
+                - "1.15"
+                - "1.16"
+                - "1.17"
+                - "1.18"
+                - "1.19"
+                - "1.20"

.github/workflows/codeql-analysis.yml

@@ -3,9 +3,15 @@ name: "CodeQL"
 on:
   push:
     branches: [ master ]
+    paths-ignore:
+      - '*.md'
+      - '*.txt'
   pull_request:
     # The branches below must be a subset of the branches above
     branches: [ master ]
+    paths-ignore:
+      - '*.md'
+      - '*.txt'
 
 jobs:
   analyze:

.github/workflows/datadog-go.yaml

@@ -1,8 +1,17 @@
-# We use github actions to test the code on windows and linux amd64. Circleci is used for linux arm64.
-
+---
+# We use github actions to test the code on windows and linux amd64.
+# Circleci is used for linux arm64.
+#
 name: datadog-go
 on:
+  push:
+    paths-ignore:
+      - '*.md'
+      - '*.txt'
   pull_request:
+    paths-ignore:
+      - '*.md'
+      - '*.txt'
 
 jobs:
   native:
@@ -16,6 +25,7 @@ jobs:
           - 1.17
           - 1.18
           - 1.19
+          - "1.20" # bug as without the quotes you get go 1.2
         runs-on:
           - macos-latest
           - ubuntu-latest

.github/workflows/generate.yaml

@@ -1,6 +1,10 @@
+---
 name: generate-mock
 on:
   pull_request:
+    paths-ignore:
+      - '*.md'
+      - '*.txt'
 
 jobs:
   native:

.gitignore

@@ -1,2 +1,3 @@
 *.swp
 *.swo
+vendor/

README.md

@@ -7,7 +7,7 @@
 
 `datadog-go` is a library that provides a [DogStatsD](https://docs.datadoghq.com/developers/dogstatsd/?code-lang=go) client in Golang.
 
-Go 1.12+ is officially supported. Older versions might work but are not tested.
+Go 1.16+ is officially supported. Older versions might work but are not tested.
 
 The following documentation is available:
 
@@ -33,6 +33,8 @@ The following documentation is available:
     - [Tweaking kernel options](#tweaking-kernel-options)
         + [Unix Domain Sockets](#unix-domain-sockets)
     - [Maximum packets size in high-throughput scenarios](#maximum-packets-size-in-high-throughput-scenarios)
+* [Support Policy](#support-policy)
+* [Supported Versions](#supported-versions)
 * [Development](#development)
 * [License](#license)
 * [Credits](#credits)
@@ -227,6 +229,35 @@ func main() {
 }
 ```
 
+### Support Policy
+
+`datadog-go` is built upon dependencies defined in specific versions of Go releases and the Datadog Agent/API.
+For Go the two latest releases are [GA](#support-ga) supported and the version before that (till version `1.12`) are in [Maintenance](#support-maintenance).
+We do not support older releases, but generally these releases are considered [Legacy](#support-legacy).
+This library only officially supports [first class ports](https://github.com/golang/go/wiki/PortingPolicy#first-class-ports) of Go.
+
+| **Level**                                              | **Support provided**                                                                                                                                                         |
+|--------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <span id="support-ga">General Availability (GA)</span> | Full implementation of all features. Full support for new features, bug & security fixes.                                                                                    |
+| <span id="support-maintenance">Maintenance</span>      | Full implementation of existing features. May receive new features. Support for bug & security fixes only.                                                                   |
+| <span id="support-legacy">Legacy</span>                | Legacy implementation. May have limited function, but no maintenance provided. [Contact our customer support team for special requests.](https://www.datadoghq.com/support/) |
+
+### Supported Versions
+
+| **Go Version** | **Support level**                   |
+|----------------|-------------------------------------|
+| 1.20           | [GA](#support-ga)                   |
+| 1.19           | [GA](#support-ga)                   |
+| 1.18           | [Maintenance](#support-maintenance) |
+| 1.17           | [Maintenance](#support-maintenance) |
+| 1.16           | [Maintenance](#support-maintenance) |
+| 1.15           | [Maintenance](#support-maintenance) |
+| 1.14           | [Maintenance](#support-maintenance) |
+| 1.13           | [Maintenance](#support-maintenance) |
+| 1.12           | [Maintenance](#support-maintenance) |
+
+Future releases may move older Go versions support to [Legacy](#support-legacy), which will be done in a **minor** version change.
+
 ## Development
 
 Run the tests with:

statsd/benchmark_report_metric_noop_test.go

@@ -1,3 +1,4 @@
+//go:build !go1.13
 // +build !go1.13
 
 package statsd_test

statsd/benchmark_report_metric_test.go

@@ -1,3 +1,4 @@
+//go:build go1.13
 // +build go1.13
 
 package statsd_test

statsd/end_to_end_uds_test.go

@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows
 
 package statsd

statsd/pipe.go

@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows
 
 package statsd

statsd/pipe_windows.go

@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows
 
 package statsd

statsd/pipe_windows_test.go

@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows
 
 package statsd

statsd/uds.go

@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows
 
 package statsd

statsd/uds_test.go

@@ -1,3 +1,4 @@
+//go:build !windows
 // +build !windows
 
 package statsd

statsd/uds_windows.go

@@ -1,3 +1,4 @@
+//go:build windows
 // +build windows
 
 package statsd