improve rowWithRange SkipSearch performance

RELEASE_NOTES.md

@@ -1,3 +1,7 @@
+### 5.1.1+e7cc638 (Released 2024-1-26)
+* Additions:
+    * [[#e7cc638](https://github.com/CSBiology/FsSpreadsheet/commit/e7cc638b170c570005b6cd8378d1e0ac31075be7)] improve rowWithRange SkipSearch performance
+
 ### 5.1.0+4732d22 (Released 2024-1-24)
 * Additions:
     * Increase Parser speed

build/ReleaseTasks.fs

@@ -62,7 +62,7 @@ let publishNPM = BuildTask.create "PublishNPM" [clean; build; runTests; packJS]
     let msg = sprintf "[NPM] release package with version %s?" stableVersionTag
     if promptYesNo msg then
         let apikey = Environment.environVarOrNone "NPM_KEY" 
-        let otp = if apikey.IsSome then $" --otp + {apikey.Value}" else ""
+        let otp = if apikey.IsSome then $" --otp {apikey.Value}" else ""
         run npm $"publish --access public{otp}" ProjectInfo.npmPkgDir
     else failwith "aborted"
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fslab/fsspreadsheet",
-  "version": "5.1.0",
+  "version": "5.1.1",
   "description": "Minimal spreadsheet creation and manipulation using exceljs io.",
   "type": "module",
   "main": "Xlsx.js",

src/FsSpreadsheet/FsWorksheet.fs

@@ -132,7 +132,13 @@
     /// <summary>
     /// Returns the FsRow at the given index. If it does not exist, it is created and appended first.
     /// </summary>
-    member self.Row(rowIndex) = 
+    member self.Row(rowIndex, ?SkipSearch) = 
+        let skipSearch = defaultArg SkipSearch false
+        if skipSearch then
+            let row = FsRow.createAt(rowIndex,self.CellCollection) 
+            _rows.Add row
+            row
+        else
         match _rows |> Seq.tryFind (fun row -> row.Index = rowIndex) with
         | Some row ->
             row
@@ -141,7 +147,7 @@
             _rows.Add row
             row
 
     /// <summary>
     /// Returns the FsRow at the given FsRangeAddress. If it does not exist, it is created and appended first.
     /// </summary>
     /// <param name="SkipSearch">If true, the FsRow is created and appended without checking if it already exists.</param>
@@ -150,7 +156,7 @@
         if rangeAddress.FirstAddress.RowNumber <> rangeAddress.LastAddress.RowNumber then
             failwithf "Row may not have a range address spanning over different row indices"
         if skipSearch then
-            let row = FsRow.createAt(rangeAddress.FirstAddress.RowNumber,self.CellCollection) 
+            let row = FsRow (rangeAddress, self.CellCollection)
             row.RangeAddress <- rangeAddress
             _rows.Add row
             row

tests/FsSpreadsheet.Tests/FsRowTests.fs

@@ -1,6 +1,6 @@
 module FsRow
 
-
+open TestingUtils
 #if FABLE_COMPILER
 open Fable.Mocha
 #else
@@ -17,7 +17,27 @@ let getDummyWorkSheet() =
     worksheet.RescanRows()
     worksheet
 
-let main =
+
+let performace =
+    testList "performance" [
+        testCase "FrowFromRange-SkipSearch" (fun () ->
+            let rowCount= 100000
+            let ws = FsWorksheet.init("MyWorksheet")
+            let timer = Stopwatch()
+            timer.Start()
+            for i = 1 to rowCount do
+                let address = FsRangeAddress(FsAddress(i,1), FsAddress(i,1))
+                ws.RowWithRange(address,true) |> ignore
+            timer.Stop()
+            let runtime = timer.Elapsed.Milliseconds
+            let expected = 50 // this is too high and should be reduced
+
+            Expect.equal ws.Rows.Count rowCount "Row count"
+            Expect.isTrue (runtime <= expected) $"Expected conversion to be finished in under {expected}, but it took {runtime}"
+        )
+    ]
+
+let rowOperations =
     testList "rowOperations" [
         testList "Prerequisites" [
             let dummyWorkSheet = getDummyWorkSheet()
@@ -117,3 +137,9 @@ let main =
                 Expect.equal maxColIndex 1 "Incorrect index"
         ]
     ]
+
+let main =
+    testList "FsRow" [
+        rowOperations
+        performace
+    ]

tests/FsSpreadsheet.Tests/FsSpreadsheet.Tests.fsproj

@@ -31,6 +31,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\..\src\FsSpreadsheet\FsSpreadsheet.fsproj" />
+    <ProjectReference Include="..\TestUtils\TestUtils.fsproj" />
   </ItemGroup>
 
   <ItemGroup>