run_ical 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 011dd6fbda180b144d3293c51cec404af07518f6ddc059b1ce36fe3d35a63436
-  data.tar.gz: f8f78bebb340cf8d8d70953689187a640370031f8e47eaef4457ffad6c619e6d
+  metadata.gz: d5ca004077cbcc81dfe3584debff9c157b21fb439521950aa28cc6739c07d520
+  data.tar.gz: 39406a1d9aa8720c62cc6df951746d569a12cc8efac6585c382d2413582d0ebb
 SHA512:
-  metadata.gz: db8c4844e30abe1aca9220e918b40bdda82983d2e5cafa118f919c16d71acfb2aec293ddca05580af2cc4a35f409e41ec41b303f7c7ad2a5a6daed3b53334345
-  data.tar.gz: 2a84b004dd7987b3c88981698e20c5d4ae9c58c97fc30992ee7a33b4929b640b0a38e137f68493464bb03867d99d54c6fa15abde9364139d672089e20d61c6b7
+  metadata.gz: a7d516478167324349a6bccfea5d59a1e28098a581d510c0d5672571639858cc14be7c74a16439fc1bff685fc07616e7b2c3f4ef43ecdde162a6f430c7268ad7
+  data.tar.gz: 57a76a19c909f40af17cc1bc3286a669075ede76c27dcc7170f269c6b68d0302b0ac566d1ca3922d941e2343822ec2bacd778dc39a3d6ad01b150bd9aeba30bb

data/README.md

