Add a justfile recipe for running cog

Closes #405

docs/install.md

@@ -2,6 +2,8 @@
 
 <!-- [[[cog
 
+import cog
+
 download_template = """
 1. [Download `python_launcher-{version}-{platform}.tar.xz`](https://github.com/brettcannon/python-launcher/releases/download/{tag}/python_launcher-{version}-{platform}.tar.xz):
 
@@ -19,7 +21,7 @@ tar --extract --strip-components 1 --directory /usr/local --file python_launcher
 def platform_download(platform):
     instructions = download_template.format(tag=TAG, version=VERSION,
                                             platform=platform)
-    print(instructions)
+    cog.outl(instructions)
 
 ]]] -->
 

justfile

@@ -5,6 +5,7 @@ MAN_MD := join(ROOT, "man-page", "py.1.md")
 MAN_FILE := join(ROOT, "man-page", "py.1")
 CARGO_TOML := join(ROOT, "Cargo.toml")
 VENV := join(ROOT, ".venv")
+INSTALL_DOCS := join(ROOT, "docs", "install.md")
 
 # Set default recipes
 _default: lint test man docs
@@ -35,7 +36,6 @@ man: _man-md
     import re
     import tomllib
 
-    VERSION_REGEX = re.compile(r'version\s*=\s*"(?P<version>[\d.]+)"')
 
     with open("{{ CARGO_TOML }}", "rb") as file:
         cargo_data = tomllib.load(file)
@@ -60,6 +60,13 @@ man: _man-md
 docs-lock:
   pipx run --spec pip-tools pip-compile --generate-hashes --allow-unsafe -o docs/requirements.txt docs/requirements.in
 
+# Update insfall instructions for a specific version
+docs-install:
+  #!/usr/bin/env bash
+  set -euxo pipefail
+  version=`cargo run -- -m release version`
+  pipx run cogapp -D VERSION=${version} -D TAG=v${version} -r {{ INSTALL_DOCS }}
+
 # Create a virtual environment for building the docs
 docs-venv:
     #!/usr/bin/env bash
@@ -75,5 +82,5 @@ docs-dev: docs-venv
     cargo run -- -m mkdocs serve
 
 # Build the documentation
-docs: docs-venv
+docs: docs-venv docs-install
     cargo run -- -m mkdocs build

release/requirements.txt

@@ -1,3 +1,2 @@
 black
-cogapp
 tomli

release/version.py

@@ -10,7 +10,7 @@
 
 def get_version():
     """Read the version from Cargo.toml."""
-    with CARGO_FILE.open("r", encoding="utf-8") as file:
+    with CARGO_FILE.open("rb") as file:
         cargo_toml = tomllib.load(file)
 
     return cargo_toml["package"]["version"]