GitHub Action to manually rebuild and publish documentation (#977)

* Expression profiling (legacy mode) (#936)

* expression profiling

* two reports

* make simple report sortable

* change default to grid

* configurable expression_profile_cutoff

* works with MP

* documentation

* expression_profile_style

* performance_log can be bool

* fix for pandas 2

* test expr profiling

* test expression profiling on mtc and semcog examples

* set encoding to utf8 because windows

* add missing import

* add warning about path length in error message

* oops, .log not .csv

* add timestamping to expression profile logs

* fix file naming, update tests

* all subprocesses to same timestamp

* add note in docs about runtime cost

* manual rebuild of docs

* add permissions

Author: jpn--

.github/workflows/rebuild-docs.yml

@@ -0,0 +1,51 @@
+name: Rebuild Docs
+on:
+    workflow_dispatch:
+        inputs:
+            commit:
+                description: 'Commit SHA or branch/tag to build docs from'
+                required: true
+                type: string
+            version:
+                description: 'Version number to publish docs as'
+                required: true
+                type: string
+
+jobs:
+    docbuild:
+        name: ubuntu-latest py3.9
+        runs-on: ubuntu-latest
+        permissions:
+            contents: write
+        defaults:
+            run:
+                shell: bash -l {0}
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  ref: ${{ github.event.inputs.commit }}
+            - name: Install uv
+              uses: astral-sh/setup-uv@v5
+              with:
+                  version: "0.7.12"
+                  enable-cache: true
+                  cache-dependency-glob: "uv.lock"
+            - name: "Set up Python"
+              uses: actions/setup-python@v5
+              with:
+                  python-version-file: ".python-version"
+            - name: Install activitysim
+              run: |
+                  uv sync --locked --dev
+            - name: Build the docs
+              run: |
+                  cd docs
+                  make clean
+                  make html
+            - name: Push to GitHub Pages
+              uses: peaceiris/[email protected]
+              with:
+                  github_token: ${{ secrets.GITHUB_TOKEN }}
+                  # Token is created automatically by Github Actions, no other config needed
+                  publish_dir: ./docs/_build/html
+                  destination_dir: ${{ github.event.inputs.version }}