tableau-cli 0.1.0__tar.gz → 0.1.1__tar.gz

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

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python:*)",
+      "Bash(echo \"EXIT: $?\")",
+      "Bash(tableau-cli datasources:*)",
+      "Bash(tableau-cli convert:*)",
+      "Bash(ruff check:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(pip index:*)",
+      "Bash(pip install:*)",
+      "Bash(bash -l -c \"history\")",
+      "Bash(twine --version)"
+    ]
+  }
+}

tableau_cli-0.1.1/.claude/skills/tableau-cli

@@ -0,0 +1 @@
+../../.agents/skills/tableau-cli

{tableau_cli-0.1.0 → tableau_cli-0.1.1}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: tableau-cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: CLI for Tableau Server/Cloud, designed for AI agent integration
-Project-URL: Repository, https://github.com/didiwang/tableau-cli
+Project-URL: Repository, https://github.com/i-richardwang/tableau-cli
 Author: Richard Wang
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -34,7 +34,11 @@ A command-line interface for Tableau Server / Tableau Cloud, designed for AI age
 
 ## Why CLI over MCP?
 
-MCP (Model Context Protocol) servers continuously occupy agent context. A CLI tool follows a simpler call-execute-exit pattern — the agent invokes a command, reads the JSON output, and moves on. This project provides the same capabilities as the [tableau-mcp](https://github.com/anthropics/tableau-mcp) server with behavioral alignment in data transformations, error handling, and output structures.
+MCP (Model Context Protocol) servers continuously occupy agent context — every tool description is loaded into the system prompt, even when only one command is needed. A CLI follows a simpler call-execute-exit pattern: the agent invokes a command, reads the JSON output, and moves on.
+
+The companion Claude Code skill under `skills/` extends the same idea to command knowledge — the full reference is loaded only when the agent is about to execute a command, not kept in context upfront. See [Use with Claude Code](#use-with-claude-code) below.
+
+This project provides the same capabilities as the [tableau-mcp](https://github.com/tableau/tableau-mcp) server, with behavioral alignment in data transformations, error handling, and output structures.
 
 ## Quick Start
 
@@ -47,7 +51,7 @@ MCP (Model Context Protocol) servers continuously occupy agent context. A CLI to
 ### Install
 
 ```bash
-git clone <repo-url>
+git clone https://github.com/i-richardwang/tableau-cli.git
 cd tableau-cli
 pip install -e .
 
@@ -79,6 +83,29 @@ Environment variables take precedence over the config file. `siteName` defaults
 tableau-cli config show
 ```
 
+## Use with Claude Code
+
+This repository ships with a Claude Code skill under `skills/`. Once loaded, it gives an agent enough context to route a user's request to the right command — without putting the full CLI reference into the system prompt.
+
+```
+skills/
+├── SKILL.md              # Intent routing + environment check
+└── references/
+    ├── cli.md            # Full command reference (loaded before executing)
+    └── installation.md   # Install + auth setup (loaded if not configured)
+```
+
+Once Claude Code has loaded the skill, a typical interaction looks like:
+
+1. The agent runs `tableau-cli --help` to verify the CLI is installed and configured. If not, it loads `references/installation.md` and stops until setup is complete.
+2. The agent maps the user's intent to a subcommand using the Intent Routing table in `SKILL.md` (e.g., "find datasources with Sales in the name" → `ds list --filter "name:has:Sales"`).
+3. Before constructing the actual command, the agent loads `references/cli.md` — the skill explicitly forbids guessing flags from memory, so the reference is the source of truth for syntax.
+4. The agent runs the command and parses the structured JSON output, including the `hint` field on errors.
+
+Common workflows (e.g., `ds download --to parquet → load with Polars/Pandas`) are pre-defined under Intent Routing in `SKILL.md`, so the agent doesn't have to reason about chaining from scratch.
+
+You can of course use `tableau-cli` directly from a shell without the skill — the skill is only needed when you want an agent to drive the tool.
+
 ## Commands
 
 ### Search
@@ -101,6 +128,10 @@ tableau-cli ds list --filter "name:has:Sales" --limit 50
 # Download datasource file (.tdsx)
 tableau-cli datasources download <datasourceId> -o ./data/
 
+# Download and convert to Parquet or CSV in one step (requires tableau-cli[convert])
+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)
 tableau-cli datasources metadata <luid>
 
@@ -126,7 +157,9 @@ tableau-cli views image <viewId> --width 1200 --height 800 --img-format SVG -o d
 
 ### Convert
 
-Convert Tableau TDSX/HYPER files to Parquet or CSV. Requires `pip install tableau-cli[convert]`.
+Convert local TDSX/HYPER files to Parquet or CSV. Requires `pip install tableau-cli[convert]`.
+
+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.
 
 ```bash
 # Convert TDSX to Parquet (default)
@@ -176,9 +209,12 @@ tableau-cli ds list --format table
 Commands that save files (`ds download`, `views image -o`, `convert`) output a JSON object with the file path to stdout, enabling agents to chain operations:
 
 ```bash
-# Download and convert pipeline
-tableau-cli ds download <id> -o ./data/        # → {"filePath": ".../data.tdsx"}
-tableau-cli convert ./data/data.tdsx -o ./data/ # → {"filePath": ".../data.parquet"}
+# Download and convert in one step
+tableau-cli ds download <id> -o ./data/ --to parquet  # → {"filePath": ".../data.parquet"}
+
+# Or as separate steps (useful for keeping the original .tdsx)
+tableau-cli ds download <id> -o ./data/               # → {"filePath": ".../data.tdsx"}
+tableau-cli convert ./data/data.tdsx -o ./data/        # → {"filePath": ".../data.parquet"}
 ```
 
 ### Error Output

{tableau_cli-0.1.0 → tableau_cli-0.1.1}/README.md

@@ -4,7 +4,11 @@ A command-line interface for Tableau Server / Tableau Cloud, designed for AI age
 
 ## Why CLI over MCP?
 
-MCP (Model Context Protocol) servers continuously occupy agent context. A CLI tool follows a simpler call-execute-exit pattern — the agent invokes a command, reads the JSON output, and moves on. This project provides the same capabilities as the [tableau-mcp](https://github.com/anthropics/tableau-mcp) server with behavioral alignment in data transformations, error handling, and output structures.
+MCP (Model Context Protocol) servers continuously occupy agent context — every tool description is loaded into the system prompt, even when only one command is needed. A CLI follows a simpler call-execute-exit pattern: the agent invokes a command, reads the JSON output, and moves on.
+
+The companion Claude Code skill under `skills/` extends the same idea to command knowledge — the full reference is loaded only when the agent is about to execute a command, not kept in context upfront. See [Use with Claude Code](#use-with-claude-code) below.
+
+This project provides the same capabilities as the [tableau-mcp](https://github.com/tableau/tableau-mcp) server, with behavioral alignment in data transformations, error handling, and output structures.
 
 ## Quick Start
 
@@ -17,7 +21,7 @@ MCP (Model Context Protocol) servers continuously occupy agent context. A CLI to
 ### Install
 
 ```bash
-git clone <repo-url>
+git clone https://github.com/i-richardwang/tableau-cli.git
 cd tableau-cli
 pip install -e .
 
@@ -49,6 +53,29 @@ Environment variables take precedence over the config file. `siteName` defaults
 tableau-cli config show
 ```
 
+## Use with Claude Code
+
+This repository ships with a Claude Code skill under `skills/`. Once loaded, it gives an agent enough context to route a user's request to the right command — without putting the full CLI reference into the system prompt.
+
+```
+skills/
+├── SKILL.md              # Intent routing + environment check
+└── references/
+    ├── cli.md            # Full command reference (loaded before executing)
+    └── installation.md   # Install + auth setup (loaded if not configured)
+```
+
+Once Claude Code has loaded the skill, a typical interaction looks like:
+
+1. The agent runs `tableau-cli --help` to verify the CLI is installed and configured. If not, it loads `references/installation.md` and stops until setup is complete.
+2. The agent maps the user's intent to a subcommand using the Intent Routing table in `SKILL.md` (e.g., "find datasources with Sales in the name" → `ds list --filter "name:has:Sales"`).
+3. Before constructing the actual command, the agent loads `references/cli.md` — the skill explicitly forbids guessing flags from memory, so the reference is the source of truth for syntax.
+4. The agent runs the command and parses the structured JSON output, including the `hint` field on errors.
+
+Common workflows (e.g., `ds download --to parquet → load with Polars/Pandas`) are pre-defined under Intent Routing in `SKILL.md`, so the agent doesn't have to reason about chaining from scratch.
+
+You can of course use `tableau-cli` directly from a shell without the skill — the skill is only needed when you want an agent to drive the tool.
+
 ## Commands
 
 ### Search
@@ -71,6 +98,10 @@ tableau-cli ds list --filter "name:has:Sales" --limit 50
 # Download datasource file (.tdsx)
 tableau-cli datasources download <datasourceId> -o ./data/
 
+# Download and convert to Parquet or CSV in one step (requires tableau-cli[convert])
+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)
 tableau-cli datasources metadata <luid>
 
@@ -96,7 +127,9 @@ tableau-cli views image <viewId> --width 1200 --height 800 --img-format SVG -o d
 
 ### Convert
 
-Convert Tableau TDSX/HYPER files to Parquet or CSV. Requires `pip install tableau-cli[convert]`.
+Convert local TDSX/HYPER files to Parquet or CSV. Requires `pip install tableau-cli[convert]`.
+
+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.
 
 ```bash
 # Convert TDSX to Parquet (default)
@@ -146,9 +179,12 @@ tableau-cli ds list --format table
 Commands that save files (`ds download`, `views image -o`, `convert`) output a JSON object with the file path to stdout, enabling agents to chain operations:
 
 ```bash
-# Download and convert pipeline
-tableau-cli ds download <id> -o ./data/        # → {"filePath": ".../data.tdsx"}
-tableau-cli convert ./data/data.tdsx -o ./data/ # → {"filePath": ".../data.parquet"}
+# Download and convert in one step
+tableau-cli ds download <id> -o ./data/ --to parquet  # → {"filePath": ".../data.parquet"}
+
+# Or as separate steps (useful for keeping the original .tdsx)
+tableau-cli ds download <id> -o ./data/               # → {"filePath": ".../data.tdsx"}
+tableau-cli convert ./data/data.tdsx -o ./data/        # → {"filePath": ".../data.parquet"}
 ```
 
 ### Error Output

{tableau_cli-0.1.0 → tableau_cli-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tableau-cli"
-version = "0.1.0"
+version = "0.1.1"
 description = "CLI for Tableau Server/Cloud, designed for AI agent integration"
 license = "Apache-2.0"
 requires-python = ">=3.10"
@@ -30,7 +30,7 @@ dependencies = [
 ]
 
 [project.urls]
-Repository = "https://github.com/didiwang/tableau-cli"
+Repository = "https://github.com/i-richardwang/tableau-cli"
 
 [project.optional-dependencies]
 convert = [

tableau_cli-0.1.1/skills/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: tableau-cli
+description: "Interact with Tableau Server / Cloud via the tableau-cli command: search content, query datasources, download files, export view images and data, convert TDSX/HYPER to Parquet/CSV. Use when the user wants to find, download, query, or export any Tableau content."
+---
+
+# Tableau CLI
+
+Interact with Tableau Server / Cloud via the `tableau-cli` command.
+
+## References
+
+Load these files when needed — do not load all of them upfront:
+
+- [references/cli.md](references/cli.md) — full CLI command reference. Load before running any `tableau-cli` command or looking up flags and syntax.
+- [references/installation.md](references/installation.md) — installation and authentication setup. Load if `tableau-cli` is not installed or not configured.
+
+## Environment Check
+
+Before running any command, verify the CLI is available:
+
+```bash
+tableau-cli --help
+```
+
+If `tableau-cli` is not installed or the API key is missing, load [references/installation.md](references/installation.md) and stop until setup is complete.
+
+## CLI Reference
+
+Before running any `tableau-cli` command, load [references/cli.md](references/cli.md) as the source of truth for exact flags, subcommands, and examples. Do not guess command syntax from memory.
+
+## Intent Routing
+
+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`
+- Download a datasource file — `ds download` (supports `--to parquet` / `--to csv` for direct conversion)
+- Inspect datasource field metadata — `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`
+- Convert TDSX/HYPER to Parquet/CSV — `convert`
+
+Common combined workflows:
+
+**Download datasource for local analysis**: `ds list` → `ds download --to parquet` → load with Polars/Pandas
+
+**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`

tableau_cli-0.1.1/skills/references/cli.md

@@ -0,0 +1,282 @@
+---
+name: tableau-cli-reference
+description: Full CLI command reference for tableau-cli. Load before running any command as the authoritative source for flags and syntax.
+---
+
+# CLI Command Reference
+
+All commands output JSON (indent=2) by default. List commands support `--format table` for human-readable output.
+
+Errors are also structured JSON:
+```json
+{
+  "isError": true,
+  "errorType": "<type>",
+  "message": "<description>",
+  "hint": "<suggested action>"
+}
+```
+
+---
+
+## search
+
+Search across all content types on the site.
+
+```bash
+tableau-cli search "keyword"
+tableau-cli search "keyword" --type workbook,view,datasource
+tableau-cli search "keyword" --limit 10 --order-by hitsTotal:desc
+tableau-cli search --format table
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `terms` | string (positional) | none | Search terms, optional |
+| `--type` | string | none | Comma-separated content types (workbook, view, datasource, etc.) |
+| `--limit` | int | 100 | Max results to return |
+| `--order-by` | string | none | Sort method (e.g., `hitsTotal:desc`) |
+| `--format` | json / table | json | Output format |
+
+View results include `parentWorkbookName` (parent workbook) and `totalViewCount` (total views).
+
+---
+
+## datasources (alias: ds)
+
+### ds list
+
+```bash
+tableau-cli ds list
+tableau-cli ds list --filter "name:has:keyword" --limit 50 --format table
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `--filter` | string | none | Server-side filter (see filter syntax below) |
+| `--page-size` | int | none | Items per page |
+| `--limit` | int | none | Max total results |
+| `--format` | json / table | json | Output format |
+
+Automatically paginates until all results are fetched or limit is reached.
+
+### ds download
+
+```bash
+tableau-cli ds download <datasource-id> -o ./output/
+tableau-cli ds download <datasource-id> -o ./output/ --to parquet
+tableau-cli ds download <datasource-id> -o ./output/ --to csv
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `datasource_id` | string (positional) | required | Datasource LUID |
+| `-o, --output` | path | `.` | Output path (directory or filename) |
+| `--to` | tdsx / parquet / csv | tdsx | Output format; parquet/csv automatically converts after download |
+
+Output: `{"filePath": "<absolute path>"}`
+
+When `--to parquet` or `--to csv` is specified, the datasource is downloaded, converted in a temporary directory, and only the final file is written to the output path. Requires `tableau-cli[convert]` extras.
+
+### ds metadata
+
+View datasource field metadata. Requires VizQL Data Service.
+
+```bash
+tableau-cli ds metadata <luid>
+tableau-cli ds metadata <luid> --format table
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `luid` | string (positional) | required | Datasource LUID |
+| `--format` | json / table | json | Output format |
+
+Returns:
+- `datasourceDescription` — datasource description
+- `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.
+
+### ds query
+
+Query datasource data directly. Requires VizQL Data Service.
+
+```bash
+tableau-cli ds query <luid> --query '{"fields": [{"fieldCaption": "Category"}, {"fieldCaption": "Sales"}]}'
+tableau-cli ds query <luid> --query '{"fields": [...]}' --limit 100 --format table
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `luid` | string (positional) | required | Datasource LUID |
+| `--query` | JSON string | required | Query definition (fields, filters, etc.) |
+| `--limit` | int | none | Row limit (client-side truncation) |
+| `--format` | json / table | json | Output format |
+
+`--query` must be valid JSON; otherwise reports `invalid-input` error. `--limit` truncates client-side, not server-side.
+
+---
+
+## views
+
+Views include worksheets (Sheets), dashboards, and stories.
+
+### views list
+
+```bash
+tableau-cli views list
+tableau-cli views list --filter "name:has:keyword" --format table
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `--filter` | string | none | Server-side filter |
+| `--page-size` | int | none | Items per page |
+| `--limit` | int | none | Max total results |
+| `--format` | json / table | json | Output format |
+
+Results include `workbookId` to trace back to the parent workbook.
+
+### views data
+
+Export view data as CSV.
+
+```bash
+tableau-cli views data <view-id>
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `view_id` | string (positional) | View LUID |
+
+Output: CSV text written directly to stdout (not JSON).
+
+### views image
+
+Export view as image.
+
+```bash
+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
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `view_id` | string (positional) | required | View LUID |
+| `--width` | int | none | Image width in pixels |
+| `--height` | int | none | Image height in pixels |
+| `--img-format` | PNG / SVG | PNG | Image format |
+| `-o, --output` | path | none | Output file path |
+
+With `-o`: outputs `{"filePath": "<absolute path>"}`. Without `-o`: base64-encoded image to stdout.
+
+---
+
+## workbooks (alias: wb)
+
+### wb list
+
+```bash
+tableau-cli wb list
+tableau-cli wb list --filter "name:has:keyword" --format table
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `--filter` | string | none | Server-side filter |
+| `--page-size` | int | none | Items per page |
+| `--limit` | int | none | Max total results |
+| `--format` | json / table | json | Output format |
+
+### wb get
+
+View workbook details, including all views with usage statistics.
+
+```bash
+tableau-cli wb get <workbook-id>
+tableau-cli wb get <workbook-id> --format table
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `workbook_id` | string (positional) | required | Workbook LUID |
+| `--format` | json / table | json | Output format |
+
+---
+
+## convert
+
+Local file conversion: TDSX/HYPER → Parquet/CSV. Requires `tableau-cli[convert]`.
+
+```bash
+tableau-cli convert data.tdsx
+tableau-cli convert data.tdsx -o ./output/
+tableau-cli convert data.tdsx --to csv -o ./output/
+tableau-cli convert extract.hyper -o ./output/result.parquet
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `input_path` | path (positional) | required | Input file (.tdsx or .hyper) |
+| `--to` | parquet / csv | parquet | Output format |
+| `-o, --output` | path | none | Output path (directory or filename); defaults to input file directory |
+
+Output: `{"filePath": "<absolute path>"}`
+
+Reports `missing-dependencies` error if convert extras are not installed, with hint to run `pip install "tableau-cli[convert]"`.
+
+---
+
+## config
+
+### config show
+
+```bash
+tableau-cli config show
+```
+
+Outputs current configuration as JSON. PAT value is masked as `"****"`.
+
+### config set
+
+```bash
+tableau-cli config set --server https://... --site-name ... --pat-name ... --pat-value ...
+```
+
+All options are optional; only updates the specified fields. Saves to `~/.tableau-cli.json`.
+
+---
+
+## Filter Syntax
+
+The `--filter` option uses `field:operator:value` format:
+
+| Operator | Meaning | Example |
+|----------|---------|---------|
+| `eq` | Exact match | `name:eq:Superstore` |
+| `has` | Contains | `name:has:Sales` |
+| `in` | Multi-value match | `name:in:[A,B,C]` |
+
+---
+
+## Intent → Command Quick Reference
+
+| User wants to… | Command |
+|-----------------|---------|
+| Search content (any type) | `search "keyword"` |
+| Find datasources | `ds list --filter "name:has:..."` |
+| Download a datasource file | `ds download <id> -o dir/` |
+| Download datasource as Parquet | `ds download <id> -o dir/ --to parquet` |
+| Download datasource as CSV | `ds download <id> -o dir/ --to csv` |
+| Inspect datasource fields | `ds metadata <luid>` |
+| Query data from a datasource | `ds query <luid> --query '{...}'` |
+| Find a dashboard/view | `views list --filter "name:has:..."` |
+| Export view data | `views data <view-id>` |
+| Export view screenshot | `views image <view-id> -o file.png` |
+| Find workbooks | `wb list --filter "name:has:..."` |
+| See views in a workbook | `wb get <workbook-id>` |
+| Convert local TDSX to Parquet | `convert file.tdsx -o dir/` |
+| Download and convert for analysis | `ds download <id> --to parquet` |

tableau_cli-0.1.1/skills/references/installation.md

@@ -0,0 +1,46 @@
+---
+name: tableau-cli-installation
+description: Installation and authentication setup for tableau-cli. Load when the CLI is not installed or not configured.
+---
+
+## Installation
+
+```bash
+pip install "tableau-cli[convert]"
+```
+
+Without `[convert]`, only core features are available (search, datasources, views, workbooks) — the `convert` command will not work.
+
+## Authentication
+
+tableau-cli uses Personal Access Token (PAT) authentication.
+
+### Option 1: CLI config (saved to ~/.tableau-cli.json)
+
+```bash
+tableau-cli config set \
+  --server https://your-tableau-server.com \
+  --site-name YourSite \
+  --pat-name your-token-name \
+  --pat-value your-token-value
+```
+
+### Option 2: Environment variables
+
+```bash
+export SERVER=https://your-tableau-server.com
+export SITE_NAME=YourSite
+export PAT_NAME=your-token-name
+export PAT_VALUE=your-token-value
+```
+
+Environment variables take precedence over the config file. `SITE_NAME` defaults to `""` (the default site) if not set.
+
+## Verification
+
+```bash
+tableau-cli config show
+tableau-cli ds list --limit 1
+```
+
+`config show` displays the current configuration (PAT value is masked). If `ds list` returns data, authentication is working.

tableau_cli-0.1.1/skills-lock.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "skills": {
+    "tableau-cli": {
+      "source": "i-richardwang/tableau-cli",
+      "sourceType": "github",
+      "computedHash": "26defe3fe68adfac902da3328240d33528db5fe9757f88f7e3a8bdc90744c6d9"
+    }
+  }
+}

{tableau_cli-0.1.0 → tableau_cli-0.1.1}/src/tableau_cli/cli.py

@@ -95,7 +95,7 @@ class TableauCli(click.Group):
 
 
 @click.group(cls=TableauCli)
-@click.version_option("0.1.0")
+@click.version_option("0.1.1")
 def cli():
     """CLI tool for interacting with Tableau Server/Cloud."""
 

tableau_cli-0.1.1/src/tableau_cli/commands/convert_cmd.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+import click
+
+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,
+)
+
+
+@click.command("convert")
+@click.argument("input_path", type=click.Path(exists=True))
+@click.option(
+    "--to", "to_fmt", default="parquet", type=click.Choice(SUPPORTED_FORMATS), help="Output format (default: parquet)"
+)
+@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()
+
+    if suffix not in (".tdsx", ".hyper"):
+        raise CliError(
+            error_type="invalid-input",
+            message=f"Unsupported file type: {suffix}",
+            hint="Supported formats: .tdsx, .hyper",
+        )
+
+    # Resolve output path
+    ext = f".{to_fmt}"
+    if output_path is None:
+        out_p = input_p.with_suffix(ext)
+    elif os.path.isdir(output_path):
+        out_p = Path(output_path) / f"{input_p.stem}{ext}"
+    else:
+        out_p = Path(output_path)
+
+    # Read hyper data
+    if suffix == ".hyper":
+        df = read_hyper(input_p)
+    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)
+
+    abs_path = os.path.abspath(out_p)
+    sys.stderr.write(f"Converted to {abs_path}\n")
+    output({"filePath": abs_path}, "json")

{tableau_cli-0.1.0 → tableau_cli-0.1.1}/src/tableau_cli/commands/datasources_cmd.py

@@ -51,19 +51,40 @@ def datasources_list(filter_, page_size, limit, fmt):
 @click.option(
     "-o", "--output", "output_path", default=".", help="Output file path or directory (default: current directory)"
 )
-def datasources_download(datasource_id, output_path):
-    """Download a datasource file (.tdsx)."""
+@click.option(
+    "--to",
+    "to_fmt",
+    default="tdsx",
+    type=click.Choice(["tdsx", "parquet", "csv"]),
+    help="Output format (default: tdsx)",
+)
+def datasources_download(datasource_id, output_path, to_fmt):
+    """Download a datasource file, optionally converting to Parquet or CSV."""
+    from pathlib import Path
+
     config = resolve_config()
 
+    if to_fmt != "tdsx":
+        from ..utils.convert import check_convert_deps
+
+        check_convert_deps()
+
     data, filename = with_auth(
         config,
         lambda api: api.download_datasource(datasource_id=datasource_id, site_id=api.site_id),
     )
 
-    file_path = os.path.join(output_path, filename) if os.path.isdir(output_path) else output_path
-
-    with open(file_path, "wb") as f:
-        f.write(data)
+    if to_fmt == "tdsx":
+        file_path = os.path.join(output_path, filename) if os.path.isdir(output_path) else output_path
+        with open(file_path, "wb") as f:
+            f.write(data)
+    else:
+        from ..utils.convert import convert_tdsx_bytes
+
+        stem = Path(filename).stem
+        out_name = f"{stem}.{to_fmt}"
+        file_path = os.path.join(output_path, out_name) if os.path.isdir(output_path) else output_path
+        convert_tdsx_bytes(data, Path(file_path), to_fmt)
 
     abs_path = os.path.abspath(file_path)
     sys.stderr.write(f"Downloaded to {abs_path}\n")

tableau_cli-0.1.0/src/tableau_cli/commands/convert_cmd.py → tableau_cli-0.1.1/src/tableau_cli/utils/convert.py

@@ -1,16 +1,13 @@
+"""Shared helpers for converting TDSX / HYPER files to Parquet or CSV."""
+
 from __future__ import annotations
 
-import os
-import sys
 from pathlib import Path
 from tempfile import TemporaryDirectory
 from typing import TYPE_CHECKING
 from zipfile import ZipFile
 
-import click
-
 from ..errors.cli_error import CliError
-from ..output.format import output
 
 if TYPE_CHECKING:
     import polars as pl
@@ -19,7 +16,15 @@ CONVERT_DEPS = ("pantab", "polars", "pyarrow")
 SUPPORTED_FORMATS = ("parquet", "csv")
 
 
-def _check_convert_deps() -> None:
+def _is_importable(name: str) -> bool:
+    try:
+        __import__(name)
+        return True
+    except ImportError:
+        return False
+
+
+def check_convert_deps() -> None:
     """Check that optional convert dependencies are installed."""
     missing = [pkg for pkg in CONVERT_DEPS if not _is_importable(pkg)]
     if missing:
@@ -30,15 +35,7 @@ def _check_convert_deps() -> None:
         )
 
 
