Merge branch 'main' into feat/translation-graph-render

Author: RobPasMue

.all-contributorsrc

@@ -905,6 +905,16 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "chendaniely",
+      "name": "Daniel Chen",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5782147?v=4",
+      "profile": "http://chendaniely.github.io",
+      "contributions": [
+        "ideas",
+        "review"
+      ]
     }
   ],
   "contributorsPerLine": 7,

.circleci/config.yml

@@ -5,6 +5,12 @@ jobs:
       - image: cimg/python:3.13
     steps:
       - checkout
+      - run:
+          name: Restore mtimes from git history
+          command: |
+            sudo apt-get update
+            sudo apt-get install git-restore-mtime
+            git restore-mtime
       - run:
           name: setup environment
           command: |

.github/workflows/build-book.yml

@@ -16,6 +16,13 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch_depth: 0
+
+      - name: Restore mtimes from git history
+        run: |
+          sudo apt-get install git-restore-mtime
+          git restore-mtime
 
       - name: Setup Python
         uses: actions/setup-python@v5

README.md

@@ -33,15 +33,26 @@ class RSSItem:
     def from_meta(cls, page_name: str, meta: dict, app: "Sphinx") -> "RSSItem":
         """Create from a page's metadata"""
         url = urljoin(app.config.html_baseurl, app.builder.get_target_uri(page_name))
+
         # purposely don't use `get` here because we want to error if these fields are absent
         return RSSItem(
             title=meta[":og:title"],
             description=meta[":og:description"],
-            date=datetime.fromisoformat(meta["date"]),
+            date=cls.get_date_updated(page_name, meta, app),
             author=meta.get(":og:author", "pyOpenSci"),
             url=url,
         )
 
+    @staticmethod
+    def get_date_updated(page_name: str, meta: dict, app: "Sphinx") -> datetime:
+        """if the page has an explicit date_updated, use that, otherwise get mtime"""
+        if 'date_updated' in meta:
+            return datetime.fromisoformat(meta['date_updated'])
+        else:
+            page_path = app.srcdir / (page_name + ".md")
+            mtime = page_path.stat().st_mtime
+            return datetime.fromtimestamp(mtime)
+
     def render(self) -> str:
         return f"""\
 <item>
@@ -61,7 +72,7 @@ class RSSFeed:
     title: str = "pyOpenSci Tutorials"
     link: str = "https://www.pyopensci.org/python-package-guide/tutorials/intro.html"
     self_link: str = "https://www.pyopensci.org/python-package-guide/tutorials.rss"
-    description: str = "Tutorials for learning python i guess!!!"
+    description: str = "A tutorial feed that lists metadata for the pyOpenSci Python packaging tutorials so we can automatically list them on our website."
     language: str = "en"
 
     def render(self) -> str:

_ext/rss.py

@@ -1,7 +1,6 @@
 ---
 :og:description: Learn how to add a LICENSE and CODE_OF_CONDUCT file to your Python package. This lesson covers choosing a permissive license, placing key files for visibility on GitHub and PyPI, and adopting the Contributor Covenant to support an inclusive community.
 :og:title: Add a License and Code of Conduct to your python package
-date: 1970-01-02
 ---
 
 # Add a `LICENSE` & `CODE_OF_CONDUCT` to your Python package

tutorials/add-license-coc.md

@@ -1,7 +1,6 @@
 ---
 :og:description: Learn how to create a clear, effective README file for your Python package. This lesson covers what to include, why each section matters, and how a well-structured README improves usability and discoverability on GitHub and PyPI.
 :og:title: Add a README file to your Python package
-date: 1970-01-03
 ---
 
 # Add a README file to your Python package

tutorials/add-readme.md

@@ -1,7 +1,6 @@
 ---
 :og:description: Learn how to add a command-line interface (CLI) to your Python package using the argparse library. This lesson walks you through creating a CLI entry point so users can run your package directly from the terminal.
 :og:title: Command Line Reference Guide
-date: 1970-01-04
 ---
 
 # Command Line Reference Guide

tutorials/command-line-reference.md

@@ -1,7 +1,6 @@
 ---
 :og:description: Get started with Hatch, a modern Python packaging tool. This lesson introduces Hatch’s features and shows how it simplifies environment management, project scaffolding, and building your package.
 :og:title: Get to Know Hatch
-date: 1970-01-05
 ---
 
 # Get to Know Hatch

tutorials/get-to-know-hatch.md

@@ -1,7 +1,6 @@
 ---
 :og:description: Learn how to make your code installable as a Python package using Hatch. This lesson walks you through structuring your code and configuring pyproject.toml so others can easily install and use your package.
 :og:title: Make your Python code installable so it can be used across projects
-date: 1970-01-01
 ---
 
 # Make your Python code installable