{"id":13564301,"url":"https://github.com/okp4/template-go","last_synced_at":"2025-04-03T21:30:37.486Z","repository":{"id":49402771,"uuid":"486094149","full_name":"okp4/template-go","owner":"okp4","description":"🖨 Template for Golang projects @okp4.","archived":false,"fork":false,"pushed_at":"2024-04-25T09:18:20.000Z","size":255,"stargazers_count":8,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-04T17:47:19.755Z","etag":null,"topics":["golang","open-source","template-repository"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/okp4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-04-27T07:41:40.000Z","updated_at":"2024-10-08T06:02:23.000Z","dependencies_parsed_at":"2023-02-17T18:10:20.758Z","dependency_job_id":"f5fd3009-63e6-41e5-9e40-641d841723e9","html_url":"https://github.com/okp4/template-go","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":"okp4/template-oss","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/okp4%2Ftemplate-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/okp4%2Ftemplate-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/okp4%2Ftemplate-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/okp4%2Ftemplate-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/okp4","download_url":"https://codeload.github.com/okp4/template-go/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247082901,"owners_count":20880739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang","open-source","template-repository"],"created_at":"2024-08-01T13:01:29.441Z","updated_at":"2025-04-03T21:30:37.051Z","avatar_url":"https://github.com/okp4.png","language":"Go","readme":"# Golang Template\n\n\u003e Template for golang projects @okp4.\n\n[![version](https://img.shields.io/github/v/release/okp4/template-go?style=for-the-badge\u0026logo=github)](https://github.com/okp4/template-go/releases)\n[![lint](https://img.shields.io/github/actions/workflow/status/okp4/template-go/lint.yml?branch=main\u0026label=lint\u0026style=for-the-badge\u0026logo=github)](https://github.com/okp4/template-go/actions/workflows/lint.yml)\n[![build](https://img.shields.io/github/actions/workflow/status/okp4/template-go/build.yml?branch=main\u0026label=build\u0026style=for-the-badge\u0026logo=github)](https://github.com/okp4/template-go/actions/workflows/build.yml)\n[![test](https://img.shields.io/github/actions/workflow/status/okp4/template-go/test.yml?branch=main\u0026label=test\u0026style=for-the-badge\u0026logo=github)](https://github.com/okp4/template-go/actions/workflows/test.yml)\n[![codecov](https://img.shields.io/codecov/c/github/okp4/template-go?style=for-the-badge\u0026token=6NL9ICGZQS\u0026logo=codecov)](https://codecov.io/gh/okp4/template-go)\n[![conventional commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?style=for-the-badge\u0026logo=conventionalcommits)](https://conventionalcommits.org)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge)](https://github.com/semantic-release/semantic-release)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg?style=for-the-badge)](https://github.com/okp4/.github/blob/main/CODE_OF_CONDUCT.md)\n[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg?style=for-the-badge)](https://opensource.org/licenses/BSD-3-Clause)\n\n## Purpose \u0026 Philosophy\n\nThis repository holds the template for building Golang projects with a consistent set of standards accros all [OKP4](https://github.com/okp4) projects. We are convinced that the quality of the code depends on clear and consistent coding conventions, with an automated enforcement (CI).\n\nThis way, the template promotes:\n\n- the use of [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/), [semantic versioning](https://semver.org/) and [semantic releasing](https://github.com/cycjimmy/semantic-release-action) which automates the whole package release workflow including: determining the next version number, generating the release notes, and publishing the artifacts (project tarball, docker images, etc.)\n- unit testing\n- linting via [golangci-lint](https://github.com/golangci/golangci-lint)\n- a uniformed way of building the project for several platforms via a Makefile using a docker image\n\n## How to use\n\n\u003e 🚨 do not fork this repository as it is a [template repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template)\n\n1. Click on [Use this template](https://github.com/okp4/template-go/generate)\n2. Give a name to your project\n3. Wait until the first run of CI finishes\n4. Clone your new project and happy coding!\n\n## Prerequisites\n\n- Be sure you have [Golang](https://go.dev/doc/install) installed.\n- [Docker](https://docs.docker.com/engine/install/) as well if you want to use the Makefile.\n\n## Build\n\n```sh\nmake build\n```\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fokp4%2Ftemplate-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fokp4%2Ftemplate-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fokp4%2Ftemplate-go/lists"}