hobo 0.8.10 → 0.9.0

data/rails_generators/hobo_model_resource/USAGE

@@ -0,0 +1,38 @@
+Description:
+    The model generator creates stubs for a new model, corresponding
+    controller and it's views.
+
+    The generator takes a model name as its argument.  The model name
+    may be given in CamelCase or under_score and should not be
+    suffixed with anything.
+
+    As additional parameters, the generator will take attribute pairs
+    described by name and type. These attributes will be used to
+    prepopulate the migration to create the table for the model and
+    give you a set of predefined fixture. You don't have to think up
+    all attributes up front, but it's a good idea of adding just the
+    baseline of what's needed to start really working with the
+    resource.
+
+    The generator creates a model class in app/models, a test suite in
+    test/unit and test fixtures in test/fixtures/singular_name.yml.
+    The generator creates a controller class in app/controllers with
+    view templates in app/views/controller_name, a helper class in
+    app/helpers, and a functional test suite in test/functional.
+
+Examples:
+    ./script/generate hobo_model_resource account
+
+        This will create an Account model:
+            Model:      app/models/account.rb
+            Controller: app/controllers/accounts_controller.rb
+            Helper:     app/helpers/accounts_helper.rb
+            Views:      app/views/accounts
+            ViewHints:  app/viewhints/account_hints.rb
+            Test:       test/unit/account_test.rb
+            Test:       test/functions/accounts_controller_test.rb
+            Fixtures:   test/fixtures/accounts.yml            
+
+    ./script/generate hobo_model_resource post title:string created_on:date body:text published:boolean
+    
+        Creates post model, controller & views with predefined attributes.

data/rails_generators/hobo_rapid/USAGE

@@ -0,0 +1,3 @@
+Description:
+
+    Adds support for Rapid to your application.

data/rails_generators/hobo_rapid/templates/hobo-rapid.js

