# pplus-web — every command a person runs, in one place. # # pixi run [args] list them all: `pixi task list` # # The README's "Commands" table lists every task here; tests/tasks.test.mjs # keeps the two in step. Without pixi, `npm install && npm test` builds core # (core/, the pplus-core submodule) and the site, and tests the site, with # whatever node and python3 are on the PATH (that is what CI does); everything # else assumes the pinned environment below. Core's own commands are in # core/pixi.toml: `pixi run --manifest-path core/pixi.toml `. [workspace] authors = ["Alex Maldonado "] channels = ["https://conda.modular.com/max/", "conda-forge"] name = "pplus-web" platforms = ["linux-64", "osx-arm64"] version = "0.1.0" [dependencies] mojo = "==1.1.0" # for the Quarto views that run a page's Mojo on a real compiler (core/mojo/pin.json) nodejs = ">=26.10.0,<26.11" # building core and the site, and the tests python = ">=3.14.7,<3.15" # the dev server and the package script (standard library only) [tasks] # --- build and test the site ----------------------------------------------- install = { cmd = "npm install", inputs = ["package.json"], outputs = ["node_modules/.package-lock.json"], description = "Install TypeScript (the only npm dependency)" } core-build = { cmd = "npx tsc -p core/tsconfig.json", depends-on = ["install"], description = "Build pplus-core (core/, a git submodule) into core/dist/ with the site's TypeScript; the site imports it as #core/" } core-test = { cmd = "node --test tests/*.test.mjs", cwd = "core", depends-on = ["core-build"], description = "Run pplus-core's own tests (its gate is core's pixi run ci)" } build = { cmd = "npx tsc -p tsconfig.json", depends-on = ["install", "core-build"], description = "Build core, then compile src/ to dist/" } watch = { cmd = "npx tsc -p tsconfig.json --watch", depends-on = ["install", "core-build"], description = "Rebuild dist/ on every change (core is built once first)" } check = { cmd = "npx tsc -p tsconfig.json --noEmit", depends-on = ["install", "core-build"], description = "Type-check only" } dev = { cmd = "python -m http.server 4173", depends-on = ["build"], description = "Build, then serve the app on http://localhost:4173" } test = { cmd = "node --test tests/*.test.mjs", depends-on = ["build"], description = "Build, then run every test of the site" } check-pages = { cmd = "node scripts/check-pages.mjs {{ dir }}", args = ["dir"], depends-on = ["build"], description = "Run every program embedded in the Quarto pages under (quarto/README.md)" } # --- Quarto ------------------------------------------------------------------ quarto-export = { cmd = "node scripts/quarto-export.mjs {{ name }} {{ dir }}", args = ["name", "dir"], depends-on = ["build"], description = "Copy core/mojo/local/.mojo, its x86-64 and setup beside a Quarto page, and print the shortcode" } quarto-css = { cmd = "node scripts/quarto-css.mjs", depends-on = ["build"], description = "Regenerate the extension's generated files: pplus-views.css, pplus-hw.css, course/*.css and syntax/mojo.xml (from core)" } quarto-engine = { cmd = "node scripts/quarto-engine.mjs {{ dir }}", args = ["dir"], depends-on = ["build"], description = "Copy a built Programming+ (and core) into a site's _extensions/pplus/engine, for the rendered views (quarto/README.md)" } quarto-example = { cmd = "quarto render quarto", depends-on = ["build"], description = "Render the example site in quarto/example with every shortcode (needs Quarto on the PATH)" } # --- ship ------------------------------------------------------------------ ci = { depends-on = ["test"], description = "What CI runs: every test of the site, against the pinned core" } site = { cmd = "scripts/assemble.sh", depends-on = ["test"], description = "Test, then assemble site/ for publishing" } package = { cmd = "python scripts/package.py", description = "Zip the files git tracks (and new ones it does not ignore) into package/ for sharing" } deploy = { cmd = "scripts/deploy.sh {{ slug }} {{ target }}", args = [{ arg = "slug", default = "pplus" }, { arg = "target", default = "" }], depends-on = ["site"], description = "Publish site/ to /srv/www/, optionally on (user@host) over SSH (docs/deploy.md)" }