Merge pull request #300 from devfeel/develop

v1.8.1 - Quality Improvement Release

Author: devfeel

.github/workflows/test.yml

@@ -0,0 +1,57 @@
+name: Test
+
+on:
+  push:
+    branches: [ aicode, master, develop ]
+  pull_request:
+    branches: [ aicode, master ]
+
+jobs:
+  test:
+    name: Test with Go ${{ matrix.go-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        go-version: ['1.21', '1.22', '1.23']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup 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 go vet
+        run: go vet ./...
+
+      - name: Run tests
+        run: go test ./... -v -coverprofile=coverage.out
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: matrix.go-version == '1.22'
+        with:
+          files: ./coverage.out
+          flags: unittests
+          fail_ci_if_error: false
+
+      - name: Generate coverage report
+        if: matrix.go-version == '1.22'
+        run: |
+          go tool cover -func=coverage.out
+          echo "## Test Coverage Report" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          go tool cover -func=coverage.out >> $GITHUB_STEP_SUMMARY

.gitignore

@@ -0,0 +1,33 @@
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool
+*.out
+coverage.out
+coverage.html
+
+# Dependency directories
+vendor/
+
+# Go workspace file
+go.work
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+example/group/group_test

TESTING.md

@@ -0,0 +1,62 @@
+# Test Coverage Improvement Plan
+
+## Current Status (2026-03-04)
+
+### Test Coverage Summary
+- **Overall**: 19.0%
+- **Core Modules**: ~25% (needs improvement)
+- **Router**: ~11% (critical)
+- **Tree**: ~10% (critical)
+- **Upload**: 0% (no tests)
+- **Session**: 23.5%
+- **JSON**: 77.8% ✅
+- **String**: 78.6% ✅
+
+## Goals
+
+### Phase 1: Core Testing (Target: 35%+)
+- [ ] Add router_test.go tests
+- [ ] Add tree_test.go tests  
+- [ ] Add uploadfile_test.go tests
+- [ ] Improve group_test.go coverage
+
+### Phase 2: Edge Cases (Target: 45%+)
+- [ ] Route conflict tests
+- [ ] Parameter parsing edge cases
+- [ ] Session concurrent tests
+- [ ] Middleware chain tests
+
+### Phase 3: Benchmarks
+- [ ] Router matching benchmarks
+- [ ] Session read/write benchmarks
+- [ ] Middleware chain benchmarks
+
+## Running Tests
+
+```bash
+# Run all tests with coverage
+go test ./... -coverprofile=coverage.out
+
+# View coverage report
+go tool cover -func=coverage.out
+
+# Generate HTML coverage report
+go tool cover -html=coverage.out -o coverage.html
+```
+
+## Test Naming Convention
+
+```
+Test<FunctionName>_<Scenario>_<ExpectedResult>
+
+Examples:
+- TestRouter_AddRoute_ValidPath_Success
+- TestRouter_AddRoute_EmptyPath_Error
+- TestGroup_Use_MiddlewareChain_Order
+```
+
+## CI Integration
+
+GitHub Actions workflow in `.github/workflows/test.yml` runs on:
+- Push to aicode, master branches
+- Pull requests