posit-cli 0.1.1__tar.gz → 0.2.0__tar.gz

posit_cli-0.2.0/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: chore(deps)
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: chore(deps)

{posit_cli-0.1.1 → posit_cli-0.2.0}/.github/workflows/ci.yaml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - uses: astral-sh/setup-uv@v9.0.0
+      - uses: astral-sh/setup-uv@v10.3.3
       - uses: extractions/setup-just@v4
       # Fail fast if uv.lock has drifted from pyproject.toml.
       - run: uv lock --locked
@@ -33,7 +33,7 @@ jobs:
           - "3.14"
     steps:
       - uses: actions/checkout@v7
-      - uses: astral-sh/setup-uv@v9.0.0
+      - uses: astral-sh/setup-uv@v10.3.3
         with:
           python-version: ${{ matrix.python-version }}
       - uses: extractions/setup-just@v4
@@ -46,7 +46,7 @@ jobs:
         # hatch-vcs reads the version from the tags, so fetch them.
         with:
           fetch-depth: 0
-      - uses: astral-sh/setup-uv@v9.0.0
+      - uses: astral-sh/setup-uv@v10.3.3
       - uses: extractions/setup-just@v4
       - run: just build
       - run: just smoke

{posit_cli-0.1.1 → posit_cli-0.2.0}/.github/workflows/release.yaml

@@ -13,7 +13,7 @@ jobs:
       - uses: actions/checkout@v7
         with:
           fetch-depth: 0
-      - uses: astral-sh/setup-uv@v9.0.0
+      - uses: astral-sh/setup-uv@v10.3.3
       - uses: extractions/setup-just@v4
       # The tag is the only source of the version, so this only guards against a
       # build that did not pick the tag up (shallow clone, dirty tree, two tags on
@@ -37,7 +37,7 @@ jobs:
           fi
       - run: just build
       - run: just smoke
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v7
         with:
           name: dist
           path: dist/
@@ -51,7 +51,7 @@ jobs:
       contents: write
     steps:
       - uses: actions/checkout@v7
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist/

