init

Author: metafates

.gitattributes

@@ -0,0 +1 @@
+*.gen.go -diff

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,30 @@
+---
+name: Bug Report
+description: File a bug report.
+labels: ["bug"]
+type: bug
+assignees:
+  - metafates
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Also tell us, what did you expect to happen?
+      placeholder: Tell us what you see!
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: |
+        Please copy and paste any relevant log output.
+        This will be automatically formatted into code, no need for backticks.
+      render: shell

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,21 @@
+---
+name: Feature Request
+description: File a feature request.
+labels: ["enhancement"]
+type: feature
+assignees:
+  - metafates
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this feature request!
+
+  - type: textarea
+    id: request
+    attributes:
+      label: Feature
+      description: Also tell us, what problem it would solve?
+      placeholder: Tell us what you have on your mind!
+    validations:
+      required: true

.github/workflows/qa.yml

@@ -0,0 +1,60 @@
+---
+name: Quality Assurance
+
+"on":
+  push:
+    branches:
+      - main
+      - master
+  pull_request:
+
+# Cancel prior runs on the same branch when a new one starts
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: stable
+
+      - name: Run unit tests with race detector
+        if: runner.os != 'Windows'
+        run: go test -race -v ./...
+
+      - name: Run unit tests without race detector
+        if: runner.os == 'Windows'
+        run: go test -v ./...
+
+      - name: Test examples output
+        run: go test -v -tags e2e -count=1 ./examples_test.go
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: stable
+
+      - name: Run linters
+        uses: golangci/golangci-lint-action@v9
+        with:
+          version: v2.11.4
+          args: --tests=false --timeout=5m

.gitignore

@@ -0,0 +1,36 @@
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Code coverage profiles and other test artifacts
+*.out
+coverage.*
+*.coverprofile
+profile.cov
+
+# Go workspace file
+go.work
+go.work.sum
+
+# env file
+.env
+
+.idea/
+
+.DS_Store
+npm-debug.log
+Thumbs.db
+**/node_modules/
+*/out/
+*/.vs/
+tsconfig.lsif.json
+*.lsif
+*.db
+*.tsbuildinfo
+vscode*.d.ts

.golangci.yaml

@@ -0,0 +1,87 @@
+---
+version: "2"
+formatters:
+  enable:
+    - gci
+    - gofumpt
+    - goimports
+    - golines
+    - swaggo
+  exclusions:
+    generated: strict
+  settings:
+    gofmt:
+      rewrite-rules:
+        - pattern: "interface{}"
+          replacement: "any"
+    gofumpt:
+      extra-rules: true
+
+linters:
+  default: all
+  disable:
+    - forcetypeassert
+    - ireturn
+    - depguard
+    - exhaustive
+    - exhaustruct
+    - wrapcheck
+    - varnamelen
+    - mnd
+    - godox
+    - interfacebloat
+    - wsl
+    - nonamedreturns
+    - noinlineerr
+    - gochecknoglobals
+    - err113
+    - gochecknoinits
+  exclusions:
+    rules:
+      - linters:
+          - lll
+        source: "\\s*// "
+      - path: examples/
+        linters:
+          - forbidigo
+          - wsl
+          - revive
+          - godot
+          - funlen
+          - gosec
+      - path: internal/
+        linters:
+          - revive
+      - text: "should have name t"
+        linters:
+          - thelper
+
+  settings:
+    gosec:
+      excludes:
+        - G304
+        - G703
+        - G404
+    dupword:
+      keywords:
+        - "the"
+        - "and"
+        - "a"
+    errcheck:
+      exclude-functions:
+        - "(*os.File).Close"
+    gocritic:
+      enable-all: true
+      disabled-checks:
+        - rangeValCopy
+        - hugeParam
+    iface:
+      enable:
+        - identical
+        - unused
+        - opaque
+        - unexported
+    testifylint:
+      enable-all: true
+    wsl_v5:
+      default: all

CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Initial stable version.

CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Contributing to Testo
+
+Thank you for your interest.
+Below you'll find everything you need to know before contributing to Testo.
+
+## Pull Requests
+
+We welcome pull requests! Please include the following in the description:
+
+- Motivation, why your change is important or helpful
+- Example usage (if applicable)
+- Whether you intend to add / change behavior or fix a bug
+
+Please be aware that the maintainers may ask for changes.
+This isn't a commentary on the quality of your idea or your code.
+We need to enforce certain practices and patterns to keep the package easy for others to understand.
+Essentially, we recognize that there are often many good ways to do a given thing, but we have to pick one and stick with it.
+
+## Issues
+
+If you find a bug or think of a useful feature you'd like to see added to Testo,
+the best thing you can do is make the necessary changes and open a pull request (see above).
+If that isn't an option, or if you'd like to discuss your change before you write the code, open an issue!
+
+Please provide enough context in the issue description that other members of the community
+can easily understand what it is that you'd like to see.