Ruby on Rails articles

facebook app for newbies

Tue, 18 Nov 2008 05:12:39 -0000

very detailed article on how to create facebook app using RoR. very nice, indeed.

found it through google terms: "rails facebook app tutorial"

double your mysql integer column capacity

Sun, 05 Oct 2008 00:42:48 -0000

By default, rails' migration create signed integer columns, which accept both positive and negative values. But in db design, 99% of time integer are used for storing foreign keys. by creating a plugin that override the mysql adapter, all integer column are automatically created with unsigned flag, so you gain twice the id capacity. sweet.

if you do want integer column with negative values, use :signed_int.


module ActiveRecord
  module ConnectionAdapters
    class MysqlAdapter
      # make pk unsigned
      NATIVE_DATABASE_TYPES = {
        :primary_key => "int(11) unsigned DEFAULT NULL auto_increment PRIMARY KEY".freeze,
        :string      => { :name => "varchar", :limit => 255 },
        :text        => { :name => "text" },
        :integer     => { :name => "int", :limit => 4 },
        :signed_int  => { :name => "int", :limit => 4 },
        :float       => { :name => "float" },
        :decimal     => { :name => "decimal" },
        :datetime    => { :name => "datetime" },
        :timestamp   => { :name => "datetime" },
        :time        => { :name => "time" },
        :date        => { :name => "date" },
        :binary      => { :name => "blob" },
        :boolean     => { :name => "tinyint", :limit => 1 }
      }
      
      # Maps logical Rails types to MySQL-specific data types.
      # by default, all integer type are unsigned, unless you use :signed_int in migration.
      #
      # http://dev.mysql.com/doc/refman/5.0/en/numeric-types.html
      def type_to_sql(type, limit = nil, precision = nil, scale = nil)
        return super unless type.to_s == 'integer' or type.to_s == 'signed_int' 

        result = case limit
        when 1; 'tinyint'
        when 2; 'smallint'
        when 3; 'mediumint'
        when nil, 4, 11; 'int(11)'  # compatibility with MySQL default
        when 5..8; 'bigint'
        else raise(ActiveRecordError, "No integer type has byte size #{limit}")
        end
        
        result += " unsigned" unless type.to_s == 'signed_int'
        result
      end      
    end
  end
end

plugin sets relative session expire time

Sat, 12 Jul 2008 19:51:17 -0000

This plugin sets the session cookie expiration in relative time, not fixed time as default rails does, very nice.

Asynchronous Processing (messaging) with Ruby on Rails

Thu, 26 Jun 2008 17:48:23 -0000

meat from slides

General purpose: Bj
Distributed processing: SQS
Speed + scalability: Starling, Workling (workling article)
background-fu

workling's readme pretty much blasted all its alternatives as crap. hehe.

and of course ror's wiki page.

What's new in Rails 2.1

Wed, 25 Jun 2008 18:56:42 -0000

all in this PDF

starting with GIT

Thu, 19 Jun 2008 01:10:13 -0000

Git magic, a very comprehensive tutorial, almost like SVN's redbook.

rails performance development

Wed, 18 Jun 2008 19:29:12 -0000

Ruby on Rails wiki page

tools

articles

Customize munin
tutorial on ruby-prof
Hodel 3000 logger works with pl_analyze, rails default logger doesn't. :(

how to freeze rails

Mon, 10 Mar 2008 01:41:19 -0000

upgrading this app, but there're many other old apps still on rails 1.2.x. so I need to freeze rails for this app. way to do it is to

rake rails:freeze:edge TAG=rel_2-0-2

you can lookup rails edge revision and tag numbers from rails' svn

Keeping up with DHH

Thu, 03 Jan 2008 14:32:16 -0000

rails sure evolves fast, now upto version 2.0.2. But I still have boat load of apps running on 1.2.x, spend quite sometime to update all the code and lock down the rails gem version to pre 2, so I can upgrade to latest rails for new apps.

It's sure hard to keep up with DHH.

