Add per-language coverage reporting

cuihairu · cuihairu · commit 1ddd35ec9b44 · 2026-01-02T08:51:33.000+08:00
diff --git a/.github/workflows/build-cpp.yml b/.github/workflows/build-cpp.yml
@@ -20,11 +20,24 @@ jobs:
       - name: Build
         if: steps.detect.outputs.present == 'true'
         run: |
-          cmake -S cpp -B cppbuild
+          cmake -S cpp -B cppbuild -DEPOCH_COVERAGE=ON
           cmake --build cppbuild
       - name: Test
         if: steps.detect.outputs.present == 'true'
         run: ctest --test-dir cppbuild --output-on-failure
+      - name: Coverage
+        if: steps.detect.outputs.present == 'true'
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install gcovr
+          gcovr -r . --object-directory cppbuild --xml-pretty -o cpp/coverage.xml --filter cpp
+      - name: Upload coverage
+        if: steps.detect.outputs.present == 'true'
+        uses: codecov/codecov-action@v4
+        with:
+          files: cpp/coverage.xml
+          flags: cpp
+          fail_ci_if_error: false
       - name: Skip (no C++ project yet)
         if: steps.detect.outputs.present != 'true'
         run: echo "No C++ sources yet."
diff --git a/.github/workflows/build-dotnet.yml b/.github/workflows/build-dotnet.yml
@@ -32,7 +32,14 @@ jobs:
           fi
       - name: Test
         if: steps.detect.outputs.present == 'true' && hashFiles('dotnet/Epoch.Tests/Epoch.Tests.csproj') != ''
-        run: dotnet run --project dotnet/Epoch.Tests/Epoch.Tests.csproj
+        run: dotnet test dotnet/Epoch.Tests/Epoch.Tests.csproj --collect:"XPlat Code Coverage"
+      - name: Upload coverage
+        if: steps.detect.outputs.present == 'true' && hashFiles('dotnet/Epoch.Tests/Epoch.Tests.csproj') != ''
+        uses: codecov/codecov-action@v4
+        with:
+          files: dotnet/Epoch.Tests/TestResults/**/coverage.cobertura.xml
+          flags: dotnet
+          fail_ci_if_error: false
       - name: Skip (no .NET project yet)
         if: steps.detect.outputs.present != 'true'
         run: echo "No .NET sources yet."
diff --git a/.github/workflows/build-go.yml b/.github/workflows/build-go.yml
@@ -26,7 +26,14 @@ jobs:
         if: steps.detect.outputs.present == 'true'
         run: |
           cd go
-          go test ./...
+          go test ./... -coverprofile=coverage.out
+      - name: Upload coverage
+        if: steps.detect.outputs.present == 'true'
+        uses: codecov/codecov-action@v4
+        with:
+          files: go/coverage.out
+          flags: go
+          fail_ci_if_error: false
       - name: Skip (no Go project yet)
         if: steps.detect.outputs.present != 'true'
         run: echo "No Go sources yet."
diff --git a/.github/workflows/build-java.yml b/.github/workflows/build-java.yml
@@ -23,8 +23,18 @@ jobs:
         with:
           distribution: temurin
           java-version: "17"
+      - name: Coverage (script)
+        if: steps.detect.outputs.present == 'true' && hashFiles('java/scripts/run-coverage.sh') != ''
+        run: java/scripts/run-coverage.sh
+      - name: Upload coverage
+        if: steps.detect.outputs.present == 'true' && hashFiles('java/scripts/run-coverage.sh') != ''
+        uses: codecov/codecov-action@v4
+        with:
+          files: java/target/jacoco.xml
+          flags: java
+          fail_ci_if_error: false
       - name: Test (script)
-        if: steps.detect.outputs.present == 'true' && hashFiles('java/scripts/run-tests.sh') != ''
+        if: steps.detect.outputs.present == 'true' && hashFiles('java/scripts/run-coverage.sh') == '' && hashFiles('java/scripts/run-tests.sh') != ''
         run: java/scripts/run-tests.sh
       - name: Build (Gradle)
         if: steps.detect.outputs.present == 'true' && hashFiles('java/scripts/run-tests.sh') == '' && hashFiles('java/gradlew') != ''
