options

type HeaderOption struct {
	// Exact row number of column name definition at a worksheet.
	// Default: 1.
	Namerow int32
	// Exact row number of column type definition at a worksheet.
	// Default: 2.
	Typerow int32
	// Exact row number of column note at a worksheet.
	// Default: 3.
	Noterow int32
	// Start row number of data at a worksheet.
	// Default: 4.
	Datarow int32

	// The line number of column name definition in a cell.
	// Value 0 means the whole cell.
	// Default: 0.
	Nameline int32
	// The line number of column type definition in a cell.
	// Value 0 means the whole cell.
	// Default: 0.
	Typeline int32
}

type InputOption struct {
	// Only for protogen: input file formats.
	// Note: recognize all formats (Excel, CSV, and XML) if not set (value is nil).
	// Default: nil.
	Formats []format.Format
	// - For protogen, specify only these subdirs (relative to input dir) to be processed.
	// - For confgen, specify only these subdirs (relative to workbook name option in .proto file).
	Subdirs []string
	// - For protogen, rewrite subdir path (relative to input dir).
	// - For confgen, rewrite subdir path (relative to workbook name option in .proto file).
	SubdirRewrites map[string]string
}

type Option func(*Options)

type Options struct {
	// Location represents the collection of time offsets in use in a geographical area.
	// Default: "Asia/Shanghai".
	LocationName string
	LogLevel     string        // Log level: debug, info, warn, error. Default: "info".
	Header       *HeaderOption // Header options of worksheet file.
	Input        *InputOption  // Input options.
	Output       *OutputOption // Output options.
	Imports      []string      // Import common proto files. Default: nil.
	Workbook     string        // Workbook filename. Default: "".
	Worksheet    string        // Worksheet name. Default: "".
}

type OutputOption struct {
	// Only for protogen: dir separator `/` or `\`  in filename is replaced by "__".
	// Default: true.
	FilenameWithSubdirPrefix bool
	// Only for protogen: append the suffix to filename.
	// Default: "".
	FilenameSuffix string
	// Only for confgen: output filename as snake_case, default is CamelCase as the protobuf message name.
	// Default: false.
	FilenameAsSnakeCase bool
	// Only for confgen: output file formats.
	// Note: Output all formats (JSON, Text, and Wire) if not set (value is nil).
	// Default: nil.
	Formats []format.Format
	// Only for confgen: output pretty format, with multiline and indent.
	// Default: true.
	Pretty bool
	// EmitUnpopulated specifies whether to emit unpopulated fields. It does not
	// emit unpopulated oneof fields or unpopulated extension fields.
	// The JSON value emitted for unpopulated fields are as follows:
	//  ╔═══════╤════════════════════════════╗
	//  ║ JSON  │ Protobuf field             ║
	//  ╠═══════╪════════════════════════════╣
	//  ║ false │ proto3 boolean fields      ║
	//  ║ 0     │ proto3 numeric fields      ║
	//  ║ ""    │ proto3 string/bytes fields ║
	//  ║ null  │ proto2 scalar fields       ║
	//  ║ null  │ message fields             ║
	//  ║ []    │ list fields                ║
	//  ║ {}    │ map fields                 ║
	//  ╚═══════╧════════════════════════════╝
	//
	// Default: true.
	EmitUnpopulated bool
}