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

tableau_cli-0.1.5/.agents/plugins/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "tableau-cli",
+  "interface": {
+    "displayName": "Tableau CLI"
+  },
+  "plugins": [
+    {
+      "name": "tableau-cli",
+      "description": "Interact with Tableau Server / Cloud via tableau-cli: search content, query datasources, download files, export view images and data, convert TDSX/HYPER to Parquet/CSV.",
+      "source": {
+        "source": "local",
+        "path": "./"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

tableau_cli-0.1.5/.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "name": "tableau-cli",
+  "description": "Claude Code plugin for tableau-cli — a Tableau Server / Cloud CLI designed for AI agent integration.",
+  "owner": {
+    "name": "Richard Wang"
+  },
+  "plugins": [
+    {
+      "name": "tableau-cli",
+      "source": "./",
+      "description": "Interact with Tableau Server / Cloud via tableau-cli: search content, query datasources, download files, export view images and data, convert TDSX/HYPER to Parquet/CSV."
+    }
+  ]
+}

tableau_cli-0.1.5/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "tableau-cli",
+  "description": "Interact with Tableau Server / Cloud via tableau-cli: search content, query datasources, download files, export view images and data, convert TDSX/HYPER to Parquet/CSV.",
+  "version": "0.1.4",
+  "author": {
+    "name": "Richard Wang"
+  },
+  "homepage": "https://github.com/i-richardwang/tableau-cli",
+  "repository": "https://github.com/i-richardwang/tableau-cli",
+  "license": "Apache-2.0"
+}

tableau_cli-0.1.5/.codex-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "tableau-cli",
+  "version": "0.1.4",
+  "description": "Interact with Tableau Server / Cloud via tableau-cli: search content, query datasources, download files, export view images and data, convert TDSX/HYPER to Parquet/CSV.",
+  "author": {
+    "name": "Richard Wang"
+  },
+  "homepage": "https://github.com/i-richardwang/tableau-cli",
+  "repository": "https://github.com/i-richardwang/tableau-cli",
+  "license": "Apache-2.0",
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Tableau CLI",
+    "shortDescription": "Drive Tableau Server / Cloud from an agent via tableau-cli",
+    "category": "Productivity"
+  }
+}