@@ -50,6 +50,22 @@ program always lands on race day.
 
 `MarathonBostonBound` ends on a Monday (Patriots' Day); every other program ends on a Sunday.
 
+### Listing programs
+
+`RunIcal::Data.constants` returns programs in load order, which is alphabetical by
+filename and puts every Advanced plan ahead of every Novice one. To present them to
+users, use the ordered helpers instead — distance ascending, then difficulty:
+
+```ruby
+RunIcal::Data.programs        # => [Novice5K, Intermediate5K, Advanced5K, Walkers5K, Novice8K, ...]
+RunIcal::Data.by_distance     # => { "5-K" => [...], "8-K" => [...], ..., "Marathon" => [...] }
+RunIcal::Data.find("Novice5K")
+```
+
+Each program exposes `DISTANCE`, `LEVEL`, `POSITION` and `DESCRIPTION`
+(`"<DISTANCE> - <LEVEL>"`). Display order is the order of `tasks/higdon_programs.yml`
+— reorder there and re-run the refresh to change it.
+
 ## Development
 
 ### Refreshing the training data

data/lib/run_ical/data/advanced_10_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Advanced10K
-      DESCRIPTION = "10-K - Advanced"
+      DISTANCE = "10-K"
+      LEVEL = "Advanced"
+      POSITION = 9
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'advanced_10_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/advanced_15_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Advanced15K
-      DESCRIPTION = "15-K - Advanced"
+      DISTANCE = "15-K"
+      LEVEL = "Advanced"
+      POSITION = 13
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'advanced_15_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/advanced_5_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Advanced5K
-      DESCRIPTION = "5-K : Advanced"
+      DISTANCE = "5-K"
+      LEVEL = "Advanced"
+      POSITION = 2
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'advanced_5_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/advanced_8_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Advanced8K
-      DESCRIPTION = "8-K - Advanced"
+      DISTANCE = "8-K"
+      LEVEL = "Advanced"
+      POSITION = 6
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'advanced_8_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/half_marathon_advanced.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class HalfMarathonAdvanced
-      DESCRIPTION = "Half Marathon - Advanced"
+      DISTANCE = "Half Marathon"
+      LEVEL = "Advanced"
+      POSITION = 18
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'half_marathon_advanced.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/half_marathon_hm3.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class HalfMarathonHM3
-      DESCRIPTION = "Half Marathon - HM3"
+      DISTANCE = "Half Marathon"
+      LEVEL = "HM3"
+      POSITION = 19
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'half_marathon_hm3.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/half_marathon_intermediate1.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class HalfMarathonIntermediate1
-      DESCRIPTION = "Half Marathon - Intermediate 1"
+      DISTANCE = "Half Marathon"
+      LEVEL = "Intermediate 1"
+      POSITION = 16
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'half_marathon_intermediate1.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/half_marathon_intermediate2.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class HalfMarathonIntermediate2
-      DESCRIPTION = "Half Marathon - Intermediate 2"
+      DISTANCE = "Half Marathon"
+      LEVEL = "Intermediate 2"
+      POSITION = 17
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'half_marathon_intermediate2.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/half_marathon_novice1.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class HalfMarathonNovice1
-      DESCRIPTION = "Half Marathon - Novice 1"
+      DISTANCE = "Half Marathon"
+      LEVEL = "Novice 1"
+      POSITION = 14
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'half_marathon_novice1.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/half_marathon_novice2.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class HalfMarathonNovice2
-      DESCRIPTION = "Half Marathon - Novice 2"
+      DISTANCE = "Half Marathon"
+      LEVEL = "Novice 2"
+      POSITION = 15
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'half_marathon_novice2.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/half_marathon_walkers.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class HalfMarathonWalkers
-      DESCRIPTION = "Half Marathon - Walkers"
+      DISTANCE = "Half Marathon"
+      LEVEL = "Walkers"
+      POSITION = 20
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'half_marathon_walkers.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/intermediate_10_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Intermediate10K
-      DESCRIPTION = "10-K - Intermediate"
+      DISTANCE = "10-K"
+      LEVEL = "Intermediate"
+      POSITION = 8
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'intermediate_10_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/intermediate_15_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Intermediate15K
-      DESCRIPTION = "15-K - Intermediate"
+      DISTANCE = "15-K"
+      LEVEL = "Intermediate"
+      POSITION = 12
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'intermediate_15_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/intermediate_5_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Intermediate5K
-      DESCRIPTION = "5-K : Intermediate"
+      DISTANCE = "5-K"
+      LEVEL = "Intermediate"
+      POSITION = 1
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'intermediate_5_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/intermediate_8_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Intermediate8K
-      DESCRIPTION = "8-K - Intermediate"
+      DISTANCE = "8-K"
+      LEVEL = "Intermediate"
+      POSITION = 5
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'intermediate_8_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_3.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Marathon3
-      DESCRIPTION = "Marathon : Marathon 3"
+      DISTANCE = "Marathon"
+      LEVEL = "Marathon 3"
+      POSITION = 30
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_3.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_advanced1.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonAdvanced1
-      DESCRIPTION = "Marathon : Advanced 1"
+      DISTANCE = "Marathon"
+      LEVEL = "Advanced 1"
+      POSITION = 25
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_advanced1.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_advanced2.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonAdvanced2
-      DESCRIPTION = "Marathon : Advanced 2"
+      DISTANCE = "Marathon"
+      LEVEL = "Advanced 2"
+      POSITION = 26
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_advanced2.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_boston_bound.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonBostonBound
-      DESCRIPTION = "Marathon : Boston Bound"
+      DISTANCE = "Marathon"
+      LEVEL = "Boston Bound"
+      POSITION = 32
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_boston_bound.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_dopey_challenge.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonDopeyChallenge
-      DESCRIPTION = "Marathon : Dopey Challenge"
+      DISTANCE = "Marathon"
+      LEVEL = "Dopey Challenge"
+      POSITION = 31
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_dopey_challenge.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_intermediate1.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonIntermediate1
-      DESCRIPTION = "Marathon : Intermediate 1"
+      DISTANCE = "Marathon"
+      LEVEL = "Intermediate 1"
+      POSITION = 23
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_intermediate1.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_intermediate2.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonIntermediate2
-      DESCRIPTION = "Marathon : Intermediate 2"
+      DISTANCE = "Marathon"
+      LEVEL = "Intermediate 2"
+      POSITION = 24
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_intermediate2.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_novice1.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonNovice1
-      DESCRIPTION = "Marathon : Novice 1"
+      DISTANCE = "Marathon"
+      LEVEL = "Novice 1"
+      POSITION = 21
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_novice1.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_novice2.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonNovice2
-      DESCRIPTION = "Marathon : Novice 2"
+      DISTANCE = "Marathon"
+      LEVEL = "Novice 2"
+      POSITION = 22
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_novice2.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_novice_supreme.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonNoviceSupreme
-      DESCRIPTION = "Marathon : Novice Supreme"
+      DISTANCE = "Marathon"
+      LEVEL = "Novice Supreme"
+      POSITION = 27
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_novice_supreme.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_personal_best.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonPersonalBest
-      DESCRIPTION = "Marathon : Personal Best"
+      DISTANCE = "Marathon"
+      LEVEL = "Personal Best"
+      POSITION = 28
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_personal_best.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/marathon_senior.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class MarathonSenior
-      DESCRIPTION = "Marathon : Senior"
+      DISTANCE = "Marathon"
+      LEVEL = "Senior"
+      POSITION = 29
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'marathon_senior.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/novice_10_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Novice10K
-      DESCRIPTION = "10-K - Novice"
+      DISTANCE = "10-K"
+      LEVEL = "Novice"
+      POSITION = 7
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'novice_10_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/novice_15_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Novice15K
-      DESCRIPTION = "15-K - Novice"
+      DISTANCE = "15-K"
+      LEVEL = "Novice"
+      POSITION = 11
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'novice_15_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/novice_5_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Novice5K
-      DESCRIPTION = "5-K : Novice"
+      DISTANCE = "5-K"
+      LEVEL = "Novice"
+      POSITION = 0
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'novice_5_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/novice_8_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Novice8K
-      DESCRIPTION = "8-K - Novice"
+      DISTANCE = "8-K"
+      LEVEL = "Novice"
+      POSITION = 4
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'novice_8_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/walkers_5_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Walkers5K
-      DESCRIPTION = "5-K - Walkers"
+      DISTANCE = "5-K"
+      LEVEL = "Walkers"
+      POSITION = 3
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'walkers_5_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data/walking_10_k.rb

@@ -1,7 +1,10 @@
 module RunIcal
   module Data
     class Walking10K
-      DESCRIPTION = "10-K - Walking"
+      DISTANCE = "10-K"
+      LEVEL = "Walkers"
+      POSITION = 10
+      DESCRIPTION = "#{DISTANCE} - #{LEVEL}"
       DATA = YAML.safe_load_file(File.join(__dir__, 'walking_10_k.yaml'), symbolize_names: true)
     end
   end

data/lib/run_ical/data.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module RunIcal
+  # Namespace for the training plans in lib/run_ical/data.
+  #
+  # `constants` returns them in load order, which is alphabetical by filename and
+  # puts every Advanced plan before every Novice one. These helpers present them
+  # the way a runner would expect: by distance ascending, then by difficulty.
+  module Data
+    class << self
+      # Every program class, ordered for display.
+      def programs
+        constants.map { |name| const_get(name) }.sort_by { |program| program::POSITION }
+      end
+
+      # Programs grouped by distance, both groups and members in display order.
+      # Suitable for rendering <optgroup>s.
+      #
+      #   RunIcal::Data.by_distance["5-K"].map(&:DESCRIPTION)
+      #   #=> ["5-K - Novice", "5-K - Intermediate", ...]
+      def by_distance
+        programs.group_by { |program| program::DISTANCE }
+      end
+
+      # Look up a program class by its name, or nil.
+      def find(name)
+        return nil unless constants.include?(name.to_sym)
+
+        const_get(name.to_sym)
+      end
+    end
+  end
+end

data/lib/run_ical/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RunIcal
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

data/lib/run_ical.rb

@@ -3,6 +3,7 @@
 require "run_ical/version"
 require "yaml"
 require "base64"
+require "run_ical/data"
 Dir[File.expand_path("run_ical/data/*.rb", __dir__)].each do |file|
   require file
 end

data/tasks/higdon_programs.yml

@@ -1,179 +1,211 @@
 # Source manifest for `rake data:refresh`.
 #
-# One entry per training program. `class` is the public API name passed to
-# RunIcal::Generator.generate(program:) -- never rename an existing one.
+# One entry per training program, in the order they should be presented to users:
+# by distance ascending, then by difficulty. `rake data:refresh` emits POSITION
+# from this order, so reordering here reorders RunIcal::Data.programs.
+#
+# `class` is the public API name passed to RunIcal::Generator.generate(program:)
+# -- never rename an existing one. DESCRIPTION is derived as "<distance> - <level>".
 # `weeks` is asserted against the scraped table so a silent site change fails loudly.
 ---
 - class: Novice5K
   file: novice_5_k
-  description: "5-K : Novice"
+  distance: "5-K"
+  level: "Novice"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/5k-training/novice-5k/
 - class: Intermediate5K
   file: intermediate_5_k
-  description: "5-K : Intermediate"
+  distance: "5-K"
+  level: "Intermediate"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/5k-training/intermediate-5k/
 - class: Advanced5K
   file: advanced_5_k
-  description: "5-K : Advanced"
+  distance: "5-K"
+  level: "Advanced"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/5k-training/advanced-5k/
 - class: Walkers5K
   file: walkers_5_k
-  description: "5-K - Walkers"
+  distance: "5-K"
+  level: "Walkers"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/5k-training/walkers-5k/
-
 - class: Novice8K
   file: novice_8_k
-  description: "8-K - Novice"
+  distance: "8-K"
+  level: "Novice"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/8k-training/novice-8k/
 - class: Intermediate8K
   file: intermediate_8_k
-  description: "8-K - Intermediate"
+  distance: "8-K"
+  level: "Intermediate"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/8k-training/intermediate-8k/
 - class: Advanced8K
   file: advanced_8_k
-  description: "8-K - Advanced"
+  distance: "8-K"
+  level: "Advanced"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/8k-training/advanced-8k/
-
 - class: Novice10K
   file: novice_10_k
-  description: "10-K - Novice"
+  distance: "10-K"
+  level: "Novice"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/10k-training/novice-10k/
 - class: Intermediate10K
   file: intermediate_10_k
-  description: "10-K - Intermediate"
+  distance: "10-K"
+  level: "Intermediate"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/10k-training/intermediate-10k/
 - class: Advanced10K
   file: advanced_10_k
-  description: "10-K - Advanced"
+  distance: "10-K"
+  level: "Advanced"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/10k-training/advanced-10k/
 - class: Walking10K
   file: walking_10_k
-  description: "10-K - Walking"
+  distance: "10-K"
+  level: "Walkers"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/10k-training/walkers-10k/
-
 - class: Novice15K
   file: novice_15_k
-  description: "15-K - Novice"
+  distance: "15-K"
+  level: "Novice"
   weeks: 10
   url: https://www.halhigdon.com/training-programs/15k-10-mile-training/novice-15k-10-mile/
 - class: Intermediate15K
   file: intermediate_15_k
-  description: "15-K - Intermediate"
+  distance: "15-K"
+  level: "Intermediate"
   weeks: 10
   url: https://www.halhigdon.com/training-programs/15k-10-mile-training/intermediate-15k-10-mile/
 - class: Advanced15K
   file: advanced_15_k
-  description: "15-K - Advanced"
+  distance: "15-K"
+  level: "Advanced"
   weeks: 10
   url: https://www.halhigdon.com/training-programs/15k-10-mile-training/advanced-15k-10-mile/
-
 - class: HalfMarathonNovice1
   file: half_marathon_novice1
-  description: "Half Marathon - Novice 1"
+  distance: "Half Marathon"
+  level: "Novice 1"
   weeks: 12
   url: https://www.halhigdon.com/training-programs/half-marathon-training/novice-1-half-marathon/
 - class: HalfMarathonNovice2
   file: half_marathon_novice2
-  description: "Half Marathon - Novice 2"
+  distance: "Half Marathon"
+  level: "Novice 2"
   weeks: 12
   url: https://www.halhigdon.com/training-programs/half-marathon-training/novice-2-half-marathon/
 - class: HalfMarathonIntermediate1
   file: half_marathon_intermediate1
-  description: "Half Marathon - Intermediate 1"
+  distance: "Half Marathon"
+  level: "Intermediate 1"
   weeks: 12
   url: https://www.halhigdon.com/training-programs/half-marathon-training/intermediate-1-half-marathon/
 - class: HalfMarathonIntermediate2
   file: half_marathon_intermediate2
-  description: "Half Marathon - Intermediate 2"
+  distance: "Half Marathon"
+  level: "Intermediate 2"
   weeks: 12
   url: https://www.halhigdon.com/training-programs/half-marathon-training/intermediate-2-half-marathon/
 - class: HalfMarathonAdvanced
   file: half_marathon_advanced
-  description: "Half Marathon - Advanced"
+  distance: "Half Marathon"
+  level: "Advanced"
   weeks: 12
   url: https://www.halhigdon.com/training-programs/half-marathon-training/advanced-half-marathon/
 - class: HalfMarathonHM3
   file: half_marathon_hm3
-  description: "Half Marathon - HM3"
+  distance: "Half Marathon"
+  level: "HM3"
   weeks: 12
   url: https://www.halhigdon.com/training-programs/half-marathon-training/half-marathon-3/
 - class: HalfMarathonWalkers
   file: half_marathon_walkers
-  description: "Half Marathon - Walkers"
+  distance: "Half Marathon"
+  level: "Walkers"
   weeks: 12
   url: https://www.halhigdon.com/training-programs/half-marathon-training/walkers-half-marathon/
-
 - class: MarathonNovice1
   file: marathon_novice1
-  description: "Marathon : Novice 1"
+  distance: "Marathon"
+  level: "Novice 1"
   weeks: 18
   url: https://www.halhigdon.com/training-programs/marathon-training/novice-1-marathon/
 - class: MarathonNovice2
   file: marathon_novice2
-  description: "Marathon : Novice 2"
+  distance: "Marathon"
+  level: "Novice 2"
   weeks: 18
   url: https://www.halhigdon.com/training-programs/marathon-training/novice-2-marathon/
 - class: MarathonIntermediate1
   file: marathon_intermediate1
-  description: "Marathon : Intermediate 1"
+  distance: "Marathon"
+  level: "Intermediate 1"
   weeks: 18
   url: https://www.halhigdon.com/training-programs/marathon-training/intermediate-1-marathon/
 - class: MarathonIntermediate2
   file: marathon_intermediate2
-  description: "Marathon : Intermediate 2"
+  distance: "Marathon"
+  level: "Intermediate 2"
   weeks: 18
   url: https://www.halhigdon.com/training-programs/marathon-training/intermediate-2-marathon/
 - class: MarathonAdvanced1
   file: marathon_advanced1
-  description: "Marathon : Advanced 1"
+  distance: "Marathon"
+  level: "Advanced 1"
   weeks: 18
   url: https://www.halhigdon.com/training-programs/marathon-training/advanced-1-marathon/
 - class: MarathonAdvanced2
   file: marathon_advanced2
-  description: "Marathon : Advanced 2"
+  distance: "Marathon"
+  level: "Advanced 2"
   weeks: 18
   url: https://www.halhigdon.com/training-programs/marathon-training/advanced-2-marathon/
 - class: MarathonNoviceSupreme
   file: marathon_novice_supreme
-  description: "Marathon : Novice Supreme"
+  distance: "Marathon"
+  level: "Novice Supreme"
   weeks: 30
   url: https://www.halhigdon.com/training-programs/marathon-training/novice-supreme/
 - class: MarathonPersonalBest
   file: marathon_personal_best
-  description: "Marathon : Personal Best"
+  distance: "Marathon"
+  level: "Personal Best"
   weeks: 30
   url: https://www.halhigdon.com/training-programs/marathon-training/personal-best/
 - class: MarathonSenior
   file: marathon_senior
-  description: "Marathon : Senior"
+  distance: "Marathon"
+  level: "Senior"
   weeks: 8
   url: https://www.halhigdon.com/training-programs/marathon-training/senior/
 - class: Marathon3
   file: marathon_3
-  description: "Marathon : Marathon 3"
+  distance: "Marathon"
+  level: "Marathon 3"
   weeks: 24
   url: https://www.halhigdon.com/training-programs/marathon-training/marathon-3/
 - class: MarathonDopeyChallenge
   file: marathon_dopey_challenge
-  description: "Marathon : Dopey Challenge"
+  distance: "Marathon"
+  level: "Dopey Challenge"
   weeks: 18
   url: https://www.halhigdon.com/training-programs/marathon-training/dopey-challenge/
-# Boston is run on Patriots' Day (a Monday), so the final table row holds a single
-# Monday cell instead of a full week. The scraper truncates to 12 full weeks + race day.
+# Boston is run on Patriots Day (a Monday), so its final table row holds a single
+# Monday cell instead of a full week. The scraper truncates to 12 weeks + race day.
 - class: MarathonBostonBound
   file: marathon_boston_bound
-  description: "Marathon : Boston Bound"
+  distance: "Marathon"
+  level: "Boston Bound"
   weeks: 13
   partial_final_week: true
   url: https://www.halhigdon.com/training-programs/marathon-training/boston-bound/

data/tasks/refresh_data.rake

@@ -26,9 +26,11 @@ module HigdonScraper
 
   module_function
 
-  # Every program in the manifest, or the single one named.
+  # Every program in the manifest, or the single one named. Position is taken from
+  # the full manifest so refreshing one program still writes the right ordering.
   def programs(only = nil)
     all = YAML.safe_load_file(MANIFEST)
+    all.each_with_index { |program, index| program["position"] = index }
     return all unless only
 
     selected = all.select { |program| program["class"] == only }
@@ -117,7 +119,7 @@ module HigdonScraper
 
   def write(program, activities)
     write_yaml(program, activities)
-    write_loader(program)
+    write_loader(program, program["position"])
   end
 
   # Ruby's emitter quotes numeric-looking strings, which keeps the marathon plans'
@@ -127,12 +129,21 @@ module HigdonScraper
     File.write(File.join(DATA_DIR, "#{program['file']}.yaml"), body.to_yaml)
   end
 
-  def write_loader(program)
-    File.write(File.join(DATA_DIR, "#{program['file']}.rb"), <<~RUBY)
+  def write_loader(program, position)
+    File.write(File.join(DATA_DIR, "#{program['file']}.rb"), loader_source(program, position))
+  end
+
+  # POSITION is the program's index in the manifest, which is ordered by distance
+  # then difficulty -- see RunIcal::Data.programs.
+  def loader_source(program, position)
+    <<~RUBY
       module RunIcal
         module Data
           class #{program['class']}
-            DESCRIPTION = #{program['description'].inspect}
+            DISTANCE = #{program['distance'].inspect}
+            LEVEL = #{program['level'].inspect}
+            POSITION = #{position}
+            DESCRIPTION = "\#{DISTANCE} - \#{LEVEL}"
             DATA = YAML.safe_load_file(File.join(__dir__, '#{program['file']}.yaml'), symbolize_names: true)
           end
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: run_ical
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Sean Cashin
@@ -225,6 +225,7 @@ files:
 - bin/setup
 - exe/run_ical
 - lib/run_ical.rb
+- lib/run_ical/data.rb
 - lib/run_ical/data/advanced_10_k.rb
 - lib/run_ical/data/advanced_10_k.yaml
 - lib/run_ical/data/advanced_15_k.rb