radiant-race_results-extension 1.4.0 → 1.4.3

data/lib/race_admin_ui.rb

@@ -0,0 +1,74 @@
+module RaceAdminUI
+
+ def self.included(base)
+   base.class_eval do
+
+      attr_accessor :race
+      alias_method :races, :race
+      attr_accessor :race_instance
+      alias_method :race_instances, :race_instance
+      attr_accessor :race_club
+      alias_method :race_clubs, :race_club
+      attr_accessor :race_competitor
+      alias_method :race_competitors, :race_competitor
+    
+      protected
+
+        def load_default_race_regions
+          OpenStruct.new.tap do |race|
+            race.edit = Radiant::AdminUI::RegionSet.new do |edit|
+              edit.main.concat %w{edit_header edit_form}
+              edit.form.concat %w{edit_name edit_metadata edit_distance edit_description edit_attachments edit_records edit_checkpoints}
+            end
+            race.new = race.edit
+            race.index = Radiant::AdminUI::RegionSet.new do |index|
+              index.thead.concat %w{title_header instances_header}
+              index.tbody.concat %w{title_cell instances_cell}
+              index.bottom.concat %w{buttons}
+            end
+          end
+        end
+    
+        def load_default_race_instance_regions
+          OpenStruct.new.tap do |race_instance|
+            race_instance.edit = Radiant::AdminUI::RegionSet.new do |edit|
+              edit.main.concat %w{edit_header edit_form}
+              edit.form.concat %w{edit_name edit_metadata edit_start edit_notes edit_file edit_report}
+            end
+            race_instance.new = race_instance.edit
+          end
+        end
+
+        def load_default_race_club_regions
+          OpenStruct.new.tap do |race_club|
+            race_club.edit = Radiant::AdminUI::RegionSet.new do |edit|
+              edit.main.concat %w{edit_header edit_form}
+              edit.form.concat %w{edit_name edit_aliases}
+            end
+            race_club.new = race_club.edit
+            race_club.index = Radiant::AdminUI::RegionSet.new do |index|
+              index.thead.concat %w{title_header members_header aliases_header}
+              index.tbody.concat %w{title_cell members_cell aliases_cell}
+              index.bottom.concat %w{buttons}
+            end
+          end
+        end
+
+        def load_default_race_competitor_regions
+          OpenStruct.new.tap do |race_competitor|
+            race_competitor.edit = Radiant::AdminUI::RegionSet.new do |edit|
+              edit.main.concat %w{edit_header edit_form}
+              edit.form.concat %w{edit_name edit_club edit_person}
+            end
+            race_competitor.new = race_competitor.edit
+            race_competitor.index = Radiant::AdminUI::RegionSet.new do |index|
+              index.thead.concat %w{title_header club_header races_header}
+              index.tbody.concat %w{title_cell club_cell races_cell}
+              index.bottom.concat %w{buttons}
+            end
+          end
+        end
+    
+    end
+  end
+end

data/lib/race_tags.rb

