✨ add replace_or_create_from_records, list_worksheets, delete_worksheet

[rafaelleinio]

Note

Low Risk
Additive API and tests only; delete_worksheet can remove remote tabs but behavior is explicit and documented.

Overview
Extends the Google Sheets client with worksheet lifecycle operations beyond the existing replace_from_records path (which still requires the tab to exist).

replace_or_create_from_records opens the spreadsheet, creates the named worksheet when WorksheetNotFound is raised (sized with min_rows and data length), otherwise resizes rows/cols as needed, then clears and writes header + records like replace_from_records—and returns the Worksheet (e.g. for its URL).

list_worksheets returns all Worksheet objects for a document via _open_document. delete_worksheet resolves the tab by name and calls del_worksheet (missing names still surface WorksheetNotFound).

Unit tests add shared spreadsheet/worksheet mocks and cover create-on-miss, list, and delete wiring through _open_document.

^{Reviewed by Cursor Bugbot for commit 91ad634. Bugbot is set up for automated code reviews on this repo. Configure here.}

[adaptcom]

Confidence Score: 4/5

Summary

Adds three additive Google Sheets helpers (replace-or-create worksheet, list, delete) with unit tests; all 11 unit tests pass locally. No existing behavior changed; risk is low.

Important Files Changed

File	Overview
gcpde/sheets.py	New replace_or_create_from_records, list_worksheets, delete_worksheet helpers
tests/unit/test_sheets.py	Autospec-based unit tests covering the three new functions

↻ Re-run review · View in Adapt

[adaptcom]

Use the existing ListJsonType alias (identical to list[dict[str, Any]]) to stay consistent with replace_from_records.

[adaptcom]

resize() also runs right after add_worksheet already sized the sheet, costing a redundant no-op API call; skip it on the create path.