Refactor(index): remove unused keys, 0-based depth, and add CI workflows

.github/workflows/release-cpp.yml

@@ -27,7 +27,7 @@ jobs:
       - name: Install Go
         uses: actions/setup-go@v5
         with:
-          go-version: "1.20.x"
+          go-version: "1.21.x"
 
       - name: Download dependencies
         run: |
@@ -59,4 +59,4 @@ jobs:
           upload_url: ${{ github.event.release.upload_url }}
           asset_path: ./${{ steps.package.outputs.name }}
           asset_name: ${{ steps.package.outputs.name }}
-          asset_content_type: application/gzip
+          asset_content_type: application/gzip

.github/workflows/release-go.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Install Go
         uses: actions/setup-go@v5
         with:
-          go-version: "1.20.x"
+          go-version: "1.21.x"
 
       - name: Download dependencies
         run: |
@@ -58,4 +58,4 @@ jobs:
           upload_url: ${{ github.event.release.upload_url }}
           asset_path: ./${{ steps.package.outputs.name }}
           asset_name: ${{ steps.package.outputs.name }}
-          asset_content_type: application/gzip
+          asset_content_type: application/gzip

.github/workflows/testing-cpp.yml

@@ -0,0 +1,72 @@
+name: Testing C++
+
+# Trigger on pushes, PRs (excluding documentation changes), and nightly.
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+  schedule:
+    - cron: 0 0 * * * # daily at 00:00
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            gen_script: bash gen.sh
+            cmake_config: cmake -S . -B build -G "Ninja" -DCMAKE_BUILD_TYPE=Debug
+            run_loader: ./bin/loader
+          - os: windows-latest
+            gen_script: cmd /c gen.bat
+            cmake_config: cmake -S . -B build -G "Ninja" -DCMAKE_BUILD_TYPE=Debug
+            run_loader: .\bin\loader.exe
+
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Install Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: 1.21.x
+          cache: true
+
+      - name: Install dependencies (Ubuntu)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y cmake ninja-build
+
+      - name: Install dependencies (Windows)
+        if: runner.os == 'Windows'
+        run: choco install cmake ninja -y
+
+      - name: Setup MSVC (Windows)
+        if: runner.os == 'Windows'
+        uses: ilammy/msvc-dev-cmd@v1
+
+      - name: Init submodules and build protobuf
+        shell: bash
+        run: bash init.sh
+
+      - name: Generate protoconf
+        working-directory: test/cpp-tableau-loader
+        run: ${{ matrix.gen_script }}
+
+      - name: CMake Configure
+        working-directory: test/cpp-tableau-loader
+        run: ${{ matrix.cmake_config }}
+
+      - name: CMake Build
+        working-directory: test/cpp-tableau-loader
+        run: cmake --build build --parallel
+
+      - name: Run loader
+        working-directory: test/cpp-tableau-loader
+        run: ${{ matrix.run_loader }}

.github/workflows/testing-go.yml

@@ -0,0 +1,64 @@
+name: Testing Go
+
+# Trigger on pushes, PRs (excluding documentation changes), and nightly.
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+  schedule:
+    - cron: 0 0 * * * # daily at 00:00
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        go-version: [1.21.x]
+        os: [ubuntu-latest, windows-latest]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v6
+
+      - name: Install Go
+        uses: actions/setup-go@v6
+        with:
+          go-version: ${{ matrix.go-version }}
+          cache: true
+
+      - name: Install Protoc
+        uses: arduino/setup-protoc@v3
+        with:
+          version: "23.x"
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install protoc-gen-go
+        run: go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.34.2
+
+      - name: Init Git submodules
+        run: git submodule update --init --recursive
+
+      - name: Generate protoconf
+        shell: bash
+        run: PROTOC=protoc bash test/go-tableau-loader/gen.sh
+
+      - name: Vet
+        run: go vet ./...
+
+      - name: Unittest
+        run: go test -v -timeout 30m -race ./... -coverprofile=coverage.txt -covermode=atomic
+
+      - name: Run loader
+        working-directory: test/go-tableau-loader
+        run: go run .
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: tableauio/loader

.gitignore

@@ -42,3 +42,4 @@ cmd/protoc-gen-go-tableau-loader/protoc-gen-go-tableau-loader
 
 test/go-tableau-loader/go-tableau-loader
 _lab/ts/src/protoconf
+coverage.txt

README.md

