Merge branch 'master' into approx_population

.github/workflows/documentation.yml

@@ -26,73 +26,73 @@ jobs:
       contents: write
 
     steps:
-    - uses: actions/checkout@v3
-
-    - name: Set up Python 3.10
-      uses: actions/setup-python@v4
-      with:
-        python-version: "3.10"  # Interpolation.py doesn't support Python 3.11 [2023-07]
-        cache: 'pip'
-        cache-dependency-path: |
-          requirements/base.txt
-          requirements/doc.txt
-
-    - name: Install Pandoc
-      run: sudo apt-get install --yes pandoc
-
-    - name: Update pip
-      run: python -m pip install --upgrade pip
-
-    - name: Install HARK
-      run: python -m pip install .[doc]
-
-    - name: Run Sphinx
-      run: >
-        sphinx-build
-        -M html Documentation HARK-docs
-        -T
-        -W
-        -j auto
-
-    - name: Set up git for deployment
-      run: |
-        git config user.name "${{ github.actor }}"
-        git config user.email "${{ github.actor }}@users.noreply.github.com"
-        git config --local --unset-all http.https://github.com/.extraheader
-
-    - name: Commit all rendered HTML files
-      run: |
-        git switch --orphan gh-pages
-        git add --all HARK-docs/html
-        git commit -qm "Documentation from @ ${{ github.repository }}@${{ github.sha }}"
-
-    - name: Deploy to GitHub Pages
-      # Only deploy to Pages on pushes to HEAD
-      if: (github.repository_owner == 'Econ-ARK') && (github.event_name == 'push') && (github.ref_name == 'master')
-      run: >
-        git push
-        --force 
-        https://x-access-token:${{ github.token }}@github.com/${{ github.repository }}
-        `git subtree split --prefix HARK-docs/html gh-pages`:refs/heads/gh-pages
+      - uses: actions/checkout@v3
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.12"
+          cache: "pip"
+          cache-dependency-path: |
+            requirements/base.txt
+            requirements/doc.txt
+
+      - name: Install Pandoc
+        run: sudo apt-get install --yes pandoc
+
+      - name: Update pip
+        run: python -m pip install --upgrade pip
+
+      - name: Install HARK
+        run: python -m pip install .[doc]
+
+      - name: Run Sphinx
+        run: >
+          sphinx-build
+          -M html Documentation HARK-docs
+          -T
+          -W
+          -j 1
+
+      - name: Set up git for deployment
+        run: |
+          git config user.name "${{ github.actor }}"
+          git config user.email "${{ github.actor }}@users.noreply.github.com"
+          git config --local --unset-all http.https://github.com/.extraheader
+
+      - name: Commit all rendered HTML files
+        run: |
+          git switch --orphan gh-pages
+          git add --all HARK-docs/html
+          git commit -qm "Documentation from @ ${{ github.repository }}@${{ github.sha }}"
+
+      - name: Deploy to GitHub Pages
+        # Only deploy to Pages on pushes to HEAD
+        if: (github.repository_owner == 'Econ-ARK') && (github.event_name == 'push') && (github.ref_name == 'master')
+        run: >
+          git push
+          --force
+          https://x-access-token:${{ github.token }}@github.com/${{ github.repository }}
+          `git subtree split --prefix HARK-docs/html gh-pages`:refs/heads/gh-pages
 
   lint:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: 3
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install --upgrade sphinx-lint
-    - name: Lint documentation with sphinx-lint
-      run: >
-        sphinx-lint
-        --ignore Documentation/example_notebooks/GenIncProcessModel.py
-        --enable all
-        --max-line-length 85 
-        README.md
-        Documentation/
+      - uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install --upgrade sphinx-lint
+      - name: Lint documentation with sphinx-lint
+        run: >
+          sphinx-lint
+          --ignore Documentation/example_notebooks/GenIncProcessModel.py
+          --enable all
+          --max-line-length 85
+          README.md
+          Documentation/

.github/workflows/examples.yml

