tutorial RSS feeds

[sneakers-the-rat]

fix: #153

i saw something with allcaps PRIORITY! and was like "oh i know how to do that.

so i slightly modified the linked PEP example and just made it dataclasses so we know whats goin on yno.

I think in general treating first paragraphs of things as descriptions the same way i think dumping a bunch of PR titles in a document and calling it a changelog - it technically satisfies the thing you were trying to do, but it isn't all that useful for that purpose. So, two at once, freebie style, i figure if we define an opengraph title and description we can just use them in the feed.

You'll see a bunch of placeholder text in the tutorial item pages - that should be changed to be an actual description instead of placeholder text!

but ya anyway this builds an rss feed into /tutorials.rss that looks like this

expand/collapse rss

<?xml version='1.0' encoding='UTF-8'?>
<rss xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0">
  <channel>
    <title>PyOpenSci Tutorials</title>
    <link>https://www.pyopensci.org/python-package-guide/tutorials/intro.html</link>
    <atom:link href="https://www.pyopensci.org/python-package-guide/tutorials.rss" rel="self"/>
    <description>Tutorials for learning python i guess!!!</description>
    <language>en</language>
    <lastBuildDate>Mon, 12 May 2025 18:15:41 GMT</lastBuildDate>
<item>
  <title>Using Hatch to Migrate setup.py to a pyproject.toml</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/setup-py-to-pyproject-toml.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/setup-py-to-pyproject-toml.html</guid>
  <pubDate>Fri, 09 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Make your Python package PyPI ready - pyproject.toml</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/pyproject-toml.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/pyproject-toml.html</guid>
  <pubDate>Thu, 08 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Publish your Python package to PyPI</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/publish-pypi.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/publish-pypi.html</guid>
  <pubDate>Wed, 07 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Publish your Python package that is on PyPI to conda-forge</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/publish-conda-forge.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/publish-conda-forge.html</guid>
  <pubDate>Tue, 06 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Get to Know Hatch</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/get-to-know-hatch.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/get-to-know-hatch.html</guid>
  <pubDate>Mon, 05 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Python packaging 101</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/intro.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/intro.html</guid>
  <pubDate>Mon, 05 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Command Line Reference Guide</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/command-line-reference.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/command-line-reference.html</guid>
  <pubDate>Sun, 04 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Add a README file to your Python package</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/add-readme.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/add-readme.html</guid>
  <pubDate>Sat, 03 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Add a License and Code of Conduct to your python package</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/add-license-coc.html</link>
  <description>Placeholder text!!!!</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/add-license-coc.html</guid>
  <pubDate>Fri, 02 Jan 1970 00:00:00 GMT</pubDate>
</item>
<item>
  <title>Make your Python code installable so it can be used across projects</title>
  <link>https://www.pyopensci.org/python-package-guide/tutorials/installable-code.html</link>
  <description>Learn how to make your Python code installable so you can use it across projects.</description>
  <author>PyOpenSci</author>
  <guid isPermaLink="true">https://www.pyopensci.org/python-package-guide/tutorials/installable-code.html</guid>
  <pubDate>Thu, 01 Jan 1970 00:00:00 GMT</pubDate>
</item>
  </channel>
</rss>

---

• To see the specific tasks where the Asana app for GitHub is being used, see below:
  • https://app.asana.com/0/0/1210402311156824

[sneakers-the-rat]

literally what

[sneakers-the-rat]

I turned off pre-commit because i find it very annoying and the output here is not giving me enough information to know what to do. not a fan of pre-commit!

[lwasser]

I turned off pre-commit because i find it very annoying and the output here is not giving me enough information to know what to do. not a fan of pre-commit!

@sneakers-the-rat thank you so so much!! I know so many people who dislike pre-commit. I love it for the pre-commit CI bot, which is useful for contributors who don't want to install or mess with pre-commit and linting in their dev environments. I totally get the challenge of troubleshooting bugs.

Thank you for doing this. It will save me so much time trying to manually update our learning resources page. I will test it out and also help fill in the missing descriptions, dates, and other details in the original headers. 🎉

[lwasser]

This works great locally! let's merge!

[lwasser]

Suggested change

	author=meta.get(":og:author", "PyOpenSci"),
	author=meta.get(":og:author", "pyOpenSci"),

[lwasser]

Ok the point of failures here are link related error code 200's (hashes that it can't find). We are ok to go ahead and merge.

[lwasser]

@sneakers-the-rat thank you again for this!!!