-def _is_importable(name: str) -> bool:
-    try:
-        __import__(name)
-        return True
-    except ImportError:
-        return False
-
-
-def _extract_hyper_from_tdsx(tdsx_path: Path, target_dir: Path) -> Path:
+def extract_hyper_from_tdsx(tdsx_path: Path, target_dir: Path) -> Path:
     """Extract the .hyper file from a TDSX archive."""
     with ZipFile(tdsx_path) as zf:
         members = [m for m in zf.namelist() if m.endswith(".hyper")]
@@ -63,7 +60,7 @@ def _extract_hyper_from_tdsx(tdsx_path: Path, target_dir: Path) -> Path:
         return extracted
 
 
-def _read_hyper(hyper_path: Path) -> pl.DataFrame:
+def read_hyper(hyper_path: Path) -> pl.DataFrame:
     """Read .hyper file and return as Polars DataFrame."""
     import pantab
     import polars as pl
@@ -83,7 +80,7 @@ def _read_hyper(hyper_path: Path) -> pl.DataFrame:
     return pl.from_pandas(next(iter(frames.values())))
 
 
-def _write_df(df: pl.DataFrame, output_path: Path, to: str) -> None:
+def write_df(df: pl.DataFrame, output_path: Path, to: str) -> None:
     """Write DataFrame to the specified format."""
     if to == "parquet":
         df.write_parquet(output_path)
