tableau-cli 0.1.3__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.3 → 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.3
+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.
 
-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**
 
-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.
+```
+codex plugin marketplace add i-richardwang/tableau-cli
+codex plugin add tableau-cli@tableau-cli
+```
 
-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.
+To receive updates, run `codex plugin marketplace upgrade`.
+
+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
 
@@ -166,7 +168,16 @@ 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 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 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.
 
@@ -268,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.3 → 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.
 
-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**
 
-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.
+```
+codex plugin marketplace add i-richardwang/tableau-cli
+codex plugin add tableau-cli@tableau-cli
+```
 
-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.
+To receive updates, run `codex plugin marketplace upgrade`.
+
+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
 
@@ -136,7 +137,16 @@ 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 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 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.
 
@@ -238,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.3 → tableau_cli-0.1.5}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tableau-cli"
-version = "0.1.3"
+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.3/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.3/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.3 → 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.3")
+@click.version_option(package_name="tableau-cli")
 def cli():
     """CLI tool for interacting with Tableau Server/Cloud."""
 

{tableau_cli-0.1.3 → tableau_cli-0.1.5}/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,19 @@ def convert_command(input_path, to_fmt, output_path):
     else:
         out_p = Path(output_path)
 
-    # Read hyper data
+    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":
-        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.3 → tableau_cli-0.1.5}/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,