If you've put "RAILS_GEM_VERSION = '1.2.5' unless defined? RAILS_GEM_VERSION" or frozen rails gem into your old app to 1.2.5 or 1.2.6, and when you run script/server, and get cryptic error like

/usr/lib/ruby/site_ruby/1.8/rubygems.rb:246:in `activate': 
can't activate activesupport (= 2.0.2), already activated activesupport-1.4.4] (Gem::Exception)

Most likely you're missing some gem. run script/console to find the missing gems.

Better solution is to allow your rail apps to define all gems dependencies, and install it automatically.

Rails 2 is near

Thu, 15 Nov 2007 02:36:35 -0000

On Nov 9th, David announced the availability of Rails 2 RC 1. Time sure flies.

To see notable features in rails 2, check out RoR blog.

merb is da bomb!

Thu, 29 Nov 2007 15:34:11 -0000

Today I discovered Merb, and it definitely is da bomb class stuff!

What is it? It's a rails like MVC framework without the sucky parts.

The problem with rails is, although convention over configuration is generally a good thing, but sometimes it's hard to draw the line where it is. Merb don't do lots of things for you automatically like rails, so you have the freedom to do things in your own unique way.

Notable features of merbs are:

Pluggable ORM

When you generate a new app, it doesn't assume you're using a DB. so merb can be used to create app without DB need, and server management frontend, cron job admin, etc. Even if you need to use ORM, you have the choice to use activereord, or other ORM I've never heard of, like Datamapper, Sequel.

Manual rendering

Rails' action automatically calls render method for you. This pose some problems, you can't render multiple times or you get double render exception; you can't have nested layout, although people did create nested_layout plugin to work it around.

In merb, you have to call render manually. which just returns the output text as result. want nested layout? then render with different layouts as many times as you want, in situations like you want to provide theme support. As said in ancient Chinese proverb, 进一步，山穷水尽；退一步，海阔天空。(One step forward, you're stuck in nowhere; one step back, there's world of possibilities).

Rails has something similar method called render_to_string, in merb, it's first class citizen.

Plugin dependency

If you've been working with rails for awhile, then you know how much rails plugin suck. There's no plugin dependency, I see people either copy all plugin B code into plugin A if A needs B, or rename plugins since rails loads plugins alphabetically. Note, rails do allow you to configure plugin loading order now.

In merb, plugin is just a gem, multiple versions and dependency are all built in.

Summary

To give credit to rails, merb did "steal" lot of code from rails, but the framwork has vastly different approach. Merb tries to stay agile, a micro framework, yet provides support to allow component builders to add functionality easily.

Merb's tool and coding syntax usage are very similar to rails, so rails developer should be able to learn and use it without much difficulty.

For all rails developers, it's definitely something to dive into.

trivia

One thing intrigues me is that merb is on the domain merbivore.com, not merb.com. After some poking around, then I found out merb.com's owner wanted either $25000 lum sum or $500 monthly rent for use of the domain. No love for open source. :(

Add theme support to rails app

Wed, 24 Oct 2007 18:25:10 -0000

If you want to add theme support to your rails app, easiest way is to use Matt McCray's theme_support plugin. just do "script/plugin install http://mattmccray.com/svn/rails/plugins/theme_support/" to get it.

1. The Problem

But it doesn't work out of box. when you start the server, you'll get error like:

theme_app/vendor/plugins/theme_support/lib/patches/routeset_ex.rb:27:in `create_theme_routes': 
undefined method `named_route' for #<actioncontroller::routing::routeset:0xb74da758> (NoMethodError)
        from theme_app/vendor/plugins/theme_support/lib/patches/routeset_ex.rb:13:in `draw'
        from ./script/../config/../config/routes.rb:1
        ...

Since the last update of the plugin was April 2006, and now is Oct 2007, so changes of rails internal must made the plugin incompatible. On Matt's blog, someone suggested a workaround, to change the route function calls in plugin's route patch (lib/patch/routeset_ex.rb). But I choose to take a more conservative approach, not to patch routing at all.

