Add deployment

.gitignore

@@ -369,3 +369,7 @@ deps/src/
 # such, it should not be committed for packages, but should be committed for
 # applications that require a static environment.
 #Manifest.toml
+
+# Posit Connect files
+manifest.json
+requirements.txt

Makefile

@@ -0,0 +1,23 @@
+MANIFEST_FILES = manifest.json requirements.txt
+SOURCE_FILES := src/reedfrost/__init__.py src/reedfrost/app.py
+
+.PHONY: local deploy clean
+
+local:
+	poetry run streamlit run src/reedfrost/app.py
+
+deploy: $(MANIFEST_FILES) $(SOURCE_FILES)
+	rsconnect deploy \
+		manifest manifest.json \
+		--title reedfrost
+
+manifest.json requirements.txt: $(SOURCE_FILES)
+	rm -f requirements.txt
+	rsconnect write-manifest streamlit . \
+		$(SOURCE_FILES) \
+		--exclude "**" \
+		--entrypoint src/reedfrost/app.py \
+		--overwrite
+
+clean:
+	rm -f $(MANIFEST_FILES)

README.md

@@ -14,16 +14,37 @@ This is a [poetry](https://python-poetry.org/)-enabled Python project:
 2. [Install poetry](https://python-poetry.org/docs/#installation).
 3. Install this package locally with `poetry install`.
 
-### App
-
-Run the [Streamlit](https://streamlit.io/) app locally: `poetry run streamlit run src/reedfrost/app.py`.
-
 ### Docs
 
 Read the [docs online](https://cdcgov.github.io/reedfrost/).
 
 Documentation is built using [`mkdocs`](https://www.mkdocs.org/). View the documentation locally with `poetry run mkdocs serve`.
 
+### Local app
+
+Run the [Streamlit](https://streamlit.io/) app locally with `make local`.
+
+### Deployed app
+
+To deploy using [Posit Connect](https://docs.posit.co/connect/user/publishing-cli/):
+
+- Navigate to your Posit server
+- Request to be made a Publisher
+- Get an API key
+- Add the server:
+  ```
+  rsconnect add \
+    --server YOUR_SERVER \
+    --name NICKNAME \
+    --api-key YOUR_API_KEY
+  ```
+  You may need to add `--insecure` if you have certificate problems.
+- Check which versions of Python are installed on the server:
+  ```
+  rsconnect details -n NICKNAME
+  ```
+  Ensure that the app is developed against a compatible version of Python.
+
 ## Project admins
 
 - Scott Olesen <[email protected]> (CDC/IOD/ORR/CFA)

pyproject.toml

@@ -17,6 +17,7 @@ polars = "^1.23.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.3.4"
+rsconnect-python = "^1.25.2"
 
 
 [tool.poetry.group.mkdocs.dependencies]