maybeai-sheet-cli 0.6.0__tar.gz → 0.7.0__tar.gz

{maybeai_sheet_cli-0.6.0 → maybeai_sheet_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maybeai-sheet-cli
-Version: 0.6.0
+Version: 0.7.0
 Summary: CLI for common MaybeAI spreadsheet operations
 Project-URL: Homepage, https://github.com/OmniMCP-AI/maybeai-sheet-cli
 Project-URL: Repository, https://github.com/OmniMCP-AI/maybeai-sheet-cli
@@ -226,7 +226,7 @@ mbs
 │
 ├── excel_worksheet
 │   ├── read                     API   Read the full range of the worksheet.
-│   ├── list-table               API   List worksheets in a workbook.
+│   ├── list-table               API   Detect content-backed tables in a worksheet.
 │   ├── create                   API   Create a worksheet, optionally with starter values.
 │   ├── update                   API   Update worksheet metadata.
 │   ├── sample                   PLAN  Return bounded worksheet/range sample rows.
@@ -351,6 +351,7 @@ mbs excel-worksheet read --doc-id abc123 --worksheet-name Actuals --range A1:D20
 mbs excel-worksheet create --doc-id abc123 --name Actuals  # API
 mbs excel-worksheet update --doc-id abc123 --worksheet-name Actuals --title "Actuals FY26"  # API
 mbs excel-worksheet metadata --doc-id abc123 --worksheet-name Actuals  # API
+mbs excel-worksheet list-table --doc-id abc123 --gid 3  # API
 mbs excel-worksheet sample --doc-id abc123 --worksheet-name Actuals --range A1:Z5000 --limit 50  # PLAN
 
 # excel-worksheet range

{maybeai_sheet_cli-0.6.0 → maybeai_sheet_cli-0.7.0}/README.md

@@ -202,7 +202,7 @@ mbs
 │
 ├── excel_worksheet
 │   ├── read                     API   Read the full range of the worksheet.
-│   ├── list-table               API   List worksheets in a workbook.
+│   ├── list-table               API   Detect content-backed tables in a worksheet.
 │   ├── create                   API   Create a worksheet, optionally with starter values.
 │   ├── update                   API   Update worksheet metadata.
 │   ├── sample                   PLAN  Return bounded worksheet/range sample rows.
@@ -327,6 +327,7 @@ mbs excel-worksheet read --doc-id abc123 --worksheet-name Actuals --range A1:D20
 mbs excel-worksheet create --doc-id abc123 --name Actuals  # API
 mbs excel-worksheet update --doc-id abc123 --worksheet-name Actuals --title "Actuals FY26"  # API
 mbs excel-worksheet metadata --doc-id abc123 --worksheet-name Actuals  # API
+mbs excel-worksheet list-table --doc-id abc123 --gid 3  # API
 mbs excel-worksheet sample --doc-id abc123 --worksheet-name Actuals --range A1:Z5000 --limit 50  # PLAN
 
 # excel-worksheet range

{maybeai_sheet_cli-0.6.0 → maybeai_sheet_cli-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "maybeai-sheet-cli"
-version = "0.6.0"
+version = "0.7.0"
 description = "CLI for common MaybeAI spreadsheet operations"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -39,3 +39,11 @@ mbs = "maybeai_sheet.cli:app"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/maybeai_sheet"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/tests",
+  "/README.md",
+  "/pyproject.toml",
+]

{maybeai_sheet_cli-0.6.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.6.0"
+__version__ = "0.7.0"

{maybeai_sheet_cli-0.6.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/cli.py

@@ -52,6 +52,7 @@ def main(
     base_url: str = typer.Option(
         "https://play-be.omnimcp.ai",
         "--base-url",
+        envvar="MAYBEAI_BASE_URL",
         help="MaybeAI API base URL.",
     ),
     doc_id: Optional[str] = typer.Option(

{maybeai_sheet_cli-0.6.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/commands/excel_worksheet.py

@@ -288,6 +288,7 @@ def list_table(
     doc_id: Optional[str] = typer.Option(None, "--doc-id", help="MaybeAI document ID."),
     url: Optional[str] = typer.Option(None, "--url", help="MaybeAI workbook URL."),
     uri: Optional[str] = typer.Option(None, "--uri", help="Resolved workbook URI."),
+    gid: Optional[int] = typer.Option(None, "--gid", help="Worksheet gid."),
     worksheet_name: Optional[str] = typer.Option(None, "--worksheet-name", help="Optional worksheet name filter."),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
@@ -299,12 +300,16 @@ def list_table(
             doc_id=doc_id,
             url=url,
             uri=uri,
+            gid=gid,
             worksheet_name=worksheet_name,
             output=output,
             verbose=verbose,
             timeout=timeout,
         )
-        target = resolve_target(state)
+        target = resolve_target(
+            state,
+            force_gid_uri=bool(state.gid is not None and not state.worksheet_name),
+        )
         if target.worksheet_name or target.gid is not None:
             endpoint = "/api/v1/excel/table/metadata"
             payload: dict[str, object] = {

{maybeai_sheet_cli-0.6.0 → maybeai_sheet_cli-0.7.0}/tests/test_cli.py

@@ -24,6 +24,30 @@ class CLITests(unittest.TestCase):
         self.runner = CliRunner()
         self.env = {"MAYBEAI_API_TOKEN": "test-token"}
 
+    def test_base_url_can_come_from_environment(self) -> None:
+        captured: dict[str, str] = {}
+
+        def capture_init(client: MaybeAIClient, state: CLIContext) -> None:
+            captured["base_url"] = state.base_url
+            client.state = state
+
+        with (
+            patch.object(MaybeAIClient, "__init__", capture_init),
+            patch.object(MaybeAIClient, "post_json") as post_json,
+        ):
+            post_json.return_value = {"success": True, "worksheets": []}
+            result = self.runner.invoke(
+                app,
+                ["workbook", "list-worksheets", "--doc-id", "doc1"],
+                env={
+                    "MAYBEAI_API_TOKEN": "test-token",
+                    "MAYBEAI_BASE_URL": "http://localhost:7011",
+                },
+            )
+
+        self.assertEqual(result.exit_code, 0, result.output)
+        self.assertEqual(captured["base_url"], "http://localhost:7011")
+
     def test_workbook_create_uses_blank_bootstrap_and_filename(self) -> None:
         with patch("maybeai_sheet.commands.workbook.MaybeAIClient.post_json") as post_json:
             post_json.return_value = {"success": True, "spreadsheet_id": "doc1"}

{maybeai_sheet_cli-0.6.0 → maybeai_sheet_cli-0.7.0}/tests/test_two_engine_cli.py

@@ -103,6 +103,30 @@ class TwoEngineCLITests(unittest.TestCase):
         self.assertEqual(post_json.call_args_list[0].args[1]["worksheet_name"], "Orders")
         self.assertEqual(post_json.call_args_list[1].args[0], "/api/v1/excel/list_worksheets")
 
+    def test_excel_worksheet_list_table_accepts_gid(self) -> None:
+        with patch("maybeai_sheet.commands.excel_worksheet.MaybeAIClient.post_json") as post_json:
+            post_json.return_value = {
+                "success": True,
+                "tables": [
+                    {"range": "A1:I16", "row_count": 16, "column_count": 9},
+                    {"range": "A20:I27", "row_count": 8, "column_count": 9},
+                ],
+            }
+            result = self.runner.invoke(
+                app,
+                ["excel-worksheet", "list-table", "--doc-id", "abc123", "--gid", "3"],
+                env=self.env,
+            )
+
+        self.assertEqual(result.exit_code, 0, result.output)
+        self.assertEqual(post_json.call_args_list[0].args[0], "/api/v1/excel/table/metadata")
+        payload = post_json.call_args_list[0].args[1]
+        self.assertEqual(payload["document_id"], "abc123")
+        self.assertEqual(payload["uri"], "https://www.maybe.ai/docs/spreadsheets/d/abc123?gid=3")
+        self.assertEqual(payload["gid"], 3)
+        self.assertEqual(payload["engine"], "excelize")
+        self.assertNotIn("worksheet_name", payload)
+
     def test_excel_worksheet_read_uses_v1_read_sheet(self) -> None:
         with patch("maybeai_sheet.commands.excel_worksheet.MaybeAIClient.post_json") as post_json:
             post_json.return_value = {"success": True, "values": [["Name"], ["Alice"]]}

maybeai_sheet_cli-0.6.0/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "mcp__google-search__performGoogleSearch",
-      "WebFetch(domain:www.npmjs.com)",
-      "WebFetch(domain:advenboost.com)"
-    ]
-  }
-}

maybeai_sheet_cli-0.6.0/CLAUDE.md

@@ -1,46 +0,0 @@
-# CLAUDE.md
-
-## Repo Purpose
-
-This repository contains the `maybeai-sheet` Python CLI for MaybeAI spreadsheet APIs.
-
-## Working Rules
-
-- Keep docs and CLI behavior aligned with the actual code.
-- Prefer small, targeted changes.
-- Do not rename commands or flags unless the implementation changes too.
-- Preserve JSON as the default output format.
-
-## Project Map
-
-- `src/maybeai_sheet/cli.py` - top-level Typer app and global options
-- `src/maybeai_sheet/update.py` - PyPI self-update helpers
-- `src/maybeai_sheet/commands/` - `workbook`, `sheet`, and `raw` command groups
-- `src/maybeai_sheet/client.py` - HTTP client and request helpers
-- `src/maybeai_sheet/resolver.py` - document and worksheet target resolution
-- `src/maybeai_sheet/formatters.py` - JSON, YAML, and table rendering
-- `tests/` - CLI, resolver, and formatter tests
-
-## Common Commands
-
-```bash
-python -m unittest discover -s tests -v
-```
-
-```bash
-python -m maybeai_sheet.cli --help
-```
-
-## Implementation Notes
-
-- Token source order is `--token` then `MAYBEAI_API_TOKEN`.
-- The default API base URL is `https://play-be.omnimcp.ai`.
-- `--doc-id` is converted to a MaybeAI workbook URL when needed.
-- `sheet headers` and formula reads rely on gid-aware URI resolution.
-- `--verify` on write/append/upsert commands reads the sheet back after the write.
-
-## Editing Guidance
-
-- Update README examples when adding or changing commands.
-- Keep request/response examples consistent with the tests.
-- If behavior changes, add or update tests in `tests/` before finishing.

maybeai_sheet_cli-0.6.0/cli-packaging-plan.md

@@ -1,279 +0,0 @@
-# MaybeAI Sheet CLI Plan
-
-## Recommendation
-
-Yes, a CLI is worth adding for the highest-frequency operations, especially:
-
-- `workbook_manifest`
-- `read_sheet`
-- `read_headers`
-- `list_worksheets`
-- `append_rows`
-- `update_range_by_lookup`
-- `update_range`
-- `clear_range`
-- `write_new_worksheet`
-- `formula_set`
-- `formula_batch_set`
-- `recalculate_formulas`
-- `workbook_profile`
-- `export`
-
-It is **not** a good replacement for the entire API surface. The repo already shows a large endpoint set, so the right design is:
-
-1. First-class commands for the common workflows
-2. Stable shared flags for auth, workbook, and worksheet targeting
-3. A generic `api` or `raw` command for less-used endpoints
-
-That keeps the CLI small enough to publish and maintain.
-
-## Why a CLI Helps
-
-For common sheet work, the current `curl` scripts have three recurring costs:
-
-- repeated auth and base URL boilerplate
-- repeated `uri` and `gid` handling
-- repeated JSON escaping for structured payloads
-
-A CLI improves:
-
-- usability for humans
-- repeatability in scripts and CI
-- discoverability through `--help`
-- safer worksheet targeting through shared options
-
-## Product Scope
-
-Package identity:
-
-- distribution name: `maybeai-sheet-cli`
-- executable: `mbs`
-- import package: `maybeai_sheet`
-
-Recommended executable:
-
-```bash
-mbs
-```
-
-Recommended Python baseline:
-
-- Python `>=3.10`
-
-Recommended implementation:
-
-- `typer` for CLI
-- `httpx` for HTTP client
-- `pydantic` for payload validation
-- `rich` for readable table / JSON output
-
-## CLI Shape
-
-```bash
-mbs [global options] <resource> <command> [command options]
-```
-
-Global options:
-
-- `--token` or env `MAYBEAI_API_TOKEN`
-- `--base-url` default `https://play-be.omnimcp.ai`
-- `--doc-id`
-- `--uri`
-- `--gid`
-- `--worksheet-name`
-- `--output json|table|yaml`
-- `--verbose`
-
-Resolution rules:
-
-1. If `--uri` is provided, use it
-2. Else if `--doc-id` is provided, build `https://www.maybe.ai/docs/spreadsheets/d/<doc_id>`
-3. If `--gid` is provided, append `?gid=<gid>` where required
-4. Prefer `--worksheet-name` for commands that support it
-
-## Proposed Commands
-
-### Read path
-
-```bash
-mbs sheet read --doc-id <id> --worksheet-name Sheet1
-mbs sheet read --doc-id <id> --worksheet-name Sheet1 --range A1:C20
-mbs sheet read-many --doc-id <id> --targets targets.json
-mbs sheet named-range --doc-id <id> --name RevenueBlock
-mbs sheet headers --doc-id <id> --gid 0
-mbs sheet worksheets --doc-id <id>
-mbs sheet profile --doc-id <id> --force-refresh
-```
-
-### Write path
-
-```bash
-mbs sheet append --doc-id <id> --gid 0 --rows rows.json
-mbs sheet upsert --doc-id <id> --gid 0 --key OrderID --rows rows.json
-mbs sheet write-range --doc-id <id> --worksheet-name Sheet1 --range A1:C3 --values values.json
-mbs sheet clear-range --doc-id <id> --worksheet-name Sheet1 --range A1:C3
-mbs sheet create-worksheet --doc-id <id> --name Summary --values values.json
-mbs sheet formula-set --doc-id <id> --worksheet-name Sheet1 --cell E2 --formula '=SUM(B2:D2)'
-mbs sheet formula-batch-set --doc-id <id> --operations ops.json --recalculate-mode worksheet
-mbs sheet recalculate --doc-id <id> --worksheet-name Sheet1
-```
-
-### File path
-
-```bash
-mbs file upload ./report.xlsx
-mbs file export --doc-id <id> --out final.xlsx
-mbs file search "q2 forecast"
-```
-
-### Escape hatch
-
-```bash
-mbs raw post /api/v3/excel/range/read --body body.json
-```
-
-The `raw` command prevents CLI growth from tracking every niche endpoint.
-
-## Command Mapping
-
-| CLI command | API endpoint |
-|---|---|
-| `workbook manifest` | `POST /api/v3/excel/workbook/manifest` |
-| `workbook capabilities` | `POST /api/v3/excel/workbook/capabilities` |
-| `sheet read` | `POST /api/v3/excel/range/read` |
-| `sheet read-range` | `POST /api/v3/excel/range/read` |
-| `sheet read-many` | `POST /api/v3/excel/range/read_many` |
-| `sheet named-range` | `POST /api/v3/excel/named_range/read` |
-| `sheet headers` | `POST /api/v3/excel/table/headers` |
-| `sheet worksheets` | `POST /api/v3/excel/worksheet/list` |
-| `sheet formulas` | `POST /api/v3/excel/formula/read` |
-| `sheet append` | `POST /api/v3/excel/table/append_rows` |
-| `sheet upsert` | `POST /api/v3/excel/table/upsert_rows` |
-| `sheet write-range` | `POST /api/v3/excel/range/write` |
-| `sheet clear-range` | `POST /api/v3/excel/range/clear` |
-| `sheet create-worksheet` | `POST /api/v3/excel/worksheet/create` |
-| `sheet formula-set` | `POST /api/v3/excel/formula/set` |
-| `sheet formula-batch-set` | `POST /api/v3/excel/formula/batch_set` |
-| `sheet recalculate` | `POST /api/v3/excel/formula/recalculate` |
-| `sheet profile` | `POST /api/v1/excel/workbook_profile` |
-| `file upload` | `POST /api/v1/excel/upload` |
-| `file export` | `GET /api/v1/excel/export/{document_id}` |
-
-## UX Rules
-
-The CLI should encode the operational rules already documented in this repo:
-
-1. Warn when neither `--worksheet-name` nor `--gid` is provided for worksheet-sensitive commands
-2. Prefer `workbook manifest` before read/write commands when the target worksheet is not already known
-3. Prefer `--worksheet-name` for `sheet read`, `sheet write-range`, and `sheet formula-set`
-4. Prefer `--gid` for `sheet headers`, `sheet append`, and `sheet upsert`
-5. Support `--verify` on write commands to automatically read back after write
-6. Support `--dry-run` where payload generation can be previewed safely
-
-Example:
-
-```bash
-mbs sheet upsert \
-  --doc-id $DOC_ID \
-  --gid 0 \
-  --key OrderID \
-  --rows sales.json \
-  --verify
-```
-
-## Suggested Package Layout
-
-```text
-src/maybeai_sheet/
-  __init__.py
-  cli.py
-  config.py
-  client.py
-  models.py
-  formatters.py
-  commands/
-    file.py
-    sheet.py
-    raw.py
-tests/
-pyproject.toml
-README.md
-```
-
-## `pyproject.toml` Direction
-
-Use a console script entry point:
-
-```toml
-[project]
-name = "maybeai-sheet-cli"
-version = "0.3.0"
-description = "CLI for common MaybeAI spreadsheet operations"
-requires-python = ">=3.10"
-dependencies = ["typer", "httpx", "pydantic", "rich"]
-
-[project.scripts]
-mbs = "maybeai_sheet.cli:app"
-```
-
-Build backend:
-
-- `hatchling` or `setuptools`
-
-Recommended:
-
-- `hatchling`
-
-## Publish-to-PyPI Plan
-
-### Phase 1
-
-Build a thin MVP around the most-used read/write flows:
-
-- `workbook manifest`
-- `sheet read`
-- `sheet headers`
-- `sheet worksheets`
-- `sheet append`
-- `sheet upsert`
-- `sheet write-range`
-- `sheet clear-range`
-- `sheet create-worksheet`
-- `sheet formula-set`
-- `sheet formula-batch-set`
-- `sheet recalculate`
-- `file upload`
-- `file export`
-
-### Phase 2
-
-Add operator-safety and better UX:
-
-- `--verify`
-- `--output table`
-- better error messages for auth and wrong-sheet targeting
-- `sheet profile`
-
-### Phase 3
-
-Publish:
-
-1. reserve package name on PyPI
-2. add `pyproject.toml`
-3. add README with install and auth setup
-4. add tests for request construction
-5. build with `python -m build`
-6. publish with `twine upload dist/*` or trusted publishing
-
-## What Not To Do
-
-- Do not create one CLI command per endpoint on day one
-- Do not force users to hand-build JSON strings for common commands
-- Do not hide worksheet targeting semantics
-- Do not publish before adding at least smoke tests for the common commands
-
-## Bottom Line
-
-Yes, a pip-published CLI is a good fit here, but only if it is opinionated around the top workflows and does not try to mirror the full backend surface.
-
-The first command to optimize is `read_sheet`, followed by the table-safe write commands.