@@ -34,7 +34,7 @@ The official config loader for [Tableau](https://github.com/tableauio/tableau).
   - C++17: `cmake -S . -B build`
   - C++20: `cmake -S . -B build -DCMAKE_CXX_STANDARD=20`
   - clang: `cmake -S . -B build -DCMAKE_CXX_COMPILER=clang++`
-- Build: `cmake --build build -j16`
+- Build: `cmake --build build --parallel`
 - Run: `./bin/loader`
 
 ### Dev at Windows
@@ -44,7 +44,7 @@ The official config loader for [Tableau](https://github.com/tableauio/tableau).
 - CMake:
   - C++17: `cmake -S . -B build -G "NMake Makefiles"`
   - C++20: `cmake -S . -B build -G "NMake Makefiles" -DCMAKE_CXX_STANDARD=20`
-- Build: `cmake --build build`
+- Build: `cmake --build build --parallel`
 - Run: `.\bin\loader.exe`
 
 ### References
@@ -58,7 +58,7 @@ The official config loader for [Tableau](https://github.com/tableauio/tableau).
 - Install protoc-gen-go: `go install google.golang.org/protobuf/cmd/protoc-gen-go@latest`
 - Change dir: `cd test/go-tableau-loader`
 - Generate protoconf: `bash ./gen.sh`
-- Build: `go build`
+- Run: `go run .`
 
 ### References
 

cmd/protoc-gen-cpp-tableau-loader/helper/helper.go

@@ -176,6 +176,7 @@ func ParseLeveledMapPrefix(md protoreflect.MessageDescriptor, mapFd protoreflect
 type MapKey struct {
 	Type string
 	Name string
+	Fd   protoreflect.FieldDescriptor // the map field descriptor this key belongs to
 }
 
 type MapKeySlice []MapKey

cmd/protoc-gen-cpp-tableau-loader/indexes/generator.go

@@ -15,9 +15,7 @@ type Generator struct {
 	message    *protogen.Message
 
 	// level message
-	maxDepth int
-	keys     helper.MapKeySlice
-	mapFds   []protoreflect.FieldDescriptor
+	keys helper.MapKeySlice
 }
 
 func NewGenerator(g *protogen.GeneratedFile, descriptor *index.IndexDescriptor, message *protogen.Message) *Generator {
@@ -31,16 +29,18 @@ func NewGenerator(g *protogen.GeneratedFile, descriptor *index.IndexDescriptor,
 }
 
 func (x *Generator) initLevelMessage() {
-	for levelMessage := x.descriptor.LevelMessage; levelMessage != nil; levelMessage = levelMessage.NextLevel {
-		if fd := levelMessage.FD; fd != nil && fd.IsMap() {
+	for lm := x.descriptor.LevelMessage; lm != nil; lm = lm.NextLevel {
+		if fd := lm.FD; fd != nil && fd.IsMap() {
+			// Only collect map keys/fds when a deeper level has an index or ordered index,
+			// because these keys are used solely for building upper-level (leveled) containers.
+			if !lm.NextLevel.NeedGenAnyIndex() {
+				break
+			}
 			x.keys = x.keys.AddMapKey(helper.MapKey{
 				Type: helper.ParseMapKeyType(fd.MapKey()),
 				Name: helper.ParseMapFieldName(fd),
+				Fd:   fd,
 			})
-			x.mapFds = append(x.mapFds, fd)
-		}
-		if len(levelMessage.Indexes) != 0 || len(levelMessage.OrderedIndexes) != 0 {
-			x.maxDepth = levelMessage.MapDepth
 		}
 	}
 }
@@ -84,16 +84,32 @@ func (x *Generator) GenHppIndexFinders() {
 	if !x.NeedGenerate() {
 		return
 	}
-	for i := 1; i <= x.maxDepth-3 && i <= len(x.mapFds)-1; i++ {
-		if i == 1 {
+	// Generate LevelIndex key structs for intermediate map levels.
+	//
+	// x.keys holds one entry per map level whose next level still needs an
+	// index (populated by initLevelMessage). For a 3-level map keyed by
+	// (k1, k2, k3) with an index at the deepest level, x.keys = [k1, k2, k3].
+	//
+	// Level containers at depth 1 are keyed by a single scalar (k1), so no
+	// composite key struct is needed. Only depths ≥ 2 require a LevelIndex
+	// struct that bundles all ancestor keys up to that depth:
+	//
+	//   keys = [k1, k2, k3]     → struct for depth 2: {k1, k2}
+	//   keys = [k1, k2, k3, k4] → struct for depth 2: {k1, k2}
+	//                             struct for depth 3: {k1, k2, k3}
+	//
+	// The loop starts at i=2 (depth 2) and creates a struct from keys[:i].
+	// It runs len(x.keys)-2 times (0 times when len ≤ 2).
+	for i := 2; i < len(x.keys); i++ {
+		if i == 2 {
 			x.g.P()
 			x.g.P(helper.Indent(1), "// LevelIndex keys.")
 			x.g.P(" public:")
 		}
-		fd := x.mapFds[i]
+		fd := x.keys[i-1].Fd
 		keyType := x.levelKeyType(fd)
 		x.g.P(helper.Indent(1), "struct ", keyType, " {")
-		keys := x.keys[:i+1]
+		keys := x.keys[:i]
 		for _, key := range keys {
 			x.g.P(helper.Indent(2), key.Type, " ", key.Name, ";")
 		}