{"id":26120865,"url":"https://github.com/pyrmont/feedstock","last_synced_at":"2025-08-02T05:08:22.181Z","repository":{"id":35120337,"uuid":"209223526","full_name":"pyrmont/feedstock","owner":"pyrmont","description":"A Ruby library for data extraction that can be used to make RSS feeds from webpages","archived":false,"fork":false,"pushed_at":"2025-02-21T06:57:42.000Z","size":77,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-29T01:54:39.933Z","etag":null,"topics":["atom-feed","data-scraping","erb-template","rss-feed","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pyrmont.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-09-18T05:17:39.000Z","updated_at":"2025-02-21T06:45:50.000Z","dependencies_parsed_at":"2025-04-13T12:25:38.089Z","dependency_job_id":"4327d435-3317-4217-b58b-ad69d8031977","html_url":"https://github.com/pyrmont/feedstock","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/pyrmont/feedstock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrmont%2Ffeedstock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrmont%2Ffeedstock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrmont%2Ffeedstock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrmont%2Ffeedstock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pyrmont","download_url":"https://codeload.github.com/pyrmont/feedstock/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrmont%2Ffeedstock/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268338058,"owners_count":24234540,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atom-feed","data-scraping","erb-template","rss-feed","ruby"],"created_at":"2025-03-10T13:52:57.122Z","updated_at":"2025-08-02T05:08:22.148Z","avatar_url":"https://github.com/pyrmont.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Feedstock\n\n[![Gem Version][gem-badge]][gem-link]\n\n[gem-badge]: https://badge.fury.io/rb/feedstock.svg\n[gem-link]: https://rubygems.org/gems/feedstock\n\nFeedstock is a Ruby library for extracting information from an HTML/XML document\nand inserting it into an ERB template. Its primary purpose is to create a feed\nfor a webpage that doesn't offer one.\n\n## Rationale\n\nI love RSS feeds.\n\nThat's why I think it's a shame not every website has a feed. However, even when\na website does have a feed, sometimes it doesn't include quite the mix\ninformation that I want. I made Feedstock to solve those two problems.\n\nFeedstock is a Ruby library that you can use to create an Atom or RSS feed. It\nrequires a URL to a document and a hash of rules. The rules tell Feedstock how\nto extract and transform the data found on the webpage. That data is stuffed\ninto a hash and then run through an ERB template. Feedstock comes with a\ntemplate but you can use your own, too.\n\n## Example\n\nThe [feeds.inqk.net repository][example] includes an example of how the\nFeedstock library can be used in practice.\n\n[example]: https://github.com/pyrmont/feeds.inqk.net/\n\"An example of using the Feedstock library\"\n\n## Installation\n\nFeedstock is available as a gem:\n\n```shell\n$ gem install feedstock\n```\n\n## Usage\n\nFeedstock extracts information from a document at a given _URL_ using a\ncollection of _rules_. The feed is generated by calling `Feedstock.feed` as\nbelow:\n\n```ruby\n# Define the URL\nurl = \"https://example.org\"\n\n# Define the rules\nrules = { info: { id: url,\n                  title: Feedstock::Extract.new(selector: \"div.title\"),\n                  updated: Feedstock::Extract.new(selector: \"span.date\") },\n\n          entry: { id: Feedstock::Extract.new(selector: \"a\", content: { attribute: \"href\" }),\n                   title: Feedstock::Extract.new(selector: \"h2\"),\n                   updated: Feedstock::Extract.new(selector: \"span.date\"),\n                   author: Feedstock::Extract.new(selector: \"span.byline\"),\n                   link: Feedstock::Extract.new(selector: \"a\", content: { attribute: \"href\" }),\n                   summary: Feedstock::Extract.new(selector: \"div.summary\") },\n\n          entries: Feedstock::Extract.new(selector: \"div.story\") }\n\n# Using the default format and template\nFeedstock.feed url, rules\n\n# Using the XML format and a user-specified template\nFeedstock.feed url, rules, :xml, \"podcast.xml\"\n```\n\nMore information is available in [api.md].\n\n[api.md]: https://github.com/pyrmont/feedstock/blob/master/api.md\n\n## Bugs\n\nFound a bug? I'd love to know about it. The best way is to report it in the\n[Issues section][ghi] on GitHub.\n\n[ghi]: https://github.com/pyrmont/feedstock/issues\n\n## Versioning\n\nFeedstock uses [Semantic Versioning 2.0.0][sv2].\n\n[sv2]: http://semver.org/\n\n## Licence\n\nFeedstock is released into the public domain. See [LICENSE][] for more details.\n\n[LICENSE]: https://github.com/pyrmont/feedstock/blob/master/LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyrmont%2Ffeedstock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyrmont%2Ffeedstock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyrmont%2Ffeedstock/lists"}