@@ -22,7 +22,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.8", "3.9", "3.10"]
+        python-version: ["3.10", "3.11", "3.12"]
     steps:
       - uses: actions/checkout@v3
       - name: Set up Python

.github/workflows/execute-notebooks.yml

@@ -5,7 +5,7 @@ on:
   workflow_dispatch:
   # 6.49 am (GMT) every Monday; time chosen at random
   schedule:
-  - cron: "49 6 * * MON"
+    - cron: "49 6 * * MON"
 
 # Limit workflow permissions
 permissions:
@@ -29,47 +29,47 @@ jobs:
       pull-requests: write
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python 3.10
-      uses: actions/setup-python@v4
-      with:
-        python-version: "3.10"  # Numba doesn't support Python 3.11 [2023-05]
-        cache: 'pip'
-        cache-dependency-path: |
-          requirements/base.txt
-          .github/workflows/execute-notebooks.yml
+      - uses: actions/checkout@v3
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.10" # Numba doesn't support Python 3.11 [2023-05]
+          cache: "pip"
+          cache-dependency-path: |
+            requirements/base.txt
+            .github/workflows/execute-notebooks.yml
 
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install .
-        # For LabeledModels.ipynb
-        python -m pip install estimagic
-        # For nbstripout
-        python -m pip install nbstripout
-        # For nb_exec.py
-        python -m pip install ipykernel nbclient nbformat
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install .
+          # For LabeledModels.ipynb
+          python -m pip install estimagic
+          # For nbstripout
+          python -m pip install nbstripout
+          # For nb_exec.py
+          python -m pip install ipykernel nbclient nbformat
 
-    - name: Strip output
-      run: nbstripout examples/**/*.ipynb
+      - name: Strip output
+        run: nbstripout examples/**/*.ipynb
 
-    # This step takes c. 20 minutes
-    - name: Execute notebooks
-      run: python tools/nb_exec.py examples/**/*.ipynb
-      env:
-        PYTHONUNBUFFERED: "1"
+      # This step takes c. 20 minutes
+      - name: Execute notebooks
+        run: python tools/nb_exec.py examples/**/*.ipynb
+        env:
+          PYTHONUNBUFFERED: "1"
 
-    - name: Open PR
-      uses: peter-evans/create-pull-request@v5
-      with:
-        author: "Econ-ARK Bot <noreply@econ-ark.org>"
-        branch: "bot/update-notebooks"
-        commit-message: "[bot] updated notebooks"
-        delete-branch: true
-        title: "[bot] Execute example notebooks"
-        # language=Markdown
-        body: >
-          This PR was [automatically generated] to re-execute
-          the example notebooks for use in the documentation.
-          
-          [automatically generated]: https://github.com/Econ-ARK/HARK/actions/workflows/execute-notebooks.yml
+      - name: Open PR
+        uses: peter-evans/create-pull-request@v5
+        with:
+          author: "Econ-ARK Bot <noreply@econ-ark.org>"
+          branch: "bot/update-notebooks"
+          commit-message: "[bot] updated notebooks"
+          delete-branch: true
+          title: "[bot] Execute example notebooks"
+          # language=Markdown
+          body: >
+            This PR was [automatically generated] to re-execute
+            the example notebooks for use in the documentation.
+
+            [automatically generated]: https://github.com/Econ-ARK/HARK/actions/workflows/execute-notebooks.yml

.github/workflows/hark.yml

@@ -21,7 +21,7 @@ jobs:
       max-parallel: 5
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: [3.8, 3.9, "3.10"]
+        python-version: ["3.10", "3.11", "3.12"]
 
     steps:
       - uses: actions/checkout@v3

.github/workflows/lint.yml

@@ -0,0 +1,27 @@
+name: pre-commit
+
+on: [push, pull_request]
+
+jobs:
+  format:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install packages
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install ".[dev]"
+          pip list
+
+      - name: Lint
+        run: pre-commit run --all-files --show-diff-on-failure --color always

.gitignore

@@ -289,3 +289,6 @@ settings.json
 .spyderproject
 spyproject
 .spyproject
+
+# 20240608: CDC added *private* to avoid accidentally uploading private material
+*private*