2. The Fix

So here are the changes I made to the plugin to make it futureproof.

Disable routing patch. comment out "require 'patches/routeset_ex'" line in theme_support/init.rb

Add theme routes into config/routes.rb


   map.theme_images "/themes/:theme/images/*filename", :controller=>'theme', :action=>'images'
   map.theme_stylesheets "/themes/:theme/stylesheets/*filename", :controller=>'theme', :action=>'stylesheets'
   map.theme_javascript "/themes/:theme/javascript/*filename", :controller=>'theme', :action=>'javascript'

   map.connect "/themes/*whatever", :controller=>'theme', :action=>'error'

Now start the server, and it shall work.

3. Usage

To create a new theme, do "script/generate theme YOUR_THEME_NAME", see plugin's readme for more usage.

4. Related pages

http://code.google.com/p/rails-multisite/
http://wiki.rubyonrails.org/rails/pages/View+Extensions if it's not down.

How to config plugin classes in dev/test/prod env file

Tue, 16 Oct 2007 23:02:59 -0000

Most of plugins set initial configuration values in default environment.rb file. What if you've written a plugin, and you want to set different config values in each environment, in RAILS_ROOT/config/environments/XXX.rb? You can't do that directly.

For example, If you have a Widget class in your plugin, and you want to set Widget.param=123 in test.rb, what you get is a big fat class not found error, like

