feat: provide defaults for dynamic params (#254)

Closes #252

Author: gildesmarais

README.md

@@ -4,6 +4,26 @@
 
 This repository contains `html2rss` feed configurations for many websites.
 
+## Dynamic Parameters
+
+Configs must include a `parameters` section to define default values for dynamic parameters:
+
+```yaml
+parameters:
+  query:
+    type: string
+    default: "technology"
+  category:
+    type: string
+    default: "news"
+
+channel:
+  url: https://example.com/search?q=%<query>s&cat=%<category>s
+  # ... rest of config
+```
+
+The `type` field specifies the parameter type (currently only `string` is supported), and `default` provides the default value when no parameter is explicitly provided.
+
 ## Documentation
 
 - [Main Documentation](https://html2rss.github.io/html2rss-configs/)

lib/html2rss/configs/bbc.co.uk/available_episodes.yml

@@ -1,3 +1,8 @@
+parameters:
+  id:
+    type: string
+    default: "b006wkfp"
+
 channel:
   url: https://www.bbc.co.uk/programmes/%<id>s/episodes/player
   time_zone: UTC

lib/html2rss/configs/blog.mondediplo.net/feed.yml

@@ -1,3 +1,8 @@
+parameters:
+  blog:
+    type: string
+    default: "-Defense-en-ligne-"
+
 channel:
   url: https://blog.mondediplo.net/%<blog>s
   time_zone: Europe/Paris

lib/html2rss/configs/github.com/releases.yml

@@ -1,3 +1,11 @@
+parameters:
+  username:
+    type: string
+    default: "nuxt"
+  repository:
+    type: string
+    default: "nuxt.js"
+
 channel:
   url: https://github.com/%<username>s/%<repository>s/releases
   time_zone: UTC

lib/html2rss/configs/imdb.com/ratings.yml

@@ -1,3 +1,8 @@
+parameters:
+  user_id:
+    type: string
+    default: "ur7019649"
+
 channel:
   url: https://www.imdb.com/user/%<user_id>s/ratings
   time_zone: UTC

lib/html2rss/configs/spiegel.de/impressum_autor.yml

@@ -1,3 +1,8 @@
+parameters:
+  id:
+    type: string
+    default: "975b6ae0-0001-0003-0000-000000018282"
+
 channel:
   url: "https://www.spiegel.de/impressum/autor-%<id>s"
   time_zone: Europe/Berlin
@@ -13,7 +18,7 @@ selectors:
   url:
     selector: "section > a"
     extractor: "href"
-  descripton:
+  description:
     selector: ".leading-loose"
   published_at:
     selector: "footer"

spec/html2rss/configs/apnews.com/hub.yml_spec.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 RSpec.describe 'apnews.com/hub.yml' do
-  it_behaves_like 'config.yml', 'apnews.com/hub.yml', section: 'world-news'
+  it_behaves_like 'config.yml', 'apnews.com/hub.yml'
 end

spec/html2rss/configs/bbc.co.uk/available_episodes.yml_spec.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 RSpec.describe 'bbc.co.uk/available-episodes.yml' do
-  it_behaves_like 'config.yml', 'bbc.co.uk/available_episodes.yml', id: 'b006wkfp'
+  it_behaves_like 'config.yml', 'bbc.co.uk/available_episodes.yml'
 end

spec/html2rss/configs/blog.mondediplo.net/feed.yml_spec.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 RSpec.describe 'blog.mondediplo.net/feed.yml' do
-  it_behaves_like 'config.yml', 'blog.mondediplo.net/feed.yml', blog: '-Defense-en-ligne-'
+  it_behaves_like 'config.yml', 'blog.mondediplo.net/feed.yml'
 end

spec/html2rss/configs/cnet.com/section_sub.yml_spec.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 RSpec.describe 'cnet.com/section_sub.yml' do
-  it_behaves_like 'config.yml', 'cnet.com/section_sub.yml', section: 'culture', sub: 'internet'
+  it_behaves_like 'config.yml', 'cnet.com/section_sub.yml'
 end