https://github.com/thiagomajesk/gluttony

Compliant elixir RSS 2.0 and Atom 1.0 parser
https://github.com/thiagomajesk/gluttony

elixir feeds rss

Last synced: about 2 months ago
JSON representation

Compliant elixir RSS 2.0 and Atom 1.0 parser

• Host: GitHub
• URL: https://github.com/thiagomajesk/gluttony
• Owner: thiagomajesk
• License: agpl-3.0
• Created: 2022-03-13T14:56:33.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2024-08-01T12:16:29.000Z (5 months ago)
• Last Synced: 2024-10-30T16:55:40.343Z (2 months ago)
• Topics: elixir, feeds, rss
• Language: Elixir
• Homepage:
• Size: 1.6 MB
• Stars: 7
• Watchers: 1
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Gluttony

Compliant elixir RSS 2.0 and Atom 1.0 parser.

Ingests and parses RSS feeds and returns raw data that can be enriched by unfurling URLs.

## Installation

Add `gluttony` to the list of dependencies in `mix.exs`:

```elixir

def deps do

  [

    {:gluttony, "~> 0.2.0"}

  ]

end

```

## Documentation

Documentation can be found at .

## Benchmarks

Thanks to [`Saxy`](https://github.com/qcam/saxy), Gluttony is probably one of the fastest libraries to parse RSS feeds out there. That is, libraries that use pure Elixir of course (without low level NIFs). You can run the benchmark project or see previous results in the `/bench` folder.

> ⚠️ Notice that I'm currently using WSL2 to run the benchmarks, so the results may actually be more optimistic without the virtualization layer. I'm also currently only yielding half of the available resources from my machine to the VM.

The data I'm using to run the benchmarks is similar to what [`fast_rss`](https://github.com/avencera/fast_rss) (another RSS feed library that uses Rust for speed) is also using, so take a look on their benchmarks for some intersting comparissons.

### Metrics

In the worst cases, Gluttony was more memory efficient than the current slowest alternative by using `0.0246 GB` compared to [`feedraptor's`](https://github.com/merongivian/feedraptor) surprising `8.22 GB`. Not only this, but in some cases finishing parsing the whole RSS feed `424.26x` faster than the current worst alternative.

## TODOs

- Better document the available options

- Add typespecs to the common result interface (`Feed` / `Entry`)