@@ -655,7 +655,9 @@ SelectManyInput = Behavior.create({
             this.element.down('.items').appendChild(newItem);
             newItem.down('span').innerHTML = selected.innerHTML
             this.itemAdded(newItem, selected)
-            selected.disabled = true
+            var optgroup = new Element("optgroup", {alt:selected.value, label:selected.text})
+            optgroup.addClassName("disabled-option")
+            selected.replace(optgroup)
             select.value = ""
             Event.addBehavior.reload()
             this.element.fire("rapid:add", { element: newItem })
@@ -678,8 +680,10 @@ SelectManyInput = Behavior.create({
                                  element.fire("rapid:change", { element: el })
                                  } } ) 
         var label = el.down('span').innerHTML
-        var option = $A(element.getElementsByTagName('option')).find(function(o) { return o.innerHTML == label })
-        option.disabled = false
+        var optgroup = element.down("optgroup[label="+label+"]")
+        var option = new Element("option", {value:optgroup.readAttribute("alt")})
+        option.innerHTML = optgroup.readAttribute("label")
+        optgroup.replace(option)
     },
 
     itemAdded: function(item, option) {

data/rails_generators/hobo_rapid/templates/themes/clean/public/stylesheets/clean.css

@@ -321,3 +321,7 @@ ul.input-many div.buttons {float:left; margin-left:10px;}
 ul.check-many { list-style-type: none; margin-left: 0px;}
 ul.check-many li input { vertical-align: -20%;}
 
+/* rapid-summary */
+table.app-summary { border: 1px solid; border-collapse: collapse; }
+table.app-summary td { padding: 2px;  border: 1px dotted #bbb; }
+table.app-summary th { padding: 2px; border-bottom: 1px solid; background: #acd3e6; }

data/rails_generators/hobo_rapid/templates/themes/clean/public/stylesheets/rapid-ui.css

@@ -92,4 +92,9 @@ select.dev-user-changer:hover { opacity: 1; }
 
 .part-wrapper {
     display: inline;  /* don't mess up layout when wrapping something */
+}
+
+optgroup.disabled-option {
+    color: #ccc;
+    height: 1em;
 }

data/rails_generators/hobo_subsite/USAGE

@@ -0,0 +1,16 @@
+Description:
+
+    Creates a subsite, a namespaced section of your application.
+
+    The subsite will use app/views/taglibs/<subsite_name>_site.dryml
+    instead of app/views/taglibs/appplication.dryml.  This allows you
+    to easily set different themes and choose different CSS files for
+    the subsite.
+
+    Controllers for the subsite are created in
+    app/controllers/<subsite_name>/ and views are also in their own
+    subdirectory.   This allows you to have two different controllers
+    and two different sets of views for the same model.
+
+    The difference between hobo_admin_site and hobo_subsite is that
+    hobo_admin_site limits the subsite to use by administrators only.

data/rails_generators/hobo_subsite/hobo_subsite_generator.rb

@@ -53,7 +53,7 @@ class HoboSubsiteGenerator < Rails::Generator::NamedBase
 
   protected
     def banner
-      "Usage: #{$0} #{spec.name} [--make-front-site | --no-front-site]"
+      "Usage: #{$0} #{spec.name} <subsite_name> [--make-front-site | --no-front-site]"
     end
 
 

data/rails_generators/hobo_user_controller/templates/controller.rb

@@ -12,7 +12,7 @@ class <%= class_name %>Controller < ApplicationController
         this.password = this.password_confirmation = nil # don't trigger password change validations
         this.state = 'active'
         this.save
-        flash[:notice] = "You are now the site administrator"
+        flash[:notice] = ht("hobo.messages.you_are_site_admin", :default=>"You are now the site administrator")
         redirect_to home_page
       end
     end
@@ -21,7 +21,7 @@ class <%= class_name %>Controller < ApplicationController
   def do_accept_invitation
     do_transition_action :accept_invitation do
       self.current_user = this
-      flash[:notice] = "You have signed up"
+      flash[:notice] = ht("hobo.messages.you_signed_up", :default=>"You have signed up")
     end
   end
 <% end -%>

data/rails_generators/hobo_user_model/templates/model.rb

@@ -9,12 +9,17 @@ class <%= class_name %> < ActiveRecord::Base
     timestamps
   end
 
+  validates_presence_of :name
+
   # This gives admin rights to the first sign-up.
   # Just remove it if you don't want that
   before_create { |user| user.administrator = true if !Rails.env.test? && count == 0 }
 
 <% if invite_only? -%>
-  validates_confirmation_of :password,              :if => "User.count == 0"
+  def new_password_required_with_invite_only?
+    new_password_required_without_invite_only? || User.count==0
+  end
+  alias_method_chain :new_password_required?, :invite_only
 <% end -%>
   
   # --- Signup lifecycle --- #

data/taglibs/rapid.dryml

@@ -18,3 +18,4 @@ The Rapid tag library makes web development go fast. The Rapid tag library is yo
 <include src="rapid_plus"/>
 <include src="rapid_generics"/>
 <include src="rapid_lifecycles"/>
+<include src="rapid_summary"/>

data/taglibs/rapid_core.dryml

@@ -112,7 +112,7 @@ This will use `<input/>` as the tag in each table cell instead of `<view/>`
                 <td param="#{this_field.to_s.sub('?', '').gsub('.', '-')}-view"><call-tag tag="&field_tag"/></td>
               </with-fields>
               <td class="controls" param="controls" if="&all_parameters[:controls]">
-                <a param="edit-link" action="edit" if="&can_edit?">Edit</a>
+                <a param="edit-link" action="edit" if="&can_edit?"><ht key="hobo.action.edit">Edit</ht></a>
                 <delete-button param/>
               </td>
             </if>
@@ -517,11 +517,11 @@ The label can be customised using the `label` attribute, e.g.
   c = this.try.to_int || this.try.total_entries || (this.try.loaded? && this.try.length) || this.try.count || this.try.length
 
   label ||= if this.is_a?(Class)
-              this.name
+              this.view_hints.model_name
             elsif (attr = this.try.origin_attribute)
-              attr.to_s.singularize
+              this.member_class.view_hints.field_name(attr).singularize
             else
-              this.member_class.name
+              this.member_class.view_hints.model_name
             end.titleize
 
   label = label.downcase if lowercase

data/taglibs/rapid_forms.dryml

@@ -32,7 +32,7 @@ Several of the tags in this taglib support the following set of ajax attributes:
 The following attributes are also supported by all the ajax tags. Set them to fragments of javascript to have that script
 executed at various points in the ajax request cycle:
  
- - before: script to run befofre the request
+ - before: script to run before the request
  
  - success: script to run on successful completion of the request
  
@@ -183,7 +183,7 @@ AJAX based submission can be enabled by simply adding an `update` attribute. e.g
       page_path = if (request.post? || request.put?) && params[:page_path]
                     params[:page_path]
                   else
-                    view_name.sub(Hobo::Dryml::EMPTY_PAGE, params[:action])
+                    view_name.sub(Hobo::Dryml::EMPTY_PAGE, params[:action] || '')
                   end
       page_path_hidden = hidden_field_tag("page_path", page_path) 
     end
@@ -319,7 +319,7 @@ edit collections a `Category` model in your application:
 <def tag="input" for="boolean" attrs="name">
   <%= unless attributes[:disabled]
         cb_tag = check_box_tag(name, '1', this, attributes)
-        cb_hidden_tag = hidden_field_tag(name, '0')
+        cb_hidden_tag = hidden_field_tag(name, '0', :id => nil)
         HoboSupport::RAILS_AT_LEAST_23 ? cb_hidden_tag + cb_tag : cb_tag + cb_hidden_tag
       end %>
 </def>
@@ -380,8 +380,6 @@ The menus default to the current time if the current value is nil.
   <% if ! order.nil?
        order = comma_split(order).*.to_sym 
        attributes.merge!(:order => order)
-       require 'ruby-debug'
-       debugger
      end -%>
   <%= select_datetime(this || current_time, attributes.merge(:prefix => param_name_for_this)) %>
 </def>
@@ -536,8 +534,8 @@ All the standard ajax attributes *except the callbacks* are supported (see the m
                                   else
                                     { :type => "button" }
                                   end)
-    label ||= "Remove"
-    confirm = "Are you sure?" if confirm.nil?
+    label ||= ht("hobo.actions.remove", :default=>"Remove") 
+    confirm = ht("hobo.messages.confirm", :default=>"Are you sure?") if confirm.nil?
     
     add_classes!(attributes,
                  image ? "image-button" : "button",
@@ -584,7 +582,7 @@ All of the standard ajax attributes are supported (see the main taglib documenti
   new = class_or_assoc.new(fields)
   new.set_creator(current_user)
   if can_create?(new)
-    label ||= "New #{new.class.name.titleize}"
+    label ||= ht("#{new.class.name.pluralize.underscore}.actions.new", :default=>"New #{new.class.name.titleize}")  
     ajax_attributes = { :message => message }
     class_name = new.class.name.underscore
     ajax_attributes[:params] = { class_name => fields } unless fields.empty?
@@ -601,7 +599,7 @@ This is the default input that Rapid uses for `belongs_to` associations. The men
 
 ### Attributes
 
- - `include-none` - whether to include a 'none' option (i.e. set the foreign key to null). Defaults to false
+ - `include-none` - whether to include a 'none' option (i.e. set the foreign key to null).   If this value is not supplied, the default is "true" if the current value is nil; otherwise the default is "false".  One implication of this is that the default may change when the form is re-rendered due to a validation failure.  Setting this value explicitly is recommended.
  - `blank-message` - the message for the 'none' option. Defaults to "(No `<model-name>`)", e.g. "(No Product)"
  - `options` - an array of records to include in the menu. Defaults to the all the records in the target table that match any `:conditions` declared on the `belongs_to` (subject to `limit`)
  - `limit` - if `options` is not specified, this limits the number of records.  Default: 100
@@ -615,7 +613,7 @@ For situations where there are too many target records to practically include in
 <def tag="select-one" attrs="include-none, blank-message, options, sort, limit, text-method"><%
   raise HoboError.new("Not allowed to edit #{this_field}") if !attributes[:disabled] && !can_edit? 
 
-  blank_message ||= "(No #{this_type.name.to_s.titleize})"
+  blank_message ||= ht("#{this_type.name.underscore}.message.no", :default=>"(No #{this_type.view_hints.model_name})")
   limit ||= 100
    
   options ||= begin
@@ -682,7 +680,7 @@ Here's a more complex example.  This used to be a part of [agility](http://cookb
       end
     end
 
-Note that this was added to the projects controller, rather than the users controller as in the first example.  You can read this as: create an auto-complete action called ’new_member_name’ that finds users that are not already members of the project, and not the owner of the project, and completes the :name field.
+Note that this was added to the projects controller, rather than the users controller as in the first example.  You can read this as: create an auto-complete action called �new_member_name� that finds users that are not already members of the project, and not the owner of the project, and completes the :name field.
 
     <name-one:user complete-target="&@project" completer="new_member_name"/>
 
@@ -751,13 +749,14 @@ To use this tag, the model of the items the user is chosing *must* have unique n
   name ||= param_name_for_this
                 
   values = this
+  remove_label ||= ht("hobo.actions.remove", :default=>'Remove')
   -%>
   <div class="input select-many" merge-attrs>
     <div style="display:none" class="item-proto">
       <div class="item" param="proto-item">
         <span></span>
         <input type="hidden" name="#{name}[]" param="proto-hidden"/>
-        <input type="button" class="remove-item" value="#{remove_label || 'Remove'}" param="proto-remove-button"/>
+        <input type="button" class="remove-item" value="#{remove_label}" param="proto-remove-button"/>
       </div>
     </div>
     <div class="items">
@@ -765,14 +764,20 @@ To use this tag, the model of the items the user is chosing *must* have unique n
         <span><%= h this.to_s %></span>
         <input type="hidden" name="#{name}[]" value="@#{h this.id}" disabled="&disabled"
                param="hidden"/>
-        <input type="button" class="remove-item" value="#{remove_label || 'Remove'}" disabled="&disabled"
+        <input type="button" class="remove-item" value="#{remove_label}" disabled="&disabled"
                param="remove-button"/>
       </div>
     </div>
     <select merge-attrs="&{:disabled => disabled}">
       <option value=""><prompt/></option>
-      <option repeat="&options.sort_by {|x| x.to_s.downcase}" value="@#{this.id}"
-              merge-attrs="&{:disabled => 'true'} if this.in?(values)"><%= h this.to_s %></option>
+      <repeat with="&options">
+        <if test="&this.in?(values)">
+          <optgroup class="disabled-option" label="#{h this.to_s}" alt="@#{this.id}">&nbsp;</optgroup>
+        </if>
+        <else>
+          <option value="@#{this.id}"><%= h this.to_s %></option>
+        </else>
+      </repeat>
     </select>
   </div>
 </def>
@@ -814,7 +819,7 @@ Use the `uri` option to specify a redirect location:
 
 <!-- A simple wrapper around the `<select>` tag and `options_for_select` helper
   
-### Attributes
+  ### Attributes
 
  - `options` - an array of options suitable to be passed to the Rails `options_for_select` helper.
  - `selected` - the value (from the `options` array) that should be initially selected. Defaults to `this`
@@ -867,7 +872,7 @@ Use the `uri` option to specify a redirect location:
   
 This tag is very different from tags like `<select-many>` and `<check-many>` in that:
 
- - Those tags are used to *chose existing records* to include in the assocaition, while `<input-many>` is used to actually create or edit the records in the association.
+ - Those tags are used to *chose existing records* to include in the association, while `<input-many>` is used to actually create or edit the records in the association.
  
 ### Example
 
@@ -880,9 +885,11 @@ The body of the tag will be repeated for each of the current records in the coll
 ### Attributes
 
  - fields:  If you do not specify any content for the input-many, a `<field-list>` is rendered.   This attribute is passed through to the `<field-list>`
+
+ - skip:  Passed through to the `<field-list>`.  If not specified, it defaults to the parent association.
   
   -->
-<def tag="input-many" attrs="fields" polymorphic>
+<def tag="input-many" attrs="fields,skip" polymorphic>
   <set empty="&this.empty?"/>
   <ul class="input-many #{this_field.dasherize} #{css_data :input_many_prefix, param_name_for_this}">
     <li repeat class="#{'record-with-errors' unless this.errors.empty?}">
@@ -897,9 +904,10 @@ The body of the tag will be repeated for each of the current records in the coll
       </div>
     </li>
     <li if="&empty">
+      <% skip ||= this.proxy_reflection.klass.reflect_on_all_associations.detect {|p| p.primary_key_name==this.proxy_reflection.primary_key_name}.try.name.to_s %>           
       <fake-field-context fake-field="0" context="&this.try.new_candidate || this.member_class.new">
         <div class="input-many-item" param="default">
-          <field-list merge-attrs="fields"/>
+          <field-list merge-attrs="fields" skip="&skip"/>
         </div>
       </fake-field-context>
       <div class="buttons">
@@ -928,8 +936,8 @@ The body of the tag will be repeated for each of the current records in the coll
 <!-- Renders the common "or (Cancel)" for a form. Attributes are merged into the link (`<a>Cancel</a>`), making it easy to customise the destination of the cancel link. By default it will link to `this` or `this.class`.
   -->
 <def tag="or-cancel">
-  <if test="&linkable?">or <a merge-attrs>Cancel</a></if>
+  <if test="&linkable?"><ht key="hobo.support.or">or</ht> <a merge-attrs><ht key="hobo.actions.cancel">Cancel</ht></a></if>
   <else>
-    <if test="&linkable?(this.class)">or <a to="&this.class" merge-attrs>Cancel</a></if>
+    <if test="&linkable?(this.class)"><ht key="hobo.support.or">or</ht> <a to="&this.class" merge-attrs><ht key="hobo.actions.cancel">Cancel</ht></a></if>
   </else>
 </def>

data/taglibs/rapid_generics.dryml

@@ -19,7 +19,9 @@
   -->
 <def tag="empty-collection-message">
   <div class="empty-collection-message" style="#{'display:none' if !this.empty?}" param="default">
-    No <collection-name lowercase/> to display
+    <ht key="#{type_name.downcase.sub(' ', '_').pluralize}.collection.empty_message">
+      No <collection-name lowercase/> to display
+    </ht>
   </div>
 </def>
 

data/taglibs/rapid_lifecycles.dryml

@@ -10,15 +10,20 @@
 
 All of the [standard ajax attributes](/api_taglibs/rapid_forms) are also supported. 
   -->
-<def tag="transition-button" attrs="transition, update, label"><%= 
-    transition = transition.name unless transition.is_a?(String)
+<def tag="transition-button" attrs="transition, update, label"><%=
+    if transition.is_a?(String)
+      transition = this.lifecycle.find_transition(transition, current_user)
+    end
+    transition_name = transition.name
+    has_params = !transition.options[:params].blank?
     ajax_attributes, html_attributes = attributes.partition_hash(Hobo::RapidHelper::AJAX_ATTRS)
 
-    html_attributes[:method] = :put
-    url = object_url(this, transition, :method => :put)
-    add_classes!(html_attributes, "transition-button #{transition}-button")
-    label ||= transition.to_s.titleize
-    if update || !ajax_attributes.empty?
+    html_attributes[:method] ||= has_params ? :get : :put
+    add_classes!(html_attributes, "transition-button #{transition_name}-button")
+    label ||= transition_name.to_s.titleize
+    url = object_url(this, transition_name, :method => html_attributes[:method])
+
+    if (update || !ajax_attributes.empty?) && !has_params
       ajax_attributes[:message] ||= label
       func = ajax_updater(url, update, ajax_attributes)
       html_attributes.update(:onclick => "var e = this; " + func, :type =>'button', :value => label)
@@ -28,10 +33,10 @@ All of the [standard ajax attributes](/api_taglibs/rapid_forms) are also support
     end
   %>
 </def>
-  
+
 
 <!-- Renders a div containing transition buttons for every transition available to the current user.
-  
+
 For example, you could use this on a `Friendship` card: the person invited to have friendship would automatically see 'Accept' and 'Decline' buttons, while the person initiating the invite would see 'Retract'.
   -->  
 <def tag="transition-buttons">

data/taglibs/rapid_navigation.dryml

@@ -85,5 +85,5 @@ This is a simple tag - just look at the source if you need to know more detail.
 
 <!--- A simple wrapper around the `will_paginate` helper. All options to `will_paginate` are available as attributes -->
 <def tag="page-nav">
-  <%= will_paginate this, attributes.symbolize_keys.reverse_merge(:inner_window => 2, :previous_label => "&laquo; Prev") %>
+  <%= will_paginate this, attributes.symbolize_keys.reverse_merge(:inner_window => 2, :previous_label => translate("hobo.actions.previous", :default=>"&laquo; Prev"), :next_label =>translate("hobo.actions.next", :default=>"Next &raquo;")) %>
 </def>

data/taglibs/rapid_plus.dryml

@@ -103,6 +103,7 @@ This tag assumes the controller has a `reorder` action. This action is added aut
     <h3 param="heading"><%= name.titleize %></h3>
     <a param="more">More <type-name plural lowercase/>...</a>
     <collection param/>
+    <a action="new" if="&can_create?(this.new)" param="new-link">New <%= this.member_class.view_hints.model_name %></a>
   </section>
 </def>
 

data/taglibs/rapid_summary.dryml

@@ -0,0 +1,300 @@
+<!-- These are a collection of tags that allow a application outline or summary to be created -->
+
+<!-- Rails.version -->
+<def tag="rails-version">
+  <%= Rails.version -%>
+</def>
+
+<!-- returns "vendor" or "gem" -->
+<def tag="rails-location">
+  <%= Rails.vendor_rails? ? "vendor" : "gem" -%>
+</def>
+
+<!-- `RAILS_ROOT` -->
+<def tag="rails-root">
+  <%= RAILS_ROOT -%>
+</def>
+
+<!-- `RAILS_ENV` -->
+<def tag="rails-env">
+  <%= RAILS_ENV -%>
+</def>
+
+<!-- Which change management system is in use:  "git" "subversion" "other" -->
+<def tag="cms-method">
+  <%= if File.exist?("#{RAILS_ROOT}/.git")
+        "git"
+      elsif File.exist?("#{RAILS_ROOT}/.svn")
+        "subversion"
+      else
+        "other"
+      end -%>
+</def>
+
+<!-- the git branch currently in use -->
+<def tag="git-branch">
+  <%= File.basename(`git symbolic-ref HEAD`) -%>
+</def>
+
+<!-- the git version currently in use -->
+<def tag="git-version" attrs="dir">
+  <% dir=RAILS_ROOT if dir.blank? -%>
+  <%= Dir.chdir(dir) {`git rev-list "HEAD^..HEAD" --abbrev-commit --abbrev=7`} -%>
+</def>
+
+<!-- returns 'clean' if there are no modified files, 'modified' otherwise. -->
+<def tag="git-clean" attrs="dir">
+  <% dir=RAILS_ROOT if dir.blank? -%>
+  <%= Dir.chdir(dir) {`git ls-files -m`}.blank? ? "clean" : "modified"  -%>
+</def>
+
+<!-- the time & date of the last commit -->
+<def tag="git-last-commit-time">
+  <%= `git log "HEAD^..HEAD" --pretty=format:%cD` -%>
+</def>
+
+<!-- calls `git-clean` or `svn-clean` as appropriate.  `svn-clean` not yet written. -->
+<def tag="cms-clean">
+  <% method = cms_method.strip -%>
+  <git-clean if="&method=='git'"/>
+</def>
+
+<!-- calls `git-last-commit-time` or `svn-last-commit-time` as appropriate.  `svn-last-commit-time` not yet written. -->
+<def tag="cms-last-commit-time">
+  <% method = cms_method.strip -%>
+  <git-last-commit-time if="&method=='git'"/>
+</def>
+
+<!-- calls `git-version` or `svn-version` as appropriate.  `svn-version` not yet written. -->
+<def tag="cms-version">
+  <% method = cms_method.strip -%>
+  <git-version if="&method=='git'"/>
+</def>
+
+<!-- calls `git-branch` or `svn-branch` as appropriate.  `svn-branch` not yet written. -->
+<def tag="cms-branch">
+  <% method = cms_method.strip -%>
+  <git-branch if="&method=='git'"/>
+</def>
+
+<!-- Hobo::VERSION -->
+<def tag="hobo-version">
+  <%= Hobo::VERSION -%>
+</def>
+
+<!-- repeats on Rails.configuration.gems, including dependent gems -->
+<def tag="with-gems">
+  <% gems = ActiveSupport::OrderedHash.new -%>
+  <% Rails.configuration.gems.each do |gem|
+       gems[name] ||= gem
+       gem.dependencies.each do |dep|
+         gems[dep] ||= dep
+       end
+     end -%>
+  <repeat with="&gems">
+    <do param="default"/>
+  </repeat>
+</def>
+
+<!-- inside `<with-gems>`, returns the gem name -->
+<def tag="gem-name">
+  <%= this.name -%>
+</def>
+
+<def tag="gem-version-requirement">
+  <%= this.requirements.map{|l| l.first+l.second.to_s}.join(",") -%>
+</def>
+
+<!-- inside `<with-gems>`, returns the version required -->
+<def tag="gem-version-required">
+  <gem-version-requirement:version-requirements />
+</def>  
+
+<!-- inside `<with-gems>`, returns the version -->
+<def tag="gem-version">
+  <%= this.specification.version.to_s -%>
+</def>
+
+<!-- inside `<with-gems>`, returns 'frozen', 'installed' or 'missing' -->
+<def tag="gem-frozen">
+  <%= this.frozen? ? "frozen" : (this.installed? ? "installed" : "missing") -%>
+</def>
+
+<!-- inside `<with-gems>`, returns the gem dependencies -->
+<def tag="gem-dependencies">
+  <repeat with="&this.dependencies">
+    <%= this.name -%><gem-version-requirement:requirement />
+  </repeat>
+</def>
+
+<!-- repeats on the plugins used by the application -->
+<def tag="with-plugins">
+  <%  fi = Hobo::FakeInitializer.new(Rails.configuration)
+      plugins = Rails.configuration.plugin_loader.new(fi).plugins %>
+  <repeat with="&plugins">
+    <do param="default" />
+  </repeat>
+</def>
+
+<!-- within `<with-plugins>`, returns the plugin name -->
+<def tag="plugin-name">
+  <%= this.name -%>
+</def>
+
+<!-- within `<with-plugins>`, returns the plugin location (directory) -->
+<def tag="plugin-location">
+  <%= this.directory -%>
+</def>
+
+<def tag="plugin-git-clean">
+  <git-clean dir="&this.directory"/>
+</def>
+
+<def tag="plugin-git-version">
+  <git-version dir="&this.directory"/>
+</def>
+
+<!-- within `<with-plugins>`, try and determine the method that was used to install the plugin.   Returns "braid", "symlink", "git-submodule" or "other" -->
+<def tag="plugin-method">
+  <%= 
+      braids = File.open("#{RAILS_ROOT}/.braids") {|f| YAML::load(f) } rescue {}
+      if !braids[this.directory.gsub(RAILS_ROOT+"/", "")].nil?
+        "braid"
+      elsif File.lstat(this.directory).symlink?
+        "symlink"
+      elsif File.exist?(this.directory+"/.git")
+        "git-submodule"
+      else
+        "other"
+      end
+   -%>
+</def>
+
+<!-- within `<with-plugins>`, determine if the plugin has been modified, returning "clean" or "modified".   Returns a blank string if this information is not available.   Uses `<plugin-git-clean>` or `<plugin-braid-clean>` to do the heavy lifting. -->
+<def tag="plugin-clean">
+  <% method = plugin_method.strip -%>
+  <plugin-git-clean if="&method=='git-submodule'"/>
+  <plugin-braid-clean if="&method=='braid'"/>
+</def>
+
+<!-- within `<with-plugins>`, returns the plugin version.   Returns a blank string if this information is not available.   Uses `<plugin-git-version>` or `<plugin-braid-version>` to do the heavy lifting. -->
+<def tag="plugin-version">
+  <% method = plugin_method.strip -%>
+  <plugin-git-version if="&method=='git-submodule'"/>
+  <plugin-braid-version if="&method=='braid'"/>
+</def>
+
+<def tag="plugin-braid-clean">
+  <%= diff=`braid diff #{this.directory.gsub(RAILS_ROOT+"/", "")}`
+      diff.strip.empty? ? "clean" : "modified" -%>
+</def>
+
+<def tag="plugin-braid-version">
+  <%=  braids = File.open("#{RAILS_ROOT}/.braids") {|f| YAML::load(f) } rescue {}
+       b=braids[this.directory.gsub(RAILS_ROOT+"/", "")]
+       b['revision'][0...7] if b -%>
+</def>
+
+<!-- repeats on the available execution environments, which are usually 'development', 'test' and 'production' -->
+<def tag="with-environments">
+  <repeat with="&Rails.configuration.database_configuration.keys">
+    <do param="default" />
+  </repeat>
+</def>
+
+<def tag="environment-name">
+  <%= this -%>
+</def>
+
+<!-- Given an environment name in the context, return the database adapter -->
+<def tag="database-type">
+  <%= Rails.configuration.database_configuration[this]['adapter'] -%>
+</def>
+
+<!-- Given an environment name in the context, return the database name -->
+<def tag="database-name">
+  <%= Rails.configuration.database_configuration[this]['database'] -%>
+</def>
+
+<!-- repeats on available models.  Does not return models defined in libraries or plugins.  -->
+<def tag="with-models">
+  <%  # stolen from railroad/model_diagram.rb
+
+    files = Dir.glob("app/models/**/*.rb")
+    models = files.map do |file|
+      model_name =  (model_path = file.gsub(/^(app\/models\/)([\w_\/\\]+)\.rb/, '\2')).camelize
+      # Hack to skip all xxx_related.rb files
+      next if /_related/i =~ model_name
+
+      begin
+        model_name.constantize
+      rescue LoadError
+        oldlen = model_path.length
+        model_path.gsub!(/.*[\/\\]/, '')
+        model_name = model_path.camelize
+        if oldlen > model_path.length
+          retry
+        end
+        next
+      rescue NameError
+        next
+      end
+    end
+   -%>
+  <repeat with="&models.sort_by {|m| m.to_s}">
+    <do param="default" />
+  </repeat>
+</def>
+
+<def tag="model-name">
+  <%= this.to_s -%>
+</def>
+
+<!-- given a model, returns the table name -->
+<def tag="model-table-name">
+  <%= this.try.table_name -%>
+</def>
+
+<!-- given a model, repeats on the database columns -->
+<def tag="with-model-columns">
+  <repeat with="&this.try.content_columns">
+    <do param="default" />
+  </repeat>
+</def>
+
+<!-- given a column, returns the type -->
+<def tag="model-column-type">
+  <%= this.type.to_s -%>
+</def>
+
+<!-- given a column, return the name -->
+<def tag="model-column-name">
+  <%= this.name -%>
+</def>
+
+<!-- given a model, repeats on the associations -->
+<def tag="with-model-associations">
+  <repeat with="&this.try.reflect_on_all_associations">
+    <do param="default" />
+  </repeat>
+</def>
+
+<!-- given an association, return the name -->
+<def tag="model-association-name">
+  <%= this.name.to_s -%>
+</def>
+
+<!-- given an association, return the macro type (`has_many`, etc.) -->
+<def tag="model-association-macro">
+  <%= if this.macro.to_s=='has_many' && this.options[:through]
+        'has_many :through'
+      else
+        this.macro.to_s
+      end -%>
+</def>
+
+<!-- given an association, return the name --> 
+<def tag="model-association-class-name">
+  <%= (this.class_name.try.respond_to? 'underscore') ? this.class_name.underscore.singularize.camelize : this.try.class_name -%>
+</def>
+