matrix-gsheets: implement v0.2.0 roadmap

matrix-bom/bom.xml

@@ -41,7 +41,7 @@
     <matrixDatasetsVersion>2.1.3-SNAPSHOT</matrixDatasetsVersion>
     <matrixGgplotVersion>0.5.0-SNAPSHOT</matrixGgplotVersion>
     <matrixGroovyExtVersion>0.2.0</matrixGroovyExtVersion>
-    <matrixGsheetsVersion>0.1.2-SNAPSHOT</matrixGsheetsVersion>
+    <matrixGsheetsVersion>0.2.0-SNAPSHOT</matrixGsheetsVersion>
     <matrixJsonVersion>2.2.0</matrixJsonVersion>
     <matrixLoggingVersion>0.1.0-SNAPSHOT</matrixLoggingVersion>
     <matrixParquetVersion>0.5.0</matrixParquetVersion>

matrix-gsheets/build.gradle

@@ -10,7 +10,7 @@ plugins {
 }
 
 group = 'se.alipsa.matrix'
-version = '0.1.2-SNAPSHOT'
+version = '0.2.0-SNAPSHOT'
 description = 'Google Sheets import/export'
 
 repositories {

matrix-gsheets/docs/0.1-0.2-MIGRATION.md

@@ -0,0 +1,64 @@
+# Migration Guide: matrix-gsheets 0.1 → 0.2
+
+## Breaking Changes
+
+### Renamed Authentication Classes
+
+The `Bq*` prefix (short for BigQuery) was historically confusing because these classes are used exclusively for Google Sheets authentication. They have been renamed:
+
+| Old Name (0.1) | New Name (0.2) |
+|----------------|----------------|
+| `BqAuthenticator` | `GsAuthenticator` |
+| `BqAuthUtils` | `GsAuthUtils` |
+
+#### Required Changes
+
+Update any direct references to the old class names:
+
+```groovy
+// Before (0.1)
+import se.alipsa.matrix.gsheets.BqAuthenticator
+BqAuthenticator.authenticate(BqAuthenticator.SCOPE_SHEETS)
+
+// After (0.2)
+import se.alipsa.matrix.gsheets.GsAuthenticator
+GsAuthenticator.authenticate(GsAuthenticator.SCOPE_SHEETS)
+```
+
+```groovy
+// Before (0.1)
+import se.alipsa.matrix.gsheets.BqAuthUtils
+BqAuthUtils.loginAndWriteAdc(...)
+
+// After (0.2)
+import se.alipsa.matrix.gsheets.GsAuthUtils
+GsAuthUtils.loginAndWriteAdc(...)
+```
+
+The static constants (`SCOPE_SHEETS`, `SCOPE_DRIVE_FILE`, `ADC_FILE_PATH`, etc.) have the same names and values — only the class name changed.
+
+## New Features
+
+### Write to Existing Spreadsheets
+
+`GsheetsWriter` now supports updating an existing spreadsheet:
+
+```groovy
+GsheetsWriter.update(
+    '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms',
+    'Sheet1!A1',
+    matrix,
+    null,   // credentials
+    true,   // convert nulls to empty strings
+    false   // convert dates to serial
+)
+```
+
+### Spreadsheet URL Helper
+
+A convenience method for generating the edit URL:
+
+```groovy
+String url = GsheetsWriter.spreadsheetUrl(spreadsheetId)
+// -> https://docs.google.com/spreadsheets/d/{spreadsheetId}/edit
+```

matrix-gsheets/release.md

@@ -7,6 +7,7 @@
   - org.mockito:mockito-core 5.22.0 -> 5.23.0
   - org.mockito:mockito-junit-jupiter 5.22.0 -> 5.23.0
   - se.alipsa.nexus-release-plugin:se.alipsa.nexus-release-plugin.gradle.plugin 2.1.1 -> 2.1.2
+- rename BqAuthenticator to GsAuthenticator and BqAuthUtils to GsAuthUtils 
 
 ## 0.1.1, 2026-01-31
 Move actual implementation for GsheetsReader and GsheetsWriter and utility methods to GsUtil so that GsImporter and GsExporter are just empty wrappers.