✨ (sudoku-game): create game and board structure

Author: yuanyu90221

.github/workflows/go.yml

@@ -0,0 +1,30 @@
+name: Go
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  build_and_test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: 'stable'
+          check-latest: true
+      - name: Setup dependency
+        run: go mod tidy
+      # - name: Install Ebitengine dependencies (optional, depending on your project)
+      #   run: |
+      #     sudo apt-get update
+      #     sudo apt-get install -y libgl1-mesa-dev xorg-dev # For Linux builds
+      # - name: Test Build
+      #   run: make build-game
+      - name: Test
+        run: go test -v ./internal/game/...

.gitignore

@@ -0,0 +1,33 @@
+# If you prefer the allow list template instead of the deny list, see community template:
+# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
+#
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Code coverage profiles and other test artifacts
+*.out
+coverage.*
+*.coverprofile
+profile.cov
+
+# Dependency directories (remove the comment below to include it)
+# vendor/
+
+# Go workspace file
+go.work
+go.work.sum
+
+# env file
+.env
+
+# Editor/IDE
+# .idea/
+# .vscode/
+bin

Makefile

@@ -0,0 +1,14 @@
+.PHONY=build
+
+build-game:
+	@CGO_ENABLED=1 GOOS=linux go build -o bin/sudoku-game cmd/main.go
+
+run-game: build-game
+	@./bin/sudoku-game
+
+
+coverage:
+	@go test -v -cover ./internal/game/...
+
+test:
+	@go test -v ./internal/game/...

README.md

@@ -0,0 +1,4 @@
+# sudoku game
+
+This is a implementation sudoku game with golang
+

go.mod

@@ -0,0 +1,11 @@
+module github.com/leetcode-golang-classroom/sudoku-game
+
+go 1.24.0
+
+require github.com/stretchr/testify v1.11.1
+
+require (
+	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/pmezard/go-difflib v1.0.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)

go.sum

@@ -0,0 +1,9 @@
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

internal/game/cell.go

@@ -0,0 +1,16 @@
+package game
+
+// CellType 代表數獨格子的狀態
+type CellType int
+
+const (
+	Empty  CellType = iota // 空格
+	Preset                 // 題目預設的數字
+	Input                  // 玩家輸入的數字
+)
+
+// Cell 代表數獨的一個格子
+type Cell struct {
+	Value int      // 數字，0 表示空格
+	Type  CellType // 狀態：Empty、Preset、Input
+}

internal/game/sudoku.go

@@ -0,0 +1,29 @@
+package game
+
+// Board - 盤面
+type Board struct {
+	Cells [9][9]Cell
+}
+
+// NewBoard 建立一個空的數獨盤面
+func NewBoard() *Board {
+	board := &Board{}
+	for row := 0; row < 9; row++ {
+		for col := 0; col < 9; col++ {
+			board.Cells[row][col] = Cell{Value: 0, Type: Empty}
+		}
+	}
+	return board
+}
+
+// Game - 遊戲結構
+type Game struct {
+	board *Board
+}
+
+// NewGame - 建構遊戲結構
+func NewGame() *Game {
+	return &Game{
+		board: NewBoard(),
+	}
+}

internal/game/sudoku_test.go

@@ -0,0 +1,73 @@
+package game
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestNewGame(t *testing.T) {
+	tests := []struct {
+		name      string
+		wantBoard *Board
+	}{
+		{
+			name: "Empty Board",
+			wantBoard: &Board{
+				Cells: [9][9]Cell{
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+					{
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+						{0, Empty}, {0, Empty}, {0, Empty},
+					},
+				},
+			},
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			game := NewGame()
+			assert.Equal(t, tt.wantBoard.Cells, game.board.Cells)
+		})
+	}
+}