Merge branch 'main' into docs/package-structure-code-intro-to-spanish

Author: RobPasMue

.all-contributorsrc

@@ -5,6 +5,7 @@
   "imageSize": 100,
   "commit": false,
   "commitConvention": "angular",
+  "contributorsSortAlphabetically": true,
   "contributors": [
     {
       "login": "eriknw",
@@ -96,7 +97,8 @@
       "profile": "https://jon-e.net",
       "contributions": [
         "code",
-        "design"
+        "design",
+        "ideas"
       ]
     },
     {
@@ -501,7 +503,8 @@
       "profile": "https://github.com/miguelalizo",
       "contributions": [
         "code",
-        "review"
+        "review",
+        "doc"
       ]
     },
     {
@@ -621,7 +624,8 @@
       "contributions": [
         "review",
         "code",
-        "translation"
+        "translation",
+        "doc"
       ]
     },
     {
@@ -688,7 +692,9 @@
       "profile": "http://robpasmue.github.io",
       "contributions": [
         "code",
-        "review"
+        "review",
+        "translation",
+        "ideas"
       ]
     },
     {
@@ -728,7 +734,8 @@
       "profile": "https://www.linkedin.com/in/ncclementi/",
       "contributions": [
         "code",
-        "review"
+        "review",
+        "translation"
       ]
     },
     {
@@ -748,7 +755,8 @@
       "profile": "https://github.com/Revathyvenugopal162",
       "contributions": [
         "code",
-        "review"
+        "review",
+        "doc"
       ]
     },
     {
@@ -758,8 +766,48 @@
       "profile": "https://github.com/tkoyama010",
       "contributions": [
         "code",
+        "review",
+        "doc",
+        "translation",
+        "ideas"
+      ]
+    },
+    {
+      "login": "willingc",
+      "name": "Carol Willing",
+      "avatar_url": "https://avatars.githubusercontent.com/u/2680980?v=4",
+      "profile": "https://hachyderm.io/web/@willingc",
+      "contributions": [
         "review"
       ]
+    },
+    {
+      "login": "kozo2",
+      "name": "Kozo Nishida",
+      "avatar_url": "https://avatars.githubusercontent.com/u/12192?v=4",
+      "profile": "https://github.com/kozo2",
+      "contributions": [
+        "review",
+        "translation"
+      ]
+    },
+    {
+      "login": "melissawm",
+      "name": "Melissa Weber Mendonça",
+      "avatar_url": "https://avatars.githubusercontent.com/u/3949932?v=4",
+      "profile": "http://melissawm.github.io",
+      "contributions": [
+        "question"
+      ]
+    },
+    {
+      "login": "OriolAbril",
+      "name": "Oriol Abril-Pla",
+      "avatar_url": "https://avatars.githubusercontent.com/u/23738400?v=4",
+      "profile": "http://oriolabrilpla.cat",
+      "contributions": [
+        "question"
+      ]
     }
   ],
   "contributorsPerLine": 7,

.github/workflows/build-book.yml

@@ -15,57 +15,57 @@ jobs:
   build-test-book:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+      - uses: actions/checkout@v4
 
-    - name: Setup Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.9'
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.9"
 
-    - name: Upgrade pip
-      run: |
-        # install pip=>20.1 to use "pip cache dir"
-        python3 -m pip install --upgrade pip
-    - name: Get pip cache dir
-      id: pip-cache
-      run: echo "::set-output name=dir::$(pip cache dir)"
+      - name: Upgrade pip
+        run: |
+          # install pip=>20.1 to use "pip cache dir"
+          python3 -m pip install --upgrade pip
+      - name: Get pip cache dir
+        id: pip-cache
+        run: echo "::set-output name=dir::$(pip cache dir)"
 
-    - name: Cache dependencies
-      uses: actions/cache@v4
-      with:
-        path: ${{ steps.pip-cache.outputs.dir }}
-        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
-        restore-keys: |
-          ${{ runner.os }}-pip-
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.pip-cache.outputs.dir }}
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
 
-    - name: Install dependencies
-      run: python3 -m pip install nox
+      - name: Install dependencies
+        run: python3 -m pip install nox
 
-    - name: Build book
-      run: nox -s docs-test
+      - name: Build book
+        run: nox -s docs-test
 
-    # Save html as artifact
-    - name: Save book html as artifact for viewing
-      uses: actions/upload-artifact@v4
-      with:
-        name: book-html
-        path: |
-          _build/html/
+      # Save html as artifact
+      - name: Save book html as artifact for viewing
+        uses: actions/upload-artifact@v4
+        with:
+          name: book-html
+          path: |
+            _build/html/
 
-    # Push the book's HTML to github-pages
-    - name: Push to GitHub Pages
-      # Only push if on main branch
-      if: github.ref == 'refs/heads/main'
-      uses: peaceiris/actions-gh-pages@v3.8.0
-      with:
-        github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: ./_build/html
+      # Push the book's HTML to github-pages
+      - name: Push to GitHub Pages
+        # Only push if on main branch
+        if: github.ref == 'refs/heads/main'
+        uses: peaceiris/actions-gh-pages@v3.8.0
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./_build/html
 
-    # Test for bad links and ensure alt tags for usability
-    - name: Check HTML using htmlproofer
-      uses: chabad360/htmlproofer@master
-      with:
-        directory: '_build/html'
-        arguments: |
-          --ignore-files "/.+\/_static\/.+/,/genindex.html/"
-          --ignore-status-codes "404, 403, 429, 503"
+      # Test for bad links and ensure alt tags for usability
+      - name: Check HTML using htmlproofer
+        uses: chabad360/htmlproofer@master
+        with:
+          directory: "_build/html"
+          arguments: |
+            --ignore-files "/.+\/_static\/.+/,/genindex.html/"
+            --ignore-status-codes "404, 403, 429, 503"

.pre-commit-config.yaml

@@ -12,7 +12,6 @@
 # - Register git hooks: pre-commit install --install-hooks
 
 repos:
-
   # Misc commit checks
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v4.6.0
@@ -28,23 +27,29 @@ repos:
   - repo: https://github.com/codespell-project/codespell
     rev: v2.3.0
     hooks:
-    - id: codespell
-      additional_dependencies:
-        - tomli
-      exclude: >
-        (?x)^(
-            (.*vale-styles.*)|(.*\.po)
-        )$
+      - id: codespell
+        additional_dependencies:
+          - tomli
+        exclude: >
+          (?x)^(
+              (.*vale-styles.*)|(.*\.po)
+          )$
 
   - repo: https://github.com/errata-ai/vale
-    rev: v3.7.0
+    rev: v3.7.1
+    hooks:
+      - id: vale
+
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: v3.3.3
     hooks:
-    - id: vale
+      - id: prettier
+        types_or: [yaml, html, css, scss, javascript, json, toml]
 
 ci:
-    autofix_prs: false
-    #skip: [flake8, end-of-file-fixer]
-    autofix_commit_msg: |
-        '[pre-commit.ci 🤖] Apply code format tools to PR'
-    # Update hook versions every month (so we don't get hit with weekly update pr's)
-    autoupdate_schedule: monthly
+  autofix_prs: false
+  #skip: [flake8, end-of-file-fixer]
+  autofix_commit_msg: |
+    '[pre-commit.ci 🤖] Apply code format tools to PR'
+  # Update hook versions every month (so we don't get hit with weekly update pr's)
+  autoupdate_schedule: monthly