175 dockter 1 (#176)

* #175 Add 3104

* #175 Add 31, 32

* #175 Update errors

* #175 Update errors

* #175 Refactor to template

* #175 Savepoint

* #175 Savepoint

* #175 Savepoint

* #175 Savepoint

* #175 Savepoint

* #175 Add godoc

* #175 Add godoc

.github/coverage/README.md

@@ -0,0 +1,20 @@
+# Coverage
+
+## testcoverage.yaml
+
+- [testcoverage.yaml]
+- Used by `coverage:` in
+  - [go-test-darwin.yaml]
+  - [go-test-linux.yaml]
+  - [go-test-windows.yaml]
+- [go-test-coverage]
+  - [go-test-coverage configuration]
+  - [go-test-coverage badge]
+
+[go-test-darwin.yaml]: ../workflows/README.md#go-test-darwinyaml
+[go-test-linux.yaml]: ../workflows/README.md#go-test-linuxyaml
+[go-test-windows.yaml]: ../workflows/README.md#go-test-windowsyaml
+[testcoverage.yaml]: testcoverage.yaml
+[go-test-coverage]: https://github.com/vladopajic/go-test-coverage
+[go-test-coverage configuration]: https://github.com/vladopajic/go-test-coverage?tab=readme-ov-file#config
+[go-test-coverage badge]: https://github.com/vladopajic/go-test-coverage/blob/main/docs/badge.md

.testcoverage.yml → .github/coverage/testcoverage.yaml

@@ -1,50 +1,49 @@
-# (mandatory) 
+# (mandatory)
 # Path to coverprofile file (output of `go test -coverprofile` command).
 #
-# For cases where there are many coverage profiles, such as when running 
+# For cases where there are many coverage profiles, such as when running
 # unit tests and integration tests separately, you can combine all those
-# profiles into one. In this case, the profile should have a comma-separated list 
+# profiles into one. In this case, the profile should have a comma-separated list
 # of profile files, e.g., 'cover_unit.out,cover_integration.out'.
 profile: cover.out
 
-# (optional; but recommended to set) 
+# (optional; but recommended to set)
 # When specified reported file paths will not contain local prefix in the output
 local-prefix: "github.com/org/project"
 
 # Holds coverage thresholds percentages, values should be in range [0-100]
 threshold:
-  # (optional; default 0) 
+  # (optional; default 0)
   # The minimum coverage that each file should have
   file: 70
 
-  # (optional; default 0) 
+  # (optional; default 0)
   # The minimum coverage that each package should have
   package: 80
 
-  # (optional; default 0) 
+  # (optional; default 0)
   # The minimum total coverage project should have
   total: 95
-
-# Holds regexp rules which will override thresholds for matched files or packages 
+# Holds regexp rules which will override thresholds for matched files or packages
 # using their paths.
 #
-# First rule from this list that matches file or package is going to apply 
-# new threshold to it. If project has multiple rules that match same path, 
+# First rule from this list that matches file or package is going to apply
+# new threshold to it. If project has multiple rules that match same path,
 # override rules should be listed in order from specific to more general rules.
 #override:
-  # Increase coverage threshold to 100% for `foo` package 
-  # (default is 80, as configured above in this example)
-  #- threshold: 100
-  #  path: ^pkg/lib/foo$
+# Increase coverage threshold to 100% for `foo` package
+# (default is 80, as configured above in this example)
+#- threshold: 100
+#  path: ^pkg/lib/foo$
 
-# Holds regexp rules which will exclude matched files or packages 
+# Holds regexp rules which will exclude matched files or packages
 # from coverage statistics
 #exclude:
-  # Exclude files or packages matching their paths
-  #paths:
-  #  - \.pb\.go$    # excludes all protobuf generated files
-  #  - ^pkg/bar     # exclude package `pkg/bar`
- 
+# Exclude files or packages matching their paths
+#paths:
+#  - \.pb\.go$    # excludes all protobuf generated files
+#  - ^pkg/bar     # exclude package `pkg/bar`
+
 # NOTES:
 # - symbol `/` in all path regexps will be replaced by current OS file path separator
-#   to properly work on Windows
+#   to properly work on Windows

.github/dependabot.yml

@@ -3,10 +3,10 @@
 
 version: 2
 updates:
-  - package-ecosystem: "github-actions"
-    directory: "/"
+  - package-ecosystem: github-actions
+    directory: /
     schedule:
-      interval: "daily"
+      interval: daily
   - package-ecosystem: gomod
     directory: /
     schedule:

.github/linters/.checkov.yaml

@@ -1,2 +1,3 @@
 quiet: true
-skip-check: CKV_DOCKER_7
+skip-check:
+  - CKV_DOCKER_7

.github/linters/.golangci.yml → .github/linters/.golangci.yaml

@@ -1,9 +1,10 @@
 run:
   modules-download-mode: readonly
-  show-stats: true
+  timeout: 10m
 
 output:
   print-linter-name: false
+  show-stats: true
   sort-results: true
 
 linters:

.github/linters/.jscpd.json

@@ -1,5 +1 @@
-{
-  "ignore": [
-    "**/*.go,**/go-test*.yaml"
-  ]
-}
+{}

.github/linters/README.md

@@ -0,0 +1,54 @@
+# Linters
+
+## .checkov.yaml
+
+- [.checkov.yaml]
+- Used by [lint-workflows.yaml]
+- [checkov]
+  - [checkov configuration]
+
+## .golangci.yaml
+
+- [.golangci.yaml]
+- Used by [golangci-lint.yaml]
+- [golangci-lint]
+  - [golangci-lint configuration]
+
+## .jscpd.json
+
+- [.jscpd.json]
+- Used by [lint-workflows.yaml]
+- [jscpd]
+  - [jscpd configuration]
+  - Example:
+
+      ```json
+      {
+      "ignore": [
+          "**/*.go,**/go-test*.yaml"
+      ],
+      "threshold": 10
+      }
+      ```
+
+## .yaml-lint.yml
+
+- [.yaml-lint.yml]
+- Used by [lint-workflows.yaml]
+- [yaml-lint]
+  - [yaml-lint configuration]
+
+[.checkov.yaml]:  .checkov.yaml
+[.golangci.yaml]: .golangci.yaml
+[.jscpd.json]: .jscpd.json
+[.yaml-lint.yml]: .yaml-lint.yml
+[checkov configuration]: https://www.checkov.io/2.Basics/CLI%20Command%20Reference.html
+[checkov]: https://www.checkov.io/
+[golangci-lint configuration]: https://golangci-lint.run/usage/configuration/
+[golangci-lint.yaml]: ../workflows/README.md#golangci-lintyaml
+[golangci-lint]: https://golangci-lint.run/
+[jscpd configuration]: https://github.com/kucherenko/jscpd/tree/master/apps/jscpd#options
+[jscpd]: https://github.com/kucherenko/jscpd
+[lint-workflows.yaml]: ../workflows/README.md#lint-workflowsyaml
+[yaml-lint configuration]: https://yamllint.readthedocs.io/en/stable/configuration.html
+[yaml-lint]: https://github.com/adrienverge/yamllint

.github/workflows/README.md

@@ -0,0 +1,205 @@
+# Workflows
+
+## add-labels-standardized.yaml
+
+When issues are opened,
+this action adds appropriate labels to the issue.
+(e.g. "triage", "customer-submission")
+
+- [Add Labels Standardized GitHub action]
+  - Uses: [senzing-factory/build-resources/.../add-labels-to-issue.yaml]
+
+## add-to-project-garage-dependabot.yaml
+
+When a Dependabot Pull Request (PR) is made against `main` branch,
+this action adds the PR to the "Garage" project board as "In Progress".
+
+- [Add to Project Garage Dependabot GitHub action]
+  - Uses: [senzing-factory/build-resources/.../add-to-project-dependabot.yaml]
+
+## add-to-project-garage.yaml
+
+When an issue is created,
+this action adds the issue to the "Garage" board as "Backlog".
+
+- [Add to Project Garage GitHub action]
+  - Uses: [senzing-factory/build-resources/.../add-to-project.yaml]
+
+## dependabot-approve-and-merge.yaml
+
+When a Dependabot Pull Request (PR) is made against the `main` branch,
+this action determines if it should be automatically approved and merged into the `main` branch.
+Once this action occurs [move-pr-to-done-dependabot.yaml] moves the PR on the "Garage" project board to "Done".
+
+- [Dependabot Approve and Merge GitHub action]
+  - Uses: [senzing-factory/build-resources/.../dependabot-approve-and-merge.yaml]
+
+## docker-build-container.yaml
+
+When a Pull Request is made against the `main` branch,
+this action verifies that the `Dockerfile` can be successfully built.
+
+*Note:* The Docker image is **not** pushed to [DockerHub].
+
+- [Docker Build Container GitHub action]
+  - Uses: [senzing-factory/github-action-docker-buildx-build]
+
+## docker-push-containers-to-dockerhub.yaml
+
+After a [Semantic Version] release is created,
+this action builds Docker images on multiple architectures and pushes the Docker images to [DockerHub].
+
+- [Docker Push Containers to DockerHub GitHub action]
+  - Uses: [senzing-factory/github-action-docker-buildx-build]
+
+## golangci-lint.yaml
+
+When a change is committed to GitHub or a Pull Request is made against the `main` branch,
+this action runs [golangci-lint] to run multiple linters against the code.
+
+- [Golangci Lint GitHub action]
+  - Configuration:
+    - [.golangci.yaml]
+  - Uses:
+    - [actions/checkout]
+    - [senzing-factory/github-action-install-senzing-api]
+    - [actions/setup-go]
+    - [golangci/golangci-lint-action]
+
+## go-proxy-pull.yaml
+
+After a [Semantic Version] release is created,
+this action expedites the Go publishing process.
+
+- [Go Proxy Pull GitHub action]
+  - Uses: [andrewslotin/go-proxy-pull-action]
+
+## go-test-darwin.yaml
+
+When a Pull Request is made against the `main` branch,
+this action runs `go test` with coverage testing on macOS.
+
+- [Go Test Darwin GitHub action]
+  - Configuration: [testcoverage.yaml]
+  - Uses:
+    - [actions/checkout]
+    - [actions/setup-go]
+    - [gotesttools/gotestfmt-action]
+    - [senzing-factory/github-action-install-senzing-api]
+    - [actions/upload-artifact]
+    - [senzing-factory/build-resources/.../go-coverage.yaml]
+
+## go-test-linux.yaml
+
+When a change is committed to GitHub or a Pull Request is made against the `main` branch,
+this action runs `go test` with coverage testing on Linux.
+
+- [Go Test Linux GitHub action]
+  - Configuration: [testcoverage.yaml]
+  - Uses:
+    - [actions/checkout]
+    - [actions/setup-go]
+    - [gotesttools/gotestfmt-action]
+    - [senzing-factory/github-action-install-senzing-api]
+    - [actions/upload-artifact]
+    - [senzing-factory/build-resources/.../go-coverage.yaml]
+
+## go-test-windows.yaml
+
+When a Pull Request is made against the `main` branch,
+this action runs `go test` with coverage testing on Windows.
+
+- [Go Test Windows GitHub action]
+  - Configuration: [testcoverage.yaml]
+  - Uses:
+    - [actions/checkout]
+    - [actions/setup-go]
+    - [gotesttools/gotestfmt-action]
+    - [senzing-factory/github-action-install-senzing-api]
+    - [actions/upload-artifact]
+    - [senzing-factory/build-resources/.../go-coverage.yaml]
+
+## lint-workflows.yaml
+
+When a change is committed to GitHub or a Pull Request is made against the `main` branch,
+this action runs [super-linter] to run multiple linters against the code.
+
+- [Lint Workflows GitHub action]
+  - Configuration:
+    - [.checkov.yaml]
+    - [.jscpd.json]
+    - [.yaml-lint.yml]
+  - Uses: [senzing-factory/build-resources/.../lint-workflows.yaml]
+
+## make-go-github-file.yaml
+
+After a [Semantic Version] release is created,
+this action creates a Pull Request for an updated [github.go] file
+for the **next** Semantic Version release by increasing the Semantic Version's Patch value.
+
+- [Make Go GitHub File GitHub action]
+  - Uses: [senzing-factory/build-resources/.../make-go-github-file.yaml]
+
+## make-go-tag.yaml
+
+After a [Semantic Version] release is created,
+this action creates a tag in the form `vM.m.P` using the SHA of the `M.m.P` release.
+The `v` prefix is standard usage in [Go].
+
+- [Make Go Tag GitHub action]
+  - Uses:
+    - [actions/checkout]
+    - [senzing-factory/github-action-make-go-tag]
+
+## move-pr-to-done-dependabot.yaml
+
+When a Pull Request is merged into the `main` branch,
+this action moves the PR on the "Garage" project board to "Done".
+
+- [Move PR to Done Dependabot GitHub action]
+  - Uses: [senzing-factory/build-resources/.../move-pr-to-done-dependabot.yaml]
+
+[.checkov.yaml]:  ../linters/README.md#checkovyaml
+[.golangci.yaml]: ../linters/README.md#golangciyaml
+[.jscpd.json]: ../linters/README.md#jscpdjson
+[.yaml-lint.yml]: ../linters/README.md#yaml-lintyml
+[actions/checkout]: https://github.com/actions/checkout
+[actions/setup-go]: https://github.com/actions/setup-go
+[actions/upload-artifact]: https://github.com/actions/upload-artifact
+[Add Labels Standardized GitHub action]: add-labels-standardized.yaml
+[Add to Project Garage Dependabot GitHub action]: add-to-project-garage-dependabot.yaml
+[Add to Project Garage GitHub action]: add-to-project-garage.yaml
+[andrewslotin/go-proxy-pull-action]: https://github.com/andrewslotin/go-proxy-pull-action
+[Dependabot Approve and Merge GitHub action]: dependabot-approve-and-merge.yaml
+[Docker Build Container GitHub action]: docker-build-container.yaml
+[Docker Push Containers to DockerHub GitHub action]: docker-push-containers-to-dockerhub.yaml
+[DockerHub]: https://hub.docker.com/
+[github.go]: ../../cmd/github.go
+[Go Proxy Pull GitHub action]: go-proxy-pull.yaml
+[Go Test Darwin GitHub action]: go-test-darwin.yaml
+[Go Test Linux GitHub action]: go-test-linux.yaml
+[Go Test Windows GitHub action]: go-test-windows.yaml
+[Go]: https://go.dev/
+[Golangci Lint GitHub action]: golangci-lint.yaml
+[golangci-lint]: https://github.com/golangci/golangci-lint
+[golangci/golangci-lint-action]: https://github.com/golangci/golangci-lint-action
+[gotesttools/gotestfmt-action]: https://github.com/gotesttools/gotestfmt-action
+[Lint Workflows GitHub action]: lint-workflows.yaml
+[Make Go GitHub File GitHub action]: make-go-github-file.yaml
+[Make Go Tag GitHub action]: make-go-tag.yaml
+[Move PR to Done Dependabot GitHub action]: move-pr-to-done-dependabot.yaml
+[move-pr-to-done-dependabot.yaml]: move-pr-to-done-dependabotyaml
+[Semantic Version]: https://semver.org/
+[senzing-factory/build-resources/.../add-labels-to-issue.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/add-labels-to-issue.yaml
+[senzing-factory/build-resources/.../add-to-project-dependabot.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/add-to-project-dependabot.yaml
+[senzing-factory/build-resources/.../add-to-project.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/add-to-project.yaml
+[senzing-factory/build-resources/.../dependabot-approve-and-merge.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/dependabot-approve-and-merge.yaml
+[senzing-factory/build-resources/.../go-coverage.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/go-coverage.yaml
+[senzing-factory/build-resources/.../lint-workflows.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/lint-workflows.yaml
+[senzing-factory/build-resources/.../make-go-github-file.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/make-go-github-file.yaml
+[senzing-factory/build-resources/.../move-pr-to-done-dependabot.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/move-pr-to-done-dependabot.yaml
+[senzing-factory/github-action-docker-buildx-build]: https://github.com/senzing-factory/github-action-docker-buildx-build
+[senzing-factory/github-action-install-senzing-api]: https://github.com/senzing-factory/github-action-install-senzing-api
+[senzing-factory/github-action-make-go-tag]: https://github.com/senzing-factory/github-action-make-go-tag
+[super-linter]: https://github.com/super-linter/super-linter
+[testcoverage.yaml]:  ../coverage/README.md#testcoverageyaml