Progress vs. Perfection

TDD: I am finally getting it

2008-12-12T11:30:00.000-08:00

My friend Mark and I have talked a lot in the past about doing more at unit testing. That's something I've really been focusing on lately and one of the things that has come out of it is that code written for unit tests is subtly different than code not. This became crystal clear to me just a moment ago as I was writing this code:

http://pastie.org/322821

The first way I wrote it was a somewhat untestable way of doing things: in order to test AllowPost my unit test had to know all about our configuration stuff and it just couldn't easily be tested without a bunch of dependencies. Of course, my unit test framework doesn't know about those dependencies without making it jump through a whole bunch of hoops. By re-writing it the second way, the method AllowPost was an atomic unit that could be tested without knowing about the other stuff.

Of course, I want some tests that cover "the other stuff", but that's at a higher level. First, I have to get the lowest levels of tests working before the higher level tests will, otherwise it's all spaghetti.

This may all be old news to you, but for me it really drove home the phrase "test-driven development"...in other words, the tests are actually shaping the code. Suddenly, it makes so much sense why, in order for TDD to be effective, you have to write the tests first. Otherwise, you may end up with code that isn't testable in terms of a unit test framework.

attachment_fu (with rmagick) on windows not working

2008-05-09T02:56:00.001-07:00

man, i had a heck of a time getting attachment_fu (using rmagick) on windows working tonight. let me just start with this: if you're having problems, just reboot. it would have saved me an hour.

i followed all the instructions and fixed all the hacks, yet for some reason thumbnails were not generating and the height and width was not being saved. there are lots and lots of articles out there on these topics. most of them discuss how the size isn't being saved, but in my case the size was being saved.

how'd fix it: i rebooted the machine and it worked.

How To Upgrade to Rails 2.0 from 1.2.5

2008-02-17T18:04:00.000-08:00

I had to upgrade my Rails app last night to 2.0.2 from 1.2.5. This is a brief overview of what it took to make it happen. I'll write some other posts soon with more details. A little background: I'm using InstantRails and the Aptana RadRails IDE on Windows XP SP2.

Here's what I did:

Installed Instant Rails 2.0.

Checked out a working copy of my code from SVN

Updated environments.rb: RAILS_GEM_VERSION = '2.0.2'

Fired it up: didn't work.

I'm using acts_as_tree and acts_as_list, so I needed to install those plugins.

Fired it up: didn't work.

I'm also using Comatose, and there was an error with the "template_root". Bottom line: after reading some message boards, etc. I removed and reinstalled the Comatose plugin and that fixed it.

Fired it up: didn't work.

Was getting this error:

Status: 500 Internal Server Error A secret is required to generate an integrity hash for cookie session data. Us e config.action_controller.session = { :session_key => "_myapp_session", :secret => "some secret phrase of at least 30 characters" } in config/environment.rb

Well, that message says it all, so I changed that.

Fired it up: was working. Now, navigated my app...errors.

Had to change ':dependent => true' to ':dependent => :destroy'

Removed the line(s) config/environments/development.rb:12: config.breakpoint_server = true
from configuration since the setting has no effect anymore.
Instead, start `script/server` with the "-u" or "--debugger" option (or "-h"
to see all the options). This wasn't causing an error, but while trying to figure out the dependent => :destroy thing, I read it on someone's blog, so I removed it.

