tableau-cli 0.1.2__tar.gz → 0.1.4__tar.gz

tableau_cli-0.1.4/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(command -v uv)",
+      "Bash(uv --version)"
+    ]
+  }
+}

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tableau-cli
-Version: 0.1.2
+Version: 0.1.4
 Summary: CLI for Tableau Server/Cloud, designed for AI agent integration
 Project-URL: Repository, https://github.com/i-richardwang/tableau-cli
 Author: Richard Wang
@@ -132,7 +132,9 @@ tableau-cli datasources download <datasourceId> -o ./data/
 tableau-cli ds download <datasourceId> -o ./data/ --to parquet
 tableau-cli ds download <datasourceId> -o ./data/ --to csv
 
-# Get field metadata (VizQL Data Service + Metadata API enrichment)
+# Get field metadata (VizQL Data Service + Metadata API enrichment).
+# On Tableau >= 2025.3 the result also includes the datasource model:
+# logical tables and their relationships.
 tableau-cli datasources metadata <luid>
 
 # Query datasource data (VizQL Data Service)
@@ -143,21 +145,33 @@ tableau-cli ds query <luid> --query '{"fields": [...]}' --limit 100
 ### Views
 
 ```bash
-# List views
+# List views (includes upstream datasources via Metadata API enrichment)
 tableau-cli views list
 tableau-cli views list --filter "name:has:Dashboard" --format table
 
+# Get view details: upstream datasources, workbook/project/owner info, and web URL
+tableau-cli views get <viewId>
+
 # Get view data as CSV
 tableau-cli views data <viewId>
 
+# Get view data with view filters applied
+tableau-cli views data <viewId> --vf "Region=West" --vf "Category=Technology"
+
 # Download view image
 tableau-cli views image <viewId> -o dashboard.png
 tableau-cli views image <viewId> --width 1200 --height 800 --img-format SVG -o dashboard.svg
+tableau-cli views image <viewId> --vf "Region=West" -o west.png
 ```
 
 ### Convert
 
-Convert local TDSX/HYPER files to Parquet or CSV. Requires `pip install tableau-cli[convert]`.
+Convert local TDSX/HYPER files to Parquet or CSV.
+
+Conversion needs heavier packages (`pantab`, `polars`, `pyarrow`). You have two options:
+
+- Install them into the CLI: `pip install tableau-cli[convert]`.
+- Don't install anything: if [uv](https://docs.astral.sh/uv/) is on your `PATH`, conversion transparently falls back to running the step in an ephemeral `uv run --with ...` environment, so those packages never land in your host Python. The first run provisions the environment (a few seconds); later runs use uv's cache. This is the recommended path when the CLI itself was installed via `uv tool install tableau-cli`.
 
 For most use cases, `ds download --to parquet` (or `--to csv`) is simpler — it downloads and converts in one step. The `convert` command is useful when you already have a `.tdsx` or `.hyper` file on disk.
 
@@ -177,14 +191,23 @@ tableau-cli convert extract.hyper --to csv -o ./output/result.csv
 ### Workbooks
 
 ```bash
-# List workbooks
+# List workbooks (includes upstream datasources via Metadata API enrichment)
 tableau-cli workbooks list
 tableau-cli wb list --filter "name:eq:Finance" --format table
 
-# Get workbook details (includes views with usage statistics)
+# Get workbook details (includes views with usage statistics,
+# upstream datasources, and the default view's web URL)
 tableau-cli workbooks get <workbookId>
 ```
 
+### Projects
+
+```bash
+# List projects
+tableau-cli projects list
+tableau-cli projects list --filter "topLevelProject:eq:true" --format table
+```
+
 ### Config
 
 ```bash
@@ -237,10 +260,11 @@ Error types include: `authentication-error`, `feature-disabled`, `tableau-api-er
 | Area | APIs Used |
 |------|-----------|
 | Authentication | REST API v3.24 — PAT sign-in / sign-out |
