damarowen / consumer-kafka Goto Github PK

lorem ipsum abracadabra, make some a noise..

• Go 1.19+
• Docker (Developed with version 20.+)
• Taskfile Task runner or Build tool.
• golangci golang linter.
• entgo ORM adapter with sql engine, mysql, postgresql and sqlite.
• For Changelog using git-chglog

Create an env file development by copying the given example.

$ cp .env.defaultexample .env

• We use conventional commits to deal with git commits: https://www.conventionalcommits.org

  • Use feat: commit message to do git commit related to feature.
  • Use refactor: commit message to do git commit related to code refactorings.
  • Use fix: commit message to do git commit related to bugfix.
  • Use test: commit message to do git commit related to test files.
  • Use docs: commit message to do git commit related to documentations (including README.md files).
  • Use style: commit message to do git commit related to code style.

• Use git-chglog https://github.com/git-chglog/git-chglog to generate changelog (CHANGELOG.md) before merging to release branch.

• Keep your branch strategy simple. Build your strategy from these three concepts:
  • Use feature branches for all new features and bug fixes.
  • Merge feature branches into the main branch using pull requests.
  • Keep a high quality, up-to-date main branch.

Develop your features and fix bugs in feature branches based off your main branch. These branches are also known as topic branches. Feature branches isolate work in progress from the completed work in the main branch. Git branches are inexpensive to create and maintain. Even small fixes and changes should have their own feature branch.

• Use a consistent naming convention for your feature branches to identify the work done in the branch. You can also include other information in the branch name, such as who created the branch.

• Some suggestions for naming your feature branches:

  • users/username/description
  • users/username/workitem
  • bugfix/description
  • feature/feature-name
  • feature/feature-area/feature-name
  • hotfix/description

• Create a release branch from the main branch when you get close to your release or other milestone, such as the end of a sprint. Give this branch a clear name associating it with the release, for example release/20.
• Create branches to fix bugs from the release branch and merge them back into the release branch in a pull request

$ task dev

$ task test

$ task lint

• chi lightweight, idiomatic and composable router for building Go HTTP services.
• ent. An entity framework for Go,
• openTelemetry High-quality, ubiquitous, and portable telemetry to enable effective observability.
• zerolog Zero Allocation JSON Logger.

• Nanang Suryadi - Creator and Initial work - @Suryakencana07

See also the list of maintainer who participated in this project.

See also the guide to contributing.

This project under the Apache License - see the LICENSE file for details.