@@ -91,45 +88,12 @@ def _write_df(df: pl.DataFrame, output_path: Path, to: str) -> None:
         df.write_csv(output_path)
 
 
-@click.command("convert")
-@click.argument("input_path", type=click.Path(exists=True))
-@click.option(
-    "--to", "to_fmt", default="parquet", type=click.Choice(SUPPORTED_FORMATS), help="Output format (default: parquet)"
-)
-@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()
-
-    if suffix not in (".tdsx", ".hyper"):
-        raise CliError(
-            error_type="invalid-input",
-            message=f"Unsupported file type: {suffix}",
-            hint="Supported formats: .tdsx, .hyper",
-        )
-
-    # Resolve output path
-    ext = f".{to_fmt}"
-    if output_path is None:
-        out_p = input_p.with_suffix(ext)
-    elif os.path.isdir(output_path):
-        out_p = Path(output_path) / f"{input_p.stem}{ext}"
-    else:
-        out_p = Path(output_path)
-
-    # Read hyper data
-    if suffix == ".hyper":
-        df = _read_hyper(input_p)
-    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)
-
-    abs_path = os.path.abspath(out_p)
-    sys.stderr.write(f"Converted to {abs_path}\n")
-    output({"filePath": abs_path}, "json")
+def convert_tdsx_bytes(data: bytes, output_path: Path, to_fmt: str) -> None:
+    """Convert raw TDSX bytes directly to parquet/csv without persisting the intermediate file."""
+    with TemporaryDirectory() as td:
+        tmp_dir = Path(td)
+        tdsx_path = tmp_dir / "datasource.tdsx"
+        tdsx_path.write_bytes(data)
+        hyper_path = extract_hyper_from_tdsx(tdsx_path, tmp_dir)
+        df = read_hyper(hyper_path)
+    write_df(df, output_path, to_fmt)