-| Datasources | REST API (list, download) + VizQL Data Service (metadata, query) + Metadata API (GraphQL enrichment) |
-| Views | REST API (list, data, image) |
-| Workbooks | REST API (list, get with view enrichment) |
-| Search | Content Exploration API |
+| Datasources | REST API (list, download) + VizQL Data Service (metadata, model, query) + Metadata API (GraphQL enrichment) |
+| Views | REST API (list, get, data, image with view filters) + Metadata API (lineage enrichment) |
+| Workbooks | REST API (list, get with view enrichment) + Metadata API (lineage enrichment) |
+| Projects | REST API (list) |
+| Search | Content Exploration API + Metadata API (lineage enrichment) |
 | Convert | Local file conversion: TDSX/HYPER → Parquet/CSV (optional dependencies) |
 
 ## Development

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/README.md

@@ -102,7 +102,9 @@ tableau-cli datasources download <datasourceId> -o ./data/
 tableau-cli ds download <datasourceId> -o ./data/ --to parquet
 tableau-cli ds download <datasourceId> -o ./data/ --to csv
 
-# Get field metadata (VizQL Data Service + Metadata API enrichment)
+# Get field metadata (VizQL Data Service + Metadata API enrichment).
+# On Tableau >= 2025.3 the result also includes the datasource model:
+# logical tables and their relationships.
 tableau-cli datasources metadata <luid>
 
 # Query datasource data (VizQL Data Service)
@@ -113,21 +115,33 @@ tableau-cli ds query <luid> --query '{"fields": [...]}' --limit 100
 ### Views
 
 ```bash
-# List views
+# List views (includes upstream datasources via Metadata API enrichment)
 tableau-cli views list
 tableau-cli views list --filter "name:has:Dashboard" --format table
 
+# Get view details: upstream datasources, workbook/project/owner info, and web URL
+tableau-cli views get <viewId>
+
 # Get view data as CSV
 tableau-cli views data <viewId>
 
+# Get view data with view filters applied
+tableau-cli views data <viewId> --vf "Region=West" --vf "Category=Technology"
+
 # Download view image
 tableau-cli views image <viewId> -o dashboard.png
 tableau-cli views image <viewId> --width 1200 --height 800 --img-format SVG -o dashboard.svg
+tableau-cli views image <viewId> --vf "Region=West" -o west.png
 ```
 
 ### Convert
 
-Convert local TDSX/HYPER files to Parquet or CSV. Requires `pip install tableau-cli[convert]`.
+Convert local TDSX/HYPER files to Parquet or CSV.
+
+Conversion needs heavier packages (`pantab`, `polars`, `pyarrow`). You have two options:
+
+- Install them into the CLI: `pip install tableau-cli[convert]`.
+- Don't install anything: if [uv](https://docs.astral.sh/uv/) is on your `PATH`, conversion transparently falls back to running the step in an ephemeral `uv run --with ...` environment, so those packages never land in your host Python. The first run provisions the environment (a few seconds); later runs use uv's cache. This is the recommended path when the CLI itself was installed via `uv tool install tableau-cli`.
 
 For most use cases, `ds download --to parquet` (or `--to csv`) is simpler — it downloads and converts in one step. The `convert` command is useful when you already have a `.tdsx` or `.hyper` file on disk.
 
@@ -147,14 +161,23 @@ tableau-cli convert extract.hyper --to csv -o ./output/result.csv
 ### Workbooks
 
 ```bash
-# List workbooks
+# List workbooks (includes upstream datasources via Metadata API enrichment)
 tableau-cli workbooks list
 tableau-cli wb list --filter "name:eq:Finance" --format table
 
-# Get workbook details (includes views with usage statistics)
+# Get workbook details (includes views with usage statistics,
+# upstream datasources, and the default view's web URL)
 tableau-cli workbooks get <workbookId>
 ```
 
+### Projects
+
+```bash
+# List projects
+tableau-cli projects list
+tableau-cli projects list --filter "topLevelProject:eq:true" --format table
+```
+
 ### Config
 
 ```bash
@@ -207,10 +230,11 @@ Error types include: `authentication-error`, `feature-disabled`, `tableau-api-er
 | Area | APIs Used |
 |------|-----------|
 | Authentication | REST API v3.24 — PAT sign-in / sign-out |
