feat: "quickstart" and "deploy pyproject" commands

docs/CHANGELOG.md

@@ -17,6 +17,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   `--no-set-default` is passed. `CONNECT_SERVER` still takes precedence.
 - New `environment` subcommand for managing execution environments on Connect.
 
+### Added
+
+- `rsconnect quickstart` command for scaffolding a new Connect-ready project.
+  Supported types: `streamlit`, `shiny`, `fastapi`, `api`, `flask`, `notebook`,
+  `voila`, `quarto`. Creates a uv-managed virtualenv and prints
+  the local-run and deploy commands.
+- `rsconnect deploy pyproject` command for deploying a project described by
+  `pyproject.toml` with a `[tool.rsconnect]` table containing `app_mode` and
+  `entrypoint`. Designed as the deploy partner for projects scaffolded by
+  `rsconnect quickstart` but works with any conforming `pyproject.toml`.
+
+### Changed
+
+- Bumped the `click` dependency floor to `>=8.2.0`. The newer `click.Choice`
+  generic support is used by `rsconnect quickstart` to validate the project
+  type argument.
+- Added `uv>=0.9.0` as a runtime dependency. `rsconnect quickstart` invokes
+  `uv venv` and `uv sync` to populate the scaffolded project's virtualenv.
+  `uv` installs as a self-contained wheel from PyPI alongside `rsconnect`.
+
 ## [1.29.0] - 2026-04-29
 
 - Added `rsconnect deploy nodejs` command for deploying Node.js applications

docs/commands/quickstart.md

@@ -0,0 +1,3 @@
+::: mkdocs-click
+    :module: rsconnect.main
+    :command: quickstart

docs/deploying.md

