# horrabin/horrorss architecture

> Architecture diagram of the GitHub repository horrabin/horrorss, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/horrabin/horrorss
- Repository: https://github.com/horrabin/horrorss

## Overview

HORRORss is a Java library that reads local or remote RSS-family feeds and maps them into Java objects. Its principal workflow is source selection, XML parsing and format-specific extraction, then assembly of channel, image, and item data into an RssFeed. The README documents RSS 0.9x, RSS 1.0, RSS 2.0, Atom, and caching; the parser excerpt also shows pluggable module parsing and date parsing. The graph uses the README and source-index references for unsampled relationships; those sources do not establish every internal call or cache detail.

Main entry points: [`src/org/horrabin/horrorss/RssParser.java`](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssParser.java) (Feed parser), [`src/org/horrabin/horrorss/RssFeed.java`](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssFeed.java) (Feed result), [`src/org/horrabin/horrorss/modules/parsers/SimpleGeoModuleParser.java`](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/modules/parsers/SimpleGeoModuleParser.java) (GeoRSS parser), [`src/org/horrabin/horrorss/util/DefaultDateParser.java`](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/util/DefaultDateParser.java) (Default dates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Feed parsing"]
  node_parser["Feed parser<br/>[RssParser.java]"]
  node_cache[("Feed cache<br/>[RssParser.java]")]
end

subgraph group_models["Feed models"]
  node_feed["Feed result<br/>[RssFeed.java]"]
  node_channel["Channel model"]
  node_image["Image model<br/>[RssImageBean.java]"]
  node_item["Item model<br/>[RssItemBean.java]"]
end

subgraph group_extensions["Parsing extensions"]
  node_dateapi["Date parser API<br/>[DateParser.java]"]
  node_dates["Default dates"]
  node_moduleapi["Module parser API"]
  node_geo["GeoRSS parser"]
  node_geodata["Geo item data"]
end

node_user(("Library caller"))
node_local["Local feed"]
node_remote(("Remote feed"))

node_user -->|"configures and loads"| node_parser
node_local -->|"provides feed"| node_parser
node_remote -->|"provides feed"| node_parser
node_parser -.->|"uses caching"| node_cache
node_parser -->|"uses date parsing"| node_dateapi
node_dates -->|"implements"| node_dateapi
node_parser -->|"defaults to"| node_dates
node_parser -->|"dispatches extensions"| node_moduleapi
node_geo -->|"implements"| node_moduleapi
node_geo -->|"creates"| node_geodata
node_parser -->|"maps channel"| node_channel
node_parser -->|"maps image"| node_image
node_parser -->|"maps items"| node_item
node_parser -->|"returns feed"| node_feed
node_feed -->|"contains model"| node_channel
node_feed -->|"contains model"| node_image
node_feed -->|"contains list"| node_item
node_parser -->|"fetches over HTTP"| node_remote

click node_parser "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssParser.java"
click node_cache "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssParser.java"
click node_dateapi "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/util/DateParser.java"
click node_dates "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/util/DefaultDateParser.java"
click node_moduleapi "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssModuleParser.java"
click node_geo "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/modules/parsers/SimpleGeoModuleParser.java"
click node_geodata "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/modules/objects/SimpleGeoRssItemBean.java"
click node_feed "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssFeed.java"
click node_channel "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssChannelBean.java"
click node_image "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssImageBean.java"
click node_item "https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssItemBean.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_parser,node_cache toneBlue
class node_feed,node_channel,node_image,node_item toneAmber
class node_dateapi,node_dates,node_moduleapi,node_geo,node_geodata toneMint
class node_user,node_local,node_remote toneIndigo
```

## Components

### Feed parsing

- [Feed parser](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssParser.java): `src/org/horrabin/horrorss/RssParser.java`
- [Feed cache](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssParser.java): `src/org/horrabin/horrorss/RssParser.java`

### Feed models

- [Feed result](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssFeed.java): `src/org/horrabin/horrorss/RssFeed.java`
- [Channel model](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssChannelBean.java): `src/org/horrabin/horrorss/RssChannelBean.java`
- [Image model](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssImageBean.java): `src/org/horrabin/horrorss/RssImageBean.java`
- [Item model](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssItemBean.java): `src/org/horrabin/horrorss/RssItemBean.java`

### Parsing extensions

- [Date parser API](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/util/DateParser.java): `src/org/horrabin/horrorss/util/DateParser.java`
- [Default dates](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/util/DefaultDateParser.java): `src/org/horrabin/horrorss/util/DefaultDateParser.java`
- [Module parser API](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/RssModuleParser.java): `src/org/horrabin/horrorss/RssModuleParser.java`
- [GeoRSS parser](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/modules/parsers/SimpleGeoModuleParser.java): `src/org/horrabin/horrorss/modules/parsers/SimpleGeoModuleParser.java`
- [Geo item data](https://github.com/horrabin/horrorss/blob/master/src/org/horrabin/horrorss/modules/objects/SimpleGeoRssItemBean.java): `src/org/horrabin/horrorss/modules/objects/SimpleGeoRssItemBean.java`

### Other components

- **Library caller**
- **Local feed**
- **Remote feed**

## Connections

- Library caller → Feed parser: configures and loads (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Local feed → Feed parser: provides feed (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Remote feed → Feed parser: provides feed (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Feed parser → Feed cache: uses caching (evidence: `README.md`)
- Feed parser → Date parser API: uses date parsing (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Default dates → Date parser API: implements (evidence: `src/org/horrabin/horrorss/util/DefaultDateParser.java`)
- Feed parser → Default dates: defaults to (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Feed parser → Module parser API: dispatches extensions (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- GeoRSS parser → Module parser API: implements (evidence: `src/org/horrabin/horrorss/modules/parsers/SimpleGeoModuleParser.java`)
- GeoRSS parser → Geo item data: creates (evidence: `src/org/horrabin/horrorss/modules/parsers/SimpleGeoModuleParser.java`)
- Feed parser → Channel model: maps channel (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Feed parser → Image model: maps image (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Feed parser → Item model: maps items (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Feed parser → Feed result: returns feed (evidence: `src/org/horrabin/horrorss/RssParser.java`)
- Feed result → Channel model: contains model (evidence: `src/org/horrabin/horrorss/RssFeed.java`)
- Feed result → Image model: contains model (evidence: `src/org/horrabin/horrorss/RssFeed.java`)
- Feed result → Item model: contains list (evidence: `src/org/horrabin/horrorss/RssFeed.java`)
- Feed parser → Remote feed: fetches over HTTP (evidence: `src/org/horrabin/horrorss/RssParser.java`)
