Automate show updates

Author: stephenyeargin

.gitignore

@@ -1,2 +1,5 @@
 .env
 _build/*
+
+# Not needed in repository
+settings.yml.backup.*

README.md

@@ -6,4 +6,27 @@
 
 ## Screenshots
 
-![screenshot](assets/screenshot.png)
+![screenshot](assets/screenshot.png)
+
+## Development
+
+### Updating Show Options
+
+The show options in `src/settings.yml` can be automatically updated using the included script:
+
+```bash
+./bin/update_shows
+```
+
+This script:
+1. Fetches the latest show data from `https://producerplayer.services.pbskids.org/show-tracking`
+2. Creates a backup of the current `settings.yml` file
+3. Updates the `pbs_kids_show_id` field options with the latest shows as key-value pairs (`title: slug`)
+4. Sorts shows alphabetically by title
+5. Saves the updated settings
+
+The script automatically creates a timestamped backup of the original settings file before making changes. Backups are stored in the same directory as the settings file with the format `settings.yml.backup.YYYYMMDD_HHMMSS`.
+
+**Requirements:**
+- Ruby (built-in libraries only)
+- Internet connection to fetch data from PBS Kids API

bin/README.md

@@ -0,0 +1,42 @@
+# PBS Kids Show Options Updater
+
+This script automatically updates the show options in `src/settings.yml` by fetching the latest show data from the PBS Kids API.
+
+## Usage
+
+From the project root directory:
+
+```bash
+./bin/update_shows
+```
+
+## What it does
+
+1. Fetches the latest show data from `https://producerplayer.services.pbskids.org/show-tracking`
+2. Creates a backup of the current `settings.yml` file
+3. Updates the `pbs_kids_show_id` field options with the latest shows
+4. Sorts shows alphabetically by title
+5. Saves the updated settings
+
+## Backup
+
+The script automatically creates a timestamped backup of the original settings file before making changes. Backups are stored in the same directory as the settings file with the format:
+
+```
+settings.yml.backup.YYYYMMDD_HHMMSS
+```
+
+## Dependencies
+
+- Ruby (built-in libraries only)
+- Internet connection to fetch data from PBS Kids API
+
+## Error Handling
+
+The script includes error handling for:
+- Network failures when fetching API data
+- JSON parsing errors
+- File I/O errors
+- Missing settings file or fields
+
+If any error occurs, the script will exit with an error message and will not modify the settings file.

bin/update_shows

@@ -0,0 +1,120 @@
+#!/usr/bin/env ruby
+
+require 'json'
+require 'net/http'
+require 'uri'
+require 'yaml'
+require 'fileutils'
+
+# Configuration
+API_URL = 'https://producerplayer.services.pbskids.org/show-tracking'
+SETTINGS_FILE = File.join(File.dirname(__FILE__), '..', 'src', 'settings.yml')
+
+def fetch_show_data
+  puts "Fetching show data from PBS Kids API..."
+  
+  uri = URI(API_URL)
+  response = Net::HTTP.get_response(uri)
+  
+  unless response.is_a?(Net::HTTPSuccess)
+    puts "Error: Failed to fetch data from API. Status: #{response.code}"
+    exit 1
+  end
+  
+  JSON.parse(response.body)
+rescue JSON::ParserError => e
+  puts "Error: Failed to parse JSON response - #{e.message}"
+  exit 1
+rescue StandardError => e
+  puts "Error: Failed to fetch data - #{e.message}"
+  exit 1
+end
+
+def load_settings
+  puts "Loading current settings..."
+  
+  unless File.exist?(SETTINGS_FILE)
+    puts "Error: Settings file not found at #{SETTINGS_FILE}"
+    exit 1
+  end
+  
+  YAML.load_file(SETTINGS_FILE)
+rescue StandardError => e
+  puts "Error: Failed to load settings file - #{e.message}"
+  exit 1
+end
+
+def format_show_options(shows)
+  puts "Formatting show options..."
+  
+  # Sort shows alphabetically by title
+  sorted_shows = shows.sort_by { |show| show['title'] }
+  
+  # Format as YAML array of hash entries
+  sorted_shows.map do |show|
+    { show['title'] => show['slug'] }
+  end
+end
+
+def update_settings(settings, new_options)
+  puts "Updating settings with new show options..."
+  
+  # Find the PBS Kids show field
+  pbs_kids_field = settings['custom_fields'].find { |field| field['keyname'] == 'pbs_kids_show_id' }
+  
+  unless pbs_kids_field
+    puts "Error: Could not find pbs_kids_show_id field in settings"
+    exit 1
+  end
+  
+  # Update the options
+  pbs_kids_field['options'] = new_options
+  
+  settings
+end
+
+def save_settings(settings)
+  puts "Saving updated settings..."
+  
+  # Create a backup
+  backup_file = "#{SETTINGS_FILE}.backup.#{Time.now.strftime('%Y%m%d_%H%M%S')}"
+  FileUtils.cp(SETTINGS_FILE, backup_file)
+  puts "Backup created: #{backup_file}"
+  
+  # Save the updated settings
+  File.open(SETTINGS_FILE, 'w') do |file|
+    file.write(settings.to_yaml)
+  end
+  
+  puts "Settings updated successfully!"
+rescue StandardError => e
+  puts "Error: Failed to save settings - #{e.message}"
+  exit 1
+end
+
+def main
+  puts "PBS Kids Show Options Updater"
+  puts "=============================="
+  
+  # Fetch latest show data
+  shows = fetch_show_data
+  puts "Found #{shows.length} shows"
+  
+  # Load current settings
+  settings = load_settings
+  
+  # Format new options
+  new_options = format_show_options(shows)
+  
+  # Update settings
+  updated_settings = update_settings(settings, new_options)
+  
+  # Save updated settings
+  save_settings(updated_settings)
+  
+  puts "Update completed successfully!"
+  puts "Updated #{new_options.length} show options"
+end
+
+# Run the script
+main if __FILE__ == $0

src/settings.yml

@@ -8,7 +8,7 @@ polling_url: |
   https://producerplayer.services.pbskids.org/show-list/?available=public&shows={{ pbs_kids_show_id }}&sort=-encored_on&type=full_length&page=1
   https://producerplayer.services.pbskids.org/show-tracking
 polling_headers: content-type=application/json
-polling_body: 
+polling_body:
 id: 110655
 custom_fields:
 - keyname: author_bio
@@ -27,9 +27,9 @@ custom_fields:
   - Alma's Way: almas-way
   - Arthur: arthur
   - Brambletown: brambletown
-  - Carl the Collector: carl-the-collector
   - 'CET Parents ': cet-parents
   - CET/ThinkTV Education: cetthinktv-education
+  - Carl the Collector: carl-the-collector
   - City Island: city-island
   - Clifford the Big Red Dog: clifford-big-red-dog
   - Clifford's Puppy Days: cliffords-puppy-days
@@ -42,12 +42,11 @@ custom_fields:
   - Donkey Hodie: donkey-hodie
   - Dot's Spot: dots-spot
   - Elinor Wonders Why: elinor-wonders-why
+  - FETCH! with Ruff Ruffman: fetch-with-ruff-ruffman
   - Family Math: family-math
   - Family Math en Español: family-math-en-espanol
-  - FETCH! with Ruff Ruffman: fetch-with-ruff-ruffman
   - Fizzy's Lunch Lab: fizzys-lunch-lab
   - Hero Elementary: hero-elementary
-  - 'iQ: smartparent': iq-smartparent
   - Jamming On the Job: jamming-on-the-job
   - Jelly, Ben & Pogo: jelly-ben-pogo
   - Keyshawn Solves It: keyshawn-solves-it
@@ -58,8 +57,8 @@ custom_fields:
   - Martha Speaks: martha-speaks
   - Maya & Miguel: maya-miguel
   - Mecha Builders: mecha-builders
-  - Mega Wow: mega-wow
   - Meet the Helpers: meet-helpers
+  - Mega Wow: mega-wow
   - Milo: milo
   - Mister Rogers' Neighborhood: mister-rogers
   - Molly of Denali: molly-of-denali
@@ -68,36 +67,38 @@ custom_fields:
   - Odd Squad: odd-squad
   - OddTube: odd-tube
   - Oh Noah!: oh-noah
-  - Parent Hacks: parent-hacks
-  - Parentalogic: parentalogic
-  - Parenting Minutes: parenting-minutes
   - PBS KIDS: pbs-kids
   - PBS KIDS Rocks!: pbs-kids-rocks
   - PBS KIDS Talk About: pbs-kids-talk-about
   - 'PBS KIDS: Activity Challenge': pbs-kids-activity-challenge
   - 'PBS KIDS: Get Moving': pbs-kids-get-moving
+  - PBS Western Reserve Educational Productions: western-reserve-public-media-educational-productions
+  - Parent Hacks: parent-hacks
+  - Parentalogic: parentalogic
+  - Parenting Minutes: parenting-minutes
   - Peg + Cat: peg
   - Phoebe & Jay: phoebe-jay
   - Pinkalicious & Peterrific: pinkalicious-and-peterrific
   - Plum Landing: plum-landing
   - Ready Jet Go: ready-jet-go
   - Rocket Saves the Day: rocket-saves-the-day
   - Rosie's Rules: rosies-rules
-  - Scribbles and Ink: scribbles-and-ink
+  - SUPER WHY!: super-why
   - SciGirls: scigirls
+  - Scribbles and Ink: scribbles-and-ink
   - Search It Up!: search-it-up
   - Sesame Street: sesame-street
   - Sid the Science Kid: sid-science-kid
   - Skillsville: skillsville
   - Splash and Bubbles: splash-and-bubbles
-  - SUPER WHY!: super-why
   - Super Why's Comic Book Adventures: super-whys-comic-book-adventures
   - The Cat in the Hat: cat-in-the-hat
   - The Not-Too-Late Show with Elmo: not-too-late-show-elmo
   - The Ruff Ruffman Show: ruff-ruffman-show
   - Through the Woods: through-woods
   - Tiny Time Travel: tiny-time-travel
   - Together We Can: together-we-can
+  - WOSU Specials: wosu-specials
   - Weather Hunters: weather-hunters
   - What Can You Become?: what-can-you-become
   - What's Good?: whats-good
@@ -106,8 +107,8 @@ custom_fields:
   - Word of the Week: word-of-the-week
   - WordGirl: wordgirl
   - Work It Out Wombats!: work-it-out-wombats
-  - WOSU Specials: wosu-specials
   - Xavier Riddle and the Secret Museum: xavier-riddle-and-secret-museum
   - You, Me, Community: you-me-community
+  - 'iQ: smartparent': iq-smartparent
 name: PBS Kids
 refresh_interval: 1440