swift-rss-standard

Type-safe RSS 2.0 feed type definitions for Swift with support for iTunes podcast extensions and Dublin Core metadata.

Overview

swift-rss-standard provides complete RSS 2.0 specification support with type-safe Swift types for representing RSS feed data structures. Includes dedicated support for podcast feeds via iTunes extensions and metadata enrichment through Dublin Core.

For RSS feed generation and parsing, see swift-rss.

Features

• Complete RSS 2.0 Support: All required and optional channel and item elements per RSS 2.0 specification
• iTunes Podcast Extensions: Full support for podcast-specific metadata (duration, episode type, season/episode numbers)
• Dublin Core Metadata: Rich metadata support for creators, subjects, publishers
• Type Safety: Compile-time validation with Hashable, Sendable, Codable conformance
• Validation: Failable initializers enforce RSS requirements (items require title OR description)
• Swift 6.0 Concurrency: Strict concurrency mode with complete Sendable conformance

Installation

Add swift-rss-standard to your Package.swift dependencies:

dependencies: [
    .package(url: "https://github.com/swift-web-standards/swift-rss-standard", from: "0.1.0")
]

Then add the products you need to your target dependencies:

.target(
    name: "YourTarget",
    dependencies: [
        .product(name: "RSS", package: "swift-rss-standard"),
        .product(name: "RSS iTunes", package: "swift-rss-standard"),  // Optional: for podcast feeds
        .product(name: "RSS Dublin Core", package: "swift-rss-standard")  // Optional: for metadata
    ]
)

Quick Start

import RSS_Standard

// Create a basic RSS feed model
let channel = RSS.Channel(
    title: "My Blog",
    link: URL(string: "https://example.com")!,
    description: "A blog about Swift development",
    language: "en-US",
    items: [
        try! RSS.Item(
            title: "First Post",
            description: "Hello, world!",
            link: URL(string: "https://example.com/post1")!,
            pubDate: Date()
        )
    ]
)

// Use the model with swift-rss for XML generation/parsing
// See: https://github.com/coenttb/swift-rss

Usage Examples

Podcast Feed with iTunes Extensions

import RSS_Standard
import RSS_Standard_iTunes

let channel = RSS.Channel(
    title: "My Podcast",
    link: URL(string: "https://example.com/podcast")!,
    description: "A podcast about technology",
    items: [
        try! RSS.Item(
            title: "Episode 1: Getting Started",
            description: "In this episode we discuss...",
            link: URL(string: "https://example.com/episode1")!,
            pubDate: Date()
        )
    ]
)

// Use with swift-rss for XML generation

Related Packages

• swift-rss: RSS feed generation and parsing using these types
• swift-rfc-4287: Type-safe Atom feed generation and parsing for Swift (RFC 4287 implementation)
• swift-json-feed: Type-safe JSON Feed generation and parsing for Swift
• swift-syndication: Unified syndication API supporting RSS, Atom, and JSON Feed with format conversion
• swift-rfc-2822: RFC 2822 date formatting for email and RSS dates

License

This project is licensed under the Apache License 2.0. See LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.