tableau_cli-0.1.5/.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - "**"
+  pull_request:
+
+jobs:
+  conversion:
+    name: Hyper exports (${{ matrix.os }}, Python ${{ matrix.python }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [macos-14, macos-15-intel, windows-latest, ubuntu-latest]
+        python: ['3.11', '3.14']
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv python install ${{ matrix.python }}
+      - run: uv venv --python ${{ matrix.python }}
+      - run: uv pip install -e ".[convert,dev]" "tableauhyperapi==0.0.26479"
+      - run: uv run --no-sync ruff check .
+      - run: uv run --no-sync pytest
+      - run: uv build

tableau_cli-0.1.5/.github/workflows/release.yml

@@ -0,0 +1,75 @@
+name: "Publish release to PyPI"
+
+on:
+  push:
+    tags:
+      # Publish on version tags, e.g. v0.1.0
+      - "v[0-9]+.[0-9]+.[0-9]+"
+      - "v[0-9]+.[0-9]+.[0-9]+rc[0-9]+"
+      - "v[0-9]+.[0-9]+.[0-9]+[ab][0-9]+"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Check tag matches package version
+        run: |
+          version="$(python3 -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')"
+          tag="${GITHUB_REF_NAME#v}"
+          if [ "$version" != "$tag" ]; then
+            echo "::error::Tag ${GITHUB_REF_NAME} does not match pyproject.toml version ${version}."
+            exit 1
+          fi
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: false
+
+      - name: Build
+        run: uv build
+
+      - name: Smoke test (wheel)
+        run: uv run --isolated --no-project --with dist/*.whl tableau-cli --version | grep -F -x "tableau-cli, version ${GITHUB_REF_NAME#v}"
+
+      - name: Smoke test (source distribution)
+        run: uv run --isolated --no-project --with dist/*.tar.gz tableau-cli --version | grep -F -x "tableau-cli, version ${GITHUB_REF_NAME#v}"
+
+      - name: Upload distributions as artifacts
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: false
+
+      - name: Download distributions artifact
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: dist
+          path: dist/
+
+      - name: Generate PEP 740 attestations
+        uses: astral-sh/attest-action@f589a42a7efb6fe400b4f400de60b4bc90390027 # v0.0.6
+
+      - name: Publish
+        run: uv publish --trusted-publishing always

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: tableau-cli
-Version: 0.1.4
+Version: 0.1.5
 Summary: CLI for Tableau Server/Cloud, designed for AI agent integration
 Project-URL: Repository, https://github.com/i-richardwang/tableau-cli
 Author: Richard Wang
@@ -12,20 +12,21 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Requires-Dist: click>=8.0
 Requires-Dist: httpx>=0.27
 Provides-Extra: convert
-Requires-Dist: pantab>=4.0; extra == 'convert'
-Requires-Dist: polars>=1.0; extra == 'convert'
-Requires-Dist: pyarrow>=15.0; extra == 'convert'
+Requires-Dist: tableauhyperapi>=0.0.26479; extra == 'convert'
 Provides-Extra: dev
+Requires-Dist: pyarrow>=15.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
 Requires-Dist: ruff>=0.11; extra == 'dev'
+Requires-Dist: tzdata; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # tableau-cli
@@ -36,7 +37,7 @@ A command-line interface for Tableau Server / Tableau Cloud, designed for AI age
 
 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.
+The companion agent 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 Coding Agents](#use-with-coding-agents) 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.
 
@@ -44,7 +45,7 @@ This project provides the same capabilities as the [tableau-mcp](https://github.
 
 ### Prerequisites
 
-- Python >= 3.10
+- Python >= 3.11
 - A Tableau Server or Tableau Cloud instance
 - A [Personal Access Token (PAT)](https://help.tableau.com/current/server/en-us/security_personal_access_tokens.htm)
 
@@ -83,28 +84,29 @@ Environment variables take precedence over the config file. `siteName` defaults
 tableau-cli config show
 ```
 
-## Use with Claude Code
+## Use with Coding Agents
 
-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.
+This repository ships an agent skill (`skills/tableau-cli/`) that routes a user's request to the right command and loads the full CLI reference only at execution time. The repository doubles as its own plugin marketplace for both Claude Code and Codex.
+
+**Claude Code**
 
 ```
-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)
+/plugin marketplace add i-richardwang/tableau-cli
+/plugin install tableau-cli@tableau-cli
 ```
 
-Once Claude Code has loaded the skill, a typical interaction looks like:
+To receive updates, enable auto-update for the `tableau-cli` marketplace in `/plugin`, or run `/plugin marketplace update tableau-cli` manually.
+
+**Codex**
 
-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.
+```
+codex plugin marketplace add i-richardwang/tableau-cli
+codex plugin add tableau-cli@tableau-cli
+```
 
-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.
+To receive updates, run `codex plugin marketplace upgrade`.
 
-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.
+The skill is only needed when an agent drives the tool — the CLI works standalone from any shell.
 
 ## Commands
 
@@ -128,7 +130,7 @@ 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])
+# Download and convert to Parquet or CSV in one step (requires tableau-cli[convert] or uv)
 tableau-cli ds download <datasourceId> -o ./data/ --to parquet
 tableau-cli ds download <datasourceId> -o ./data/ --to csv
 
@@ -168,10 +170,14 @@ tableau-cli views image <viewId> --vf "Region=West" -o west.png
 
 Convert local TDSX/HYPER files to Parquet or CSV.
 
-Conversion needs heavier packages (`pantab`, `polars`, `pyarrow`). You have two options:
+Conversion runs locally through the official `tableauhyperapi` package. Its native Hyper engine exports directly to Parquet or CSV, without loading the entire extract into a DataFrame. 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`.
+- Install the export dependency 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 the conversion dependency never lands 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`.
+
+The conversion runtime requires native 64-bit Python 3.11 or newer. Supported targets are Apple Silicon Macs (macOS 13+), Intel Macs, Windows x86_64, and the Linux x86_64 distributions supported by [Hyper API](https://tableau.github.io/hyper-db/docs/installation/). Package installation selects the engine for the interpreter's platform; Apple Silicon uses the native ARM package.
+
+Each extract must contain exactly one table. Exports preserve column order and use Hyper's native [Parquet and CSV mappings](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/dc-sql-reference/copy-to.html). CSV includes a header and uses ISO dates. The destination is replaced only after a complete export. Download-and-convert commands check that the local engine can start before downloading the datasource.
 
 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.
 
@@ -273,8 +279,12 @@ Error types include: `authentication-error`, `feature-disabled`, `tableau-api-er
 # Run directly
 python -m tableau_cli.cli views list
 
-# Install in editable mode
-pip install -e .
+# Install development and conversion dependencies
+pip install -e ".[convert,dev]"
+
+# Validate local exports and isolated uv execution
+ruff check .
+pytest
 ```
 
 ## Acknowledgements

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

@@ -6,7 +6,7 @@ A command-line interface for Tableau Server / Tableau Cloud, designed for AI age
 
 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.
+The companion agent 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 Coding Agents](#use-with-coding-agents) 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.
 
@@ -14,7 +14,7 @@ This project provides the same capabilities as the [tableau-mcp](https://github.
 
 ### Prerequisites
 
-- Python >= 3.10
+- Python >= 3.11
 - A Tableau Server or Tableau Cloud instance
 - A [Personal Access Token (PAT)](https://help.tableau.com/current/server/en-us/security_personal_access_tokens.htm)
 
@@ -53,28 +53,29 @@ Environment variables take precedence over the config file. `siteName` defaults
 tableau-cli config show
 ```
 
-## Use with Claude Code
+## Use with Coding Agents
 
-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.
+This repository ships an agent skill (`skills/tableau-cli/`) that routes a user's request to the right command and loads the full CLI reference only at execution time. The repository doubles as its own plugin marketplace for both Claude Code and Codex.
+
+**Claude Code**
 
 ```
-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)
+/plugin marketplace add i-richardwang/tableau-cli
+/plugin install tableau-cli@tableau-cli
 ```
 
-Once Claude Code has loaded the skill, a typical interaction looks like:
+To receive updates, enable auto-update for the `tableau-cli` marketplace in `/plugin`, or run `/plugin marketplace update tableau-cli` manually.
+
+**Codex**
 
-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.
+```
+codex plugin marketplace add i-richardwang/tableau-cli
+codex plugin add tableau-cli@tableau-cli
+```
 
-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.
+To receive updates, run `codex plugin marketplace upgrade`.
 
-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.
+The skill is only needed when an agent drives the tool — the CLI works standalone from any shell.
 
 ## Commands
 
@@ -98,7 +99,7 @@ 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])
+# Download and convert to Parquet or CSV in one step (requires tableau-cli[convert] or uv)
 tableau-cli ds download <datasourceId> -o ./data/ --to parquet
 tableau-cli ds download <datasourceId> -o ./data/ --to csv
 
@@ -138,10 +139,14 @@ tableau-cli views image <viewId> --vf "Region=West" -o west.png
 
 Convert local TDSX/HYPER files to Parquet or CSV.
 
-Conversion needs heavier packages (`pantab`, `polars`, `pyarrow`). You have two options:
+Conversion runs locally through the official `tableauhyperapi` package. Its native Hyper engine exports directly to Parquet or CSV, without loading the entire extract into a DataFrame. 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`.
+- Install the export dependency 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 the conversion dependency never lands 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`.
+
+The conversion runtime requires native 64-bit Python 3.11 or newer. Supported targets are Apple Silicon Macs (macOS 13+), Intel Macs, Windows x86_64, and the Linux x86_64 distributions supported by [Hyper API](https://tableau.github.io/hyper-db/docs/installation/). Package installation selects the engine for the interpreter's platform; Apple Silicon uses the native ARM package.
+
+Each extract must contain exactly one table. Exports preserve column order and use Hyper's native [Parquet and CSV mappings](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/dc-sql-reference/copy-to.html). CSV includes a header and uses ISO dates. The destination is replaced only after a complete export. Download-and-convert commands check that the local engine can start before downloading the datasource.
 
 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.
 
@@ -243,8 +248,12 @@ Error types include: `authentication-error`, `feature-disabled`, `tableau-api-er
 # Run directly
 python -m tableau_cli.cli views list
 
-# Install in editable mode
-pip install -e .
+# Install development and conversion dependencies
+pip install -e ".[convert,dev]"
+
+# Validate local exports and isolated uv execution
+ruff check .
+pytest
 ```
 
 ## Acknowledgements

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

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tableau-cli"
-version = "0.1.4"
+version = "0.1.5"
 description = "CLI for Tableau Server/Cloud, designed for AI agent integration"
 license = "Apache-2.0"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 readme = "README.md"
 authors = [
     { name = "Richard Wang" },
@@ -18,10 +18,10 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries",
 ]
 dependencies = [
@@ -34,12 +34,13 @@ Repository = "https://github.com/i-richardwang/tableau-cli"
 
 [project.optional-dependencies]
 convert = [
-    "pantab>=4.0",
-    "polars>=1.0",
-    "pyarrow>=15.0",
+    "tableauhyperapi>=0.0.26479",
 ]
 dev = [
     "ruff>=0.11",
+    "pytest>=8.0",
+    "pyarrow>=15.0",
+    "tzdata",
 ]
 
 [project.scripts]
@@ -49,7 +50,7 @@ tableau-cli = "tableau_cli.cli:main"
 packages = ["src/tableau_cli"]
 
 [tool.ruff]
-target-version = "py310"
+target-version = "py311"
 line-length = 120
 
 [tool.ruff.lint]

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

@@ -78,7 +78,7 @@ tableau-cli ds download <datasource-id> -o ./output/ --to csv
 
 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.
+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. Runs locally through Hyper API; requires `tableau-cli[convert]` or `uv` on `PATH`.
 
 ### ds metadata
 
@@ -256,7 +256,7 @@ Results include name, description, parent project, content permissions, owner, a
 
 ## convert
 
-Local file conversion: TDSX/HYPER → Parquet/CSV. Requires `tableau-cli[convert]`.
+Local file conversion: TDSX/HYPER → Parquet/CSV. Uses the official local Hyper engine; requires `tableau-cli[convert]` or `uv` on `PATH`.
 
 ```bash
 tableau-cli convert data.tdsx
@@ -273,7 +273,9 @@ tableau-cli convert extract.hyper -o ./output/result.parquet
 
 Output: `{"filePath": "<absolute path>"}`
 
-Reports `missing-dependencies` error if convert extras are not installed, with hint to run `pip install "tableau-cli[convert]"`.
+Requires exactly one table per extract. CSV includes a header and uses ISO dates; Parquet uses Hyper's native type mappings. The output is replaced only after a successful export.
+
+Reports `missing-dependencies` when neither Hyper API nor `uv` is available. Engine startup and export failures are reported as `convert-error`.
 
 ---
 

{tableau_cli-0.1.4/skills → tableau_cli-0.1.5/skills/tableau-cli}/references/installation.md

@@ -9,7 +9,9 @@ description: Installation and authentication setup for tableau-cli. Load when th
 pip install "tableau-cli[convert]"
 ```
 
-Without `[convert]`, only core features are available (search, datasources, views, workbooks) — the `convert` command and `ds download --to parquet/csv` will not work.
+Requires Python 3.11 or newer. The `[convert]` extra installs the official `tableauhyperapi` package for local Parquet/CSV exports. Use native 64-bit Python on Apple Silicon or Intel macOS, Windows x86_64, or a supported Linux x86_64 distribution.
+
+Alternatively, install the core CLI and keep `uv` on `PATH`. Conversion then runs in an isolated environment provisioned automatically by `uv`; the first run installs the export dependency and later runs reuse the cache. Core commands do not need conversion dependencies.
 
 ## Upgrade
 

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

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

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

@@ -43,6 +43,12 @@ def convert_command(input_path, to_fmt, output_path):
     else:
         out_p = Path(output_path)
 
+    if input_p.resolve() == out_p.resolve():
+        raise CliError(
+            error_type="invalid-input",
+            message="The output path must differ from the input file.",
+        )
+
     # Convert (in-process if deps present, else via an ephemeral uv environment)
     if suffix == ".hyper":
         run_conversion(input_p, out_p, to_fmt)

tableau_cli-0.1.5/src/tableau_cli/utils/_hyper_export.py

@@ -0,0 +1,81 @@
+"""Local Hyper exports, shared by the CLI and isolated Python execution."""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+HYPER_REQUIREMENT = "tableauhyperapi>=0.0.26479"
+SUPPORTED_FORMATS = ("parquet", "csv")
+
+
+def _start_hyper():
+    from tableauhyperapi import HyperException, HyperProcess, Telemetry
+
+    try:
+        return HyperProcess(
+            Telemetry.DO_NOT_SEND_USAGE_DATA_TO_TABLEAU,
+            parameters={"log_config": "", "date_style": "YMD"},
+        )
+    except HyperException as exc:
+        raise RuntimeError(
+            "Unable to start the local Hyper engine. Use a native 64-bit Python on a supported platform "
+            f"and reinstall tableau-cli[convert]. Details: {exc}"
+        ) from exc
+
+
+def check_runtime() -> None:
+    """Verify that the installed Hyper engine can start."""
+    with _start_hyper():
+        pass
+
+
+def export_hyper(hyper_path: Path, output_path: Path, to_fmt: str) -> None:
+    """Export a single-table Hyper file, replacing the destination only on success."""
+    from tableauhyperapi import Connection, escape_string_literal
+
+    if to_fmt not in SUPPORTED_FORMATS:
+        raise ValueError(f"Unsupported format: {to_fmt}")
+    source = hyper_path.resolve()
+    destination = output_path.absolute()
+    if source == destination.resolve():
+        raise ValueError("The output path must differ from the input Hyper file.")
+
+    with TemporaryDirectory(prefix=".tableau-export-", dir=destination.parent) as td:
+        staged = Path(td) / f"data.{to_fmt}"
+        with _start_hyper() as hyper, Connection(hyper.endpoint, str(source)) as connection:
+            tables = [
+                table
+                for schema in connection.catalog.get_schema_names()
+                for table in connection.catalog.get_table_names(schema)
+            ]
+            if not tables:
+                raise ValueError(f"No tables found in {hyper_path.name}")
+            if len(tables) != 1:
+                raise ValueError(f"Found {len(tables)} tables in {hyper_path.name}, expected 1")
+
+            options = f"FORMAT => {escape_string_literal(to_fmt)}"
+            if to_fmt == "csv":
+                options += ", HEADER => true"
+            connection.execute_command(f"COPY {tables[0]} TO {escape_string_literal(str(staged))} WITH ({options})")
+        staged.replace(destination)
+
+
+def main() -> None:
+    """Report worker failures as structured JSON for the parent CLI."""
+    try:
+        if sys.argv[1:] == ["--check"]:
+            check_runtime()
+        elif len(sys.argv) == 4:
+            export_hyper(Path(sys.argv[1]), Path(sys.argv[2]), sys.argv[3])
+        else:
+            raise ValueError("Expected --check or <hyper_path> <output_path> <parquet|csv>")
+    except Exception as exc:
+        print(json.dumps({"error_type": "convert-error", "message": str(exc)}))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()