/usr/lib/ruby/gems/1.8/gems/activesupport-1.4.2/lib/active_support/dependencies.rb:266:in
 `load_missing_constant': uninitialized constant Widget (NameError)

The reason for that is when rails is starting up and processing each environment file, it hasn't load any plugins yet, so it doesn't know about your plugin classes. When I searched the web for solutions, people tried modifying rails initializer or other similar crazy stuff.

The solution is quite simple, just do it afterwards.

at the end of my environment.rb, just add require File.join(File.dirname(__FILE__), "environments/#{ENV['RAILS_ENV'] || 'test'}_post_init")
"|| 'test'" part is need for rake. then put your plugin configuration code in environments/test_post_init.rb, development_post_init.rb, and production_post_init.rb

If any of the config values are used in config/routes.rb, make sure to copy that line in the beginning of routes.rb file too.

Use Capistrano to deploy your own private gem.

Tue, 16 Oct 2007 23:02:59 -0000

Jeffrey Allan Hardy has written a guide about how to deploy public gems. Now what if you have your own private gems, and you like to deploy them as easily as deploying a rails app, what do you do? Use capistrano. This articles shows how to use Capistrano to deploy your own private gem.

You gem should have existing tasks called "gem" and "install_gem", you can get them automatically if you use new_gem to generate your new gem (that's a mouthful). On another thought, new_gem should be renamed to "gem_gen", sounds alot cooler and less confusing.

1. Write cap tasks

in your gem project folder, create 2 files, "capfile", and "gem_deploy.rb".

capfile should be looks like this:

load 'deploy' if respond_to?(:namespace) # cap2 differentiator
load 'gem_deploy'

and gem_deploy.rb should have following

# to deploy this gem, check out first, then
# 
# cap deploy:setup
# cap deploy:update_code
# 
# 
# === reference ===
# install standard gem
# http://www.quotedprintable.com/2007/3/16/installing-gems-with-capistrano

#ssh_options[:verbose] = :debug 
set :synchronous_connect, true    # without this, upload task will hang

role :lib, "mysite.com"

set :application, "my_cool_gem"
set :repository,  "svn://my/gems/#{application}/trunk"
set :deploy_to, "/home/dorren/temp/#{application}"
set :user, "dorren"
set :deploy_via, :copy


namespace :deploy do
  desc "build and install gem by using rake"
  task :finalize_update do    
    # -S accepts password from stdin instead of terminal, see man sudo"
    cmd = "-S ls && cd #{current_release} && rake gem && rake install_gem"
    sudo cmd do |channel, stream, data|
      print data if stream == :out
      channel.send_data($stdin.gets) if data =~ /^>\s/
    end
  end
end

2. Deploy

cap deploy:setupwill setup temporary staging folder.
cap deploy:update_code will install the gem.

3. troubleshooting

Q: I get error, "<me> is not in the sudoers file." when deploying.
A: I just added myself into the sudoer group which resolved the problem.

Same problem, 17 lines in java, 3 lines in ruby

Tue, 16 Oct 2007 23:02:59 -0000

write a program to produce the following output:
1 A
2 BB
3 CCC
......
25 YYYYYYYYYYYYYYYYYYYYYYYYY
26 ZZZZZZZZZZZZZZZZZZZZZZZZZZ
27 012345678901234567890123456

In java, this is probably what most of programmers do:


 public class Text {
  public static void main(String args[]) {
    int x = 0;
    for (char c = 'A'; c <= 'Z'; c++) {
      x++;
      System.out.print(x + " ");
      for (int i = 0; i < x; i++) {
        System.out.print( c );
      }
      System.out.println();
    }
    System.out.print(x + 1 + " ");
    for (int i = 0; i <= x; i++) {
      System.out.print(i % 10);
    }
  }
}

In ruby it only takes 3 lines

n = ?A - 1
(1..26).each do |i| puts i.to_s + " " + (i+n).chr*i end
puts "27 " + (0..27).collect{|i| i%10}.to_s

Some rubyism for people not familiar with ruby.

# some ruby language functions
#
# ?<x> return the ASCII code of the character
# ?A => 65
# ?B => 66
# ?\n => 10 backspace ASCII code is 10
#
#
# <n>.chr returns the character from given ASCII code
# 65.chr => "A"
# 66.chr => "B"
# 10.chr => "\n"
#
#
# <str>*<n> multiplies given string n times.
# "ABC"*2 => ABCABC
#
#
# ruby use "#{var}" syntax to print variable in a string
# x = "abc"
# puts "output: #{x}" => "output: abc"

But you can combine the character and number printing together in one loop. try it.

Be_taggable, the commercial ;)

Tue, 16 Oct 2007 23:02:59 -0000

Be_Taggable, the commercial ;)


=== acting troupe
actor1 (be): be_taggable, need to be hot and attractive.
actor2 (acts): acts_as_taggable, need to be anyone but hot and attractive.

=== scene 1
acts: Hi, my name is acts_as_taggable.
be:   Hi, my name is be_taggable.
acts: hmmm... never heard of.
be:   That's ok, I can do what you do, but much easier and efficient.
acts: oh yeah? how so?
be:   my name has only 11 letters, 5 less than yours, a 31.25% improvement.

*Acts laugh hysterically*
acts: wow, I'm really impressed.
be:   *unfazed, continues calmly*
      I have just 67 lines of code, 1/10th of your size.

*Acts looking suspiciously at Be for a few seconds*
acts: can you tag any models?
be:   yes, without creating additional join tables.
acts: can you find by tags?
be:   you mean Tag.find_by_name ? yes, you can find by tags, by model class,
     by count, or any combination of it.

*Acts's face gets red*
be:   plus for model tables, I added tags_cache column to reduce DB traffic.
be:   Run 3 shell commands will get you started right away, no need to create
     tables by hand.

*Acts faint and fall back onto the ground*
be:   Did I say too much?


*Camera zoom out, blurs*
*Display URL http://railers.rubyforge.org/be_taggable *

Many thanks to acts_as_taggable. be_taggable becomes small by standing on the shoulder of acts_as_taggable giant.

Be_taggable plugin, 1/10th size of acts_as_taggable

Tue, 16 Oct 2007 23:02:59 -0000

Meet be_taggable plugin

Originally I planned to use the Acts_as_taggable gem, then i check out the code, and just can't accept how can simple tagging takes 675 lines.

So by "borrowing" code from that gem, I've created be_taggable plugin, major improvements:

The name Be_taggable is 5 letters less, or 31.25% more efficient.
BeTaggable module weights 67 lines, compare to 675 lines, a whopping 90% improvement.
Built in tags_cache column to reduce DB traffic.
Simple installation, run 3 commands and you‘re ready to tag and roll.

Install

svn export http://railers.rubyforge.org/svn/plugins/trunk/be_taggable
script/generate be_taggable_tables Article Bookmark ... # models to be tagged
rake db:migrate

Usage

  Class TestBook
    be_taggable  # Mark your class be_taggable.
    ...
  end

  book = TestBook.create(:name => "AWDWR")
  book.tag("programming, rails")       # 2 tags added
  book.tag("agile,       rails")       # "programming" removed,
                                         "agile"       added,
                                         "rails"       untouched.

  hash = TestBook.tags_count     # {"rails" => 1, "agile" => 1}

  book.tag("")                         # remove all tags.

  TestBook.find_tagged_with("rails")  # return list of matching book objects.
  TestBook.find_tagged_with("rails", :offset => 20, :limit => 10)  # search with options.

and in template


# To display model‘s tags from tags_cache column.

      <% for tag in YAML::load(article.tags_cache) %>
        <%= link_to(tag, tagged_articles_path(tag))  # assume route exists %>
      <% end -%>


# To show tag cloud
    <table>
    <% Article.tags_count.sort.each{|pair| %>
      <tr>
        <td><%= link_to(pair[0], tagged_articles_path(pair[0])) %></td>
        <td><%= pair[1] # count %></td>
      </tr>
    <% } %>
    </table>

Reference

Documentation: http://railers.rubyforge.org/be_taggable/
Code: svn export http://railers.rubyforge.org/svn/plugins/trunk/be_taggable

Simple code for playing card

Tue, 16 Oct 2007 23:02:59 -0000

Simple code to implement playing card. In case you want to build an online casino with Ruby on Rails, you got a head start. :)

class Deck
   COLOR = %w(S H D C)  # Spade Heart Diamond Club
   POINT = %w(2 3 4 5 6 7 8 9 10 J Q K A)
   attr_accessor :cards
   
   def initialize
     @cards = []
     COLOR.each{|c| 
       POINT.each{|p| 
         @cards << Card.new(COLOR.index(c), POINT.index(p))
       }
     }
     self
   end
   
   def shuffle
     52.times{|i| r = rand(52); @cards[i], @cards[r] = @cards[r], @cards[i]}
   end
   
   def sort
     @cards.sort!{|x, y| x <=> y}
   end
   
   def to_s
     @cards.collect{|c| "#{COLOR[c.color]} #{POINT[c.point]}"}.join("\n")
   end
end

class Card
  attr_accessor :color, :point
  def initialize(color, point)
    @color, @point = color, point
  end
  
  def <=>(obj)
    color == obj.color ? obj.point <=> point : color <=> obj.color
  end
end

deck = Deck.new
deck.shuffle
puts "\n----shuffle-----\n#{deck}"
deck.sort
puts "\n----sort-----\n#{deck}"

Ruby on Rails articles

facebook app for newbies

double your mysql integer column capacity

plugin sets relative session expire time

Asynchronous Processing (messaging) with Ruby on Rails

What's new in Rails 2.1

starting with GIT

rails performance development

tools

articles

how to freeze rails

Keeping up with DHH

Rails 2 is near

merb is da bomb!

Pluggable ORM

Manual rendering

Plugin dependency

Summary

trivia

more problem and hacks in theme_support plugin

Updates, ActionView::TemplateError check

Add theme support to rails app

1. The Problem

2. The Fix

3. Usage

4. Related pages

How to config plugin classes in dev/test/prod env file

Use Capistrano to deploy your own private gem.

1. Write cap tasks

2. Deploy

3. troubleshooting

Same problem, 17 lines in java, 3 lines in ruby

Be_taggable, the commercial ;)

Be_taggable plugin, 1/10th size of acts_as_taggable

Meet be_taggable plugin

Install

Usage

Reference

Simple code for playing card