Release v2.0.2 — Result types

Author: diegoripera

CHANGELOG.md

@@ -12,7 +12,7 @@ This project follows [Semantic Versioning](https://semver.org/).
 | Area | v1 behaviour | v2 behaviour |
 |------|-------------|-------------|
 | **Constructor** | `new JetDatabaseReader(path)` | `AccessReader.Open(path)` — factory method required |
-| **`ReadTable()`** | Returned `(headers, rows, schema)` tuple | **Renamed** to `ReadTablePreview()` |
+| **`ReadTable()`** | Returned `(headers, rows, schema)` tuple | Now an overload — `ReadTable(string, int)` returns `TableResult` |
 | **`ReadTableAsDataTable()`** | Returned `DataTable` with `string` columns | **Renamed** to `ReadTableAsStringDataTable()` |
 | **`StreamRows()`** | Returned `IEnumerable<string[]>` | Now returns `IEnumerable<object[]>` with native CLR types |
 | **`ReadAllTables()`** | Returned `DataTable` with `string` columns | Now returns `DataTable` with typed CLR columns |
@@ -23,7 +23,9 @@ This project follows [Semantic Versioning](https://semver.org/).
 | Method | Description |
 |--------|-------------|
 | `ReadTable()` | Primary read method — typed `DataTable` (replaces `ReadTableAsDataTableTyped`) |
+| `ReadTable(string, int)` | Sampled-rows overload — returns `TableResult` (headers, rows, schema) |
 | `ReadTableAsync()` | Async typed `DataTable` |
+| `ReadTableAsync(string, int)` | Async sampled-rows overload — returns `Task<TableResult>` |
 | `StreamRowsAsStrings()` | Compatibility streaming — `IEnumerable<string[]>` |
 | `ReadAllTablesAsStrings()` | Bulk read with string columns |
 | `ReadAllTablesAsStringsAsync()` | Async bulk read with string columns |
@@ -36,6 +38,8 @@ This project follows [Semantic Versioning](https://semver.org/).
 | `TableQuery.Count()` / `CountAsStrings()` | Count per chain |
 | `GetColumnMetadata()` | Rich per-column metadata with CLR type |
 | `GetStatistics()` / `GetStatisticsAsync()` | Database-level statistics + cache hit rate |
+| `TableResult` | Result type for sampled-rows overload — `Headers`, `Rows`, `Schema` |
+| `TableColumn` | Schema entry — `Name`, `TypeName`, `SizeDesc` |
 
 ### 🔧 Improvements
 
@@ -68,11 +72,12 @@ DataTable dt = r.ReadTableAsDataTable("Orders");
 // v2
 DataTable dt = r.ReadTableAsStringDataTable("Orders");
 
-// ── Preview with schema ──────────────────────────────────────────────
+// ── Sample with schema ──────────────────────────────────────────────
 // v1
 var (h, rows, schema) = r.ReadTable("Orders", maxRows: 10);
 // v2
-var (h, rows, schema) = r.ReadTablePreview("Orders", maxRows: 10);
+TableResult p = r.ReadTable("Orders", 10);
+// p.Headers / p.Rows / p.Schema[i].Name, .TypeName, .SizeDesc
 
 // ── Stream rows (typed) ──────────────────────────────────────────────
 // v1

…seReader.Tests/AccessReaderAsyncTests.cs …der.Tests/Core/AccessReaderAsyncTests.csJetDatabaseReader.Tests/AccessReaderAsyncTests.cs renamed to JetDatabaseReader.Tests/Core/AccessReaderAsyncTests.cs JetDatabaseReader.Tests/AccessReaderAsyncTests.cs renamed to JetDatabaseReader.Tests/Core/AccessReaderAsyncTests.cs

@@ -244,7 +244,7 @@ public void ReadTable_Preview_HeadersMatchSchemaColumnNames(string path)
             using var reader = TestDatabases.Open(path);
             string table = reader.ListTables()[0];
 
-            TablePreviewResult preview = reader.ReadTable(table, maxRows: 10);
+            TableResult preview = reader.ReadTable(table, maxRows: 10);
 
             preview.Headers.Should().HaveCount(preview.Schema.Count);
             for (int i = 0; i < preview.Headers.Count; i++)
@@ -259,7 +259,7 @@ public void ReadTable_Preview_RowCount_DoesNotExceedMaxRows(string path)
             string table = reader.ListTables()[0];
             const int max = 5;
 
-            TablePreviewResult preview = reader.ReadTable(table, maxRows: max);
+            TableResult preview = reader.ReadTable(table, maxRows: max);
 
             preview.Rows.Should().HaveCountLessThanOrEqualTo(max);
         }
@@ -271,7 +271,7 @@ public void ReadTable_Preview_EachRow_HasSameColumnCountAsHeaders(string path)
             using var reader = TestDatabases.Open(path);
             string table = reader.ListTables()[0];
 
-            TablePreviewResult preview = reader.ReadTable(table, maxRows: 20);
+            TableResult preview = reader.ReadTable(table, maxRows: 20);
 
             foreach (var row in preview.Rows)
                 row.Should().HaveCount(preview.Headers.Count);

…aseReader.Tests/AccessReaderCoreTests.cs …ader.Tests/Core/AccessReaderCoreTests.csJetDatabaseReader.Tests/AccessReaderCoreTests.cs renamed to JetDatabaseReader.Tests/Core/AccessReaderCoreTests.cs JetDatabaseReader.Tests/AccessReaderCoreTests.cs renamed to JetDatabaseReader.Tests/Core/AccessReaderCoreTests.cs

@@ -773,29 +773,29 @@ public long GetRealRowCount(string tableName)
         /// Returns column headers, sampled rows (as strings), and per-column schema.
         /// Useful for previewing table structure and data.
         /// </summary>
-        public TablePreviewResult ReadTable(string tableName, int maxRows)
+        public TableResult ReadTable(string tableName, int maxRows)
         {
             CatalogEntry entry = GetCatalogEntry(tableName);
 
             if (entry == null)
-                return new TablePreviewResult
+                return new TableResult
                 {
                     Headers = new List<string>(),
                     Rows    = new List<List<string>>(),
-                    Schema  = new List<TablePreviewColumn>()
+                    Schema  = new List<TableColumn>()
                 };
 
             TableDef td = ReadTableDef(entry.TDefPage);
             if (td == null || td.Columns.Count == 0)
-                return new TablePreviewResult
+                return new TableResult
                 {
                     Headers = new List<string>(),
                     Rows    = new List<List<string>>(),
-                    Schema  = new List<TablePreviewColumn>()
+                    Schema  = new List<TableColumn>()
                 };
 
             var headers = td.Columns.ConvertAll(c => c.Name);
-            var schema  = td.Columns.ConvertAll(c => new TablePreviewColumn
+            var schema  = td.Columns.ConvertAll(c => new TableColumn
             {
                 Name     = c.Name,
                 TypeName = TypeCodeToName(c.Type),
@@ -817,7 +817,7 @@ public TablePreviewResult ReadTable(string tableName, int maxRows)
                 }
             }
 
-            return new TablePreviewResult { Headers = headers, Rows = rows, Schema = schema };
+            return new TableResult { Headers = headers, Rows = rows, Schema = schema };
         }
 
         private static string TypeCodeToName(byte t)
@@ -1188,7 +1188,7 @@ public Task<DataTable> ReadTableAsync(string tableName = null, IProgress<int> pr
         /// Async overload of <see cref="ReadTable(string, int)"/>.
         /// Reads up to <paramref name="maxRows"/> rows and schema information asynchronously.
         /// </summary>
-        public Task<TablePreviewResult> ReadTableAsync(string tableName, int maxRows)
+        public Task<TableResult> ReadTableAsync(string tableName, int maxRows)
         {
             return Task.Run(() => ReadTable(tableName, maxRows));
         }

…aseReader.Tests/AccessReaderReadTests.cs …ader.Tests/Core/AccessReaderReadTests.csJetDatabaseReader.Tests/AccessReaderReadTests.cs renamed to JetDatabaseReader.Tests/Core/AccessReaderReadTests.cs JetDatabaseReader.Tests/AccessReaderReadTests.cs renamed to JetDatabaseReader.Tests/Core/AccessReaderReadTests.cs

@@ -56,15 +56,14 @@ public interface IAccessReader : IDisposable
         /// Reads up to <paramref name="maxRows"/> rows from the table named
         /// <paramref name="tableName"/> (case-insensitive).
         /// Returns column headers, sampled rows (as strings), and per-column schema.
-        /// Useful for previewing table structure and data.
         /// </summary>
-        TablePreviewResult ReadTable(string tableName, int maxRows);
+        TableResult ReadTable(string tableName, int maxRows);
 
         /// <summary>
         /// Async overload of <see cref="ReadTable(string, int)"/>.
         /// Reads up to <paramref name="maxRows"/> rows and schema information asynchronously.
         /// </summary>
-        Task<TablePreviewResult> ReadTableAsync(string tableName, int maxRows);
+        Task<TableResult> ReadTableAsync(string tableName, int maxRows);
 
         /// <summary>
         /// Yields rows from <paramref name="tableName"/> as properly typed object arrays without collecting them all in memory.