diff --git a/.github/workflows/build-node.yml b/.github/workflows/build-node.yml
@@ -28,6 +28,13 @@ jobs:
           cd node
           npm install --no-package-lock
           npm test
+      - name: Upload coverage
+        if: steps.detect.outputs.present == 'true'
+        uses: codecov/codecov-action@v4
+        with:
+          files: node/coverage/lcov.info
+          flags: node
+          fail_ci_if_error: false
       - name: Skip (no Node project yet)
         if: steps.detect.outputs.present != 'true'
         run: echo "No Node sources yet."
diff --git a/.github/workflows/build-python.yml b/.github/workflows/build-python.yml
@@ -26,7 +26,17 @@ jobs:
         if: steps.detect.outputs.present == 'true'
         run: |
           cd python
-          python -m unittest discover -s tests
+          python -m pip install --upgrade pip
+          python -m pip install coverage
+          coverage run -m unittest discover -s tests
+          coverage xml -o coverage.xml
+      - name: Upload coverage
+        if: steps.detect.outputs.present == 'true'
+        uses: codecov/codecov-action@v4
+        with:
+          files: python/coverage.xml
+          flags: python
+          fail_ci_if_error: false
       - name: Skip (no Python project yet)
         if: steps.detect.outputs.present != 'true'
         run: echo "No Python sources yet."
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -14,7 +14,9 @@ jobs:
           node-version: "22"
           cache: "pnpm"
       - name: Enable pnpm
-        run: corepack enable
+        run: |
+          corepack enable
+          corepack prepare pnpm@9.15.1 --activate
       - name: Install
         run: pnpm install --frozen-lockfile
       - name: Build
diff --git a/.gitignore b/.gitignore
@@ -62,6 +62,7 @@ node_modules/
 docs/.vuepress/dist/
 docs/.vuepress/cache/
 docs/.vuepress/temp/
+node/coverage/
 
 # Build outputs
 cppbuild/
@@ -70,6 +71,7 @@ dotnet/bin/
 dotnet/obj/
 dotnet/**/bin/
 dotnet/**/obj/
+dotnet/**/TestResults/
 python/__pycache__/
 python/**/__pycache__/
 python/.pytest_cache/
@@ -79,3 +81,8 @@ python/dist/
 python/*.egg-info/
 python/**/*.pyc
 .gocache/
+go/coverage.out
+cpp/coverage.xml
+java/target/jacoco.exec
+java/target/jacoco.xml
+python/coverage.xml
diff --git a/README.md b/README.md
@@ -20,14 +20,14 @@
 
 ## 支持语言
 
