Files
StarPunk/starpunk/feeds/opml.py
T
PhilandClaude Opus 5.5 75946be7b2 maint: Dependency upgrades and High backlog items (v2.11.0)
- All dependencies to current releases (97 known vulnerabilities -> 0),
  Python 3.14, uv pinned, requirements-test.txt, lxml/dateutil pinned
- CSRF tokens on admin forms, logout and IndieAuth consent
- IndieAuth client and crosspost link-card fetches via safe_get
- FLASK_DEBUG/FLASK_ENV default off/production; image sets them
- Foreign keys enforced on pooled connections; migration 018 removes orphans
- Rate limits shared across processes (rate_limits, migration 019)
- datetime.utcnow() and sqlite3 default adapters replaced
- compose.yaml fixed; duplicate dev_auth.py and test.ini removed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-03 13:09:52 -07:00

79 lines
2.5 KiB
Python

"""
OPML 2.0 feed list generation for StarPunk
Generates OPML 2.0 subscription lists that include all available feed formats
(RSS, ATOM, JSON Feed). OPML files allow feed readers to easily subscribe to
all feeds from a site.
Per v1.1.2 Phase 3:
- OPML 2.0 compliant
- Lists all three feed formats
- Public access (no authentication required per CQ8)
- Includes feed discovery link
Specification: http://opml.org/spec2.opml
"""
from datetime import datetime, timezone
from xml.sax.saxutils import escape
def generate_opml(site_url: str, site_name: str) -> str:
"""
Generate OPML 2.0 feed subscription list.
Creates an OPML document listing all available feed formats for the site.
Feed readers can import this file to subscribe to all feeds at once.
Args:
site_url: Base URL of the site (e.g., "https://example.com")
site_name: Name of the site (e.g., "My Blog")
Returns:
OPML 2.0 XML document as string
Example:
>>> opml = generate_opml("https://example.com", "My Blog")
>>> print(opml[:38])
<?xml version="1.0" encoding="UTF-8"?>
OPML Structure:
- version: 2.0
- head: Contains title and creation date
- body: Contains outline elements for each feed format
- outline attributes:
- type: "rss" (used for all syndication formats)
- text: Human-readable feed description
- xmlUrl: URL to the feed
Standards:
- OPML 2.0: http://opml.org/spec2.opml
- RSS type used for all formats (standard convention)
"""
# Ensure site_url doesn't have trailing slash
site_url = site_url.rstrip('/')
# Escape XML special characters in site name
safe_site_name = escape(site_name)
# RFC 822 date format (required by OPML spec)
creation_date = datetime.now(timezone.utc).replace(tzinfo=None).strftime('%a, %d %b %Y %H:%M:%S GMT')
# Build OPML document
opml_lines = [
'<?xml version="1.0" encoding="UTF-8"?>',
'<opml version="2.0">',
' <head>',
f' <title>{safe_site_name} Feeds</title>',
f' <dateCreated>{creation_date}</dateCreated>',
' </head>',
' <body>',
f' <outline type="rss" text="{safe_site_name} - RSS" xmlUrl="{site_url}/feed.rss"/>',
f' <outline type="rss" text="{safe_site_name} - ATOM" xmlUrl="{site_url}/feed.atom"/>',
f' <outline type="rss" text="{safe_site_name} - JSON Feed" xmlUrl="{site_url}/feed.json"/>',
' </body>',
'</opml>',
]
return '\n'.join(opml_lines)