-| Datasources | REST API (list, download) + VizQL Data Service (metadata, query) + Metadata API (GraphQL enrichment) |
-| Views | REST API (list, data, image) |
-| Workbooks | REST API (list, get with view enrichment) |
-| Search | Content Exploration API |
+| Datasources | REST API (list, download) + VizQL Data Service (metadata, model, query) + Metadata API (GraphQL enrichment) |
+| Views | REST API (list, get, data, image with view filters) + Metadata API (lineage enrichment) |
+| Workbooks | REST API (list, get with view enrichment) + Metadata API (lineage enrichment) |
+| Projects | REST API (list) |
+| Search | Content Exploration API + Metadata API (lineage enrichment) |
 | Convert | Local file conversion: TDSX/HYPER → Parquet/CSV (optional dependencies) |
 
 ## Development

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tableau-cli"
-version = "0.1.2"
+version = "0.1.4"
 description = "CLI for Tableau Server/Cloud, designed for AI agent integration"
 license = "Apache-2.0"
 requires-python = ">=3.10"

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/skills/SKILL.md

@@ -33,13 +33,14 @@ Before running any `tableau-cli` command, load [references/cli.md](references/cl
 The following requests can be handled directly with CLI commands. Load [references/cli.md](references/cli.md) and execute:
 
 - Search content across types — `search`
-- List/filter datasources, views, or workbooks — `ds list` / `views list` / `wb list`
+- List/filter datasources, views, workbooks, or projects — `ds list` / `views list` / `wb list` / `projects list`
 - Download a datasource file — `ds download` (supports `--to parquet` / `--to csv` for direct conversion)
-- Inspect datasource field metadata — `ds metadata`
+- Inspect datasource field metadata and table relationships — `ds metadata`
 - Query data from a datasource — `ds query`
-- Export view data as CSV — `views data`
-- Export view as image — `views image`
-- View workbook details and its views — `wb get`
+- View details of a single view, incl. its web URL and upstream datasources — `views get`
+- Export view data as CSV — `views data` (supports `--vf "Field=Value"` view filters)
+- Export view as image — `views image` (supports `--vf "Field=Value"` view filters)
+- View workbook details, its views, and its web URL — `wb get`
 - Convert TDSX/HYPER to Parquet/CSV — `convert`
 
 Common combined workflows:
@@ -49,3 +50,5 @@ Common combined workflows:
 **Quick data extraction (no file download)**: `ds metadata` → `ds query` (requires VizQL Data Service; fall back to download + convert if unavailable)
 
 **Export dashboard screenshot**: `views list` → `views image`
+
+**From dashboard to data**: `search` or `views get` → `upstreamDatasources[].luid` → `ds metadata` → `ds query`

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/skills/references/cli.md

@@ -40,6 +40,8 @@ tableau-cli search --format table
 
 View results include `parentWorkbookName` (parent workbook) and `totalViewCount` (total views).
 
+Workbook and view results include `upstreamDatasources[]` (`{luid, name}`) — the published datasources they are built on. Use this to jump from a dashboard to `ds metadata` / `ds query` without a separate lookup.
+
 ---
 
 ## datasources (alias: ds)
@@ -94,10 +96,11 @@ tableau-cli ds metadata <luid> --format table
 
 Returns:
 - `datasourceDescription` — datasource description
+- `datasourceModel` — logical tables and their relationships (join fields and operators); only present on Tableau >= 2025.3
 - `fieldGroups[].fields[]` — field list (name, dataType, role, formula, description, etc.)
 - `parameters[]` — parameter list (name, parameterType, dataType, value, etc.)
 
-Attempts to enrich via GraphQL Metadata API; falls back to base VizQL metadata if unavailable.
+Attempts to enrich via GraphQL Metadata API; falls back to base VizQL metadata if unavailable. Use `datasourceModel` to understand multi-table datasources before constructing `ds query` requests.
 
 ### ds query
 
@@ -137,7 +140,22 @@ tableau-cli views list --filter "name:has:keyword" --format table
 | `--limit` | int | none | Max total results |
 | `--format` | json / table | json | Output format |
 
-Results include `workbookId` to trace back to the parent workbook.
+Results include the parent `workbook` (with name), `project`, `owner`, `upstreamDatasources[]` (published datasources the view is built on), and `totalViewCount`.
+
+### views get
+
+View details for a single view, including its web URL.
+
+```bash
+tableau-cli views get <view-id>
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `view_id` | string (positional) | required | View LUID |
+| `--format` | json / table | json | Output format |
+
+Returns the view with `upstreamDatasources[]`, parent `workbook` / `project` / `owner` info, usage statistics, and `url` — the web URL to open the view in a browser.
 
 ### views data
 
@@ -145,11 +163,13 @@ Export view data as CSV.
 
 ```bash
 tableau-cli views data <view-id>
+tableau-cli views data <view-id> --vf "Region=West" --vf "Category=Technology"
 ```
 
 | Option | Type | Description |
 |--------|------|-------------|
 | `view_id` | string (positional) | View LUID |
+| `--vf` | `Field=Value` (repeatable) | View filter: filter the view by field values before export |
 
 Output: CSV text written directly to stdout (not JSON).
 
@@ -161,6 +181,7 @@ Export view as image.
 tableau-cli views image <view-id> -o output.png
 tableau-cli views image <view-id> --width 1200 --height 800 -o output.png
 tableau-cli views image <view-id> --img-format SVG -o output.svg
+tableau-cli views image <view-id> --vf "Region=West" -o west.png
 ```
 
 | Option | Type | Default | Description |
@@ -169,6 +190,7 @@ tableau-cli views image <view-id> --img-format SVG -o output.svg
 | `--width` | int | none | Image width in pixels |
 | `--height` | int | none | Image height in pixels |
 | `--img-format` | PNG / SVG | PNG | Image format |
+| `--vf` | `Field=Value` (repeatable) | none | View filter: filter the view by field values before rendering |
 | `-o, --output` | path | none | Output file path |
 
 With `-o`: outputs `{"filePath": "<absolute path>"}`. Without `-o`: base64-encoded image to stdout.
@@ -191,6 +213,8 @@ tableau-cli wb list --filter "name:has:keyword" --format table
 | `--limit` | int | none | Max total results |
 | `--format` | json / table | json | Output format |
 
+Results include `upstreamDatasources[]` (`{luid, name}`) — the published datasources each workbook is built on.
+
 ### wb get
 
 View workbook details, including all views with usage statistics.
@@ -205,6 +229,29 @@ tableau-cli wb get <workbook-id> --format table
 | `workbook_id` | string (positional) | required | Workbook LUID |
 | `--format` | json / table | json | Output format |
 
+Returns the workbook with `upstreamDatasources[]` and `url` — the web URL to open the workbook's default view in a browser.
+
+---
+
+## projects
+
+### projects list
+
+```bash
+tableau-cli projects list
+tableau-cli projects list --filter "topLevelProject:eq:true" --format table
+tableau-cli projects list --filter "parentProjectId:eq:<project-id>"
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `--filter` | string | none | Server-side filter (fields: name, parentProjectId, topLevelProject, ownerName, createdAt, updatedAt) |
+| `--page-size` | int | none | Items per page |
+| `--limit` | int | none | Max total results |
+| `--format` | json / table | json | Output format |
+
+Results include name, description, parent project, content permissions, owner, and timestamps.
+
 ---
 
 ## convert
@@ -274,9 +321,14 @@ The `--filter` option uses `field:operator:value` format:
 | Inspect datasource fields | `ds metadata <luid>` |
 | Query data from a datasource | `ds query <luid> --query '{...}'` |
 | Find a dashboard/view | `views list --filter "name:has:..."` |
+| See view details / get view link | `views get <view-id>` |
+| Find the datasource behind a dashboard | `views get <view-id>` → `upstreamDatasources` |
 | Export view data | `views data <view-id>` |
+| Export filtered view data | `views data <view-id> --vf "Field=Value"` |
 | Export view screenshot | `views image <view-id> -o file.png` |
+| Export filtered view screenshot | `views image <view-id> --vf "Field=Value" -o file.png` |
 | Find workbooks | `wb list --filter "name:has:..."` |
-| See views in a workbook | `wb get <workbook-id>` |
+| See views in a workbook / get workbook link | `wb get <workbook-id>` |
+| Browse projects / site structure | `projects list` |
 | Convert local TDSX to Parquet | `convert file.tdsx -o dir/` |
 | Download and convert for analysis | `ds download <id> --to parquet` |

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/src/tableau_cli/api/client.py

@@ -89,6 +89,14 @@ class RestApi:
             self._client.post(url, headers=self._auth_headers())
         self._creds = None
 
+    # ── Server (REST API) ───────────────────────────────────────────
+
+    def get_server_info(self) -> dict[str, Any]:
+        url = f"{self._base_url}/serverinfo"
+        resp = self._client.get(url, headers=self._auth_headers())
+        resp.raise_for_status()
+        return resp.json()["serverInfo"]
+
     # ── Datasources (REST API) ──────────────────────────────────────
 
     def list_datasources(
@@ -167,9 +175,17 @@ class RestApi:
             "views": [_shape_view(v) for v in raw_list],
         }
 
-    def query_view_data(self, *, view_id: str, site_id: str) -> str:
+    def get_view(self, *, view_id: str, site_id: str) -> dict[str, Any]:
+        url = f"{self._base_url}/sites/{site_id}/views/{view_id}"
+        params = {"includeUsageStatistics": "true"}
+        resp = self._client.get(url, params=params, headers=self._auth_headers())
+        resp.raise_for_status()
+        return _shape_view(resp.json()["view"])
+
+    def query_view_data(self, *, view_id: str, site_id: str, view_filters: dict[str, str] | None = None) -> str:
         url = f"{self._base_url}/sites/{site_id}/views/{view_id}/data"
-        resp = self._client.get(url, headers=self._auth_headers())
+        params = _view_filter_params(view_filters)
+        resp = self._client.get(url, params=params, headers=self._auth_headers())
         resp.raise_for_status()
         return resp.text
 
@@ -181,6 +197,7 @@ class RestApi:
         width: int | None = None,
         height: int | None = None,
         format_: str = "PNG",
+        view_filters: dict[str, str] | None = None,
     ) -> bytes:
         url = f"{self._base_url}/sites/{site_id}/views/{view_id}/image"
         params: dict[str, Any] = {"resolution": "high"}
@@ -190,6 +207,7 @@ class RestApi:
             params["vizHeight"] = height
         if format_:
             params["format"] = format_
+        params.update(_view_filter_params(view_filters))
         resp = self._client.get(url, params=params, headers=self._auth_headers())
         if resp.status_code >= 400:
             error_data: dict[str, Any] = {}
@@ -264,6 +282,33 @@ class RestApi:
             "workbooks": [_shape_workbook(w) for w in raw_list],
         }
 
+    # ── Projects (REST API) ─────────────────────────────────────────
+
+    def query_projects(
+        self,
+        *,
+        site_id: str,
+        filter_: str = "",
+        page_size: int | None = None,
+        page_number: int | None = None,
+    ) -> dict[str, Any]:
+        url = f"{self._base_url}/sites/{site_id}/projects"
+        params: dict[str, Any] = {}
+        if filter_:
+            params["filter"] = filter_
+        if page_size is not None:
+            params["pageSize"] = page_size
+        if page_number is not None:
+            params["pageNumber"] = page_number
+        resp = self._client.get(url, params=params, headers=self._auth_headers())
+        resp.raise_for_status()
+        data = resp.json()
+        raw_list = data.get("projects", {}).get("project") or []
+        return {
+            "pagination": _parse_pagination(data["pagination"]),
+            "projects": [_shape_project_detail(p) for p in raw_list],
+        }
+
     # ── Content Exploration (Search) ────────────────────────────────
 
     def search_content(
@@ -305,6 +350,18 @@ class RestApi:
         resp.raise_for_status()
         return resp.json()
 
+    def get_datasource_model(self, *, datasource_luid: str) -> dict[str, Any]:
+        url = f"{self._host}/api/v1/vizql-data-service/get-datasource-model"
+        body = {"datasource": {"datasourceLuid": datasource_luid}}
+        try:
+            resp = self._client.post(url, json=body, headers=self._auth_headers())
+        except httpx.TransportError as exc:
+            raise FeatureDisabledError(VDS_DISABLED_MESSAGE) from exc
+        if resp.status_code == 404:
+            raise FeatureDisabledError(VDS_DISABLED_MESSAGE)
+        resp.raise_for_status()
+        return resp.json()
+
     def query_datasource(self, *, datasource_luid: str, query: dict, options: dict | None = None) -> dict[str, Any]:
         url = f"{self._host}/api/v1/vizql-data-service/query-datasource"
         body: dict[str, Any] = {
@@ -350,6 +407,13 @@ def _parse_pagination(p: dict[str, Any]) -> dict[str, int]:
     }
 
 
+def _view_filter_params(view_filters: dict[str, str] | None) -> dict[str, str]:
+    """Map view filter field names to `vf_`-prefixed query parameters."""
+    if not view_filters:
+        return {}
+    return {(key if key.startswith("vf_") else f"vf_{key}"): value for key, value in view_filters.items()}
+
+
 # ── Response shaping (equivalent to Zod schemas in TS version) ──────────
 
 
@@ -359,6 +423,31 @@ def _shape_project(raw: Any) -> dict[str, str]:
     return {"name": raw.get("name", ""), "id": raw.get("id", "")}
 
 
+def _shape_project_detail(raw: dict[str, Any]) -> dict[str, Any]:
+    """Match TS projectSchema: {id, name, description?, parentProjectId?, contentPermissions?, ...}"""
+    result: dict[str, Any] = {
+        "id": raw.get("id", ""),
+        "name": raw.get("name", ""),
+    }
+    for key in (
+        "description",
+        "parentProjectId",
+        "contentPermissions",
+        "controllingPermissionsProjectId",
+        "createdAt",
+        "updatedAt",
+    ):
+        if key in raw:
+            result[key] = raw[key]
+    # z.coerce.boolean() — convert string "true"/"false" to bool
+    if "topLevelProject" in raw:
+        top_level = raw["topLevelProject"]
+        result["topLevelProject"] = top_level.lower() == "true" if isinstance(top_level, str) else bool(top_level)
+    if isinstance(raw.get("owner"), dict) and raw["owner"].get("id"):
+        result["owner"] = {"id": raw["owner"]["id"]}
+    return result
+
+
 def _shape_tags(raw: Any) -> dict[str, Any]:
     if not isinstance(raw, dict):
         return {}
@@ -382,10 +471,11 @@ def _shape_datasource(raw: dict[str, Any]) -> dict[str, Any]:
 
 
 def _shape_view(raw: dict[str, Any]) -> dict[str, Any]:
-    """Match TS viewSchema: {id, name, createdAt, updatedAt, workbook?, owner?, project?, tags, usage?}"""
+    """Match TS viewSchema: {id, name, contentUrl, createdAt, updatedAt, workbook?, owner?, project?, tags, usage?}"""
     result: dict[str, Any] = {
         "id": raw.get("id", ""),
         "name": raw.get("name", ""),
+        "contentUrl": raw.get("contentUrl", ""),
         "createdAt": raw.get("createdAt", ""),
         "updatedAt": raw.get("updatedAt", ""),
     }

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/src/tableau_cli/cli.py

@@ -87,10 +87,13 @@ def _check_for_update() -> str | None:
         resp = httpx.get("https://pypi.org/pypi/tableau-cli/json", timeout=3)
         resp.raise_for_status()
         latest = resp.json()["info"]["version"]
-        if latest != current:
+
+        def version_key(version: str) -> tuple[int, ...]:
+            return tuple(int(part) for part in version.split("."))
+
+        if version_key(latest) > version_key(current):
             return (
-                f"Update available: {current} → {latest}. "
-                'Run `pip install --upgrade "tableau-cli[convert]"` to update.'
+                f'Update available: {current} → {latest}. Run `pip install --upgrade "tableau-cli[convert]"` to update.'
             )
     except Exception:
         pass
@@ -120,7 +123,7 @@ class TableauCli(click.Group):
 
 
 @click.group(cls=TableauCli)
-@click.version_option("0.1.2")
+@click.version_option("0.1.4")
 def cli():
     """CLI tool for interacting with Tableau Server/Cloud."""
 
@@ -129,6 +132,7 @@ def main() -> None:
     from .commands.config_cmd import config_group
     from .commands.convert_cmd import convert_command
     from .commands.datasources_cmd import datasources_group
+    from .commands.projects_cmd import projects_group
     from .commands.search_cmd import search_command
     from .commands.views_cmd import views_group
     from .commands.workbooks_cmd import workbooks_group
@@ -137,6 +141,7 @@ def main() -> None:
     cli.add_command(convert_command)
     cli.add_command(datasources_group)
     cli.add_command(datasources_group, name="ds")  # alias
+    cli.add_command(projects_group)
     cli.add_command(views_group)
     cli.add_command(workbooks_group)
     cli.add_command(workbooks_group, name="wb")  # alias

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/src/tableau_cli/commands/convert_cmd.py

@@ -11,10 +11,8 @@ from ..errors.cli_error import CliError
 from ..output.format import output
 from ..utils.convert import (
     SUPPORTED_FORMATS,
-    check_convert_deps,
     extract_hyper_from_tdsx,
-    read_hyper,
-    write_df,
+    run_conversion,
 )
 
 
@@ -26,8 +24,6 @@ from ..utils.convert import (
 @click.option("-o", "--output", "output_path", default=None, help="Output file or directory (default: same as input)")
 def convert_command(input_path, to_fmt, output_path):
     """Convert TDSX/HYPER files to Parquet or CSV format."""
-    check_convert_deps()
-
     input_p = Path(input_path)
     suffix = input_p.suffix.lower()
 
@@ -47,15 +43,13 @@ def convert_command(input_path, to_fmt, output_path):
     else:
         out_p = Path(output_path)
 
-    # Read hyper data
+    # Convert (in-process if deps present, else via an ephemeral uv environment)
     if suffix == ".hyper":
-        df = read_hyper(input_p)
+        run_conversion(input_p, out_p, to_fmt)
     else:
         with TemporaryDirectory() as td:
             hyper_path = extract_hyper_from_tdsx(input_p, Path(td))
-            df = read_hyper(hyper_path)
-
-    write_df(df, out_p, to_fmt)
+            run_conversion(hyper_path, out_p, to_fmt)
 
     abs_path = os.path.abspath(out_p)
     sys.stderr.write(f"Converted to {abs_path}\n")

{tableau_cli-0.1.2 → tableau_cli-0.1.4}/src/tableau_cli/commands/datasources_cmd.py

@@ -65,9 +65,9 @@ def datasources_download(datasource_id, output_path, to_fmt):
     config = resolve_config()
 
     if to_fmt != "tdsx":
-        from ..utils.convert import check_convert_deps
+        from ..utils.convert import ensure_convert_available
 
-        check_convert_deps()
+        ensure_convert_available()
 
     data, filename = with_auth(
         config,
@@ -104,17 +104,25 @@ def datasources_metadata(luid, fmt):
             get_graphql_query,
             simplify_read_metadata_result,
         )
+        from ..utils.tableau_version import is_tableau_version_at_least
 
         read_metadata_result = api.read_metadata(datasource_luid=luid)
 
+        # The datasource model (logical tables and their relationships) comes from
+        # a dedicated VizQL Data Service endpoint that requires Tableau >= 2025.3.
+        datasource_model_result = None
+        product_version = api.get_server_info().get("productVersion", {}).get("value", "")
+        if is_tableau_version_at_least(product_version, "2025.3.0"):
+            datasource_model_result = api.get_datasource_model(datasource_luid=luid)
+
         # Try to enrich with Metadata API (GraphQL)
         try:
             graphql_result = api.graphql(get_graphql_query(luid))
         except Exception:
             # Metadata API may not be available
-            return simplify_read_metadata_result(read_metadata_result)
+            return simplify_read_metadata_result(read_metadata_result, datasource_model_result)
 
-        return combine_fields(read_metadata_result, graphql_result)
+        return combine_fields(read_metadata_result, graphql_result, datasource_model_result)
 
     result = with_auth(config, fn)
     output(result, fmt)