@@ -0,0 +1,720 @@
+module RaceTags
+  include Radiant::Taggable
+  include ActionView::Helpers::TextHelper
+  # include ActionView::Helpers::TagHelper
+
+  class TagError < StandardError; end
+
+  ####### race list
+
+  desc %{
+    Loops through the list of races we know about. Takes the usual by and order parameters.
+
+    *Usage:* 
+    <pre><code><r:races:each>...</r:races:each></code></pre>
+  }
+  tag 'races' do |tag|
+    _get_races(tag)
+    tag.expand
+  end
+  tag 'races:each' do |tag|
+    result = []
+    tag.locals.races.each do |race|
+      tag.locals.race = race
+      result << tag.expand
+    end
+    result
+  end
+
+  ####### races
+
+  desc %{
+    Retreives a single race from the name or id you supply or (on a RacePage) from the url or parameters.
+    All the r:race:* tags will follow the same retrieval rules.
+
+    *Usage:* 
+    <pre><code><r:race [name="dunnerdale"] [id="1"]>...</r:race></code></pre>
+  }
+  tag 'race' do |tag|
+    _get_race(tag)
+    raise TagError, "No such race" unless tag.locals.race
+    tag.expand
+  end
+  
+  desc %{
+    Expands if a race is available. Most useful on a RacePage.
+
+    *Usage:* 
+    <pre><code><r:if_race>...</r:if_race></code></pre>
+  }
+  tag 'if_race' do |tag|
+    _get_race(tag)
+    tag.expand if tag.locals.race
+  end
+  
+  desc %{
+    Expands if no race is available. Most useful on a RacePage.
+
+    *Usage:* 
+    <pre><code><r:unless_race>...</r:unless_race></code></pre>
+  }
+  tag 'unless_race' do |tag|
+    _get_race(tag)
+    tag.expand unless tag.locals.race
+  end
+  
+  desc %{
+    Displays the formatted description of the currently selected race.
+
+    *Usage:* 
+    <pre><code><r:race:description /></code></pre>
+  }
+  tag "race:description" do |tag|
+    _get_race(tag)
+    tag.locals.race.filter.filter(tag.locals.race.description)
+  end
+  
+
+  [:id, :name, :slug, :distance, :climb].each do |field|
+    desc %{
+      Displays the #{field} of the currently selected race.
+
+      *Usage:* 
+      <pre><code><r:race:#{field} /></code></pre>
+    }
+    tag "race:#{field}" do |tag|
+      _get_race(tag)
+      tag.locals.race.send(field) if tag.locals.race
+    end
+  end
+
+  desc %{
+    Loops through the list of instances of the present race, retrieving the set of results
+    for each and making them available to any contained r:results tags.
+
+    *Usage:* 
+    <pre><code><r:race:instances:each>...</r:race:instances:each></code></pre>
+  }
+  tag 'race:results' do |tag|
+    _get_race(tag)
+    raise TagError, "No race to show results of" unless tag.locals.race
+    tag.expand
+  end
+  tag 'race:results:each' do |tag|
+    result = []
+    tag.locals.race.instances.each do |instance|
+      tag.locals.race_instance = instance
+      result << tag.expand
+    end
+    result
+  end
+
+  ####### race instances (required for most other tags)
+
+  desc %{
+    Retrieves a set of results from the specified race and instance or (on a RacePage) from the url or parameters.
+
+    *Usage:* 
+    <pre><code>
+      <r:results race="dunnerdale" instance="2009">
+        <ol>
+          <r:performances:each>
+            <li><r:performance:name />: <r:performance:elapsed_time /></li>
+          </r:performances:each>
+        </ol>
+      </r:results>
+    </code></pre>
+  }
+  tag 'results' do |tag|
+    _get_race_instance(tag)
+    raise TagError, "No race instance whose results to show" unless tag.locals.race_instance
+    tag.expand
+  end
+  
+  desc %{
+    Expands if a race instance is available. Most useful on a RacePage.
+
+    *Usage:* 
+    <pre><code><r:if_results>...</r:if_results></code></pre>
+  }
+  tag 'if_results' do |tag|
+    _get_race_instance(tag)
+    tag.expand if tag.locals.race_instance
+  end
+  
+  desc %{
+    Expands if no race instance is available. Most useful on a RacePage.
+
+    *Usage:* 
+    <pre><code><r:unless_results>...</r:unless_results></code></pre>
+  }
+  tag 'unless_results' do |tag|
+    _get_race_instance(tag)
+    tag.expand unless tag.locals.race_instance
+  end
+  
+  desc %{
+    Expands if results are available for this race instance.
+
+    *Usage:* 
+    <pre><code><r:if_results_uploaded>...</r:if_results_uploaded></code></pre>
+  }
+  tag 'if_results_uploaded' do |tag|
+    _get_race_instance(tag)
+    raise TagError, "No race instance to check for results" unless tag.locals.race_instance
+    tag.expand if tag.locals.race_instance.has_results?
+  end
+  
+  desc %{
+    Expands if results are not available for this race instance.
+
+    *Usage:* 
+    <pre><code><r:r:unless_results_uploaded>...</r:r:unless_results_uploaded></code></pre>
+  }
+  tag 'unless_results_uploaded' do |tag|
+    _get_race_instance(tag)
+    raise TagError, "No race instance to check for results" unless tag.locals.race_instance
+    tag.expand unless tag.locals.race_instance.has_results?
+  end
+
+
+  [:id, :name, :full_name, :slug, :path, :notes, :report].each do |field|
+    desc %{
+      Displays the #{field} column of the currently selected race instance.
+
+      *Usage:* 
+      <pre><code><r:results:#{field} /></code></pre>
+    }
+    tag "results:#{field}" do |tag|
+      _get_race_instance(tag)
+      raise TagError, "No race instance to show #{field} of" unless tag.locals.race_instance
+      tag.locals.race_instance.send(field)
+    end
+  end
+
+  [:notes, :report].each do |field|
+    desc %{
+      Displays the formatted #{field} column of the currently selected race instance.
+
+      *Usage:* 
+      <pre><code><r:results:#{field} /></code></pre>
+    }
+    tag "results:#{field}" do |tag|
+      _get_race_instance(tag)
+      raise TagError, "No race instance whose #{field} to show" unless tag.locals.race_instance
+      tag.locals.race_instance.filter.filter(tag.locals.race_instance.send(field))
+    end
+  end
+  
+  desc %{
+    Displays the start of the current race instance as a date.
+
+    *Usage:* 
+    <pre><code><r:results:start_date /></code></pre>
+  }
+  tag "results:start_date" do |tag|
+    _get_race_instance(tag)
+    raise TagError, "No race instance whose date to show" unless tag.locals.race_instance
+    tag.locals.race_instance.nice_start_date
+  end
+  
+  desc %{
+    Displays the start of the current race instance as a time of day. 
+
+    *Usage:* 
+    <pre><code><r:results:start_time /></code></pre>
+  }
+  tag "results:start_time" do |tag|
+    _get_race_instance(tag)
+    raise TagError, "No race instance whose start time to show" unless tag.locals.race_instance
+    tag.locals.race_instance.nice_start_time
+  end
+
+  [:checkpoints, :categories, :competitors, :performances, :finishers, :non_finishers].each do |collection|
+    desc %{
+      Loops through the list of #{collection} in the current results set.
+
+      *Usage:* 
+      <pre><code><r:#{collection}:each [limit="10"]>...</r:#{collection}:each></code></pre>
+    }
+    tag "#{collection}" do |tag|
+      _get_race_instance(tag)
+      raise TagError, "No race instance in which to show #{collection}" unless tag.locals.race_instance
+      tag.expand
+    end
+    tag "#{collection}:each" do |tag|
+      _get_race_instance(tag)
+      result = []
+      tag.locals.race_instance.send(collection).each do |member|
+        setter = [:performances, :finishers, :non_finishers].include?(collection) ? 'performance=' : "#{collection.to_s.singularize}="
+        tag.locals.send(setter, member)
+        result << tag.expand
+      end
+      result
+    end
+  end
+
+
+  ####### performances
+
+  desc %{
+    Retrieves a single performance from the result set, based on the race number or position that you supply.
+
+    *Usage:* 
+    <pre><code><r:performance [number="1"] [position="1"]>...</r:performance></code></pre>
+  }
+  tag 'performance' do |tag|
+    raise TagError, "No race instance available within which to find a performance" unless tag.locals.race_instance
+    _get_race_performance(tag)
+    raise TagError, "No race performance found" unless tag.locals.performance
+    tag.expand
+  end
+
+  [:position, :name, :number, :elapsed_time, :position, :status].each do |field|
+    desc %{
+      Displays the #{field} column of the performance currently in the foreground.
+
+      *Usage:* 
+      <pre><code><r:performance:#{field} /></code></pre>
+    }
+    tag "performance:#{field}" do |tag|
+      _get_race_performance(tag)
+      tag.locals.performance.send(field) if tag.locals.performance
+    end
+  end
+
+  [:club, :category, :competitor, :race_instance].each do |association|
+    desc %{
+      Retrieves the #{association} associated with the performance currently in the foreground 
+
+      If double, we expand and make the #{association} available to any contained r:#{association} tags.
+
+      If single, we just display the name of the #{association}.
+
+      <pre><code>
+        <r:performance:#{association} />
+        <r:performance:#{association}>...</r:performance:#{association}></code></pre>
+      </code></pre>
+    }
+    tag "performance:#{association}" do |tag|
+      _get_race_performance(tag)
+      if tag.double?
+        tag.locals.send("#{association}=".intern, tag.locals.performance.send(association))
+        tag.expand
+      else
+        associate = tag.locals.performance.send(association)
+        associate.name if associate
+      end
+    end
+  end
+  
+  tag "performance:if_finished" do |tag|
+    _get_race_performance(tag)
+    tag.expand if tag.locals.performance.finished?
+  end
+  tag "performance:unless_finished" do |tag|
+    _get_race_performance(tag)
+    tag.expand unless tag.locals.performance.finished?
+  end
+
+  tag "performance:if_prize" do |tag|
+    _get_race_performance(tag)
+    tag.expand if tag.locals.performance.prized?
+  end
+  tag "performance:unless_prize" do |tag|
+    _get_race_performance(tag)
+    tag.expand unless tag.locals.performance.prized?
+  end
+  
+  tag "performance:prize" do |tag|
+    _get_race_performance(tag)
+    tag.locals.performance.prize
+  end
+
+  desc %{
+    Loops through the list of checkpoint times associated with the present performance. Within this tag
+    you can use r:checkpoint_time singly just to show the split time, or a clause like this to show more detail:
+  
+    *Usage:* 
+    <pre><code>
+      <r:performance:checkpoint_times:each>
+        <strong><r:checkpoint_time:elapsed_time /><strong><br />
+        pos: <r:checkpoint_time:position /> (<r:checkpoint_time:gain />)
+      </r:performance:checkpoint_times:each>
+    </code></pre>
+  }
+  tag 'performance:checkpoint_times' do |tag|
+    _get_race_performance(tag)
+    raise TagError, "No performance to find times for" unless tag.locals.performance
+    tag.expand
+  end
+  tag 'performance:checkpoint_times:each' do |tag|
+    _get_race_performance(tag)
+    result = []
+    tag.locals.performance.checkpoint_times.each do |time|
+      tag.locals.checkpoint_time = time
+      result << tag.expand
+    end
+    result
+  end
+
+
+  ####### categories
+
+  desc %{
+    Retrieves a single category from the result set, based on the name that you supply.
+
+    *Usage:* 
+    <pre><code><r:category name="MV40">...</r:category></code></pre>
+  }
+  tag 'category' do |tag|
+    _get_race_category(tag)
+    raise TagError, "No race category found" unless tag.locals.category
+    tag.expand
+  end
+
+  [:id, :name, :record, :entries, :finishers].each do |field|
+    desc %{
+      Displays the #{field} column of the race category currently in the foreground.
+
+      *Usage:* 
+      <pre><code><r:category:#{field} /></code></pre>
+    }
+    tag "category:#{field}" do |tag|
+      _get_race_category(tag)
+      tag.locals.category.send(field) if tag.locals.category
+    end
+  end
+
+  desc %{
+    Loops through the list of performances in the present racea category, making them available
+    to the usual r:performance tags.
+  
+    Supply a @limit@ attribute to limit the size of the list returned.
+
+    *Usage:* 
+    <pre><code><r:category:performances:each [limit="10"]>...</r:category:performances:each></code></pre>
+  }
+  tag 'category:performances' do |tag|
+    _get_race_category(tag)
+    raise TagError, "No category to draw performances from" unless tag.locals.category
+    tag.expand
+  end
+  tag 'category:performances:each' do |tag|
+    _get_race_category(tag)
+    result = []
+    tag.locals.category.performances.each do |performance|
+      tag.locals.performance = performance
+      result << tag.expand
+    end
+    result
+  end
+
+  ####### clubs
+
+  desc %{
+    Retrieves a single club from the result set, based on the name that you supply.
+
+    *Usage:* 
+    <pre><code><r:club name="Black Combe Runners">...</r:club></code></pre>
+  }
+  tag 'club' do |tag|
+    _get_club(tag)
+    # raise TagError, "No club found" unless tag.locals.club
+    tag.expand if tag.locals.club
+  end
+  [:id, :name, :url].each do |field|
+    desc %{
+      Displays the #{field} column of the club currently in the foreground.
+
+      *Usage:* 
+      <pre><code><r:club:#{field} /></code></pre>
+    }
+    tag "club:#{field}" do |tag|
+      _get_club(tag)
+      tag.locals.club ||= _get_club(tag)
+      tag.locals.club.send(field) if tag.locals.club
+    end
+  end
+
+  desc %{
+    Renders a link to the club currently in the foreground. Attributes and link text are passed through as usual.
+
+    *Usage:* 
+    <pre><code><r:club:link class="cssclass" /></code></pre>
+  }
+  tag "club:link" do |tag|
+    _get_club(tag)
+    raise TagError, "No club to link to" unless tag.locals.club
+    options = tag.attr.dup
+    anchor = options['anchor'] ? "##{options.delete('anchor')}" : ''
+    attributes = options.inject(' ') { |s, (k, v)| s << %{#{k.downcase}="#{v}" } }.strip
+    text = tag.double? ? tag.expand : tag.render('club:name')
+    %{<a href="#{tag.render('club:url')}#{anchor}"#{attributes}>#{text}</a>}
+  end
+
+  ####### checkpoints
+
+  desc %{
+    Retrieves a single checkpoint from the result set, based on the name that you supply.
+  
+    *Usage:* 
+    <pre><code><r:checkpoint name="Raven Crag">...</r:checkpoint></code></pre>
+  }
+  tag 'checkpoint' do |tag|
+    _get_race_checkpoint(tag)
+    raise TagError, "No checkpoint found" unless tag.locals.checkpoint
+    tag.expand
+  end
+  [:id, :name, :location].each do |field|
+    desc %{
+      Displays the #{field} column of the checkpoint currently in the foreground.
+
+      *Usage:* 
+      <pre><code><r:checkpoint:#{field} /></code></pre>
+    }
+    tag "checkpoint:#{field}" do |tag|
+      _get_race_checkpoint(tag)
+      tag.locals.checkpoint.send(field) if tag.locals.club
+    end
+  end
+
+  desc %{
+    Loops through the list of checkpoint times associated with the present checkpoint.
+  
+    Supply a @limit@ attribute to limit the size of the list returned.
+  
+    *Usage:* 
+    <pre><code><r:checkpoint:times:each [limit="10"]>...</r:checkpoint:times:each></code></pre>
+  }
+  tag 'checkpoint:times' do |tag|
+    _get_race_checkpoint(tag)
+    raise TagError, "No checkpoint to find times for" unless tag.locals.checkpoint
+    tag.expand
+  end
+  tag 'checkpoint:times:each' do |tag|
+    _get_race_checkpoint(tag)
+    result = []
+    tag.locals.checkpoint.times.each do |time|
+      tag.locals.checkpoint_time = time
+      result << tag.expand
+    end
+    result
+  end
+
+  ####### checkpoint times are only shown in lists
+
+  desc %{
+    Retrieves a single checkpoint from the result set, based on the name that you supply.
+
+    Used singly: it just displays the time at that checkpoint.
+  
+    If double, it expands in the usual way. You can use r:performance:* tags within this tag if you want to display
+    a list of arrivals at this point, and r:checkpoint_time:* tags to display the time, position and gain data. 
+    This is only likely to happen when you're displaying an individual performance but it is also possible to build
+    a complete splits table this way.
+    
+  }
+  tag 'checkpoint_time' do |tag|
+    raise TagError, "checkpoint_time tag can only be used in a results list" unless tag.locals.checkpoint_time
+    if tag.double?
+      tag.locals.performance = tag.locals.checkpoint_time.performance
+      tag.expand
+    else
+      tag.locals.checkpoint_time.elapsed_time
+    end
+  end
+
+  [:elapsed_time, :position, :gain].each do |field|
+    desc %{
+      Displays the #{field} of the checkpoint arrival time currently in the foreground.
+
+      *Usage:* 
+      <pre><code><r:checkpoint_time:#{field} /></code></pre>
+    }
+    tag "checkpoint_time:#{field}" do |tag|
+      raise TagError, "checkpoint_time:* tags can only be used in a results list" unless tag.locals.checkpoint_time
+      tag.locals.checkpoint_time.send(field)
+    end
+  end
+
+  ####### standard display blocks
+
+  desc %{
+    Displays a complete table of race results in a simple standard format.
+  }
+  tag 'results:table' do |tag|
+    _get_race_instance
+    raise TagError, "No race instance to list" unless tag.locals.race_instance
+    result = []
+    result << %{<table class="results">}
+    result << tag.render('results:header')
+    tag.locals.performances = tag.locals.race_instance.performances
+    result << tag.render('performances:table')
+    result << %{</table>}
+    result.flatten
+  end
+
+  desc %{
+    Displays a standard list of performances. This is here to support the results:table and category:table but you can 
+    use it directly if you like. A list of perfomances must be available.
+  }
+  tag 'performances:table' do |tag|
+    raise TagError, "No performances to display" unless tag.locals.performances
+    result = []
+    result << %{<tbody>}
+    if tag.locals.performances.any?
+      tag.locals.performances.each do |performance|
+        tag.locals.performance = performance
+        result << %{
+  <tr>
+    <td>#{tag.render('performance:position')}</td>
+    <td>#{tag.render('performance:name')}</td>
+    <td>#{tag.render('performance:club')}</td>
+    <td>#{tag.render('performance:category')}</td>
+    <td>#{tag.render('performance:time')}</td>
+  </tr>
+        }
+      end
+    else
+      result << %{<tr><td colspan="5" class="nodata">No results to display</td></tr>}
+    end
+    result << %{</tbody>}
+    result
+  end
+
+  desc %{
+    Displays standard column headings suitable for use in any of the results tables
+  }
+  tag 'results:header' do |tag|
+    %{<thead><tr><th>Pos</th><th>Name</th><th>Club</th><th>Cat</th><th>Time</th></tr></thead>}
+  end
+
+  desc %{
+    Displays a complete table of splits for the current race.
+  }
+  tag 'results:splits' do |tag|
+  
+  end
+
+  desc %{
+    Displays a complete table of results in the current category, in a simple standard format.
+  }
+  tag 'category:list' do |tag|
+  
+  end
+
+  desc %{
+    Displays a table of the prize-winning performances suitable for use on a summary page.
+  }
+  tag 'results:prizes' do |tag|
+  
+  end
+
+  desc %{
+    Displays a table of the category-prize-winning performances suitable for use on a summary page.
+  }
+  tag 'category:prizes' do |tag|
+
+  end
+
+  ####### page furniture
+
+
+  desc %{
+    Renders a trail of breadcrumbs to the current page. On a race_results page this tag is 
+    overridden to show the name and instance of the race being displayed
+
+    *Usage:*
+
+    <pre><code><r:breadcrumbs [separator="separator_string"] [nolinks="true"] /></code></pre>
+  }
+  tag 'breadcrumbs' do |tag|
+    page = tag.locals.page
+    nolinks = (tag.attr['nolinks'] == 'true')
+  
+    if race
+      crumbs = nolinks ? [page.breadcrumb] : [%{<a href="#{url}">#{tag.render('breadcrumb')}</a>}]
+      if race_instance
+        crumbs << (nolinks ? race : %{<a href="#{url}/#{race.slug}">#{race.name}</a>})
+        crumbs << race_instance.name
+      else
+        crumbs << race.name
+      end
+    else
+     crumbs = [page.breadcrumb]
+    end
+    page.ancestors.each do |ancestor|
+      tag.locals.page = ancestor
+      if nolinks
+        crumbs.unshift tag.render('breadcrumb')
+      else
+        crumbs.unshift %{<a href="#{tag.render('url')}">#{tag.render('breadcrumb')}</a>}
+      end
+    end
+    separator = tag.attr['separator'] || ' &gt; '
+    crumbs.join(separator)
+  end
+
+
+
+
+
+
+
+
+private
+
+  def _get_races(tag)
+    return tag.locals.races if tag.locals.races
+    tag.locals.races = Race.all
+  end
+
+  def _get_race(tag)
+    tag.locals.race ||= tag.locals.page.race if tag.locals.page.is_a? RacePage
+    return tag.locals.race if tag.locals.race
+    tag.locals.race = Race.find_by_name(tag.attr['name']) if tag.attr['name']
+  end
+
+  def _get_race_instance(tag)
+    tag.locals.race_instance ||= tag.locals.page.race_instance if tag.locals.page.is_a? RacePage
+    return tag.locals.race_instance if tag.locals.race_instance
+    _get_race(tag)
+    return unless tag.locals.race && tag.attr['instance']
+    tag.locals.race_instance = tag.locals.race.in(tag.attr['instance'])
+  end
+
+  def _get_race_category(tag)
+    return tag.locals.category if tag.locals.category
+    raise TagError, "No race instance available within which to find a category" unless tag.locals.race_instance
+    raise TagError, "No category name supplied" unless tag.attr['name']
+    tag.locals.category = tag.locals.race_instance.categories.find_by_name(tag.attr['name'])
+  end
+
+  def _get_race_performance(tag)
+    return tag.locals.performance if tag.locals.performance
+    raise TagError, "No race instance available within which to find a peformance" unless tag.locals.race_instance
+    if name = tag.attr['name']
+      tag.locals.performance = tag.locals.race_instance.performance_by(tag.locals.race_instance.competitors.find_by_name(name))
+    elsif position = tag.attr['position']
+      tag.locals.performance = tag.locals.race_instance.performance_at(position)
+    elsif number = tag.attr['number']
+      tag.locals.performance = tag.locals.race_instance.performance.find_by_number(number)
+    else
+      raise TagError, "Performance name, number or position is required"
+    end
+  end
+
+  def _get_race_checkpoint(tag)
+    return tag.locals.checkpoint if tag.locals.checkpoint
+    raise TagError, "No race instance available within which to find a checkpoint" unless tag.locals.race_instance
+    raise TagError, "No checkpoint name supplied" unless tag.attr['name']
+    tag.locals.checkpoint = tag.locals.race_instance.checkpoints.find_by_name(tag.attr['name'])
+  end
+
+  def _get_club(tag)
+    return tag.locals.club if tag.locals.club
+    tag.locals.club = RaceClub.find_by_name(tag.attr['name']) if tag.attr['name']
+  end
+
+end