stream_test.go 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916
  1. package xlsx
  2. import (
  3. "bytes"
  4. "fmt"
  5. "io"
  6. "reflect"
  7. "strings"
  8. "testing"
  9. . "gopkg.in/check.v1"
  10. )
  11. const (
  12. TestsShouldMakeRealFiles = false
  13. )
  14. type StreamSuite struct{}
  15. var _ = Suite(&StreamSuite{})
  16. func (s *StreamSuite) TestTestsShouldMakeRealFilesShouldBeFalse(t *C) {
  17. if TestsShouldMakeRealFiles {
  18. t.Fatal("TestsShouldMakeRealFiles should only be true for local debugging. Don't forget to switch back before commiting.")
  19. }
  20. }
  21. func TestXlsxStreamWrite(t *testing.T) {
  22. // When shouldMakeRealFiles is set to true this test will make actual XLSX files in the file system.
  23. // This is useful to ensure files open in Excel, Numbers, Google Docs, etc.
  24. // In case of issues you can use "Open XML SDK 2.5" to diagnose issues in generated XLSX files:
  25. // https://www.microsoft.com/en-us/download/details.aspx?id=30425
  26. testCases := []struct {
  27. testName string
  28. sheetNames []string
  29. workbookData [][][]string
  30. headerTypes [][]*CellType
  31. expectedError error
  32. }{
  33. {
  34. testName: "One Sheet",
  35. sheetNames: []string{
  36. "Sheet1",
  37. },
  38. workbookData: [][][]string{
  39. {
  40. {"Token", "Name", "Price", "SKU"},
  41. {"123", "Taco", "300", "0000000123"},
  42. },
  43. },
  44. headerTypes: [][]*CellType{
  45. {nil, CellTypeString.Ptr(), nil, CellTypeString.Ptr()},
  46. },
  47. },
  48. {
  49. testName: "One Column",
  50. sheetNames: []string{
  51. "Sheet1",
  52. },
  53. workbookData: [][][]string{
  54. {
  55. {"Token"},
  56. {"123"},
  57. },
  58. },
  59. },
  60. {
  61. testName: "Several Sheets, with different numbers of columns and rows",
  62. sheetNames: []string{
  63. "Sheet 1", "Sheet 2", "Sheet3",
  64. },
  65. workbookData: [][][]string{
  66. {
  67. {"Token", "Name", "Price", "SKU"},
  68. {"123", "Taco", "300", "0000000123"},
  69. },
  70. {
  71. {"Token", "Name", "Price", "SKU", "Stock"},
  72. {"456", "Salsa", "200", "0346", "1"},
  73. {"789", "Burritos", "400", "754", "3"},
  74. },
  75. {
  76. {"Token", "Name", "Price"},
  77. {"9853", "Guacamole", "500"},
  78. {"2357", "Margarita", "700"},
  79. },
  80. },
  81. },
  82. {
  83. testName: "Two Sheets with same the name",
  84. sheetNames: []string{
  85. "Sheet 1", "Sheet 1",
  86. },
  87. workbookData: [][][]string{
  88. {
  89. {"Token", "Name", "Price", "SKU"},
  90. {"123", "Taco", "300", "0000000123"},
  91. },
  92. {
  93. {"Token", "Name", "Price", "SKU", "Stock"},
  94. {"456", "Salsa", "200", "0346", "1"},
  95. {"789", "Burritos", "400", "754", "3"},
  96. },
  97. },
  98. expectedError: fmt.Errorf("duplicate sheet name '%s'.", "Sheet 1"),
  99. },
  100. {
  101. testName: "One Sheet Registered, tries to write to two",
  102. sheetNames: []string{
  103. "Sheet 1",
  104. },
  105. workbookData: [][][]string{
  106. {
  107. {"Token", "Name", "Price", "SKU"},
  108. {"123", "Taco", "300", "0000000123"},
  109. },
  110. {
  111. {"Token", "Name", "Price", "SKU"},
  112. {"456", "Salsa", "200", "0346"},
  113. },
  114. },
  115. expectedError: AlreadyOnLastSheetError,
  116. },
  117. {
  118. testName: "One Sheet, too many columns in row 1",
  119. sheetNames: []string{
  120. "Sheet 1",
  121. },
  122. workbookData: [][][]string{
  123. {
  124. {"Token", "Name", "Price", "SKU"},
  125. {"123", "Taco", "300", "0000000123", "asdf"},
  126. },
  127. },
  128. expectedError: WrongNumberOfRowsError,
  129. },
  130. {
  131. testName: "One Sheet, too few columns in row 1",
  132. sheetNames: []string{
  133. "Sheet 1",
  134. },
  135. workbookData: [][][]string{
  136. {
  137. {"Token", "Name", "Price", "SKU"},
  138. {"123", "Taco", "300"},
  139. },
  140. },
  141. expectedError: WrongNumberOfRowsError,
  142. },
  143. {
  144. testName: "Lots of Sheets, only writes rows to one, only writes headers to one, should not error and should still create a valid file",
  145. sheetNames: []string{
  146. "Sheet 1", "Sheet 2", "Sheet 3", "Sheet 4", "Sheet 5", "Sheet 6",
  147. },
  148. workbookData: [][][]string{
  149. {
  150. {"Token", "Name", "Price", "SKU"},
  151. {"123", "Taco", "300", "0000000123"},
  152. },
  153. {{}},
  154. {{"Id", "Unit Cost"}},
  155. {{}},
  156. {{}},
  157. {{}},
  158. },
  159. },
  160. {
  161. testName: "Two Sheets, only writes to one, should not error and should still create a valid file",
  162. sheetNames: []string{
  163. "Sheet 1", "Sheet 2",
  164. },
  165. workbookData: [][][]string{
  166. {
  167. {"Token", "Name", "Price", "SKU"},
  168. {"123", "Taco", "300", "0000000123"},
  169. },
  170. {{}},
  171. },
  172. },
  173. {
  174. testName: "Larger Sheet",
  175. sheetNames: []string{
  176. "Sheet 1",
  177. },
  178. workbookData: [][][]string{
  179. {
  180. {"Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU"},
  181. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  182. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  183. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  184. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  185. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  186. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  187. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  188. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  189. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  190. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  191. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  192. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  193. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  194. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  195. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  196. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  197. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  198. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  199. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  200. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  201. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  202. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  203. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  204. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  205. },
  206. },
  207. },
  208. {
  209. testName: "UTF-8 Characters. This XLSX File loads correctly with Excel, Numbers, and Google Docs. It also passes Microsoft's Office File Format Validator.",
  210. sheetNames: []string{
  211. "Sheet1",
  212. },
  213. workbookData: [][][]string{
  214. {
  215. // String courtesy of https://github.com/minimaxir/big-list-of-naughty-strings/
  216. // Header row contains the tags that I am filtering on
  217. {"Token", endSheetDataTag, "Price", fmt.Sprintf(dimensionTag, "A1:D1")},
  218. // Japanese and emojis
  219. {"123", "パーティーへ行かないか", "300", "🍕🐵 🙈 🙉 🙊"},
  220. // XML encoder/parser test strings
  221. {"123", `<?xml version="1.0" encoding="ISO-8859-1"?>`, "300", `<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE foo [ <!ELEMENT foo ANY ><!ENTITY xxe SYSTEM "file:///etc/passwd" >]><foo>&xxe;</foo>`},
  222. // Upside down text and Right to Left Arabic text
  223. {"123", `˙ɐnbᴉlɐ ɐuƃɐɯ ǝɹolop ʇǝ ǝɹoqɐl ʇn ʇunpᴉpᴉɔuᴉ ɹodɯǝʇ poɯsnᴉǝ op pǝs 'ʇᴉlǝ ƃuᴉɔsᴉdᴉpɐ ɹnʇǝʇɔǝsuoɔ 'ʇǝɯɐ ʇᴉs ɹolop ɯnsdᴉ ɯǝɹo˥
  224. 00˙Ɩ$-`, "300", `ﷺ`},
  225. {"123", "Taco", "300", "0000000123"},
  226. },
  227. },
  228. },
  229. }
  230. for i, testCase := range testCases {
  231. if testCase.testName != "One Sheet" {
  232. continue
  233. }
  234. t.Run(testCase.testName, func(t *testing.T) {
  235. var filePath string
  236. var buffer bytes.Buffer
  237. if TestsShouldMakeRealFiles {
  238. filePath = fmt.Sprintf("Workbook%d.xlsx", i)
  239. }
  240. err := writeStreamFile(filePath, &buffer, testCase.sheetNames, testCase.workbookData, testCase.headerTypes, TestsShouldMakeRealFiles)
  241. switch {
  242. case err != nil && testCase.expectedError == nil:
  243. t.Fatalf("Unexpected error: %v", err.Error())
  244. case err == nil && testCase.expectedError != nil:
  245. t.Fatalf("Error is nil, but expected error was: %v", testCase.expectedError)
  246. case err != nil && testCase.expectedError != nil && err.Error() != testCase.expectedError.Error():
  247. t.Fatalf("Error differs from expected error. Error: %v, Expected Error: %v ", err, testCase.expectedError)
  248. }
  249. if testCase.expectedError != nil {
  250. return
  251. }
  252. // read the file back with the xlsx package
  253. var bufReader *bytes.Reader
  254. var size int64
  255. if !TestsShouldMakeRealFiles {
  256. bufReader = bytes.NewReader(buffer.Bytes())
  257. size = bufReader.Size()
  258. }
  259. actualSheetNames, actualWorkbookData, _ := readXLSXFile(t, filePath, bufReader, size, TestsShouldMakeRealFiles)
  260. // check if data was able to be read correctly
  261. if !reflect.DeepEqual(actualSheetNames, testCase.sheetNames) {
  262. t.Fatal("Expected sheet names to be equal")
  263. }
  264. if !reflect.DeepEqual(actualWorkbookData, testCase.workbookData) {
  265. t.Fatal("Expected workbook data to be equal")
  266. }
  267. })
  268. }
  269. }
  270. func TestXlsxStreamWriteWithDefaultCellType(t *testing.T) {
  271. // When shouldMakeRealFiles is set to true this test will make actual XLSX files in the file system.
  272. // This is useful to ensure files open in Excel, Numbers, Google Docs, etc.
  273. // In case of issues you can use "Open XML SDK 2.5" to diagnose issues in generated XLSX files:
  274. // https://www.microsoft.com/en-us/download/details.aspx?id=30425
  275. testCases := []struct {
  276. testName string
  277. sheetNames []string
  278. workbookData [][][]string
  279. expectedWorkbookData [][][]string
  280. headerTypes [][]*CellMetadata
  281. expectedError error
  282. }{
  283. {
  284. testName: "One Sheet",
  285. sheetNames: []string{
  286. "Sheet1",
  287. },
  288. workbookData: [][][]string{
  289. {
  290. {"Token", "Name", "Price", "SKU"},
  291. {"123", "Taco", "300.0", "0000000123"},
  292. {"123", "Taco", "string", "0000000123"},
  293. },
  294. },
  295. expectedWorkbookData: [][][]string{
  296. {
  297. {"Token", "Name", "Price", "SKU"},
  298. {"123", "Taco", "300.00", "0000000123"},
  299. {"123", "Taco", "string", "0000000123"},
  300. },
  301. },
  302. headerTypes: [][]*CellMetadata{
  303. {DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultDecimalCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr()},
  304. },
  305. },
  306. {
  307. testName: "One Column",
  308. sheetNames: []string{
  309. "Sheet1",
  310. },
  311. workbookData: [][][]string{
  312. {
  313. {"Token"},
  314. {"1234"},
  315. },
  316. },
  317. expectedWorkbookData: [][][]string{
  318. {
  319. {"Token"},
  320. {"1234.00"},
  321. },
  322. },
  323. headerTypes: [][]*CellMetadata{
  324. {DefaultDecimalCellMetadata.Ptr()},
  325. },
  326. },
  327. {
  328. testName: "Several Sheets, with different numbers of columns and rows",
  329. sheetNames: []string{
  330. "Sheet 1", "Sheet 2", "Sheet3",
  331. },
  332. workbookData: [][][]string{
  333. {
  334. {"Token", "Name", "Price", "SKU"},
  335. {"123", "Taco", "300", "0000000123"},
  336. },
  337. {
  338. {"Token", "Name", "Price", "SKU", "Stock"},
  339. {"456", "Salsa", "200", "0346", "1"},
  340. {"789", "Burritos", "400", "754", "3"},
  341. },
  342. {
  343. {"Token", "Name", "Price"},
  344. {"9853", "Guacamole", "500"},
  345. {"2357", "Margarita", "700"},
  346. },
  347. },
  348. expectedWorkbookData: [][][]string{
  349. {
  350. {"Token", "Name", "Price", "SKU"},
  351. {"123", "Taco", "300.00", "0000000123"},
  352. },
  353. {
  354. {"Token", "Name", "Price", "SKU", "Stock"},
  355. {"456", "Salsa", "200.00", "0346", "1"},
  356. {"789", "Burritos", "400.00", "754", "3"},
  357. },
  358. {
  359. {"Token", "Name", "Price"},
  360. {"9853", "Guacamole", "500"},
  361. {"2357", "Margarita", "700"},
  362. },
  363. },
  364. headerTypes: [][]*CellMetadata{
  365. {DefaultIntegerCellMetadata.Ptr(), nil, DefaultDecimalCellMetadata.Ptr(), nil},
  366. {DefaultIntegerCellMetadata.Ptr(), nil, DefaultDecimalCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultIntegerCellMetadata.Ptr()},
  367. {nil, nil, nil},
  368. },
  369. },
  370. {
  371. testName: "Two Sheets with the same name",
  372. sheetNames: []string{
  373. "Sheet 1", "Sheet 1",
  374. },
  375. workbookData: [][][]string{
  376. {
  377. {"Token", "Name", "Price", "SKU"},
  378. {"123", "Taco", "300", "0000000123"},
  379. },
  380. {
  381. {"Token", "Name", "Price", "SKU", "Stock"},
  382. {"456", "Salsa", "200", "0346", "1"},
  383. {"789", "Burritos", "400", "754", "3"},
  384. },
  385. },
  386. expectedError: fmt.Errorf("duplicate sheet name '%s'.", "Sheet 1"),
  387. },
  388. {
  389. testName: "One Sheet Registered, tries to write to two",
  390. sheetNames: []string{
  391. "Sheet 1",
  392. },
  393. workbookData: [][][]string{
  394. {
  395. {"Token", "Name", "Price", "SKU"},
  396. {"123", "Taco", "300", "0000000123"},
  397. },
  398. {
  399. {"Token", "Name", "Price", "SKU"},
  400. {"456", "Salsa", "200", "0346"},
  401. },
  402. },
  403. expectedError: AlreadyOnLastSheetError,
  404. },
  405. {
  406. testName: "One Sheet, too many columns in row 1",
  407. sheetNames: []string{
  408. "Sheet 1",
  409. },
  410. workbookData: [][][]string{
  411. {
  412. {"Token", "Name", "Price", "SKU"},
  413. {"123", "Taco", "300", "0000000123", "asdf"},
  414. },
  415. },
  416. expectedError: WrongNumberOfRowsError,
  417. },
  418. {
  419. testName: "One Sheet, too few columns in row 1",
  420. sheetNames: []string{
  421. "Sheet 1",
  422. },
  423. workbookData: [][][]string{
  424. {
  425. {"Token", "Name", "Price", "SKU"},
  426. {"123", "Taco", "300"},
  427. },
  428. },
  429. expectedError: WrongNumberOfRowsError,
  430. },
  431. {
  432. testName: "Lots of Sheets, only writes rows to one, only writes headers to one, should not error and should still create a valid file",
  433. sheetNames: []string{
  434. "Sheet 1", "Sheet 2", "Sheet 3", "Sheet 4", "Sheet 5", "Sheet 6",
  435. },
  436. workbookData: [][][]string{
  437. {
  438. {"Token", "Name", "Price", "SKU"},
  439. {"123", "Taco", "300", "0000000123"},
  440. },
  441. {{}},
  442. {{"Id", "Unit Cost"}},
  443. {{}},
  444. {{}},
  445. {{}},
  446. },
  447. headerTypes: [][]*CellMetadata{
  448. {DefaultIntegerCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultIntegerCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr()},
  449. {nil},
  450. {nil, nil},
  451. {nil},
  452. {nil},
  453. {nil},
  454. },
  455. },
  456. {
  457. testName: "Two Sheets, only writes to one, should not error and should still create a valid file",
  458. sheetNames: []string{
  459. "Sheet 1", "Sheet 2",
  460. },
  461. workbookData: [][][]string{
  462. {
  463. {"Token", "Name", "Price", "SKU"},
  464. {"123", "Taco", "300", "0000000123"},
  465. },
  466. {{}},
  467. },
  468. headerTypes: [][]*CellMetadata{
  469. {DefaultDateCellMetadata.Ptr(), DefaultDateCellMetadata.Ptr(), DefaultDateCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr()},
  470. {nil},
  471. },
  472. },
  473. {
  474. testName: "Larger Sheet",
  475. sheetNames: []string{
  476. "Sheet 1",
  477. },
  478. workbookData: [][][]string{
  479. {
  480. {"Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU", "Token", "Name", "Price", "SKU"},
  481. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  482. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  483. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  484. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  485. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  486. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  487. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  488. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  489. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  490. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  491. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  492. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  493. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  494. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  495. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  496. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  497. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  498. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  499. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  500. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  501. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  502. {"123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123", "123", "Taco", "300", "0000000123"},
  503. {"456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346", "456", "Salsa", "200", "0346"},
  504. {"789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754", "789", "Burritos", "400", "754"},
  505. },
  506. },
  507. headerTypes: [][]*CellMetadata{
  508. {DefaultIntegerCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultIntegerCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr()},
  509. },
  510. },
  511. {
  512. testName: "UTF-8 Characters. This XLSX File loads correctly with Excel, Numbers, and Google Docs. It also passes Microsoft's Office File Format Validator.",
  513. sheetNames: []string{
  514. "Sheet1",
  515. },
  516. workbookData: [][][]string{
  517. {
  518. // String courtesy of https://github.com/minimaxir/big-list-of-naughty-strings/
  519. // Header row contains the tags that I am filtering on
  520. {"Token", endSheetDataTag, "Price", fmt.Sprintf(dimensionTag, "A1:D1")},
  521. // Japanese and emojis
  522. {"123", "パーティーへ行かないか", "300", "🍕🐵 🙈 🙉 🙊"},
  523. // XML encoder/parser test strings
  524. {"123", `<?xml version="1.0" encoding="ISO-8859-1"?>`, "300", `<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE foo [ <!ELEMENT foo ANY ><!ENTITY xxe SYSTEM "file:///etc/passwd" >]><foo>&xxe;</foo>`},
  525. // Upside down text and Right to Left Arabic text
  526. {"123", `˙ɐnbᴉlɐ ɐuƃɐɯ ǝɹolop ʇǝ ǝɹoqɐl ʇn ʇunpᴉpᴉɔuᴉ ɹodɯǝʇ poɯsnᴉǝ op pǝs 'ʇᴉlǝ ƃuᴉɔsᴉdᴉpɐ ɹnʇǝʇɔǝsuoɔ 'ʇǝɯɐ ʇᴉs ɹolop ɯnsdᴉ ɯǝɹo˥
  527. 00˙Ɩ$-`, "300", `ﷺ`},
  528. {"123", "Taco", "300", "0000000123"},
  529. },
  530. },
  531. headerTypes: [][]*CellMetadata{
  532. {DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr(), DefaultStringCellMetadata.Ptr()},
  533. },
  534. },
  535. }
  536. for i, testCase := range testCases {
  537. if testCase.testName != "One Sheet, too few columns in row 1" {
  538. continue
  539. }
  540. t.Run(testCase.testName, func(t *testing.T) {
  541. var filePath string
  542. var buffer bytes.Buffer
  543. if TestsShouldMakeRealFiles {
  544. filePath = fmt.Sprintf("WorkbookTyped%d.xlsx", i)
  545. }
  546. err := writeStreamFileWithDefaultMetadata(filePath, &buffer, testCase.sheetNames, testCase.workbookData, testCase.headerTypes, TestsShouldMakeRealFiles)
  547. switch {
  548. case err == nil && testCase.expectedError != nil:
  549. t.Fatalf("Expected an error, but nil was returned\n")
  550. case err != nil && testCase.expectedError == nil:
  551. t.Fatalf("Unexpected error: %q", err.Error())
  552. case err != testCase.expectedError && err.Error() != testCase.expectedError.Error():
  553. t.Fatalf("Error differs from expected error. Error: %v, Expected Error: %v ", err, testCase.expectedError)
  554. case err != nil:
  555. // We got an error we expected
  556. return
  557. }
  558. // read the file back with the xlsx package
  559. var bufReader *bytes.Reader
  560. var size int64
  561. if !TestsShouldMakeRealFiles {
  562. bufReader = bytes.NewReader(buffer.Bytes())
  563. size = bufReader.Size()
  564. }
  565. actualSheetNames, actualWorkbookData, workbookCellTypes := readXLSXFile(t, filePath, bufReader, size, TestsShouldMakeRealFiles)
  566. verifyCellTypesInColumnMatchHeaderType(t, workbookCellTypes, testCase.headerTypes, testCase.workbookData)
  567. // check if data was able to be read correctly
  568. if !reflect.DeepEqual(actualSheetNames, testCase.sheetNames) {
  569. t.Fatal("Expected sheet names to be equal")
  570. }
  571. if !reflect.DeepEqual(actualWorkbookData, testCase.expectedWorkbookData) {
  572. t.Log("expected: \n")
  573. t.Logf("%s\n", testCase.expectedWorkbookData)
  574. t.Log("\n")
  575. t.Log("result: \n")
  576. t.Logf("%s\n", actualWorkbookData)
  577. t.Log("\n")
  578. t.Fatal("Expected workbook data to be equal")
  579. }
  580. })
  581. }
  582. }
  583. // Ensures that the cell type of all cells in each column across all sheets matches the provided header types
  584. // in each corresponding sheet
  585. func verifyCellTypesInColumnMatchHeaderType(t *testing.T, workbookCellTypes [][][]CellType, headerMetadata [][]*CellMetadata, workbookData [][][]string) {
  586. numSheets := len(workbookCellTypes)
  587. numHeaders := len(headerMetadata)
  588. if numSheets != numHeaders {
  589. t.Fatalf("Number of sheets in workbook: %d not equal to number of sheet headers: %d", numSheets, numHeaders)
  590. }
  591. for sheetI, headers := range headerMetadata {
  592. var sanitizedHeaders []CellType
  593. for _, header := range headers {
  594. if header == (*CellMetadata)(nil) || header.cellType == CellTypeString {
  595. sanitizedHeaders = append(sanitizedHeaders, CellTypeInline)
  596. } else {
  597. sanitizedHeaders = append(sanitizedHeaders, header.cellType)
  598. }
  599. }
  600. sheet := workbookCellTypes[sheetI]
  601. // Skip header row
  602. for rowI, row := range sheet[1:] {
  603. if len(row) != len(headers) {
  604. t.Fatalf("Number of cells in row: %d not equal number of headers; %d", len(row), len(headers))
  605. }
  606. for colI, cellType := range row {
  607. headerTypeForCol := sanitizedHeaders[colI]
  608. if cellType != headerTypeForCol.fallbackTo(workbookData[sheetI][rowI+1][colI], CellTypeInline) {
  609. t.Fatalf("Cell type %d in row: %d and col: %d does not match header type: %d for this col in sheet: %d",
  610. cellType, rowI, colI, headerTypeForCol, sheetI)
  611. }
  612. }
  613. }
  614. }
  615. }
  616. // The purpose of TestXlsxStyleBehavior is to ensure that initMaxStyleId has the correct starting value
  617. // and that the logic in AddSheet() that predicts Style IDs is correct.
  618. func TestXlsxStyleBehavior(t *testing.T) {
  619. file := NewFile()
  620. sheet, err := file.AddSheet("Sheet 1")
  621. if err != nil {
  622. t.Fatal(err)
  623. }
  624. row := sheet.AddRow()
  625. rowData := []string{"testing", "1", "2", "3"}
  626. if count := row.WriteSlice(&rowData, -1); count != len(rowData) {
  627. t.Fatal("not enough cells written")
  628. }
  629. parts, err := file.MarshallParts()
  630. styleSheet, ok := parts["xl/styles.xml"]
  631. if !ok {
  632. t.Fatal("no style sheet")
  633. }
  634. // Created an XLSX file with only the default style.
  635. // This means the library adds a style by default, but no others are created
  636. if !strings.Contains(styleSheet, fmt.Sprintf(`<cellXfs count="%d">`, initMaxStyleId)) {
  637. t.Fatal("Expected sheet to have one style")
  638. }
  639. file = NewFile()
  640. sheet, err = file.AddSheet("Sheet 1")
  641. if err != nil {
  642. t.Fatal(err)
  643. }
  644. row = sheet.AddRow()
  645. rowData = []string{"testing", "1", "2", "3", "4"}
  646. if count := row.WriteSlice(&rowData, -1); count != len(rowData) {
  647. t.Fatal("not enough cells written")
  648. }
  649. sheet.SetType(0, 4, CellTypeString)
  650. sheet.SetType(3, 3, CellTypeNumeric)
  651. parts, err = file.MarshallParts()
  652. styleSheet, ok = parts["xl/styles.xml"]
  653. if !ok {
  654. t.Fatal("no style sheet")
  655. }
  656. // Created an XLSX file with two distinct cell types, which
  657. // should create two new styles. The same cell type was added
  658. // three times, this should be coalesced into the same style
  659. // rather than recreating the style. This XLSX stream library
  660. // depends on this behaviour when predicting the next style
  661. // id.
  662. if !strings.Contains(styleSheet, fmt.Sprintf(`<cellXfs count="%d">`, initMaxStyleId+2)) {
  663. t.Fatal("Expected sheet to have four styles")
  664. }
  665. }
  666. // writeStreamFile will write the file using this stream package
  667. func writeStreamFile(filePath string, fileBuffer io.Writer, sheetNames []string, workbookData [][][]string, headerTypes [][]*CellType, shouldMakeRealFiles bool) error {
  668. var file *StreamFileBuilder
  669. var err error
  670. if shouldMakeRealFiles {
  671. file, err = NewStreamFileBuilderForPath(filePath)
  672. if err != nil {
  673. return err
  674. }
  675. } else {
  676. file = NewStreamFileBuilder(fileBuffer)
  677. }
  678. var headerLen []int
  679. for i, sheetName := range sheetNames {
  680. header := workbookData[i][0]
  681. headerLen = append(headerLen, len(header))
  682. var sheetHeaderTypes []*CellType
  683. if i < len(headerTypes) {
  684. sheetHeaderTypes = headerTypes[i]
  685. }
  686. err := file.AddSheet(sheetName, header, sheetHeaderTypes)
  687. if err != nil {
  688. return err
  689. }
  690. }
  691. streamFile, err := file.Build()
  692. if err != nil {
  693. return err
  694. }
  695. for i, sheetData := range workbookData {
  696. if i != 0 {
  697. err = streamFile.NextSheet()
  698. if err != nil {
  699. return err
  700. }
  701. }
  702. streamFile.currentSheet.columnCount = headerLen[i]
  703. for i, row := range sheetData {
  704. if i == 0 {
  705. continue
  706. }
  707. err = streamFile.Write(row)
  708. if err != nil {
  709. return err
  710. }
  711. }
  712. }
  713. err = streamFile.Close()
  714. if err != nil {
  715. return err
  716. }
  717. return nil
  718. }
  719. // writeStreamFileWithDefaultMetadata is the same thing as writeStreamFile but with headerMetadata instead of headerTypes
  720. func writeStreamFileWithDefaultMetadata(filePath string, fileBuffer io.Writer, sheetNames []string, workbookData [][][]string, headerMetadata [][]*CellMetadata, shouldMakeRealFiles bool) error {
  721. var file *StreamFileBuilder
  722. var err error
  723. if shouldMakeRealFiles {
  724. file, err = NewStreamFileBuilderForPath(filePath)
  725. if err != nil {
  726. return err
  727. }
  728. } else {
  729. file = NewStreamFileBuilder(fileBuffer)
  730. }
  731. var headerLen []int
  732. for i, sheetName := range sheetNames {
  733. header := workbookData[i][0]
  734. headerLen = append(headerLen, len(header))
  735. var sheetHeaderTypes []*CellMetadata
  736. if i < len(headerMetadata) {
  737. sheetHeaderTypes = headerMetadata[i]
  738. }
  739. err := file.AddSheetWithDefaultColumnMetadata(sheetName, header, sheetHeaderTypes)
  740. if err != nil {
  741. return err
  742. }
  743. }
  744. streamFile, err := file.Build()
  745. if err != nil {
  746. return err
  747. }
  748. for i, sheetData := range workbookData {
  749. if i != 0 {
  750. err = streamFile.NextSheet()
  751. if err != nil {
  752. return err
  753. }
  754. }
  755. cellCount := headerLen[i]
  756. for i, row := range sheetData {
  757. if i == 0 {
  758. continue
  759. }
  760. err = streamFile.WriteWithColumnDefaultMetadata(row, cellCount)
  761. if err != nil {
  762. return err
  763. }
  764. }
  765. }
  766. err = streamFile.Close()
  767. if err != nil {
  768. return err
  769. }
  770. return nil
  771. }
  772. // readXLSXFile will read the file using the xlsx package.
  773. func readXLSXFile(t *testing.T, filePath string, fileBuffer io.ReaderAt, size int64, shouldMakeRealFiles bool) ([]string, [][][]string, [][][]CellType) {
  774. var readFile *File
  775. var err error
  776. if shouldMakeRealFiles {
  777. readFile, err = OpenFile(filePath)
  778. if err != nil {
  779. t.Fatal(err)
  780. }
  781. } else {
  782. readFile, err = OpenReaderAt(fileBuffer, size)
  783. if err != nil {
  784. t.Fatal(err)
  785. }
  786. }
  787. var actualWorkbookData [][][]string
  788. var workbookCellTypes [][][]CellType
  789. var sheetNames []string
  790. for _, sheet := range readFile.Sheets {
  791. sheetData := [][]string{}
  792. sheetCellTypes := [][]CellType{}
  793. for _, row := range sheet.Rows {
  794. data := []string{}
  795. cellTypes := []CellType{}
  796. for _, cell := range row.Cells {
  797. str, err := cell.FormattedValue()
  798. if err != nil {
  799. t.Fatal(err)
  800. }
  801. data = append(data, str)
  802. cellTypes = append(cellTypes, cell.Type())
  803. }
  804. sheetData = append(sheetData, data)
  805. sheetCellTypes = append(sheetCellTypes, cellTypes)
  806. }
  807. sheetNames = append(sheetNames, sheet.Name)
  808. actualWorkbookData = append(actualWorkbookData, sheetData)
  809. workbookCellTypes = append(workbookCellTypes, sheetCellTypes)
  810. }
  811. return sheetNames, actualWorkbookData, workbookCellTypes
  812. }
  813. func (s *StreamSuite) TestAddSheetErrorsAfterBuild(t *C) {
  814. file := NewStreamFileBuilder(bytes.NewBuffer(nil))
  815. err := file.AddSheet("Sheet1", []string{"Header"}, nil)
  816. if err != nil {
  817. t.Fatal(err)
  818. }
  819. err = file.AddSheet("Sheet2", []string{"Header2"}, nil)
  820. if err != nil {
  821. t.Fatal(err)
  822. }
  823. _, err = file.Build()
  824. if err != nil {
  825. t.Fatal(err)
  826. }
  827. err = file.AddSheet("Sheet3", []string{"Header3"}, nil)
  828. if err != BuiltStreamFileBuilderError {
  829. t.Fatal(err)
  830. }
  831. }
  832. func (s *StreamSuite) TestBuildErrorsAfterBuild(t *C) {
  833. file := NewStreamFileBuilder(bytes.NewBuffer(nil))
  834. err := file.AddSheet("Sheet1", []string{"Header"}, nil)
  835. if err != nil {
  836. t.Fatal(err)
  837. }
  838. err = file.AddSheet("Sheet2", []string{"Header2"}, nil)
  839. if err != nil {
  840. t.Fatal(err)
  841. }
  842. _, err = file.Build()
  843. if err != nil {
  844. t.Fatal(err)
  845. }
  846. _, err = file.Build()
  847. if err != BuiltStreamFileBuilderError {
  848. t.Fatal(err)
  849. }
  850. }
  851. func TestCloseWithNothingWrittenToSheets(t *testing.T) {
  852. buffer := bytes.NewBuffer(nil)
  853. file := NewStreamFileBuilder(buffer)
  854. sheetNames := []string{"Sheet1", "Sheet2"}
  855. workbookData := [][][]string{
  856. {{"Header1", "Header2"}},
  857. {{"Header3", "Header4"}},
  858. }
  859. err := file.AddSheet(sheetNames[0], workbookData[0][0], nil)
  860. if err != nil {
  861. t.Fatal(err)
  862. }
  863. err = file.AddSheet(sheetNames[1], workbookData[1][0], nil)
  864. if err != nil {
  865. t.Fatal(err)
  866. }
  867. stream, err := file.Build()
  868. if err != nil {
  869. t.Fatal(err)
  870. }
  871. err = stream.Close()
  872. if err != nil {
  873. t.Fatal(err)
  874. }
  875. bufReader := bytes.NewReader(buffer.Bytes())
  876. size := bufReader.Size()
  877. actualSheetNames, actualWorkbookData, _ := readXLSXFile(t, "", bufReader, size, false)
  878. // check if data was able to be read correctly
  879. if !reflect.DeepEqual(actualSheetNames, sheetNames) {
  880. t.Fatal("Expected sheet names to be equal")
  881. }
  882. if !reflect.DeepEqual(actualWorkbookData, workbookData) {
  883. t.Fatal("Expected workbook data to be equal")
  884. }
  885. }