feat: add ci/cd 相关脚本

Author: guonaihong

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Environment (please complete the following information):**
+ - OS: [e.g. Ubuntu 20.04, macOS 12.0]
+ - Go Version: [e.g. 1.21.0]
+ - Pulse Version: [e.g. v1.0.0]
+
+**Additional context**
+Add any other context about the problem here.
+
+**Code sample**
+If applicable, add code sample to help explain your problem.
+
+```go
+// Your code here
+``` 

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: 'enhancement'
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here. 

.github/workflows/ci.yml

@@ -0,0 +1,74 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        go-version: [1.21, 1.22, 1.23]
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Go
+      uses: actions/setup-go@v5
+      with:
+        go-version: ${{ matrix.go-version }}
+    
+    - name: Cache go modules
+      uses: actions/cache@v4
+      with:
+        path: ~/go/pkg/mod
+        key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
+        restore-keys: |
+          ${{ runner.os }}-go-
+    
+    - name: Download dependencies
+      run: go mod download
+    
+    - name: Run tests
+      run: go test -race -coverprofile=coverage.out -covermode=atomic . ./core/...
+    
+    - name: Upload coverage to Codecov
+      if: matrix.os == 'ubuntu-latest' && matrix.go-version == '1.23'
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.out
+        token: ${{ secrets.CODECOV_TOKEN }}
+        fail_ci_if_error: false
+    
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Go
+      uses: actions/setup-go@v5
+      with:
+        go-version: '1.23'
+    
+    - name: golangci-lint
+      uses: golangci/golangci-lint-action@v6
+      with:
+        version: latest
+        args: --timeout=5m --skip-dirs=example --skip-dirs=cpu
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Go
+      uses: actions/setup-go@v5
+      with:
+        go-version: '1.23'
+    
+    - name: Build
+      run: go build . 

.golangci.yml

@@ -0,0 +1,47 @@
+run:
+  timeout: 5m
+
+linters:
+  enable:
+    - gofmt
+    - golint
+    - govet
+    - errcheck
+    - staticcheck
+    - unused
+    - gosimple
+    - structcheck
+    - varcheck
+    - ineffassign
+    - deadcode
+    - typecheck
+    - gosec
+    - gocyclo
+    - dupl
+    - misspell
+    - unparam
+    - unconvert
+    - goconst
+    - gocognit
+    - asciicheck
+    - gofumpt
+    - goimports
+    - revive
+
+linters-settings:
+  gocyclo:
+    min-complexity: 15
+  goconst:
+    min-len: 2
+    min-occurrences: 2
+  misspell:
+    locale: US
+  revive:
+    min-confidence: 8
+
+issues:
+  exclude-use-default: false
+  exclude:
+    # for "revive" linter
+    - "should have comment"
+    - "comment on exported" 

CONTRIBUTING.md

@@ -0,0 +1,82 @@
+# Contributing to Pulse
+
+感谢您对Pulse项目的贡献！本文档将帮助您了解如何为项目做贡献。
+
+## 开发流程
+
+### 1. Fork和Clone
+
+```bash
+# Fork项目到您的GitHub账户
+# 然后Clone到本地
+git clone https://github.com/YOUR_USERNAME/pulse.git
+cd pulse
+```
+
+### 2. 创建分支
+
+```bash
+git checkout -b feature/your-feature-name
+```
+
+### 3. 开发和测试
+
+在开发过程中，请确保：
+
+- 编写清晰的代码和注释
+- 添加必要的测试用例
+- 运行测试确保通过
+
+```bash
+# 运行测试
+make test
+
+# 运行测试并生成覆盖率报告
+make test-coverage
+
+# 运行代码检查
+make lint
+```
+
+### 4. 提交代码
+
+```bash
+git add .
+git commit -m "feat: add your feature description"
+git push origin feature/your-feature-name
+```
+
+### 5. 创建Pull Request
+
+- 创建PR并填写详细的描述
+- 确保所有CI检查通过
+- 等待代码审查
+
+## CI/CD 流程
+
+项目使用GitHub Actions进行持续集成，包括：
+
+- **测试**：在多个Go版本(1.21, 1.22, 1.23)和操作系统(Ubuntu, macOS)上运行测试
+- **代码检查**：使用golangci-lint进行代码质量检查
+- **覆盖率**：生成测试覆盖率报告并上传到Codecov
+- **构建**：验证代码可以正常构建
+
+## 代码规范
+
+- 遵循Go官方代码规范
+- 使用`gofmt`格式化代码
+- 通过`golangci-lint`检查
+- 为新功能添加测试用例
+- 保持测试覆盖率
+
+## 报告问题
+
+如果您发现bug或有功能建议：
+
+1. 搜索现有的issues，避免重复
+2. 使用适当的issue模板
+3. 提供详细的描述和复现步骤
+
+## 许可证
+
+通过贡献代码，您同意您的贡献将在Apache 2.0许可证下发布。 

Makefile

@@ -1,9 +1,28 @@
 # Makefile for building pulse examples for macOS, Linux and Windows
-.PHONY: all clean mac linux windows examples mac-race linux-race windows-race
+.PHONY: all clean mac linux windows examples mac-race linux-race windows-race test test-coverage ci-test lint
 
 # Default target
 all: examples
 
+# Test and CI targets
+test:
+	@echo "Running tests..."
+	go test -v -race ./...
+
+test-coverage:
+	@echo "Running tests with coverage..."
+	go test -race -coverprofile=coverage.out -covermode=atomic . ./core/...
+	go tool cover -html=coverage.out -o coverage.html
+	@echo "Coverage report generated: coverage.html"
+
+ci-test:
+	@echo "Running CI tests..."
+	go test -race -coverprofile=coverage.out -covermode=atomic . ./core/...
+
+lint:
+	@echo "Running linter..."
+	golangci-lint run --timeout=5m --skip-dirs=example --skip-dirs=cpu
+
 # Directories
 EXAMPLE_DIR = example
 BIN_DIR = bin

README.md

@@ -1,4 +1,11 @@
 # pulse
+
+[![CI](https://github.com/antlabs/pulse/actions/workflows/ci.yml/badge.svg)](https://github.com/antlabs/pulse/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/antlabs/pulse/branch/master/graph/badge.svg)](https://codecov.io/gh/antlabs/pulse)
+[![Go Report Card](https://goreportcard.com/badge/github.com/antlabs/pulse)](https://goreportcard.com/report/github.com/antlabs/pulse)
+[![Go Reference](https://pkg.go.dev/badge/github.com/antlabs/pulse.svg)](https://pkg.go.dev/github.com/antlabs/pulse)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
 极简异步io库，速度很快，非常简单
 
 ## 特性

codecov.yml

@@ -0,0 +1,32 @@
+codecov:
+  require_ci_to_pass: yes
+
+coverage:
+  precision: 2
+  round: down
+  range: "70...100"
+  
+  status:
+    project:
+      default:
+        target: auto
+        threshold: 1%
+        informational: false
+    patch:
+      default:
+        target: auto
+        threshold: 1%
+        informational: false
+
+parsers:
+  gcov:
+    branch_detection:
+      conditional: yes
+      loop: yes
+      method: no
+      macro: no
+
+comment:
+  layout: "reach,diff,flags,tree"
+  behavior: default
+  require_changes: no