Initial v1.0.0 commit

2026-07-04 20:21:39 +02:00 · 2021-01-28 17:37:47 +01:00
commit 1481d27782
4164 changed files with 1264675 additions and 0 deletions
@@ -0,0 +1,29 @@
+*.log
+.DS_Store
+doc
+tmp
+pkg
+*.gem
+*.pid
+coverage
+coverage.data
+build/*
+*.pbxuser
+*.mode1v3
+.svn
+profile
+.console_history
+.sass-cache/*
+.rake_tasks~
+*.log.lck
+solr/
+.jhw-cache/
+jhw.*
+*.sublime*
+node_modules/
+dist/
+generated/
+.vendor/
+bin/*
+gin-bin
+.idea/
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Mark Bates
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
@@ -0,0 +1,61 @@
+TAGS ?= ""
+GO_BIN ?= "go"
+
+install: 
+	$(GO_BIN) install -tags ${TAGS} -v .
+	make tidy
+
+tidy:
+ifeq ($(GO111MODULE),on)
+	$(GO_BIN) mod tidy
+else
+	echo skipping go mod tidy
+endif
+
+deps:
+	$(GO_BIN) get -tags ${TAGS} -t ./...
+	make tidy
+
+build: 
+	$(GO_BIN) build -v .
+	make tidy
+
+test: 
+	$(GO_BIN) test -cover -tags ${TAGS} ./...
+	make tidy
+
+ci-deps: 
+	$(GO_BIN) get -tags ${TAGS} -t ./...
+
+ci-test: 
+	$(GO_BIN) test -tags ${TAGS} -race ./...
+
+lint:
+	go get github.com/golangci/golangci-lint/cmd/golangci-lint
+	golangci-lint run --enable-all
+	make tidy
+
+update:
+ifeq ($(GO111MODULE),on)
+	rm go.*
+	$(GO_BIN) mod init
+	$(GO_BIN) mod tidy
+else
+	$(GO_BIN) get -u -tags ${TAGS}
+endif
+	make test
+	make install
+	make tidy
+
+release-test: 
+	$(GO_BIN) test -tags ${TAGS} -race ./...
+	make tidy
+
+release:
+	$(GO_BIN) get github.com/gobuffalo/release
+	make tidy
+	release -y -f version.go --skip-packr
+	make tidy
+
+
+
@@ -0,0 +1,10 @@
+# github.com/markbates/oncer Stands on the Shoulders of Giants
+
+github.com/markbates/oncer does not try to reinvent the wheel! Instead, it uses the already great wheels developed by the Go community and puts them all together in the best way possible. Without these giants, this project would not be possible. Please make sure to check them out and thank them for all of their hard work.
+
+Thank you to the following **GIANTS**:
+
+
+* [github.com/davecgh/go-spew](https://godoc.org/github.com/davecgh/go-spew)
+
+* [github.com/stretchr/testify](https://godoc.org/github.com/stretchr/testify)
@@ -0,0 +1,65 @@
+variables:
+  GOBIN:  "$(GOPATH)/bin" # Go binaries path
+  GOPATH: "$(system.defaultWorkingDirectory)/gopath" # Go workspace path
+  modulePath: "$(GOPATH)/src/github.com/$(build.repository.name)" # Path to the module"s code
+
+jobs:
+- job: Windows
+  pool:
+    vmImage: "vs2017-win2016"
+  strategy:
+    matrix:
+      go 1.11 (on):
+        go_version: "1.11.11"
+        GO111MODULE: "on"
+      go 1.11 (off):
+        go_version: "1.11.11"
+        GO111MODULE: "off"
+      go 1.12 (on):
+        go_version: "1.12.6"
+        GO111MODULE: "on"
+      go 1.12 (off):
+        go_version: "1.12.6"
+        GO111MODULE: "off"
+  steps:
+    - template: azure-tests.yml
+
+- job: macOS
+  pool:
+    vmImage: "macOS-10.13"
+  strategy:
+    matrix:
+      go 1.11 (on):
+        go_version: "1.11.11"
+        GO111MODULE: "on"
+      go 1.11 (off):
+        go_version: "1.11.11"
+        GO111MODULE: "off"
+      go 1.12 (on):
+        go_version: "1.12.6"
+        GO111MODULE: "on"
+      go 1.12 (off):
+        go_version: "1.12.6"
+        GO111MODULE: "off"
+  steps:
+    - template: azure-tests.yml
+
+- job: Linux
+  pool:
+    vmImage: "ubuntu-16.04"
+  strategy:
+    matrix:
+      go 1.11 (on):
+        go_version: "1.11.11"
+        GO111MODULE: "on"
+      go 1.11 (off):
+        go_version: "1.11.11"
+        GO111MODULE: "off"
+      go 1.12 (on):
+        go_version: "1.12.6"
+        GO111MODULE: "on"
+      go 1.12 (off):
+        go_version: "1.12.6"
+        GO111MODULE: "off"
+  steps:
+    - template: azure-tests.yml
@@ -0,0 +1,19 @@
+steps:
+  - task: GoTool@0
+    inputs:
+      version: $(go_version)
+  - task: Bash@3
+    inputs:
+      targetType: inline
+      script: |
+        mkdir -p "$(GOBIN)"
+        mkdir -p "$(GOPATH)/pkg"
+        mkdir -p "$(modulePath)"
+        shopt -s extglob
+        mv !(gopath) "$(modulePath)"
+    displayName: "Setup Go Workspace"
+  - script: |
+      go get -t -v ./...
+      go test -race ./...
+    workingDirectory: "$(modulePath)"
+    displayName: "Tests"
@@ -0,0 +1,20 @@
+package oncer
+
+import (
+	"fmt"
+	"io"
+	"os"
+)
+
+const deprecated = "DEPRECATED"
+
+var deprecationWriter io.Writer = os.Stdout
+
+func Deprecate(depth int, name string, msg string) {
+	Do(deprecated+name, func() {
+		fmt.Fprintf(deprecationWriter, "[%s] %s has been deprecated.\n", deprecated, name)
+		if len(msg) > 0 {
+			fmt.Fprintf(deprecationWriter, "\t%s\n", msg)
+		}
+	})
+}
@@ -0,0 +1,8 @@
+module github.com/markbates/oncer
+
+go 1.12
+
+require (
+	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/stretchr/testify v1.3.0
+)
@@ -0,0 +1,9 @@
+github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+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/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.3.0 h1:TivCn/peBQ7UY8ooIcPgZFpTNSz0Q2U6UrFlUfqbe0Q=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
@@ -0,0 +1,7 @@
+//+build !debug
+
+package oncer
+
+func log(name string, fn func()) func() {
+	return fn
+}
@@ -0,0 +1,19 @@
+//+build debug
+
+package oncer
+
+import (
+	"fmt"
+	"time"
+)
+
+func log(name string, fn func()) func() {
+	return func() {
+		start := time.Now()
+		if len(name) > 80 {
+			name = name[(len(name) - 80):]
+		}
+		defer fmt.Println(name, time.Now().Sub(start))
+		fn()
+	}
+}
@@ -0,0 +1,26 @@
+package oncer
+
+import (
+	"sync"
+)
+
+var onces = &sync.Map{}
+
+func Do(name string, fn func()) {
+	o, _ := onces.LoadOrStore(name, &sync.Once{})
+	if once, ok := o.(*sync.Once); ok {
+		once.Do(log(name, fn))
+	}
+}
+
+func Reset(names ...string) {
+	if len(names) == 0 {
+		onces = &sync.Map{}
+		return
+	}
+
+	for _, n := range names {
+		onces.Delete(n)
+		onces.Delete(deprecated + n)
+	}
+}
@@ -0,0 +1,4 @@
+package oncer
+
+// Version of oncer
+const Version = "v1.0.0"