-| Language | Version | Build |
-|---|---|---|
-| ![C++](https://img.shields.io/badge/C%2B%2B-00599C?logo=c%2B%2B&logoColor=white) | C++17 | [![build-cpp](https://github.com/cuihairu/epoch/actions/workflows/build-cpp.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-cpp.yml) |
-| ![Java](https://img.shields.io/badge/Java-007396?logo=openjdk&logoColor=white) | Java 17 | [![build-java](https://github.com/cuihairu/epoch/actions/workflows/build-java.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-java.yml) |
-| ![.NET](https://img.shields.io/badge/.NET-512BD4?logo=dotnet&logoColor=white) | .NET 8.0 | [![build-dotnet](https://github.com/cuihairu/epoch/actions/workflows/build-dotnet.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-dotnet.yml) |
-| ![Go](https://img.shields.io/badge/Go-00ADD8?logo=go&logoColor=white) | Go 1.24 | [![build-go](https://github.com/cuihairu/epoch/actions/workflows/build-go.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-go.yml) |
-| ![Node.js](https://img.shields.io/badge/Node.js-339933?logo=node.js&logoColor=white) | Node.js 22 | [![build-node](https://github.com/cuihairu/epoch/actions/workflows/build-node.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-node.yml) |
-| ![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white) | Python 3.12 | [![build-python](https://github.com/cuihairu/epoch/actions/workflows/build-python.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-python.yml) |
+| Language | Version | Build | Coverage |
+|---|---|---|---|
+| ![C++](https://img.shields.io/badge/C%2B%2B-00599C?logo=c%2B%2B&logoColor=white) | C++17 | [![build-cpp](https://github.com/cuihairu/epoch/actions/workflows/build-cpp.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-cpp.yml) | [![codecov](https://codecov.io/gh/cuihairu/epoch/branch/main/graph/badge.svg?flag=cpp)](https://codecov.io/gh/cuihairu/epoch) |
+| ![Java](https://img.shields.io/badge/Java-007396?logo=openjdk&logoColor=white) | Java 17 | [![build-java](https://github.com/cuihairu/epoch/actions/workflows/build-java.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-java.yml) | [![codecov](https://codecov.io/gh/cuihairu/epoch/branch/main/graph/badge.svg?flag=java)](https://codecov.io/gh/cuihairu/epoch) |
+| ![.NET](https://img.shields.io/badge/.NET-512BD4?logo=dotnet&logoColor=white) | .NET 8.0 | [![build-dotnet](https://github.com/cuihairu/epoch/actions/workflows/build-dotnet.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-dotnet.yml) | [![codecov](https://codecov.io/gh/cuihairu/epoch/branch/main/graph/badge.svg?flag=dotnet)](https://codecov.io/gh/cuihairu/epoch) |
+| ![Go](https://img.shields.io/badge/Go-00ADD8?logo=go&logoColor=white) | Go 1.24 | [![build-go](https://github.com/cuihairu/epoch/actions/workflows/build-go.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-go.yml) | [![codecov](https://codecov.io/gh/cuihairu/epoch/branch/main/graph/badge.svg?flag=go)](https://codecov.io/gh/cuihairu/epoch) |
+| ![Node.js](https://img.shields.io/badge/Node.js-339933?logo=node.js&logoColor=white) | Node.js 22 | [![build-node](https://github.com/cuihairu/epoch/actions/workflows/build-node.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-node.yml) | [![codecov](https://codecov.io/gh/cuihairu/epoch/branch/main/graph/badge.svg?flag=node)](https://codecov.io/gh/cuihairu/epoch) |
+| ![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white) | Python 3.12 | [![build-python](https://github.com/cuihairu/epoch/actions/workflows/build-python.yml/badge.svg)](https://github.com/cuihairu/epoch/actions/workflows/build-python.yml) | [![codecov](https://codecov.io/gh/cuihairu/epoch/branch/main/graph/badge.svg?flag=python)](https://codecov.io/gh/cuihairu/epoch) |
 
 ## 文档
 - 概念与设计：`docs/guide/concepts.md`
diff --git a/codecov.yml b/codecov.yml
@@ -0,0 +1,28 @@
+coverage:
+  status:
+    project:
+      default:
+        target: 0
+    patch:
+      default:
+        target: 0
+
+flags:
+  cpp:
+    paths:
+      - cpp/
+  java:
+    paths:
+      - java/
+  dotnet:
+    paths:
+      - dotnet/
+  go:
+    paths:
+      - go/
+  node:
+    paths:
+      - node/
+  python:
+    paths:
+      - python/
diff --git a/cpp/CMakeLists.txt b/cpp/CMakeLists.txt
@@ -11,3 +11,11 @@ enable_testing()
 add_executable(epoch_cpp_test tests/epoch_vector_test.cpp)
 target_link_libraries(epoch_cpp_test PRIVATE epoch_cpp)
 add_test(NAME epoch_cpp_vector COMMAND epoch_cpp_test)
+
+option(EPOCH_COVERAGE "Enable coverage instrumentation" OFF)
+if (EPOCH_COVERAGE)
+    foreach(target epoch_cpp epoch_cpp_test)
+        target_compile_options(${target} PRIVATE -O0 -g --coverage)
+        target_link_options(${target} PRIVATE --coverage)
+    endforeach()
+endif()
diff --git a/dotnet/Epoch.Tests/Epoch.Tests.csproj b/dotnet/Epoch.Tests/Epoch.Tests.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <OutputType>Exe</OutputType>
     <TargetFramework>net8.0</TargetFramework>
+    <IsTestProject>true</IsTestProject>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
   </PropertyGroup>
@@ -10,4 +10,11 @@
     <ProjectReference Include="..\Epoch.csproj" />
   </ItemGroup>
 
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.10.0" />
+    <PackageReference Include="xunit" Version="2.8.1" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.8.1" />
+    <PackageReference Include="coverlet.collector" Version="6.0.2" />
+  </ItemGroup>
+
 </Project>
diff --git a/dotnet/Epoch.Tests/Program.cs b/dotnet/Epoch.Tests/Program.cs
diff --git a/dotnet/Epoch.Tests/VectorTests.cs b/dotnet/Epoch.Tests/VectorTests.cs
@@ -0,0 +1,81 @@
+using System.Globalization;
+using Epoch;
+using Xunit;
+
+namespace Epoch.Tests;
+
+public class VectorTests
+{
+    [Fact]
+    public void VectorMatchesExpected()
+    {
+        var vectorPath = LocateVectorFile();
+        var messages = new List<Message>();
+        var expected = new List<Expected>();
+
+        foreach (var line in File.ReadAllLines(vectorPath))
+        {
+            if (string.IsNullOrWhiteSpace(line) || line.StartsWith("#", StringComparison.Ordinal))
+            {
+                continue;
+            }
+            var parts = line.Split(',');
+            if (parts.Length == 0)
+            {
+                continue;
+            }
+            if (parts[0] == "M" && parts.Length == 7)
+            {
+                messages.Add(new Message(
+                    long.Parse(parts[1], CultureInfo.InvariantCulture),
+                    long.Parse(parts[2], CultureInfo.InvariantCulture),
+                    long.Parse(parts[3], CultureInfo.InvariantCulture),
+                    long.Parse(parts[4], CultureInfo.InvariantCulture),
+                    long.Parse(parts[5], CultureInfo.InvariantCulture),
+                    long.Parse(parts[6], CultureInfo.InvariantCulture)
+                ));
+            }
+            else if (parts[0] == "E" && parts.Length == 4)
+            {
+                expected.Add(new Expected(
+                    long.Parse(parts[1], CultureInfo.InvariantCulture),
+                    long.Parse(parts[2], CultureInfo.InvariantCulture),
+                    parts[3]
+                ));
+            }
+        }
+
+        var results = Engine.ProcessMessages(messages);
+        Assert.Equal(expected.Count, results.Count);
+        for (var i = 0; i < expected.Count; i++)
+        {
+            var exp = expected[i];
+            var res = results[i];
+            Assert.Equal(exp.Epoch, res.Epoch);
+            Assert.Equal(exp.State, res.State);
+            Assert.Equal(exp.Hash, res.Hash);
+        }
+    }
+
+    private static string LocateVectorFile()
+    {
+        var current = Directory.GetCurrentDirectory();
+        for (var i = 0; i < 6; i++)
+        {
+            var candidate = Path.Combine(current, "test-vectors", "epoch_vector_v1.txt");
+            if (File.Exists(candidate))
+            {
+                return candidate;
+            }
+            var parent = Directory.GetParent(current);
+            if (parent == null)
+            {
+                break;
+            }
+            current = parent.FullName;
+        }
+        throw new InvalidOperationException("Vector file not found");
+    }
+
+    private record Expected(long Epoch, long State, string Hash);
+}
diff --git a/java/scripts/run-coverage.sh b/java/scripts/run-coverage.sh
diff --git a/node/package.json b/node/package.json
