feat: support workbook alias

internal/importer/book/book.go

@@ -25,8 +25,8 @@ type Book struct {
 
 // NewBook creates a new book.
 // Example:
-// 	- bookName: Test
-// 	- filename: testdata/Test.xlsx
+//   - bookName: Test
+//   - filename: testdata/Test.xlsx
 func NewBook(bookName, filename string, parser SheetParser) *Book {
 	return &Book{
 		name:     bookName,
@@ -151,7 +151,7 @@ func (b *Book) ParseMetaAndPurge() (err error) {
 		// need all sheets except the metasheet "@TABLEAU"
 		b.meta.MetasheetMap = make(map[string]*tableaupb.Metasheet) // init
 		for _, sheet := range b.GetSheets() {
-			if sheet.Name != MetasheetName {
+			if sheet.Name != MetasheetName && sheet.Name != BookNameInMetasheet {
 				b.meta.MetasheetMap[sheet.Name] = &tableaupb.Metasheet{
 					Sheet: sheet.Name,
 				}
@@ -163,6 +163,9 @@ func (b *Book) ParseMetaAndPurge() (err error) {
 
 	var keepedSheetNames []string
 	for sheetName, sheetMeta := range b.meta.MetasheetMap {
+		if sheetName == BookNameInMetasheet {
+			continue
+		}
 		sheet := b.GetSheet(sheetName)
 		if sheet == nil {
 			return xerrors.E0001(sheetName, b.Filename())

internal/importer/book/sheet.go

@@ -15,9 +15,13 @@ import (
 )
 
 // MetasheetName is the name of metasheet which defines the metadata
-// of each worksheet. Default metasheet name is "@TABLEAU".
+// of each worksheet. Default is "@TABLEAU".
 var MetasheetName = "@TABLEAU"
 
+// BookNameInMetasheet is the name which represents workbook in metasheet.
+// Default is "#".
+const BookNameInMetasheet = "#"
+
 // SetMetasheetName change the metasheet name to the specified name.
 //
 // NOTE: If will not change MetasheetName value if the specified name

internal/protogen/protogen.go

@@ -298,7 +298,13 @@ func (gen *Generator) convert(dir, filename string, checkProtoFileConflicts bool
 	var bp *bookParser
 	if pass == firstPass {
 		// create a book parser
-		bp = newBookParser(imp.BookName(), rewrittenWorkbookName, gen)
+		bookName := imp.BookName()
+		alias := getWorkbookAlias(imp)
+		if alias != "" {
+			bookName = alias
+			debugWorkbookName += " (alias: " + alias + ")"
+		}
+		bp = newBookParser(bookName, rewrittenWorkbookName, gen)
 		// cache this new bookParser
 		gen.addBookParser(absPath, bp)
 	} else {

internal/protogen/util.go

@@ -8,6 +8,8 @@ import (
 	"strings"
 
 	"github.com/tableauio/tableau/internal/fs"
+	"github.com/tableauio/tableau/internal/importer"
+	"github.com/tableauio/tableau/internal/importer/book"
 	"github.com/tableauio/tableau/options"
 	"github.com/tableauio/tableau/proto/tableaupb"
 	"github.com/tableauio/tableau/xerrors"
@@ -59,6 +61,15 @@ func prepareOutdir(outdir string, importFiles []string, delExisted bool) error {
 	return nil
 }
 
+func getWorkbookAlias(imp importer.Importer) string {
+	sheetMap := imp.Metabook().GetMetasheetMap()
+	if sheetMap == nil {
+		return ""
+	}
+	meta := sheetMap[book.BookNameInMetasheet]
+	return meta.GetAlias()
+}
+
 func getRelCleanSlashPath(rootdir, dir, filename string) (string, error) {
 	relativeDir, err := filepath.Rel(rootdir, dir)
 	if err != nil {

test/functest/conf/AliasedSheetScalar.json

@@ -0,0 +1,5 @@
+{
+    "id": 1,
+    "name": "Apple",
+    "desc": "A kind of delicious fruit."
+}

test/functest/func_test.go

@@ -100,8 +100,14 @@ func Test_CompareGeneratedJSON(t *testing.T) {
 		}
 		oldPath := filepath.Join(oldConfDir, file.Name())
 		absOldPath, err := filepath.Abs(oldPath)
+		if err != nil {
+			t.Fatal(err)
+		}
 		newPath := filepath.Join(newConfDir, file.Name())
 		absNewPath, err := filepath.Abs(newPath)
+		if err != nil {
+			t.Fatal(err)
+		}
 		oldData, err := os.ReadFile(oldPath)
 		if err != nil {
 			t.Fatal(err)

test/functest/proto/excel__metasheet__aliased_workbook.proto

@@ -0,0 +1,19 @@
+// Code generated by tableau (protogen v0.5.0). DO NOT EDIT.
+// clang-format off
+
+syntax = "proto3";
+
+package protoconf;
+
+import "tableau/protobuf/tableau.proto";
+
+option go_package = "github.com/tableauio/tableau/test/functest/protoconf";
+option (tableau.workbook) = {name:"excel/metasheet/BookAlias#*.csv"};
+
+message AliasedSheetScalar {
+  option (tableau.worksheet) = {name:"Scalar" namerow:1 typerow:2 noterow:3 datarow:4};
+
+  uint32 id = 1 [(tableau.field) = {name:"ID"}];
+  string name = 2 [(tableau.field) = {name:"Name"}];
+  string desc = 3 [(tableau.field) = {name:"Desc"}];
+}

test/functest/testdata/excel/metasheet/BookAlias#@TABLEAU.csv

@@ -0,0 +1,3 @@
+Sheet,Alias
+#,AliasedWorkbook
+Scalar,AliasedSheetScalar,

test/functest/testdata/excel/metasheet/BookAlias#Scalar.csv

@@ -0,0 +1,4 @@
+ID,Name,Desc
+uint32,string,string
+Item's ID,Item's Name,Item's Description
+1,Apple,A kind of delicious fruit.