Also, had to install the classic_pagination plugin. (Really, every blog out there says I should upgrade to will_paginate, but my blog is about progress vs. perfection. Old school pagination works for me for now, so I'll stick with it.)

Fired it up...everything running, but still some functionality isn't working. (Gee...I wish I'd writen *all* the unit tests. Okay, let's debug.)

Opened RadRails, imported existing directory into a project.

Got this error: rad rails "Cannot find gem for Rails ~>2.0.2.0:"...had to switch workspace because I installed the new Instant Rails and RadRails was still pointing at the old one. (Not an issue if you overwrite, but I'm running my concurrently.)

Hmmm...the server runs through Aptana RadRails, but debugger is slow as heck...turns out that I updated ruby-debug-ide when I updated gems and that un-checked the checkbox for using the fast debugger in the IDE. Also, had to install ruby-debug-base. (I don't think this was required before, but once I installed it the debugger worked.)

Whew, well, I haven't found my bug yet, but that's how far I've progressed. Hopefully this will help the next guy out.

Rails vs. ASP.NET (Really, Ruby vs C#)

2007-12-31T15:02:00.001-08:00

Where have I been...why the lack of posts: a) holidays, b) knee injury playing basketball (that required surgery to repair) has slowed me down, c) recently, I've started to work on a project where ASP.NET using C# was the requirement.

So, I haven't been working in Rails for a few weeks and it's been a few years since I've used ASP.NET or C#, so I've had to jump back into it a little to refresh myself.

Now, look, I'm not trying to start a religious war here: ASP.NET and Rails each have their own benefits and drawbacks. However, I would like to say this: for simple web sites Rails is so much easier.

Here's a simple example: I've got a URL stored in the database, such as http://www.mysite.com/foo/fee/foh.htm and I need to get the foh.htm (which isn't stored).

ASP.NET with C#

    public string FileName
    {
        get
        {
            char[] delim = { '/' };
            string[] a = this.Url.Split(delim);
            return a[a.Length - 1];
        }
    }

Rails with Ruby

  def filename
    self.url.split('/').last
  end

I'm sure I'm not the first person to make this comparison. I just felt compelled to speak out about the many moments during the day where it takes me several minutes longer to do something with ASP.NET and C# than Ruby and Rails.

How to Make Subversion via HTTP work with RailsMachine (and Capistrano)

2007-12-20T09:53:00.000-08:00

Last night I setup my site on RailsMachine. Overall, it was a very pleasant experience. One bugaboo that I ran into:

I have my Subversion repository setup using http, not svn+ssh. The repository is hosted at Joyent and I don't recall why I set it up this way, but there must have been a reason.

Anyhoo...so, I'm plugging away with RailsMachine and using Capistrano for the first time and it's all pretty sweet, except for I can't seem to access my svn repository. Cap would reach the point in the script where it made the HTTP request and I would see the HTTP authentication, but I had no way to type in my user/pass combo, and it would fail.

Long story short: RailsMachine requires that you run Cap using a user called "deploy", and those are the credentials that Cap passes via HTTP Authentication to the svn repository. So, I was able to get it to work by simply creating a user for my svn repository called "deploy" with the same password as "deploy" on my RailsMachine server. Everything works fine now!

more on attachment_fu on windows

2007-12-11T09:33:00.000-08:00

In my previous post about attachment_fu (with rmagick) on windows, I did something sort of silly in the #create action of my controller: Windows required a little time to catch up because the file system loaded the file slower that attachemnt_fu needed it. To solve that problem, I added "sleep 5" immediately before MyObject#save.

The problem with that hack is every time I need to #save I have to remember to insert the "sleep 5" hack. That's a mistake waiting to happen. So, I moved the sleep to the model, like so:


  class MyObject < ActiveRecord::Base
    def before_save
      sleep 5  ## <<-- pauses so Windows can catch up.  
    end
  end

It's much more logical that this code is part of the model because the delay is fundamentally a part saving the object, not a part of responding to an action.

This also address the notion of keeping your controllers skinny and your models fat. Jamis Buck blogs very eloquently about this notion here.

attachment_fu (with rmagick) on windows

2007-11-19T22:42:00.001-08:00

Today, I've been working to get attachment_fu working with rmagick on Windows. At first, it wasn't uploading the file properly and after much Googling implemented these changes to get it working.

1. I added a pause to my #create in order to allow Windows time to catch up. In short, Ruby is moving faster than the Windows file system, and it was trying to create a record for a file that didn't exist yet. Here's what I did:

  def create
    @upload = Upload.new(params[:upload])
    sleep 5  ## <<-- pauses so Windows can catch up.  Probably would be
             ## smart to make this something like sleep 5 if OS == Windows
             ## obviously, that's not the right syntax.
    if @upload.save
      flash[:notice] = 'Upload was successfully created.'
      redirect_to :action => 'list'
    else
      render :action => 'new'
    end
  end

I am fully aware that this is a hack, but it gets the job done.

2. I continued to get the error message "Size is not included in the list". Long story short, this is the error message attachment_fu returns when the file size exceeds the limit set in the model. In addition, it provides this message if no file is provided at all which is a duplicate error because validates_as_attachment is already doing a validates_presence_of against the size.

So, in order to create some better error messaging, and following the notions of how to hack a plugin from this blog post, I created a new plugin called attachment_fu_hacks and in init.rb added this code:

klass = Numeric
klass.class_eval do
  def to_human
    units = %w{B KB MB GB TB}
    e = (Math.log(self)/Math.log(1024)).floor
    s = "%.1f" % (to_f / 1024**e)
    s.sub(/\.?0*$/, ' ' + units[e])
  end
end

klass = Technoweenie::AttachmentFu::InstanceMethods
klass.module_eval do
  
  # overrides attachment_fu.rb:342 b/c to provide better error messages
  def attachment_attributes_valid?
   
    attr_name = :size
    enum = attachment_options[attr_name]
    val = send(attr_name)
    if !enum.nil? && !val.nil? && !enum.include?(val)
      err_msg = enum.end.to_human
      errors.add attr_name, "of file is too big (must be less than #{err_msg})"
    end
    
    attr_name = :content_type
    enum = attachment_options[attr_name]
    val = send(attr_name)
    if !enum.nil? && !val.nil? && !enum.include?(val)
      err_msg = enum.join(', ').gsub(/image\//, '.') unless enum.nil?
      errors.add attr_name, "is not supported (must be #{err_msg})"      
    end
  end
end  

klass = Technoweenie::AttachmentFu::ClassMethods
klass.module_eval do
  # overrides attachment_fu.rb:106 b/c i don't think it's necessary 
  # to evaluate size or content_type if there is no file
  def validates_as_attachment
    validates_presence_of :filename
    validate              :attachment_attributes_valid?
  end  
end

I recognize that there might be a more idiomatic Ruby way to write attachment_attributes_valid?, but I prefer this because it's very clear as to what's going on.

Issue with has_many and Array.empty?

2007-11-08T16:42:00.000-08:00

I've posted a narrative of my issue on the Google Rails Group:


/app/controllers/document_groups_controller.rb
  def show
    @document_group = DocumentGroup.find(params[:id])
    @journal = Journal.find(params[:journal_id])
    @document_group_templates = @document_group.document_templates
    @logger = RAILS_DEFAULT_LOGGER
    
    #
    # this is the money line: comment it out and @document_group_templates.empty?
    # is true in the view.  leave it in, and it's false.  true is correct.
    #
    @logger.debug "###### --->" + @document_group_templates.inspect
    #
    # it turns out that this triggers the SQL to be run by Rails that acutally
    # populates the @document_group_templates Array.
    #

    render :action => :show, :layout => 'ajax_div'
  end


/app/views/document_groups/show.rhtml
#
#@document_group_templates.empty? evaluates to true without the inspection above
#
<% if !@document_group_templates.empty? %>
# 
# now, what's interesting is that if i change this to 
#
#  if @document_group_templates.count > 0
#
# that also triggers the SQL to be run.  but, interestingly, #size does not 
# trigger the SQL.
#
 <ul>
 <% 
  @document_group_templates.each do |child| 
            %><li><%= link_to child.name, :controller => :template, :action => :show, :id => child.id %><%
  end
  %>
  </ul>
<% end %>

/app/models/document_group.rb
class DocumentGroup < ActiveRecord::Base
  has_many :document_templates, :order => :document_group_position
  acts_as_tree :counter_cache => true
end

/app/models/document_template.rb
class DocumentTemplate < ActiveRecord::Base
  belongs_to :document_group, :counter_cache => true
  acts_as_list :scope => :document_group, :column => :document_group_position
end

How to call render :partial properly

2007-11-05T13:59:00.000-08:00

At some point, you may be going bananas because you're getting this error:

NoMethodError in DocumentController#new
undefined method `include?' for :new:Symbol

and the problem is that you're doing this somewhere:
render :partial => :new
instead of this:
render :partial => 'new'

This error is spawned by the method partial_pieces in /ruby/lib/ruby/gems/1.8/gems/actionpack-1.13.3/lib/action_view/partials.rb:90 which is trying to figure out if the partial you're calling is in the directory of the current controller, or some other directory. Here's that code:

89      def partial_pieces(partial_path)
90        if partial_path.include?('/')
91          return File.dirname(partial_path), File.basename(partial_path)
92        else
93          return controller.class.controller_path, partial_path
94        end
95      end

The error comes from line 90. Seems like if this were inserted at line 89.5, then this problem could be handled more gracefully
partial_path = partial_path.to_s if partial_path.is_a? Symbol
given the fuzzyness of symbols and strings, it would seem to make sense to me.

How to Avoid and Infinite Loop with before_save and after_save

2007-10-29T17:45:00.001-07:00

I have an entity that looks something like this:

journal
  author_first_name
  author_last_name
  journal_name
  journal_email_address

where

journal_name = author_first_name + ' ' + author_last_name
journal_email_address = journal_name + '-' id

I had journal_name and journal_email_address implemented as attributes on the Journal model, but the time came along where, for various reasons, it has become valuable to also store that information in the database. So, what I thought I’d do, in app/models/journal.rb:

def make_journal_name
  self.journal_name = self.author_first_name + ' ' + self.author_last_name
end  

def make_inbound_email
  self.inbound_email = self.journal_name.gsub(/[^a-zA-Z0-9]/, '') + '-' + self.id.to_s
end
def before_save
  make_journal_name
  make_inbound_email
end

which works fine in the case of an update of an existing record. However, it does not work in the case of a creation of a new record because before saving self.id does not exist. The result was my e-mail addresses are looking like “SallyJones-” as opposed to “SallyJones-64”.

Okay, I thought, “since I need an ID to work with I’ll move this to after_save,” like so:

def after_save
  make_journal_name
  make_inbound_email
  self.save
end

but that creates an infinite loop.

The solution to this problem is to use an undocumented method: update_without_callbacks.

def after_save
  make_journal_name
  make_inbound_email
  self.update_without_callbacks
end

update_without_callbacks is an instance method on ActiveRecord::Base, but for some reason it’s undocumented. In fact, it explicitly has :nodoc set in the source, although I can’t figure out why. To me, it seems that having more documented is better than having less.

The Rails Way

2007-10-24T17:05:00.000-07:00

A big part of using Rails is understanding that if you conform to "The Rails Way" things are much easier. Of course, The Rails Way might not work for your project, and in that case, Rails might not be the right framework choice. But, you have to learn The Rails Way in order to know.

I can't claim to explain The Rails Way completely, but I've been helping a new (to Rails) developer on my team get up and running, so I've been having to coach him to see The Rails Way.

I started by talking about "entities". An entity is a thing like a "widget"...some object in our application domain that we need to represent. By convention, the names of the database table, unit tests, models, controllers, views, layouts and helpers must always coordinated in Rails to the name of the entity. So, with our "widget" entity, this is how they should be:

DB Table: widgets
Model: app/models/widget.rb
Controller: app/controllers/widgets_controller.rb
View: app/views/widget/...
Layout: app/views/layouts/widgets.rhtml
Helper: app/helpers/widgets_helper.rb

The beautiful thing about Rails is that by using generators, this gets managed for you. Here’s the approach I always take when creating an entity. This can be done through an IDE (such as RadRails, which is what I use) or on the command line...I’ll use the command line here:

cd path/to/rails/app
ruby ./script/generate model Widget which will generate your model file and your migration file with the proper table name.
Open up the migration, add the appropriate columns and save.
rake db:migrate to apply your migration to the DB.
ruby ./script/generate scaffold Widget which will create your controller, views, layout and helper.

Generators create a starting point to start editing, and it also gets all the file names correct. Let’s talk about the editing that needs to happen. Personally, I always do my editing in this order:

Migration
Model
Controllers
Views
Layouts

This makes the most sense to me because I’m starting with the raw data, and working my way forward to what the user sees on the web page.

A little background on controllers (a good article to read is this: http://www.softiesonrails.com/search?q=rest+101): Your standard CRUD controller has 8 actions:

Create (Create): /widgets/create
Show (Read): /widgets/show/:id
Update (Update): /widgets/update/:id
Destroy (Delete): /widgets/destroy/:id
New (precursor to create): /widgets/new
Edit (precursor to update): /widgets/edit/:id
List (lists all entities): /widgets/list
Index (the default action): /widgets

When, you generate your scaffold, it’s going to automatically generate the 8 actions above. When designing entities if you have methods that don't fit within one of those actions then it's typically an indication that your entity model could our should be designed differently.

(A great example of how it's all about entity design is the login and logout actions for a User. I was thinking the other day about where the login and logout methods belong because they make sense on a User, but they aren't one of the above eight actions. Of course, I was thinking about it all wrong: login and logout are really the Create and Destroy methods on the Session entity, and Session entities belong to a User.)

Finally, a note in regard to the relationships between views, controllers and models in the context of validation. The typical user pattern in relation to creating an entity is:

User visits /widgets/new page
Enters data, click submit.
/widgets/new POSTs to Widgets#create
Widgets#create puts the data in the DB, then (if you look at the scaffold generated controller)
- If success, calls redirect_to
- If fails, calls render :action => :new

Why in one case does it redirect, and the other does it render? It all has to do with a little method call that should appear in your new widgets view, i.e. /widgets/new:
<%= error_messages_for 'widget' %>
See, a model has the capability to validate it’s attributes (e.g. lookup validates_presence_of in the Rails docs for examples of these capabilities). When you call Object#save the validation routines are executed and if the model doesn’t validate (i.e. Object#save returns false) we render the new action again. error_messages_for looks up the failures and automagically renders error messaging.

The beauty of generators is that script/generate scaffold Widget sets all of this up for you.

The Problem with Rails Plugins

2007-10-18T09:29:00.000-07:00

The other day Mark asked if I was using active_scaffold. The answer is that I have a perfect use for it, and I installed it, and it works perfectly for what I need it for. However, it also overrides some core Rails functions, and when I execute functionality in my portion of the app the active_scaffold version of those functions are throwing exceptions. For example:

class ActionController::Routing::RouteSet 
  def generate_with_nil_id_awareness(*args) 
    args[0].delete(:id) if args[0][:id].nil? 
    generate_without_nil_id_awareness(*args) 
  end 
  alias_method_chain :generate, :nil_id_awareness 
end

Now, to me, ActionController::Routing::RouteSet seems like a pretty core function in Rails. Of course, it may be the case that I’ve done something wrong and their updated version is catching that error. (You can read more on that here: http://groups.google.com/group/activescaffold/browse_thread/thread/1c4e2f30e8b00ac6/309665c0a85d65c8).

However, my thinking is that I don’t need some plugin f’ing with my app. In fact, this points to a major issue with plugins…they’re not these self-contained units, i.e. components...but, rather, they are mixed in with the core Rails framework and our apps. This means we must think very carefully about which plugins we’ll use because, effectively, we need to know them as well as we know our own code. In other words, they are not black boxes...they are just code we import into our app that somebody else wrote (and is kind enough to share). For example, active_scaffold installs 138 files, and who knows how many kLOCs of code, and who knows what funky stuff they’ve done.

So, long story short, I’m not using active_scaffold because I don’t trust that there isn't come code in there that's gonna mess up my app, and it's too much code for me to review and become familiar with. Any ideas on an alternative?

I’ve looked at Streamlined, Hobo Scaffolding Extensions. According to the docs, Streamlined doesn’t do nested records editing which I require, Scaffolding Extensions handles nested record editing, but isn't the best UX, and Hobo has the same problem as Radiant CMS...I have to put my app into theirs, not their app into mine. (However, both Radiant and Hobo seem like nice platforms for the right project, just not the one I'm currently working on.)

What does "idiomatic Ruby" mean?

2007-10-12T10:19:00.001-07:00

From a chat with Mark today, in regard to reading a post where I used the word "idiomatic":

(10:10:42) Mark: idiomatic, what a word
(10:11:12) Scott Porad: yes, i don't even know what it means...but people 
say it when they mean, "there's a more clever way to write this in ruby".
(10:11:26) Mark: Peculiar to or characteristic of a given language.
(10:12:05) Mark: nice, one of the descriptions of idiomatic, uses idiomatic 
to describe it: Characterized by proficient use of idiomatic expressions

Acts As Authenticated and Reset Password

2007-10-11T16:45:00.001-07:00

Using Acts as Authenticated, imagine this use case:

User forgets password...has reset code sent to their e-mail.
User receives e-mail, clicks link to reset password.
User arrives on reset password page and thinks, "hmmm...I think I'll go visit the homepage instead".
User types http://www.yoursite.com/ in their browser (or clicks a link the header, or whatever).

What happens is that when the user clicks the link in the email it takes them to /account/reset_password which looks up their account by the reset code on the link (which was sent in the e-mail) and it logs them in. So, when they decide, "hmmm...I think I'll go visit the homepage instead," the user is now logged in, but has not reset their password.

To me, that seems to present a problem. So, I added a before_filter to my ApplicationController that verifies that all logged in users must have a nil password reset code otherwise they are redirected to /account/change_password. (The password reset code isn't cleared until after the user has successfully changed their password.)

In the ApplicationController I added:
before_filter :ensure_password_resetand

module AuthenticatedSystem
  def ensure_password_reset
    redirect_to :controller => :account, :action => :change_password unless reset_password_has_been_changed
  end
  
  def reset_password_has_been_changed
    if logged_in?
      if current_user.password_reset_code.nil?
        return true
      else
        return false
      end
    else
      true
    end
  end  
end

I'm certain that there is a more idiomatic Ruby way to write reset_password_has_been_changed, but I couldn't think of it.

Fixing a Blank Password Bug in Acts As Authenticated

2007-10-10T10:08:00.000-07:00

I came across a bug in Acts As Authenticated when users tried to change their passwords. If they submitted the form with nothing in the new or confirm new password text field, then no error was thrown, but the password wasn't changed either.

The problem was in the :if clause on the validates_presence_of validation, password_required?. It was causing the validation not to occur.

    def password_required?
      crypted_password.blank? || !password.blank?
    end

This code is saying that a password is required in two situations:

when the crypted_password is blank -- that situation happens when creating a new user, OR
when the class instance variable 'password' is not blank -- this can only happen when the variable has been accessed, such as when attempting to update a password.

The bug is in the test for !password.blank? because it's assuming that the user will enter something as a new password. To resolve that, I changed the code to this:

    def password_required?
      crypted_password.blank? || !password.nil?
    end

and now the validation is called (and fails) properly. More about this issue can be found in the last few posts on this page.

How To Make the Debugger Work with RadRails

2007-10-10T09:59:00.001-07:00

I've finally got the debugger working with Aptana's RadRails.

I've had the debugger working for awhile, but I was experiencing a problem where the current line, i.e. the current execution line, wasn't being highlighted. Actually, the source file of the current line wasn't being even opened.

After trolling around various messages boards, etc., I learned that the bug has been fixed in the latest beta version of RadRails. Here’s a post on how to do that: http://www.aptana.com/forums/viewtopic.php?t=2939

Personally, I had to manually add the update site in order to get it to work, although you might not have that experience. Of course, it took me awhile to figure out how to do this...here you go:

Go to Help > Software Updates > Find and Install

Select "Search for new features to install" and click "Next"

Click the button on the right for "New Remote Site"

Enter:
- Name: RadRails Beta
- URL: http://update.aptana.com/update/rails/beta/3.2/site.xml
Click 'OK'

Check the box next to "RadRails Beta"

Click the "Finish" button.

Now the update should download and install.

Where to put/store/save/keep your modules and files containing modules?

2007-10-04T01:59:00.000-07:00

To a Rails newbie, sometimes the simplest things are hard to figure out. Here's what you need to know:

When you create a module, you save it to your lib/ directory.

All the modules in the lib/ directory are auto-loaded by Rails. That is, Rails does something like this:

for file in lib/
   require file
end

Also, I think there is some magic to this, but I'm not 100% sure. If you have a module called MiscUtils then your file needs to be named misc_utils.rb in order for Rails to auto-load it.

Additionally, Ruby does this super-sweet thing where you can re-open any class or module and add to it at any time. In other words, you can declare a class or module in two locations, and Ruby will merge them together and treat them as one class. My experience has been that when you do this, then you need to explicitly require the files even if they're in the lib directory.

What is that hyphen right before the closing of an ERb block?

2007-10-03T11:36:00.000-07:00

Periodically, I see some ERb code in a view like this:


<% form_tag '/posts' do -%>     
    <%= submit_tag 'Save' %>
<% end -%>

In fact, that code was culled right from the Rails docs at for form_tag

As you can see, in those two ERb tags, there is this syntax at close of the tag:

-%>

Today I was wondering what the hyphen (-) was for before the percentage symbol (%). It turns out that the hyphen means that when the HTML output is generated there is no line return after the close of the ERb tag.

For example, the ERb code above produces this HTML:

<form action="/posts" method="post">    <div><input name="commit" type="submit" value="Save" /></div>
</form>

whereas this ERb code:

<% form_tag '/posts' do %>    
    <%= submit_tag 'Save' %>
<% end %>

produces this HTML:

<form action="/posts" method="post">
    <div><input name="commit" type="submit" value="Save" /></div>
</form>

How Mixins, Include and Extend Work

2007-10-01T20:53:00.000-07:00

I was a little puzzled tonight by this chunk of code that I found in the acts_as_authenticated plug-in module:

    def self.included(base)
      base.send :helper_method, :current_user, :logged_in?
    end

It comes down to some Ruby magic: when a module is included by a class the self.included method on the module is called. Likewise, when a class extends a module the self.extended method is called.

"base" is the class that includes/extends the module. "send" is calling the method ":helper_method" and passing ":current_user" and ":logged_in?" as parameters.

Special thanks to Juixe for an excellent article that helped me figure this out.

DRY Migrations (aka reverting or undoing earlier migrations)

2007-09-28T17:43:00.000-07:00

I have a case where I made some database changes in migration 001 and now I want to undo them in migration 005. This is different that actually rolling back to version 001 (i.e. rake db:migrate version=1)...I actually want to undo or revert what I did in 001. The obvious thing to do would be to simply have 005 do the opposite of 001, but that isn't very DRY.

Using a simple example, let's say my migrations were:

001_create_books.rb
002_create_libraries.rb
003_create_librarians.rb

and now my library is going electronic, so I do this:

004_create_e_books.rb
005_destroy_books.rb

In 005 I want to do the exact opposite of 001, so I did this:

class DestroyBooks < ActiveRecord::Migration
  def self.up
    CreateBooks::migrate(:down)
  end

  def self.down
    CreateBooks::migrate(:up)
  end
end

Custom Configurations and App Specific Settings

2007-09-27T13:39:00.000-07:00

One not immediately obvious Ruby on Rails configuration issue I came across is how to structure application-specific config parameters, and in particular, how to make them configurable/overridable across different environments (dev, test, production). This has been solved repeatedly in different ways by the Rails community and there's info scattered around but assimilating it took a while, here's what I've settled on for now.

I couldn't have said it better myself. I've now spent 4 hours researching the best way to do this...this is a basic feature of a web app, you'd think there would be a conventional way to create ..whatever you want to call them: custom configurations, application specific settings, application configs...in Rails.

At present, I've found four solutions...the one suggested by the above blogger, and these three others:

http://www.taknado.com/2007/7/25/custom-configuration-info-in-rails
http://jarmark.org/projects/app-config/
Use after_initialize method on the Rails::Configuration class. (Note: this is only semi-well documented...it's documented, but not included at http://api.rubyonrails.org. I found it here: http://edgedocs.planetargon.org/classes/Rails/Configuration.html#M002860)

In addition, I found these blog posts useful:

http://toolmantim.com/article/2006/12/27/environments_and_the_rails_initialisation_process
http://glu.ttono.us/articles/2006/05/22/guide-environments-in-rails-1-1

I haven't decided how I'm going to do this yet, but I hope you find this helpful.

UPDATE: I was exchanging e-mail from Jeff at softiesonrails.com who suggested this solution:

What I usually do is add it to the bottom of environment.rb. If I have RAILS_ENV-dependent data (like development mode vs. production mode), then just put the relevant Ruby code at the bottom of environments/development.rb, for example:

module MyConstants ALLOWED_NAMES = ['jeff', 'cookie monster'] IP_ALLOWED = '1.2.3.4' end
and then you can access them anywhere in your Rails code as MyConstants::ALLOWED_NAMES, etc.

If you prefer to move it to a file, you'd create a file named my_constants.rb in the /lib folder, and then explicitly require it from environment.rb:

require 'my_constants'

Reverting Migrations (self.drop) Issue

2007-09-18T17:31:00.001-07:00

I created an ran a migration today. Here is how my database looked to begin:


mysql> show tables;
+--------------------------------------+
| Tables_in_books_development          |
+--------------------------------------+
| journals                             |
| schema_info                          |
+--------------------------------------+
2 rows in set (0.00 sec)

mysql> select * from schema_info;
+---------+
| version |
+---------+
|      19 |
+---------+
1 row in set (0.00 sec)

Then, I ran this migration:


class CreateThemes < ActiveRecord::Migration
  def self.up
    create_table :themes do |t|
      t.column :name, :string
      t.column :stylesheet_path, :string
      t.column :thumbnail_path, :string
      t.column :journals_count, :integer, :default => 0
    end
    #add_column :journals, :theme_id, :integer
  end

  def self.down
    drop_table :themes
    remove_column :journals, :theme_id
  end
end

Notice how I have the add_column method commented out. Running Rake yields this:


C:\rails_apps\books>rake db:migrate
(in C:/rails_apps/books)
== CreateThemes: migrating ====================================================
-- create_table(:themes)
   -> 0.1200s
== CreateThemes: migrated (0.1200s) ===========================================

As you can see, the column is not added to the journals table. Here's what my database looks like now:


mysql> show tables;
+--------------------------------------+
| Tables_in_books_development          |
+--------------------------------------+
| journals                             |
| schema_info                          |
| themes                               |
+--------------------------------------+
3 rows in set (0.00 sec)

mysql> select * from schema_info;
+---------+
| version |
+---------+
|      20 |
+---------+
1 row in set (0.00 sec)

Well, I really need that column added to journals, so I better revert that migration via Rake, uncomment the add_column method, and re-Rake. Here's what happens:


C:\rails_apps\books>rake db:migrate version=19
(in C:/rails_apps/books)
== CreateThemes: reverting ====================================================
-- drop_table(:themes)
   -> 0.0500s
-- remove_column(:journals, :theme_id)
rake aborted!
Mysql::Error: Can't DROP 'theme_id'; check that column/key exists: ALTER TABLE journals DROP `theme_id`

(See full trace by running task with --trace)

Oops! The self.down method is crapping out because there is no column in journals called theme_id. (Of course, we knew that.) Let's checkout the database now:


mysql> show tables;
+--------------------------------------+
| Tables_in_books_development          |
+--------------------------------------+
| journals                             |
| schema_info                          |
+--------------------------------------+
2 rows in set (0.01 sec)

mysql> select * from schema_info;
+---------+
| version |
+---------+
|      20 |
+---------+
1 row in set (0.00 sec)

Do you see that schema_info still says version 20. I presume that the last thing a migration does is update the schema_info.version with the idea being that we don't modify the version until we sure that the migration has succeeded. The problem with that is that migrations aren't transactional--that is, they can complete or fail partially, yet the schema_info is updated as though it were a transaction. I don't know how Rails fixes this, but it's something worth knowing about.

Anyhow, at this point my database is in limbo...neither in version 19 nor 20. When I run

rake db:migrate

nothing happens because as far as Rake can tell, the DB is up-to-date. But, I can't run

rake db:migrate version=19

either because Rake will error out because there is no theme table to drop.

Okay, so the short-term solution to this problem is to clean-up the database manually. In my case, everything was actually reverted in the self.drop, but Rake doesn't know that. In your case you may have more manual clean-up to do. So, all I needed to do was update schema_info.version to 19.

Netscape Navigator 1.0

2007-09-17T13:37:00.000-07:00

I'm not getting much work done today...my desk and office are a mess, so I'm working at cleaning up.

While doing so, I found a bit of history in my desk, and you can have it.

Create Action Requires POST

2007-09-11T13:15:00.000-07:00

UPDATE: I wrote the whole post below, and then I figured it out...oy, the risks of auto-generated code. Typically, I use script/generate scaffold to build my controllers and views, then I start modifying from there. The risk of using auto-generated code is that you don't know every detail...and, if you're gonna own a program, you gotta know ever detail.

Long story short: I started digging around at .../verification.rb and I finally ended up back at my own controller and found this that scaffold sticks this bit of code in at the top of every controller:


  # GETs should be safe (see http://www.w3.org/2001/tag/doc/whenToUseGet.html)
  verify :method => :post, :only => [ :destroy, :create, :update ],
         :redirect_to => { :action => :list }

which is why I wasn't able call create with a GET. Yikes!

Boy, what a morning! I found a "feature" of Rails that I don't quite understand yet, but it certainly caused me a lot of headache. Maybe somebody else who is frustrated will benefit from this information.

Long story short: if you are going to call the create action in a controller, then you can only do so via POST. If you try to do so via GET you will get an error like the one below. In other words:


<html>
<body>
 Form with POST method --> works
 <form action="/books/create" method="post">
  <input type="submit" name="submit" value="submit">
 </form>

 Form with GET method --> does not work
 <form action="/books/create" method="get">
  <input type="submit" name="submit" value="submit">
 </form>
</body>
</html>

Apparently, Rails has some sort of before_filter that requires certain types of actions to be called via certain HTTP methods. (Note: I am not using any of the Rails RESTful stuff, e.g. map.resources.)

I have yet to figure out exactly what filter causes this requirement. Also, I would be interested in knowing if there is a way to inspect all the before filters that will be run for a given action or controller. If you know, please post in the comments.

Special thanks to Dirkjan for helping me debug this far.

From development.log

Processing BooksController#create (for 127.0.0.1 at 2007-09-11 10:53:22) [GET]
  Session ID: e042ea5ba771fd5423d39369ec8e1227
  Parameters: {"action"=>"create", "controller"=>"books", "journal_id"=>"1"}
Redirected to http://localhost:3005/books/list
Filter chain halted as [#<ActionController::Filters::ClassMethods::ProcFilter:0x47e198c @filter=#<Proc:0x0391ce4c@C:/InstantRails-1.7-win/InstantRails/ruby/lib/ruby/gems/1.8/gems/actionpack-1.13.3/lib/action_controller/verification.rb:74>>] returned false.
Completed in 0.01000 (100 reqs/sec) | DB: 0.00000 (0%) | 302 Found [http://localhost/books/create?journal_id=1]


Processing BooksController#list (for 127.0.0.1 at 2007-09-11 10:53:22) [GET]
  Session ID: e042ea5ba771fd5423d39369ec8e1227
  Parameters: {"action"=>"list", "controller"=>"books"}
  [4;36;1mBook Columns (0.010000)[0m   [0;1mSHOW FIELDS FROM books[0m
  [4;35;1mSQL (0.000000)[0m   [0mSELECT count(*) AS count_all FROM books [0m
  [4;36;1mBook Load (0.000000)[0m   [0;1mSELECT * FROM books LIMIT 0, 10[0m
Rendering  within layouts/books
Rendering books/list
Completed in 0.03000 (33 reqs/sec) | Rendering: 0.01000 (33%) | DB: 0.01000 (33%) | 200 OK [http://localhost/books/list]

How to use IRC for Ruby on Rails (#rubyonrails)

2007-09-10T16:36:00.000-07:00

14 years ago I used IRC to chat with people online about the Grateful Dead and Phish, but haven't since, and basically forgot about 99% of how it works.

Then, recently I wanted to join the #rubyonrails IRC channel to get some instant information, so from http://www.rubyonrails.com/community I learned that #rubyonrails was hosted at irc.freenode.net. I downloaded ChatZilla and tried to join.

Frustration. #rubyonrails requires some sort of nickname registration and it took me the longest time to figure out how the heck it works.

I searched for documentation and found all sorts, but what I was found was very dry and technical and full of details. Typically, I like that type of stuff--bare bones, just the facts.

But, here I needed the dummies course, and I found it at http://www.zymic.com/irc.php. I can't vouch for that site, but thank goodness they had some basic info...it wasn't 100% correct, but it got me close enough.

In ChatZilla > Preferences > General there is a "nickname" setting. When you connect to irc.freenode.net you need to register this nickname...obviously, it should be something sort of unique. (How to connect? Open Firefox and visit the URL irc://irc.freenode.net ...which should launch ChatZilla.)

After ChatZilla connects to irc.freenode.net, you will need to register your nickname, aka "nick". To register the nick, type:

/msg nickserv register <yourpassword>

where <yourpassword> is some password of your creation. This will register your nickname with some sort of central registration database.

Then, to enter the channel type:

/join #rubyonrails

On subsequent visits to IRC, ChatZilla will send your username to nickserv, but you will need to "identify" yourself this time. To do so, type:

/msg nickserv identify <yourpassword>

Then, join the channel like you did before:

/join #rubyonrails

Personally, I think of it like this:

register = create a login
identify = login
join = enter a chat room

Hopefully, these instructions will help someone else out along the way.

P.S. By the way, the delay between posts is explained by the fact that I was out of town for a few weeks visiting family.

Incorporation

2007-08-20T21:51:00.001-07:00

We incorporated our startup today...a small milestone on a long journey, so we took a picture to commemorate the moment.

HTML and Helpers

2007-08-20T16:56:00.000-07:00

Look at all this code. Yikes!

Even though, in theory, you're supposed to be allowed to put HTML in your helpers, the result is that you still end up mixing up all your presentation and business logic. Some people would argue that it's not possible to separate presentation and content. I'm not arguing either way...just trying to point out that it's easy to get these things intermingled.

Anyhow, what's going on here is that a document group has a bunch of document templates. Users will have filled out some templates--in which case the "instances" of those templates become documents--and in other cases they won't have filled them out.

Originally, I was just going to do a condition based on the existence of the document or not, but then I realized this edge case that somehow a user may end up with two documents based on the same template. I'm not sure how this would happen, but could happen easily, for example, if the user bookmarked the URL for the new document page for that document template.

I suppose I could make the new action check for the existence of a document using said template for the current user, and that would almost ensure this problem wouldn't happen...from the UI. What happens if data is added directly to the database? In fact, that's how I found this case...I accidentally loaded some test data twice and my original code crapped out.

Anyhow, in my view:



<% 
@document_group.document_templates.each do |child| 
    array_of_links_to_document_if_exists_from_template(child).each do |link| 
        %><li><%= link %></li><%
    end
end
%>

And in my helper:



  def array_of_links_to_document_if_exists_from_template(document_template)
    links = []
    documents = Document.find(:all, :conditions => { :journal_id => @journal, :document_template_id => document_template })
    if (!documents.empty?)
      documents.each do |document|
        links.push(link_to_remote(document.name, { :update => "dvMainPane", :url => { :controller => :documents, :action => :edit, :id => document }}))
      end
    else
      links.push(link_to_remote(document_template.name, { :update => "dvMainPane", :url => { :controller => :documents, :action => :new, :journal_id => @journal, :document_template_id => document_template.id }}))
    end
    links
  end

Is the helper the right place for business logic? I'm thinking right solution here isn't to put the logic in a helper...maybe helpers are really just rendering helpers...and that the logic should be in my model.

Navigating Associations in Scaffolding with Toffee

2007-08-16T10:32:00.000-07:00

My friend Mark suggested Toffee for dealing with navigating scaffold associations.

Haven't tried it yet, but on the surface seems to solve some of what I was discussing.

Creating Multiple Objects (of different Models) in one form.

2007-08-14T16:19:00.000-07:00

Yikes! Did I ever dig hole for myself, so let me tell you how I got out of it.

Long story short: I have a model architecture like this:

document
 |
 --> document_content_groups[]
     |
     -->document_contents

In other words, document_contents are name value pairs...think of them as questions (name) and answers (value). one or more document_contents are grouped into a document_content_group...think of that as a chunk of questions. in other words, a document_content_group has a collection of document_contents. then, a document has a collection of document_content_groups.

So, on a form where a user creates a new document really we're creating many things:

1 new document object
1 or more document_content_group objects
1 or more document_content objects

and, all of these must be associated with their parent properly.

On p. 499 the Rails book (Agile Web Development with Rails) it is suggested that something like this be done:

<% for_tag do %>
  <% for @product in @products %>
    <%= text_field("product[]", 'image_url') %><br />
  <% end %>
<% end %>

and what this syntax is supposed to do is make the ID of the object be inserted into the form "name" field, e.g. name="product_ID[image_url]". But (sharing this is the purpose of this post), this syntax does not work with a newly created object, it only works with editing existing objects. I solved the problem like this:


@dcg_index = 0
@dc_index = 0
for document_content_group in @document_content_groups %>
 <p><%= document_content_group.name %><br />
 <%= text_field("document_content_group", 'name', :index => @dcg_index) %></p>
  <% 
  for document_content in document_content_group.document_contents %>
   <p><%= document_content.name %><br />
   <%= hidden_field ("document_content", "document_content_group", :value => @dcg_index.to_s, :index => @dc_index) %>
   <%= hidden_field ("document_content", "name", :value => document_content.name, :index => @dc_index) %>
   <%= text_field("document_content", "value", :index => @dc_index) %></p>
   <% @dc_index += 1%>
  <% end %>
 <% @dcg_index += 1%>
<% end %>

Now, the result is that when the form is posted I get two hashes in the params: document_content_groups and document_contents each of which contains hashes representing the objects I want to create.

I can easily create the document_content_groups by passing those hashes in to create, but I have to do some munging on the document_contents to prepare them:


      @dcg_index = 0  # this must be the same initial index from the "new" form
      for document_content_group_hash in params[:document_content_group].values do
        document_content_group = @document.document_content_groups.create(document_content_group_hash)
        for document_content_hash in params[:document_content].values do
          if (document_content_hash["document_content_group"].to_i == @dcg_index)
            # this is removed from the hash because it's not really the document_content_group_id...
            # it's just a temporary ID that was used to group the items together from the _new form
            document_content_hash.delete("document_content_group")
            document_content_group.document_contents.create(document_content_hash)
          end
        end
        @dcg_index += 1
      end

Anyhow, not particularly pretty, but it gets the job done for now. Suggestions on how to make it more graceful are welcome.

Navigating Associations in Scaffolding

2007-08-08T23:14:00.001-07:00

In a scaffold generated list.rhtml only the content_columns are displayed. I modified that to show all columns, but the drawback is that for foreign keys you only see the ID, not any thing descriptive. That is, if I have books which belong_to authors, then what I see from the list.rhtml is author_id, not author_name.

I’ve been working to get around that because I can save a lot of time if the joins work magically. So, I wrote some code that basically looks at a column, if it’s an “id column”, then it walks the association to find the object. Once found, it looks for some logical text to display, and if none is found then defaults to the ID.

I've put the code below, but I can’t believe Rails doesn’t provide a way to do this automagically...it seems like something that would be used so often. Anyone?

Anyhow Scaffold makes this:

<% for document_content_template in @ document_content_templates %>
  
  <% for column in DocumentContentTemplate.content_columns %>
    <%=h document_content_template.send(column.name) %>
  <% end %>
  [... snipped show-edit-destroy ]
  
<% end %>

Which I’ve changed to this:

<% for document_content_template in @document_content_templates %>
  
  <% for column in DocumentContentTemplate.columns %>
    <%=h display_column_text(column, document_content_template) %>
  <% end %>
  [... snipped show-edit-destroy ]
  
<% end %>

With these helpers:

1  def display_column_text(column, object)
2    if column.name[-3, 3] != "_id" 
3      object.send(column.name)
4    else
5      value_from_join(column, object)
6    end
7  end
8
9  def value_from_join(column, object)
10   h = column.name.sub(/_id/, '')       # strip off the id
11   r = object.send(h)                   # get the object
12
13   if (defined? r.name != nil) 
14     r.name
15   elsif (defined? r.description != nil)
16     r.description
17   else
18     r.id
19   end
20 end

P.S. Yes, I realize there might be a bug on line 10.
P.P.S There’s actually a potentail bug on line 11 as well…what happens if you have a controller that’s like this:

belongs_to :model_name, :foreign_key => "some_other_id"

which will throw this error:

undefined method `some_other' for #<ModelName:0x47a8650>

UPDATE: the bug on line 11 can easily be handled like so:

begin                               # get the object
  r = object.send(h)                   
rescue
  return object.send(column.name)
end

Again, I can’t believe Rails doesn’t the magic to navigate around these objects more gracefully. Thoughts or comments anyone???

Perfection, Not Progress

2007-08-08T10:29:00.000-07:00

I wasted an entire day yesterday on :counter_cache => true. (Why was it wasted? Because I didn't need a counter cache yesterday, but knew that I would need it in a few weeks or months...progress versus perfection rears its ugly head again.)

Anyhow the problem ultimately had nothing to do with counter caching, but the error message didn't help too much, and there wasn't much in Google about the error message, so I spent a lot of time looking for the problem in the wrong place. Hopefully this post will help others in the future if you're getting this error message:

NoMethodError in Document content templateController#create undefined method `increment_counter' for Class:Class

Yesterday I was creating entities called DocumentTemplate and DocumentContentTemplate:

class DocumentTemplate < ActiveRecord::Base
  has_many :DocumentContentTemplates
end

class DocumentContentTemplate < ActiveRecord::Base
  belongs_to :DocumentTemplate
end

Then, I ran a quick script/generate scaffold on both of these, and modified the _form.rhmtl for DocumentContentTemplate in order to add the association to DocumentTemplate. Everything is working fine.

Next, I decide that I'm going to need a counter cache on the DocumentTemplate, so I modify the DocumentContentTemplate model and added the document_content_templates_count column to the document_templates table via migration:

class DocumentContentTemplate < ActiveRecord::Base
  belongs_to :DocumentTemplate, :counter_cache => true
end

Now, when I create a new DocumentContentTemplate the method DocumentContentTemplate#create should automatically increment the document_content_templates_count column in the document_templates table. But, when I submit the form that calls the create method I get this error:

NoMethodError in Document content templateController#create 
undefined method `increment_counter' for Class:Class

I spent hours debugging and investigating all the things related to counter cache, but it turns out that wasn't the problem. Go way back to the has_many and belongs_to declarations:

has_many :DocumentContentTemplates
belongs_to :DocumentTemplate

which, if you look carefully, should really be:

has_many :document_content_templates
belongs_to :document_template

So, if you're seeing that error, that's how to fix it. But, this raises two issues that I want to bring up:

1. My understanding is that the camel-case of a class name is supposed to be used when referring to the class, not an instance of it. For example, camelcase is used in a class definition or when the class is being used:

class DocumentTemplate < ActiveRecord::Base

DocumentTemplate.find(:all)

With that in mind, aren't the has_* and belongs_to methods referring to classes? Why don't they use the camelcase?

2. Regardless of the answer to #1, why does Rails handle this error gracefully? Why does has_*|belongs_to :ClassName not throw an error when it should be has_*|belongs :class_name?

REST

2007-07-24T12:44:00.001-07:00

Started designing my app last night. I had most of it in mind, so I just started hammering it out. I know, not the best way to do it, but sometimes you just have to get into the code.

A few days ago, I wanted to get more in sync with Rails and REST before, so I did some reading online. Something I enjoyed was this article (and the subequent parts) from SoftiesOnRails.com.

With REST fresh in mind, design goes really smoothly. There's only one place (yet) in my app where I'm feeling like I can't use one of the seven basic actions provided by a RESTful conroller.

It has to do with a "wizard" model where when a user is creating a new Widget we break it up into a few steps. So, I'm using the create action for the first page of the wizard, and then I guess I need to do some sort of update for the subequent pages. I'm not sure...haven't really researched it yet, but there must be a right way to do this.

RadRails and Scaffold-Migration Best Practice

2007-07-22T23:31:00.001-07:00

So, started tinkering again with Ruby on Rails tonight. It's been about a year since I last worked with RoR, so I wanted to familiarize myself with it again.

Fired up RadRails. Let me say that this has undergone vast improvement since I used it a year ago, and I would feel totally comfortable recommending it to anyone. I have been able to manage the entire development process from within the IDE: create and empty application, generate models, views, controllers, and migrations; instantiate, start and stopp servers; rake tasks, database management...so far, I can do everything through the IDE. I'm very impressed.

Then, I spent an hour or so screwing around with a little test app to re-familiarize myself with how the whole thing worked. An issue here and there, but generally speaking it all worked out well.

I'm still trying to get my head around the whole script/generate scaffold thing in relation to migrations. You have to setup the DB table before you can run script/generate scaffold. But, you have to run script/generate model to setup the migration and then run rake db:migrate. This seems feels like I'm doing something wrong because I thought script/generate scaffold is supposed to setup the model too. That's how it was a year ago, in pre-migration days. I have to figure out the best practice now...suggestions are welcome in the comments.

Aptana RadRails IDE and InstantRails

2007-07-20T08:36:00.001-07:00

So, I'm doing this new startup thing--can't tell you just yet what the thing is--from the very scratch and Mark asked me keep a blog about it. Here goes...

Yesterday was spent setting up my development environment. In short, this is composed of two things:

InstantRails
Aptana IDE with RadRails Plug-In

And the key is figuring out how to get the them to play nicely together. So far, I ran into only two glitches:

Installed InstantRails, then installed Aptana IDE, then installed RadRails Plug-In. But, the plug-in wasn't working which I could tell because it's configuration options weren't appearing in the preferences. From reading this post I learned that it turns out I needed to upgrade my Java JDK to 1.5+. Yay. Also, turns out you can't just easily upgrade from within the JDK 1.4 (what I had) Control Panel tool to the latest version. You have to uninstall, find the new package, install, blah...yay.

Got the RR Plug-In working, started reading the RR help documentation and it says there's some configurations that I need to setup. Even though the RR configs are appearing in the Aptana IDE prefs, the specific configs they mention are not to be found in the location where the screenshot in the docs say to look for them. Ug. Maybe the install didn't work...so, uninstall, re-install...everything. No luck. Some posts I read say don't install one sub-package of the RR plug-in (the Ruby Development Tools, RDT)...okay, uninstall, re-install without package...no luck.

Turns out, this was a bug in the documentation. The configurations had been moved to a new area of the preferences, but the documentation hadn't been updated. Oy!

Finally, This article on the InstantRails wiki describes how to configure RadRails so that they play nicely together. I set the configs and was all set. Hooray!

Note on the title: Progress vs. Perfection...what's it mean?
Some could interpret it as a form of saying quantity is preferable to quality, but that's not what it means to me. In my view, it's about staying focused on the goal while demonstrating respect for the Law of Diminishing Returns.

Just Do It!

2006-07-11T00:00:00.000-07:00

Which template should I use? Hmmm...don't know...doesn't matter. That's the whole point of this blog...to make decisions, and move on...without worrying about making a mistake.

Update, July 20, 2007: Just changed the theme...I wanted a serif font...easier on the eyes.