@@ -283,6 +283,52 @@ library(rsconnect)
 ?rsconnect::writeManifest
 ```
 
+### Deploying from a pyproject.toml
+
+`rsconnect deploy pyproject` reads a `[tool.rsconnect]` table from a project's
+`pyproject.toml` instead of taking the app mode and entrypoint as CLI arguments.
+It is designed as the deploy partner for projects scaffolded by
+`rsconnect quickstart`, but works with any project whose `pyproject.toml`
+contains the required keys.
+
+The `[tool.rsconnect]` table has two required keys:
+
+- `app_mode` — the Connect app mode the deployment uses. Supported values
+  are `python-streamlit`, `python-shiny`, `python-fastapi`, `python-api`,
+  `jupyter-voila`, `jupyter-static`, `quarto-static`, and `quarto-shiny`.
+- `entrypoint` — the file or importable path Connect runs. The expected form
+  depends on `app_mode`: a script filename such as `app.py` for Streamlit and
+  Shiny, a `module:object` reference such as `my_app.__connect__:app` for
+  FastAPI or WSGI APIs, a `report.qmd` for Quarto, and a `notebook.ipynb` for
+  Voila or static Jupyter content.
+
+A minimal Streamlit project looks like this:
+
+```toml
+[project]
+name = "my_app"
+version = "0.1.0"
+requires-python = ">=3.9"
+dependencies = ["streamlit"]
+
+[tool.rsconnect]
+app_mode = "python-streamlit"
+entrypoint = "app.py"
+```
+
+Projects scaffolded by `rsconnect quickstart` already contain this table.
+From the parent directory of the project, deploy it with:
+
+```bash
+rsconnect deploy pyproject my_app/
+```
+
+The directory passed to `deploy pyproject` must contain `pyproject.toml`.
+Dependencies follow the same resolution rules as the other deploy commands:
+`[project.dependencies]` from `pyproject.toml` provides the dependency
+snapshot, and `uv.lock` or `requirements.txt` may be supplied via
+`--requirements-file` when a pinned environment is needed.
+
 ### Options for All Types of Deployments
 
 These options apply to any type of content deployment.

mkdocs.yml

@@ -49,6 +49,7 @@ nav:
       - list: commands/list.md
       - login: commands/login.md
       - logout: commands/logout.md
+      - quickstart: commands/quickstart.md
       - remove: commands/remove.md
       - system: commands/system.md
       - version: commands/version.md

pyproject.toml

@@ -84,13 +84,18 @@ extend_ignore = ["E203", "E231", "E302"]
 per-file-ignores = ["tests/test_metadata.py: E501"]
 
 [tool.setuptools]
-packages = ["rsconnect"]
+packages = ["rsconnect", "rsconnect.quickstart", "rsconnect.quickstart.templates"]
 
 [tool.setuptools_scm]
 write_to = "rsconnect/version.py"
 
 [tool.setuptools.package-data]
 rsconnect = ["py.typed"]
+# Per-mode quickstart templates are shipped as package data so
+# pkgutil.get_data() can read them from a wheel install. The glob covers
+# every subdirectory (streamlit/, shiny/, fastapi/, api/, notebook/, quarto/)
+# and every extension (.py, .ipynb, .qmd) without enumerating each one.
+"rsconnect.quickstart.templates" = ["**/*"]
 
 [tool.pytest.ini_options]
 markers = ["vetiver: tests for vetiver"]

rsconnect/api.py

@@ -144,7 +144,7 @@ def handle_bad_response(self, response: HTTPResponse | T, is_httpresponse: bool
         if isinstance(response, HTTPResponse):
             if response.exception:
                 raise RSConnectException(
-                    "Exception trying to connect to %s - %s" % (self.url, response.exception), cause=response.exception
+                    "Could not connect to %s - %s" % (self.url, response.exception), cause=response.exception
                 )
             # Sometimes an ISP will respond to an unknown server name by returning a friendly
             # search page so trap that since we know we're expecting JSON from Connect.  This

rsconnect/bundle.py

@@ -57,6 +57,7 @@
 from .exception import RSConnectException
 from .log import VERBOSE, logger
 from .models import AppMode, AppModes, GlobSet
+from .shiny_express import escape_to_var_name, is_express_app
 
 if TYPE_CHECKING:
     from .actions import QuartoInspectResult
@@ -1182,8 +1183,12 @@ def infer_entrypoint_candidates(path: str, mimetype: str) -> list[str]:
 def guess_deploy_dir(path: str | Path, entrypoint: Optional[str]) -> str:
     if path and not exists(path):
         raise RSConnectException(f"Path {path} does not exist.")
+    # The entrypoint is a bare basename meant to be resolved relative to ``path``
+    # (the later logic does ``join(abs_path, basename(entrypoint))``). Accept it
+    # when it exists relative to the CWD or inside ``path``; only reject when neither.
     if entrypoint and not exists(entrypoint):
-        raise RSConnectException(f"Entrypoint {entrypoint} does not exist.")
+        if not (path and isfile(os.path.join(abspath(path), basename(entrypoint)))):
+            raise RSConnectException(f"Entrypoint {entrypoint} does not exist.")
     abs_path = abspath(path)
     abs_entrypoint = abspath(entrypoint) if entrypoint else None
     if not path and not entrypoint:
@@ -1224,6 +1229,26 @@ def guess_deploy_dir(path: str | Path, entrypoint: Optional[str]) -> str:
     return deploy_dir
 
 
+def resolve_shiny_express_entrypoint(entrypoint: str, directory: str) -> str:
+    """Rewrite a Shiny entrypoint to its Shiny Express module form when needed.
+
+    Connect runs Shiny Express apps through the ``shiny.express.app:<var>``
+    module rather than a plain file, so both ``deploy shiny`` and
+    ``deploy pyproject`` must apply this rewrite to deploy a working app.
+
+    Accepts a bare module name (``"app"``) or a filename (``"app.py"``).
+    Returns the ``shiny.express.app:<escaped>`` form when the app file is a
+    Shiny Express app, otherwise returns ``entrypoint`` unchanged.
+
+    :param str entrypoint: the configured entrypoint, with or without ``.py``.
+    :param str directory: directory containing the app file.
+    """
+    app_file = entrypoint if entrypoint.lower().endswith(".py") else entrypoint + ".py"
+    if is_express_app(app_file, directory):
+        return "shiny.express.app:" + escape_to_var_name(app_file)
+    return entrypoint
+
+
 def abs_entrypoint(path: str | Path, entrypoint: str) -> str | None:
     if isfile(entrypoint):
         return abspath(entrypoint)