[add] kicking off examples. Making usage of go.mod

Author: filipecosta90

.circleci/config.yml

@@ -5,13 +5,12 @@ version: 2
 jobs:
   build: # test with circleci/golang:1.9
     docker:
-      - image: circleci/golang:1.9
+      - image: circleci/golang:1.12
 
     working_directory: /go/src/github.com/filipecosta90/hdrhistogram
     steps:
       - checkout
-      - run: go get -v -t -d ./...
-      - run: go test -v ./. -race -coverprofile=coverage.txt -covermode=atomic
+      - run: make test
       - run: bash <(curl -s https://codecov.io/bash) -t ${CODECOV_TOKEN}
 
 workflows:

.gitignore

@@ -1,6 +1,8 @@
 .vscode/
 .idea/
 
+coverage.txt
+
 # Binaries for programs and plugins
 *.exe
 *.exe~

.golangci.yml

@@ -0,0 +1,15 @@
+# options for analysis running
+run:
+  # include test files or not, default is true
+  tests: false
+
+linters-settings:
+  golint:
+    # minimal confidence for issues, default is 0.8
+    min-confidence: 0.8
+
+exclude-rules:
+  # Exclude some linters from running on tests files.
+  - path: _test\.go
+    linters:
+      - errcheck

Makefile

@@ -0,0 +1,36 @@
+# Go parameters
+GOCMD=GO111MODULE=on go
+GOBUILD=$(GOCMD) build
+GOINSTALL=$(GOCMD) install
+GOCLEAN=$(GOCMD) clean
+GOTEST=$(GOCMD) test
+GOGET=$(GOCMD) get
+GOMOD=$(GOCMD) mod
+GOFMT=$(GOCMD) fmt
+
+.PHONY: all test coverage
+all: test coverage
+
+checkfmt:
+	@echo 'Checking gofmt';\
+ 	bash -c "diff -u <(echo -n) <(gofmt -d .)";\
+	EXIT_CODE=$$?;\
+	if [ "$$EXIT_CODE"  -ne 0 ]; then \
+		echo '$@: Go files must be formatted with gofmt'; \
+	fi && \
+	exit $$EXIT_CODE
+
+lint:
+	golangci-lint run
+
+get:
+	GO111MODULE=on $(GOGET) github.com/golangci/golangci-lint/cmd/golangci-lint
+	$(GOGET) -t -v ./...
+
+test: get lint
+	$(GOFMT) ./...
+	$(GOTEST) -race -covermode=atomic ./...
+
+coverage: get test
+	$(GOTEST) -race -coverprofile=coverage.txt -covermode=atomic .
+

bench/bench_realtime_ops/bench_windowed_realtime_ops_test.go

@@ -0,0 +1,30 @@
+package hdrhistogram_test
+
+import (
+	"fmt"
+	"github.com/filipecosta90/hdrhistogram"
+)
+
+// This latency Histogram could be used to track and analyze the counts of
+// observed integer values between 0 us and 30000000 us ( 30 secs )
+// while maintaining a value precision of 4 significant digits across that range,
+// translating to a value resolution of :
+//   - 1 microsecond up to 10 milliseconds,
+//   - 100 microsecond (or better) from 10 milliseconds up to 10 seconds,
+//   - 300 microsecond (or better) from 10 seconds up to 30 seconds,
+func ExampleNew() {
+	lH := hdrhistogram.New(1, 30000000, 4)
+	input := []int64{
+		459876, 669187, 711612, 816326, 931423, 1033197, 1131895, 2477317,
+		3964974, 12718782,
+	}
+
+	for _, sample := range input {
+		lH.RecordValue(sample)
+	}
+
+	fmt.Printf("Percentile 50: %d\n", lH.ValueAtQuantile(50.0))
+
+	// Output:
+	// Percentile 50: 931423
+}

bench/bench_realtime_ops/common.go

@@ -0,0 +1,9 @@
+module github.com/filipecosta90/hdrhistogram
+
+go 1.14
+
+require (
+	code.cloudfoundry.org/bytefmt v0.0.0-20200131002437-cf55d5288a48
+	github.com/golangci/golangci-lint v1.30.0 // indirect
+	github.com/stretchr/testify v1.6.1
+)