posit_cli-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,91 @@
+# Contributing
+
+This guide covers local development for `posit-cli`. End-user installation and CLI usage are documented in [README.md](README.md).
+
+## Prerequisites
+
+Install these tools before starting:
+
+- Git
+- Python 3.8 or newer
+- [uv](https://docs.astral.sh/uv/)
+- [just](https://github.com/casey/just)
+
+The project uses uv for dependency management and virtual environments. The supported Python versions are 3.8 through 3.14, which are tested in CI.
+
+## Set Up
+
+Clone the repository and change into its directory:
+
+```console
+git clone https://github.com/posit-dev/posit-cli.git
+cd posit-cli
+```
+
+Sync the project, test, and lint dependencies:
+
+```console
+just deps
+```
+
+This runs `uv sync --all-extras`, using `uv.lock` to create or update the project environment in `.venv`. You do not need to activate `.venv` when using the `just` recipes.
+
+To put an editable `posit` command on your `PATH`, run:
+
+```console
+just dev
+posit --help
+```
+
+`just dev` installs the checkout as an editable uv tool. Changes to the source are therefore available through `posit` without rebuilding or reinstalling the package. If the command is not found, add the directory printed by `uv tool dir --bin` to your `PATH`, or run `uv tool update-shell`.
+
+## Common Commands
+
+Run these commands from the repository root:
+
+| Command | Purpose |
+| --- | --- |
+| `just deps` | Sync runtime, test, and lint dependencies from `uv.lock`. |
+| `just dev` | Install the checkout as an editable uv tool. |
+| `just test` | Run tests against Python 3.13. |
+| `just test 3.8` | Run tests against a specific Python version. |
+| `just lint` | Check formatting and run Ruff. |
+| `just fmt` | Format files and apply Ruff fixes. |
+| `just build` | Build the wheel and source distribution in `dist/`. |
+| `just smoke` | Run `posit --help` from the latest built wheel. |
+| `just install` | Install the latest built wheel as a non-editable uv tool. |
+| `just uninstall` | Remove the uv-managed `posit-cli` tool. |
+| `just clean` | Remove build, test, and lint artifacts. |
+
+`just smoke` expects a wheel to exist in `dist/`, so run `just build` first unless another command has already built one.
+
+## Dependency Changes
+
+Runtime dependencies and optional test/lint dependencies are declared in `pyproject.toml`. When changing them:
+
+1. Update `pyproject.toml`.
+2. Run `uv lock` to update `uv.lock`.
+3. Run `just deps` to sync the local environment.
+4. Include both `pyproject.toml` and `uv.lock` in the change.
+
+CI checks that the lockfile is current with `uv lock --locked`.
+
+## Before Opening A Pull Request
+
+Run the checks relevant to your change. The normal local validation sequence is:
+
+```console
+just deps
+just lint
+just test
+just build
+just smoke
+```
+
+CI also runs the test suite against Python 3.8, 3.9, 3.10, 3.11, 3.12, 3.13, and 3.14. Add or update tests when changing behavior, and update user-facing documentation in `README.md` when the CLI changes.
+
+Keep commits focused and use Conventional Commit messages, such as `fix: handle expired Connect tokens` or `docs: clarify local setup`.
+
+## Releases
+
+Release preparation and publishing are documented in [RELEASE.md](RELEASE.md). In particular, do not add a hard-coded version to `pyproject.toml`; release versions come from Git tags through `hatch-vcs`.

{posit_cli-0.1.1 → posit_cli-0.2.0}/Justfile

@@ -1,5 +1,9 @@
 # posit-cli task runner. Run `just --list` to see recipes.
 
+# Sync project and development dependencies into the project environment
+deps:
+    uv sync --all-extras
+
 # Run the test suite against a single Python version (default 3.13)
 test py="3.13":
     uv run --python {{py}} --extra test pytest tests
@@ -25,9 +29,17 @@ smoke:
     WHL=$(ls -t dist/*.whl | head -1)
     uv run --no-project --with "$WHL" posit --help
 
-# Install the most recently built wheel into the active environment
+# Install the most recently built wheel as a standalone uv tool
 install: build
-    uv pip install "$(ls -t dist/*.whl | head -1)"
+    uv tool install --force "$(ls -t dist/*.whl | head -1)"
+
+# Install the project as an editable standalone uv tool
+dev:
+    uv tool install --editable --force .
+
+# Remove the installed standalone uv tool
+uninstall:
+    uv tool uninstall posit-cli
 
 # Print the version that a build gets from the current git state
 version:

posit_cli-0.1.1/README.md → posit_cli-0.2.0/PKG-INFO

@@ -1,3 +1,23 @@
+Metadata-Version: 2.5
+Name: posit-cli
+Version: 0.2.0
+Summary: A single, friendly command-line interface for Posit Connect, in the spirit of gh.
+Author: Posit Software, PBC
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.8
+Requires-Dist: click>=8.0
+Requires-Dist: jq>=1.4
+Requires-Dist: keyring>=23.0
+Requires-Dist: rsconnect-python<2,>=1.33
+Provides-Extra: lint
+Requires-Dist: ruff>=0.6; extra == 'lint'
+Provides-Extra: snowflake
+Requires-Dist: rsconnect-python[snowflake]; extra == 'snowflake'
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == 'test'
+Description-Content-Type: text/markdown
+
 # posit-cli
 
 A friendly command-line interface for Posit products, in the spirit of [`gh`](https://cli.github.com/).
@@ -37,6 +57,22 @@ Each of these puts the `posit` executable on your `PATH`. To upgrade later, run
 [Git authentication docs](https://docs.astral.sh/uv/concepts/authentication/git/)
 for tokens and other hosts.
 
+### Connect on Snowflake
+
+To deploy to Posit Connect on Snowflake, install the Snowflake extra instead:
+
+```console
+uv tool install 'posit-cli[snowflake]'
+# or: pip install 'posit-cli[snowflake]'
+```
+
+This includes the Snowflake CLI. Before deploying, configure a
+[Snowflake CLI connection](https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections)
+with access to your Connect instance and `authenticator` set to `snowflake_jwt`
+(key-pair authentication) or `oauth`. Select it with
+`--snowflake-connection-name` when adding the Connect server with
+`posit connect add`; see `posit connect add --help` for options.
+
 ## Getting started
 
 **1. Log in.** Point `posit` at your Connect server and authenticate. This runs
@@ -114,10 +150,27 @@ $ posit connect api v1/users -X GET -f page_size=5          # or force GET
 $ posit connect api v1/content -f name=my-app              # POST body (creates content)
 ```
 
+## `posit connect version`
+
+Print the Connect server version using your saved credentials:
+
+```console
+$ posit connect version
+$ posit connect version --name production
+$ posit connect version --server https://connect.example.com --api-key "$CONNECT_API_KEY"
+```
+
+The command supports `-n`/`--name`, `-s`/`--server`, `-k`/`--api-key`,
+`--no-tls-verify`, and `-c`/`--cacert`, with the same connection environment
+variables as `posit connect api`. It prints an empty line if the server hides
+its version. Rsconnect's `CONNECT_SERVER_VERSION` environment variable overrides
+the reported version.
+
 ## `posit connect *`
 
 `posit` wraps [`rsconnect-python`](https://github.com/posit-dev/rsconnect-python):
 it re-exposes the full `rsconnect` command set under `posit connect`, in addition to the `api` utility.
+The `version` command is overridden to report the Connect server version.
 
 ## Using `posit` with Claude Code
 

posit_cli-0.1.1/PKG-INFO → posit_cli-0.2.0/README.md

@@ -1,21 +1,3 @@
-Metadata-Version: 2.4
-Name: posit-cli
-Version: 0.1.1
-Summary: A single, friendly command-line interface for Posit Connect, in the spirit of gh.
-Author: Posit Software, PBC
-License-Expression: MIT
-License-File: LICENSE
-Requires-Python: >=3.8
-Requires-Dist: click>=8.0
-Requires-Dist: jq>=1.4
-Requires-Dist: keyring>=23.0
-Requires-Dist: rsconnect-python<2,>=1.30
-Provides-Extra: lint
-Requires-Dist: ruff>=0.6; extra == 'lint'
-Provides-Extra: test
-Requires-Dist: pytest>=7; extra == 'test'
-Description-Content-Type: text/markdown
-
 # posit-cli
 
 A friendly command-line interface for Posit products, in the spirit of [`gh`](https://cli.github.com/).
@@ -55,6 +37,22 @@ Each of these puts the `posit` executable on your `PATH`. To upgrade later, run
 [Git authentication docs](https://docs.astral.sh/uv/concepts/authentication/git/)
 for tokens and other hosts.
 
+### Connect on Snowflake
+
+To deploy to Posit Connect on Snowflake, install the Snowflake extra instead:
+
+```console
+uv tool install 'posit-cli[snowflake]'
+# or: pip install 'posit-cli[snowflake]'
+```
+
+This includes the Snowflake CLI. Before deploying, configure a
+[Snowflake CLI connection](https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections)
+with access to your Connect instance and `authenticator` set to `snowflake_jwt`
+(key-pair authentication) or `oauth`. Select it with
+`--snowflake-connection-name` when adding the Connect server with
+`posit connect add`; see `posit connect add --help` for options.
+
 ## Getting started
 
 **1. Log in.** Point `posit` at your Connect server and authenticate. This runs
@@ -132,10 +130,27 @@ $ posit connect api v1/users -X GET -f page_size=5          # or force GET
 $ posit connect api v1/content -f name=my-app              # POST body (creates content)
 ```
 
+## `posit connect version`
+
+Print the Connect server version using your saved credentials:
+
+```console
+$ posit connect version
+$ posit connect version --name production
+$ posit connect version --server https://connect.example.com --api-key "$CONNECT_API_KEY"
+```
+
+The command supports `-n`/`--name`, `-s`/`--server`, `-k`/`--api-key`,
+`--no-tls-verify`, and `-c`/`--cacert`, with the same connection environment
+variables as `posit connect api`. It prints an empty line if the server hides
+its version. Rsconnect's `CONNECT_SERVER_VERSION` environment variable overrides
+the reported version.
+
 ## `posit connect *`
 
 `posit` wraps [`rsconnect-python`](https://github.com/posit-dev/rsconnect-python):
 it re-exposes the full `rsconnect` command set under `posit connect`, in addition to the `api` utility.
+The `version` command is overridden to report the Connect server version.
 
 ## Using `posit` with Claude Code
 

{posit_cli-0.1.1 → posit_cli-0.2.0}/pyproject.toml

@@ -12,7 +12,7 @@ dependencies = [
     # posit-cli reuses rsconnect-python's *internal* API (RSConnectExecutor,
     # RSConnectClient). These have no stability contract, so re-verify the internals
     # on bumps. See tests/test_rsconnect_contract.py.
-    "rsconnect-python>=1.30,<2",
+    "rsconnect-python>=1.33,<2",
     # rsconnect imports `keyring` optionally; we depend on it directly so OAuth
     # tokens land in the OS keyring.
     "keyring>=23.0",
@@ -25,6 +25,7 @@ dependencies = [
 posit = "posit_cli.__main__:cli"
 
 [project.optional-dependencies]
+snowflake = ["rsconnect-python[snowflake]"]
 test = ["pytest>=7"]
 lint = ["ruff>=0.6"]
 

{posit_cli-0.1.1 → posit_cli-0.2.0}/skills/posit-cli/SKILL.md

@@ -175,6 +175,10 @@ posit connect deploy quarto ./report
 posit connect deploy manifest ./manifest.json   # deploy a prepared bundle
 ```
 
+To update existing Connect content instead of creating new content, pass its
+GUID with `--guid <guid>`. Find the GUID with
+`posit connect api v1/content -q '.[] | "\(.guid)  \(.title)"'`.
+
 Available deploy targets include `api`, `bokeh`, `bundle`, `dash`, `fastapi`,
 `flask`, `gradio`, `html`, `manifest`, `nodejs`, `notebook`, `panel`, `pyproject`,
 `quarto`, `shiny`, `streamlit`, `tensorflow`, `voila`. Use `quickstart` to
@@ -191,6 +195,8 @@ These are rsconnect commands — run `posit connect <command> --help` for detail
 - `add` / `list` / `remove` / `details` / `info` — manage saved servers and
   deployment metadata.
 - `login` / `logout` — OAuth credential management.
+- `token` — print the OAuth access token from `login` (for the Connect SDKs or
+  `curl`). `--refresh` gets a new one after a 401; exit status 4 means log in again.
 - `bootstrap` — create an initial admin user on a fresh Connect instance.
 
 ## When something fails

{posit_cli-0.1.1 → posit_cli-0.2.0}/src/posit_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.1'
-__version_tuple__ = version_tuple = (0, 1, 1)
+__version__ = version = '0.2.0'
+__version_tuple__ = version_tuple = (0, 2, 0)
 
 __commit_id__ = commit_id = None

{posit_cli-0.1.1 → posit_cli-0.2.0}/src/posit_cli/connect/__init__.py

@@ -9,6 +9,7 @@ import click
 from rsconnect.main import cli as rsconnect_cli
 
 from .api import api as api_cmd
+from .version import version as version_cmd
 
 
 _epilog = (
@@ -29,3 +30,5 @@ for _name, _cmd in rsconnect_cli.commands.items():
     connect.add_command(_cmd, name=_name)
 
 connect.add_command(api_cmd, name="api")
+# The mounted command reports the rsconnect package version.
+connect.add_command(version_cmd, name="version")

posit_cli-0.2.0/src/posit_cli/connect/version.py

@@ -0,0 +1,68 @@
+"""Print the selected Connect server's version."""
+
+from typing import Optional
+
+import click
+from rsconnect.api import RSConnectException, RSConnectExecutor
+
+
+@click.command(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    short_help="Show the Connect server version.",
+)
+@click.option("--name", "-n", default=None, help="Nickname of a saved server.")
+@click.option(
+    "--server",
+    "-s",
+    default=None,
+    envvar="CONNECT_SERVER",
+    help="Connect server URL [env: CONNECT_SERVER].",
+)
+@click.option(
+    "--api-key",
+    "-k",
+    default=None,
+    envvar="CONNECT_API_KEY",
+    help="Connect API key [env: CONNECT_API_KEY].",
+)
+@click.option(
+    "--no-tls-verify",
+    "insecure",
+    is_flag=True,
+    default=False,
+    envvar="CONNECT_INSECURE",
+    help="Skip TLS certificate verification (still uses TLS) [env: CONNECT_INSECURE].",
+)
+@click.option(
+    "--cacert",
+    "-c",
+    type=click.Path(exists=True, dir_okay=False),
+    default=None,
+    envvar="CONNECT_CA_CERTIFICATE",
+    help="Path to trusted TLS CA certificate.",
+)
+def version(
+    name: Optional[str],
+    server: Optional[str],
+    api_key: Optional[str],
+    insecure: bool,
+    cacert: Optional[str],
+) -> None:
+    """Print the Connect server version using saved credentials by default.
+
+    CONNECT_SERVER_VERSION overrides the reported version. If the server hides
+    its version, print an empty line.
+    """
+    try:
+        executor = RSConnectExecutor(
+            ctx=None,
+            name=name,
+            url=server,
+            api_key=api_key,
+            insecure=insecure,
+            cacert=cacert,
+        )
+        server_version = executor.client.server_version()
+    except RSConnectException as exc:
+        raise click.ClickException(str(exc)) from exc
+    click.echo(server_version)

{posit_cli-0.1.1 → posit_cli-0.2.0}/tests/test_rsconnect_contract.py

@@ -17,6 +17,7 @@ def test_executor_surface():
         assert expected in params, f"RSConnectExecutor lost __init__ param {expected!r}"
 
     assert hasattr(RSConnectClient, "request")
+    assert callable(getattr(RSConnectClient, "server_version", None))
     req_params = inspect.signature(RSConnectClient.request).parameters
     for expected in ("method", "path", "query_params", "body", "headers"):
         assert expected in req_params, f"RSConnectClient.request lost {expected!r}"

posit_cli-0.2.0/tests/test_version.py

@@ -0,0 +1,97 @@
+"""Tests for Connect server version output and connection selection."""
+
+from unittest.mock import patch
+
+import pytest
+from click.testing import CliRunner
+from rsconnect.api import RSConnectClient, RSConnectException, RSConnectServer
+
+from posit_cli.__main__ import cli
+
+
+@pytest.mark.parametrize(
+    "settings, output", [({"version": "2026.10.0"}, "2026.10.0\n"), ({}, "\n")]
+)
+def test_server_version(settings, output, monkeypatch):
+    monkeypatch.delenv("CONNECT_SERVER_VERSION", raising=False)
+    client = RSConnectClient(RSConnectServer("https://connect.example.com", api_key="key"))
+    with patch("posit_cli.connect.version.RSConnectExecutor") as executor:
+        with patch.object(client, "get", return_value=settings) as get:
+            executor.return_value.client = client
+            result = CliRunner().invoke(cli, ["connect", "version"])
+    assert result.exit_code == 0, result.output
+    assert result.output == output
+    get.assert_called_once_with("server_settings")
+    executor.assert_called_once_with(
+        ctx=None, name=None, url=None, api_key=None, insecure=False, cacert=None
+    )
+
+
+def test_server_version_override(monkeypatch):
+    monkeypatch.setenv("CONNECT_SERVER_VERSION", "2026.09.0")
+    client = RSConnectClient(RSConnectServer("https://connect.example.com", api_key="key"))
+    with patch("posit_cli.connect.version.RSConnectExecutor") as executor:
+        with patch.object(client, "get") as get:
+            executor.return_value.client = client
+            result = CliRunner().invoke(cli, ["connect", "version"])
+    assert result.exit_code == 0, result.output
+    assert result.output == "2026.09.0\n"
+    get.assert_not_called()
+
+
+@pytest.mark.parametrize("use_env", [False, True])
+def test_connection_options(tmp_path, use_env):
+    cacert = tmp_path / "ca.pem"
+    cacert.write_text("certificate")
+    args = ["connect", "version", "--name", "production"]
+    env = {}
+    if use_env:
+        env = {
+            "CONNECT_SERVER": "https://connect.example.com",
+            "CONNECT_API_KEY": "key",
+            "CONNECT_INSECURE": "true",
+            "CONNECT_CA_CERTIFICATE": str(cacert),
+        }
+    else:
+        args += [
+            "-s",
+            "https://connect.example.com",
+            "-k",
+            "key",
+            "--no-tls-verify",
+            "-c",
+            str(cacert),
+        ]
+    with patch("posit_cli.connect.version.RSConnectExecutor") as executor:
+        executor.return_value.client.server_version.return_value = "2026.10.0"
+        result = CliRunner().invoke(cli, args, env=env)
+    assert result.exit_code == 0, result.output
+    executor.assert_called_once_with(
+        ctx=None,
+        name="production",
+        url="https://connect.example.com",
+        api_key="key",
+        insecure=True,
+        cacert=str(cacert),
+    )
+
+
+@pytest.mark.parametrize("stage", ["selection", "request"])
+def test_errors(stage):
+    with patch("posit_cli.connect.version.RSConnectExecutor") as executor:
+        error = RSConnectException("unable to retrieve server version")
+        if stage == "selection":
+            executor.side_effect = error
+        else:
+            executor.return_value.client.server_version.side_effect = error
+        result = CliRunner().invoke(cli, ["connect", "version"])
+    assert result.exit_code == 1
+    assert result.output == "Error: unable to retrieve server version\n"
+    assert isinstance(result.exception, SystemExit)
+
+
+def test_help():
+    result = CliRunner().invoke(cli, ["connect", "version", "-h"])
+    assert result.exit_code == 0
+    assert "Connect server version" in result.output
+    assert "--server" in result.output