├── .github ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── ISSUE_TEMPLATE │ ├── bug.yml │ ├── config.yml │ ├── question.yml │ └── suggestion.yml ├── PULL_REQUEST_TEMPLATE.md ├── dependabot.yml ├── images │ ├── card.svg │ ├── flat_blue.svg │ ├── flat_brightgreen.svg │ ├── flat_critical.svg │ ├── flat_custom.svg │ ├── flat_green.svg │ ├── flat_important.svg │ ├── flat_inactive.svg │ ├── flat_informational.svg │ ├── flat_japanese.svg │ ├── flat_lightgrey.svg │ ├── flat_orange.svg │ ├── flat_red.svg │ ├── flat_simple_blue.svg │ ├── flat_simple_brightgreen.svg │ ├── flat_simple_critical.svg │ ├── flat_simple_custom.svg │ ├── flat_simple_green.svg │ ├── flat_simple_important.svg │ ├── flat_simple_inactive.svg │ ├── flat_simple_informational.svg │ ├── flat_simple_japanese.svg │ ├── flat_simple_lightgrey.svg │ ├── flat_simple_orange.svg │ ├── flat_simple_red.svg │ ├── flat_simple_success.svg │ ├── flat_simple_yellow.svg │ ├── flat_simple_yellowgreen.svg │ ├── flat_success.svg │ ├── flat_yellow.svg │ ├── flat_yellowgreen.svg │ ├── godoc.svg │ ├── license.svg │ ├── plastic_blue.svg │ ├── plastic_brightgreen.svg │ ├── plastic_critical.svg │ ├── plastic_custom.svg │ ├── plastic_green.svg │ ├── plastic_important.svg │ ├── plastic_inactive.svg │ ├── plastic_informational.svg │ ├── plastic_japanese.svg │ ├── plastic_lightgrey.svg │ ├── plastic_orange.svg │ ├── plastic_red.svg │ ├── plastic_simple_blue.svg │ ├── plastic_simple_brightgreen.svg │ ├── plastic_simple_critical.svg │ ├── plastic_simple_custom.svg │ ├── plastic_simple_green.svg │ ├── plastic_simple_important.svg │ ├── plastic_simple_inactive.svg │ ├── plastic_simple_informational.svg │ ├── plastic_simple_japanese.svg │ ├── plastic_simple_lightgrey.svg │ ├── plastic_simple_orange.svg │ ├── plastic_simple_red.svg │ ├── plastic_simple_success.svg │ ├── plastic_simple_yellow.svg │ ├── plastic_simple_yellowgreen.svg │ ├── plastic_success.svg │ ├── plastic_yellow.svg │ ├── plastic_yellowgreen.svg │ ├── square_blue.svg │ ├── square_brightgreen.svg │ ├── square_critical.svg │ ├── square_custom.svg │ ├── square_green.svg │ ├── square_important.svg │ ├── square_inactive.svg │ ├── square_informational.svg │ ├── square_japanese.svg │ ├── square_lightgrey.svg │ ├── square_orange.svg │ ├── square_red.svg │ ├── square_simple_blue.svg │ ├── square_simple_brightgreen.svg │ ├── square_simple_critical.svg │ ├── square_simple_custom.svg │ ├── square_simple_green.svg │ ├── square_simple_important.svg │ ├── square_simple_inactive.svg │ ├── square_simple_informational.svg │ ├── square_simple_japanese.svg │ ├── square_simple_lightgrey.svg │ ├── square_simple_orange.svg │ ├── square_simple_red.svg │ ├── square_simple_success.svg │ ├── square_simple_yellow.svg │ ├── square_simple_yellowgreen.svg │ ├── square_success.svg │ ├── square_yellow.svg │ └── square_yellowgreen.svg └── workflows │ ├── ci.yml │ ├── codeql.yml │ └── godoc.yml ├── .gitignore ├── .typos.toml ├── LICENSE ├── Makefile ├── README.md ├── SECURITY.md ├── badge.go ├── badge_test.go ├── go.mod ├── go.sum └── testdata ├── black.svg ├── flat.svg ├── flat_simple.svg ├── plastic.svg ├── plastic_simple.svg ├── square.svg ├── square_simple.svg └── white.svg /.github/CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Contributor Code of Conduct 2 | 3 | As contributors and maintainers of this project, and in the interest of 4 | fostering an open and welcoming community, we pledge to respect all people who 5 | contribute through reporting issues, posting feature requests, updating 6 | documentation, submitting pull requests or patches, and other activities. 7 | 8 | We are committed to making participation in this project a harassment-free 9 | experience for everyone, regardless of level of experience, gender, gender 10 | identity and expression, sexual orientation, disability, personal appearance, 11 | body size, race, ethnicity, age, religion, or nationality. 12 | 13 | Examples of unacceptable behavior by participants include: 14 | 15 | * The use of sexualized language or imagery 16 | * Personal attacks 17 | * Trolling or insulting/derogatory comments 18 | * Public or private harassment 19 | * Publishing other's private information, such as physical or electronic 20 | addresses, without explicit permission 21 | * Other unethical or unprofessional conduct 22 | 23 | Project maintainers have the right and responsibility to remove, edit, or 24 | reject comments, commits, code, wiki edits, issues, and other contributions 25 | that are not aligned to this Code of Conduct, or to ban temporarily or 26 | permanently any contributor for other behaviors that they deem inappropriate, 27 | threatening, offensive, or harmful. 28 | 29 | By adopting this Code of Conduct, project maintainers commit themselves to 30 | fairly and consistently applying these principles to every aspect of managing 31 | this project. Project maintainers who do not follow or enforce the Code of 32 | Conduct may be permanently removed from the project team. 33 | 34 | This Code of Conduct applies both within project spaces and in public spaces 35 | when an individual is representing the project or its community. 36 | 37 | Instances of abusive, harassing, or otherwise unacceptable behavior may be 38 | reported by contacting a project maintainer at `conduct@essentialkaos.com`. All 39 | complaints will be reviewed and investigated and will result in a response that 40 | is deemed necessary and appropriate to the circumstances. Maintainers are 41 | obligated to maintain confidentiality with regard to the reporter of an 42 | incident. 43 | -------------------------------------------------------------------------------- /.github/CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contributing Guidelines 2 | 3 | **IMPORTANT! Contribute your code only if you have an excellent understanding of project idea and all existing code base. Otherwise, a nicely formatted issue will be more helpful to us.** 4 | 5 | ### Issues 6 | 7 | 1. Provide product version where the problem was found; 8 | 2. Provide info about your environment; 9 | 3. Provide detailed info about your problem; 10 | 4. Provide steps to reproduce the problem; 11 | 5. Provide actual and expected results. 12 | 13 | ### Code 14 | 15 | 1. Check your code **before** creating pull request; 16 | 2. If tests are present in a project, add tests for your code; 17 | 3. Add inline documentation for your code; 18 | 4. Apply code style used throughout the project; 19 | 5. Create your pull request to `develop` branch (_pull requests to other branches are not allowed_). 20 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/bug.yml: -------------------------------------------------------------------------------- 1 | name: ❗ Bug Report 2 | description: File a bug report 3 | title: "[Bug]: " 4 | labels: ["issue • bug"] 5 | assignees: 6 | - andyone 7 | 8 | body: 9 | - type: markdown 10 | attributes: 11 | value: | 12 | > [!IMPORTANT] 13 | > Before you open an issue, search GitHub Issues for a similar bug reports. If so, please add a 👍 reaction to the existing issue. 14 | 15 | - type: textarea 16 | attributes: 17 | label: Module version info 18 | description: Output of `grep 'github.com/essentialkaos/go-badge' go.sum` command 19 | render: shell 20 | validations: 21 | required: true 22 | 23 | - type: textarea 24 | attributes: 25 | label: Steps to reproduce 26 | description: Short guide on how to reproduce this problem on our site 27 | placeholder: | 28 | 1. [First Step] 29 | 2. [Second Step] 30 | 3. [and so on...] 31 | validations: 32 | required: true 33 | 34 | - type: textarea 35 | attributes: 36 | label: Expected behavior 37 | description: What you expected to happen 38 | validations: 39 | required: true 40 | 41 | - type: textarea 42 | attributes: 43 | label: Actual behavior 44 | description: What actually happened 45 | validations: 46 | required: true 47 | 48 | - type: textarea 49 | attributes: 50 | label: Additional info 51 | description: Include gist of relevant config, logs, etc. 52 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/config.yml: -------------------------------------------------------------------------------- 1 | blank_issues_enabled: false 2 | 3 | contact_links: 4 | - name: Security Policies and Procedures 5 | url: https://github.com/essentialkaos/.github/blob/master/SECURITY.md 6 | about: Security procedures and general policies for all ESSENTIAL KAOS projects. 7 | 8 | - name: Contributing Guidelines 9 | url: https://github.com/essentialkaos/contributing-guidelines/blob/master/CONTRIBUTING.md 10 | about: Contributing Guidelines for all ESSENTIAL KAOS projects 11 | 12 | - name: Go Version Support Policy 13 | url: https://github.com/essentialkaos/.github/blob/master/GO-VERSION-SUPPORT.md 14 | about: Information about supported Go versions 15 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/question.yml: -------------------------------------------------------------------------------- 1 | name: ❓ Question 2 | description: Question about application, configuration or code 3 | title: "[Question]: " 4 | labels: ["issue • question"] 5 | assignees: 6 | - andyone 7 | 8 | body: 9 | - type: markdown 10 | attributes: 11 | value: | 12 | > [!IMPORTANT] 13 | > Before you open an issue, search GitHub Issues for a similar question. If so, please add a 👍 reaction to the existing issue. 14 | 15 | - type: textarea 16 | attributes: 17 | label: Question 18 | description: Detailed question 19 | validations: 20 | required: true 21 | 22 | - type: textarea 23 | attributes: 24 | label: Module version info 25 | description: Output of `grep 'github.com/essentialkaos/go-badge' go.sum` command 26 | render: shell 27 | validations: 28 | required: true 29 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/suggestion.yml: -------------------------------------------------------------------------------- 1 | name: ➕ Suggestion 2 | description: Suggest new feature or improvement 3 | title: "[Suggestion]: " 4 | labels: ["issue • suggestion"] 5 | assignees: 6 | - andyone 7 | 8 | body: 9 | - type: markdown 10 | attributes: 11 | value: | 12 | > [!IMPORTANT] 13 | > Before you open an issue, search GitHub Issues for a similar feature requests. If so, please add a 👍 reaction to the existing issue. 14 | > 15 | > Opening a feature request kicks off a discussion. Requests may be closed if we're not actively planning to work on them. 16 | 17 | - type: textarea 18 | attributes: 19 | label: Proposal 20 | description: Description of the feature 21 | validations: 22 | required: true 23 | 24 | - type: textarea 25 | attributes: 26 | label: Current behavior 27 | description: What currently happens 28 | validations: 29 | required: true 30 | 31 | - type: textarea 32 | attributes: 33 | label: Desired behavior 34 | description: What you would like to happen 35 | validations: 36 | required: true 37 | 38 | - type: textarea 39 | attributes: 40 | label: Use case 41 | description: Why is this important (helps with prioritizing requests) 42 | validations: 43 | required: true 44 | -------------------------------------------------------------------------------- /.github/PULL_REQUEST_TEMPLATE.md: -------------------------------------------------------------------------------- 1 | ### What did you implement: 2 | 3 | Closes #XXXXX 4 | 5 | ### How did you implement it: 6 | 7 | ... 8 | 9 | ### How can we verify it: 10 | 11 | ... 12 | 13 | ### TODO's: 14 | 15 | - [ ] Write tests 16 | - [ ] Write documentation 17 | - [ ] Check that there aren't other open pull requests for the same issue/feature 18 | - [ ] Format your source code by `make fmt` 19 | - [ ] Provide verification config / commands 20 | - [ ] Enable "Allow edits from maintainers" for this PR 21 | - [ ] Update the messages below 22 | 23 | **Is this ready for review?:** No 24 | **Is it a breaking change?:** No 25 | -------------------------------------------------------------------------------- /.github/dependabot.yml: -------------------------------------------------------------------------------- 1 | version: 2 2 | 3 | updates: 4 | - package-ecosystem: "gomod" 5 | directory: "/" 6 | target-branch: "develop" 7 | schedule: 8 | interval: "daily" 9 | timezone: "Etc/UTC" 10 | time: "03:00" 11 | labels: 12 | - "PR • MAINTENANCE" 13 | assignees: 14 | - "andyone" 15 | reviewers: 16 | - "andyone" 17 | groups: 18 | all: 19 | applies-to: version-updates 20 | update-types: 21 | - "minor" 22 | - "patch" 23 | 24 | - package-ecosystem: "github-actions" 25 | directory: "/" 26 | target-branch: "develop" 27 | schedule: 28 | interval: "daily" 29 | timezone: "Etc/UTC" 30 | time: "03:00" 31 | labels: 32 | - "PR • MAINTENANCE" 33 | assignees: 34 | - "andyone" 35 | reviewers: 36 | - "andyone" 37 | -------------------------------------------------------------------------------- /.github/images/card.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_blue.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_brightgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_critical.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_custom.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_green.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_important.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_inactive.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_informational.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_japanese.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_lightgrey.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_orange.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_red.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_blue.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_brightgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_critical.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_custom.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_green.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_important.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_inactive.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_informational.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_japanese.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_lightgrey.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_orange.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_red.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_success.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_yellow.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_simple_yellowgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_success.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_yellow.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/flat_yellowgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/godoc.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/license.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_blue.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_brightgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_critical.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_custom.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_green.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_important.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_inactive.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_informational.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_japanese.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_lightgrey.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_orange.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_red.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_blue.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_brightgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_critical.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_custom.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_green.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_important.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_inactive.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_informational.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_japanese.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_lightgrey.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_orange.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_red.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_success.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_yellow.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_simple_yellowgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_success.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_yellow.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/plastic_yellowgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_blue.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_brightgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_critical.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_custom.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_green.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_important.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_inactive.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_informational.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_japanese.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_lightgrey.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_orange.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_red.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_blue.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_brightgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_critical.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_custom.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_green.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_important.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_inactive.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_informational.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_japanese.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_lightgrey.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_orange.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_red.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_success.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_yellow.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_simple_yellowgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_success.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_yellow.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/images/square_yellowgreen.svg: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /.github/workflows/ci.yml: -------------------------------------------------------------------------------- 1 | name: CI 2 | 3 | on: 4 | push: 5 | branches: [master, develop] 6 | pull_request: 7 | branches: [master] 8 | workflow_dispatch: 9 | inputs: 10 | force_run: 11 | description: 'Force workflow run' 12 | required: true 13 | type: choice 14 | options: [yes, no] 15 | 16 | permissions: 17 | actions: read 18 | contents: read 19 | statuses: write 20 | 21 | concurrency: 22 | group: ${{ github.workflow }}-${{ github.ref }} 23 | cancel-in-progress: true 24 | 25 | jobs: 26 | Go: 27 | name: Go 28 | runs-on: ubuntu-latest 29 | 30 | strategy: 31 | matrix: 32 | go: [ 'oldstable', 'stable' ] 33 | 34 | steps: 35 | - name: Checkout 36 | uses: actions/checkout@v4 37 | 38 | - name: Set up Go 39 | uses: actions/setup-go@v5 40 | with: 41 | go-version: ${{ matrix.go }} 42 | 43 | - name: Download dependencies 44 | run: make deps 45 | 46 | - name: Download Verdana font 47 | run: curl -L -o 'Verdana.ttf' 'https://github.com/matomo-org/travis-scripts/raw/master/fonts/Verdana.ttf' 48 | 49 | - name: Run tests 50 | run: go test -v -covermode count -coverprofile cover.out ./... 51 | 52 | - name: Send coverage data to Coveralls 53 | uses: essentialkaos/goveralls-action@v2 54 | env: 55 | COVERALLS_TOKEN: ${{ secrets.GITHUB_TOKEN }} 56 | with: 57 | profile: cover.out 58 | parallel: true 59 | flag-name: linux-${{ matrix.go }} 60 | 61 | - name: Send coverage data to Codacy 62 | env: 63 | CODACY_PROJECT_TOKEN: ${{ secrets.CODACY_PROJECT_TOKEN }} 64 | run: | 65 | bash <(curl -Ls https://coverage.codacy.com/get.sh) report \ 66 | --force-coverage-parser go \ 67 | -r cover.out \ 68 | --partial 69 | 70 | SendCoverage: 71 | name: Send Coverage 72 | runs-on: ubuntu-latest 73 | 74 | needs: Go 75 | 76 | steps: 77 | - name: Finish parallel tests (Coveralls) 78 | uses: essentialkaos/goveralls-action@v2 79 | env: 80 | COVERALLS_TOKEN: ${{ secrets.GITHUB_TOKEN }} 81 | with: 82 | parallel-finished: true 83 | 84 | - name: Finish parallel tests (Codacy) 85 | env: 86 | CODACY_PROJECT_TOKEN: ${{ secrets.CODACY_PROJECT_TOKEN }} 87 | run: bash <(curl -Ls https://coverage.codacy.com/get.sh) final 88 | 89 | Aligo: 90 | name: Aligo 91 | runs-on: ubuntu-latest 92 | 93 | needs: Go 94 | 95 | steps: 96 | - name: Checkout 97 | uses: actions/checkout@v4 98 | 99 | - name: Set up Go 100 | uses: actions/setup-go@v5 101 | with: 102 | go-version: 'stable' 103 | 104 | - name: Download dependencies 105 | run: make deps 106 | 107 | - name: Check Golang sources with Aligo 108 | uses: essentialkaos/aligo-action@v2 109 | continue-on-error: true 110 | with: 111 | files: ./... 112 | 113 | Typos: 114 | name: Typos 115 | runs-on: ubuntu-latest 116 | 117 | needs: Go 118 | 119 | steps: 120 | - name: Checkout 121 | uses: actions/checkout@v4 122 | 123 | - name: Check spelling 124 | uses: crate-ci/typos@master 125 | continue-on-error: true 126 | -------------------------------------------------------------------------------- /.github/workflows/codeql.yml: -------------------------------------------------------------------------------- 1 | name: "CodeQL" 2 | 3 | on: 4 | push: 5 | branches: [master, develop] 6 | pull_request: 7 | branches: [master] 8 | schedule: 9 | - cron: '0 3 * * */2' 10 | 11 | permissions: 12 | security-events: write 13 | actions: read 14 | contents: read 15 | 16 | jobs: 17 | analyse: 18 | name: Analyse 19 | runs-on: ubuntu-latest 20 | 21 | steps: 22 | - name: Checkout repository 23 | uses: actions/checkout@v4 24 | with: 25 | fetch-depth: 2 26 | 27 | - name: Initialize CodeQL 28 | uses: github/codeql-action/init@v3 29 | with: 30 | languages: go 31 | 32 | - name: Perform CodeQL Analysis 33 | uses: github/codeql-action/analyze@v3 34 | -------------------------------------------------------------------------------- /.github/workflows/godoc.yml: -------------------------------------------------------------------------------- 1 | name: GoDoc 2 | 3 | on: 4 | create 5 | 6 | jobs: 7 | GoDoc: 8 | name: Generate docs 9 | runs-on: ubuntu-latest 10 | 11 | steps: 12 | - name: Trigger GoSumDB and PkgGoDev 13 | uses: essentialkaos/godoc-action@v1 14 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | Verdana.ttf 2 | -------------------------------------------------------------------------------- /.typos.toml: -------------------------------------------------------------------------------- 1 | [files] 2 | extend-exclude = ["go.sum"] 3 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright 2020 ESSENTIAL KAOS 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | -------------------------------------------------------------------------------- /Makefile: -------------------------------------------------------------------------------- 1 | ################################################################################ 2 | 3 | # This Makefile generated by GoMakeGen 3.3.1 using next command: 4 | # gomakegen --mod . 5 | # 6 | # More info: https://kaos.sh/gomakegen 7 | 8 | ################################################################################ 9 | 10 | ifdef VERBOSE ## Print verbose information (Flag) 11 | VERBOSE_FLAG = -v 12 | endif 13 | 14 | ifdef PROXY ## Force proxy usage for downloading dependencies (Flag) 15 | export GOPROXY=https://proxy.golang.org/cached-only,direct 16 | endif 17 | 18 | ifdef CGO ## Enable CGO usage (Flag) 19 | export CGO_ENABLED=1 20 | else 21 | export CGO_ENABLED=0 22 | endif 23 | 24 | MAKEDIR = $(dir $(realpath $(firstword $(MAKEFILE_LIST)))) 25 | GITREV ?= $(shell test -s $(MAKEDIR)/.git && git rev-parse --short HEAD) 26 | 27 | ################################################################################ 28 | 29 | .DEFAULT_GOAL := help 30 | .PHONY = fmt vet deps update test init vendor tidy mod-init mod-update mod-download mod-vendor help 31 | 32 | ################################################################################ 33 | 34 | init: mod-init ## Initialize new module 35 | 36 | deps: mod-download ## Download dependencies 37 | 38 | update: mod-update ## Update dependencies to the latest versions 39 | 40 | vendor: mod-vendor ## Make vendored copy of dependencies 41 | 42 | test: ## Run tests 43 | @echo "[36;1mStarting tests…[0m" 44 | ifdef COVERAGE_FILE ## Save coverage data into file (String) 45 | @go test $(VERBOSE_FLAG) -covermode=count -coverprofile=$(COVERAGE_FILE) ./. 46 | else 47 | @go test $(VERBOSE_FLAG) -covermode=count . 48 | endif 49 | 50 | tidy: ## Cleanup dependencies 51 | @echo "[32m•[0m[90m•[0m [36;1mTidying up dependencies…[0m" 52 | ifdef COMPAT ## Compatible Go version (String) 53 | @go mod tidy $(VERBOSE_FLAG) -compat=$(COMPAT) -go=$(COMPAT) 54 | else 55 | @go mod tidy $(VERBOSE_FLAG) 56 | endif 57 | @echo "[32m••[0m [36;1mUpdating vendored dependencies…[0m" 58 | @test -d vendor && rm -rf vendor && go mod vendor $(VERBOSE_FLAG) || : 59 | 60 | mod-init: 61 | @echo "[32m•[0m[90m••[0m [36;1mModules initialization…[0m" 62 | @rm -f go.mod go.sum 63 | ifdef MODULE_PATH ## Module path for initialization (String) 64 | @go mod init $(MODULE_PATH) 65 | else 66 | @go mod init 67 | endif 68 | 69 | @echo "[32m••[0m[90m•[0m [36;1mDependencies cleanup…[0m" 70 | ifdef COMPAT ## Compatible Go version (String) 71 | @go mod tidy $(VERBOSE_FLAG) -compat=$(COMPAT) -go=$(COMPAT) 72 | else 73 | @go mod tidy $(VERBOSE_FLAG) 74 | endif 75 | @echo "[32m•••[0m [36;1mStripping toolchain info…[0m" 76 | @grep -q 'toolchain ' go.mod && go mod edit -toolchain=none || : 77 | 78 | mod-update: 79 | @echo "[32m•[0m[90m•••[0m [36;1mUpdating dependencies…[0m" 80 | ifdef UPDATE_ALL ## Update all dependencies (Flag) 81 | @go get -u $(VERBOSE_FLAG) all 82 | else 83 | @go get -u $(VERBOSE_FLAG) ./... 84 | endif 85 | 86 | @echo "[32m••[0m[90m••[0m [36;1mStripping toolchain info…[0m" 87 | @grep -q 'toolchain ' go.mod && go mod edit -toolchain=none || : 88 | 89 | @echo "[32m•••[0m[90m•[0m [36;1mDependencies cleanup…[0m" 90 | ifdef COMPAT 91 | @go mod tidy $(VERBOSE_FLAG) -compat=$(COMPAT) 92 | else 93 | @go mod tidy $(VERBOSE_FLAG) 94 | endif 95 | 96 | @echo "[32m••••[0m [36;1mUpdating vendored dependencies…[0m" 97 | @test -d vendor && rm -rf vendor && go mod vendor $(VERBOSE_FLAG) || : 98 | 99 | mod-download: 100 | @echo "[36;1mDownloading dependencies…[0m" 101 | @go mod download 102 | 103 | mod-vendor: 104 | @echo "[36;1mVendoring dependencies…[0m" 105 | @rm -rf vendor && go mod vendor $(VERBOSE_FLAG) || : 106 | 107 | fmt: ## Format source code with gofmt 108 | @echo "[36;1mFormatting sources…[0m" 109 | @find . -name "*.go" -exec gofmt -s -w {} \; 110 | 111 | vet: ## Runs 'go vet' over sources 112 | @echo "[36;1mRunning 'go vet' over sources…[0m" 113 | @go vet -composites=false -printfuncs=LPrintf,TLPrintf,TPrintf,log.Debug,log.Info,log.Warn,log.Error,log.Critical,log.Print ./... 114 | 115 | help: ## Show this info 116 | @echo -e '\n\033[1mTargets:\033[0m\n' 117 | @grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) \ 118 | | awk 'BEGIN {FS = ":.*?## "}; {printf " \033[33m%-6s\033[0m %s\n", $$1, $$2}' 119 | @echo -e '\n\033[1mVariables:\033[0m\n' 120 | @grep -E '^ifdef [A-Z_]+ .*?## .*$$' $(abspath $(lastword $(MAKEFILE_LIST))) \ 121 | | sed 's/ifdef //' \ 122 | | sort -h \ 123 | | awk 'BEGIN {FS = " .*?## "}; {printf " \033[32m%-13s\033[0m %s\n", $$1, $$2}' 124 | @echo -e '' 125 | @echo -e '\033[90mGenerated by GoMakeGen 3.3.1\033[0m\n' 126 | 127 | ################################################################################ 128 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |
2 | 3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
Usage example • Examples • CI Status • Contributing • Thanks • License
14 | 15 |