Gems 有很多， 不过这些都是精华!

　　capistrano

　　Capistrano 是 Rails 应用程序开发更加从容。 它还是一个用来和远程服务器交互的聪明的 framework 。 事实上我已经备份了用 Capistrano 写的代码， 作为 Rake/Net::SSH 或者 shell 代码之外的另一个选择。

　　chronic

　　rubyforge.org/”>Chronic 是一个自然语言分析器， 它的名字是个俏皮的双关。

　　>> Chronic.parse(’3rd wednesday in november’)=> Wed Nov 19 12:00:00 0000 2008ferret

　　Ferret 会让你的老板、客户爱死你。 它提供了快速文本查询的工具， 你甚至可以可以给 PDF 文件和 Office 文档加索引。 我已经在很多网站上使用 Ferret 了， 我的客户们都说：“ 哇， 这看起来像 Google!”

　　hpricot

　　hpricot 是一个快速、容易上手的 HTML 分析器。 如果你发现自己需要解析 HTML 抑或 XML 的内容， hpricot 是最简捷的方法之一。 事实上我在 Helipad 中的很多地方使用了这个工具。

　　rcov

　　rcov 是使你的程序不经常崩溃的理由之一。 它分析你的代码， 高亮显示你的测试代码遗漏的部分。 它速度快， 不占资源， 并且能减轻头痛 ：)

　　scruffy

　　我一直用 Gruff 来画图， 不过当 scruffy 很完善的时候， 我更喜欢 rubyforge.org/”>scruffy API 的设计。 它工作的方式非常精妙： 产生简单的 XML 来驱动 SVG 图。 因为 SVG 提供了一直直观地处理原始图片的方式， 你可以丢掉那些大量杂乱难懂的代码了。

　　我经常继承和重写 scruffy 来做成各种精巧的图片， 如果你觉得你现在用类库不太灵， 何不试试 scruffy 呢。

　　simple-rss

　　rubyforge.org/”>simple-rss 分析 RSS 和 atom feed， 干的又快又好。 它的分析器也容易扩展， 这样你就可以应付那些无效的或专有的 feeds。

　　thin

　　Thin 使用 EventMachine， Rack 和 Mongrel 来创建一个快速的 web server。 我用它来做 Rails 的本地开发， 它比 mongrel 稍快。 要在我的 Rails 程序中使用它， 只需要在我的程序目录下输入 thin start 就行了。 当时我的 thin 和 IE cookies 之间有点儿冲突， 要记得如果你也遇到同样的问题， 你的程序可能有麻烦。 (说明: 这个问题在 thin 0.6.1 和 Rails 2 环境下好像修正了。)

　　要安装 thin， 使用 gem install thin 命令。

　　turn

　　Turn 使你的 Test::Unit 输出更易读。 Turn 也行看起来不那么招人喜欢， 但它确实对阅读测试结果有很大帮助。 在维护 Helicoid 的时候我对测试严重依赖， 所以任何能使这项工作变得更简洁的东西我都乐于尝试。

　　要安装 turn， 使用 gem install turn 命令。

　　wirble

　　wirble 使 irb 用起来更简单。 你有更好的对 history 的支持(在 session 间)以及颜色， 所以在繁重的工作中，你的眼睛和手指能得到休息。

ruby的解析器性能是很糟糕的，ruby早期的主要用途是取代perl写批量处理的脚本的，并不是为服务器应用编写的，因此在内存分配策略上非常不适合服务器应用。Stefans Kaes编写了一个ruby GC的补丁文件，在railsbench下载包里面提供了。虽然当前Railsbench提供的GC补丁只有针对ruby 1.8.4和1.8.5版本的，但是在ruby 18,6上面使用1.8.5的GC补丁也完全没有问题。GC补丁的作用主要是针对Rails应用开大了ruby的内存堆，可以有效提高内存堆的利用率，降低GC的频率。根据Stefans Kaes提供的测试数据，打补丁并且调整参数以后，GC的频率下降到只有原来的1/10还不到。降低GC频率尽管并不能够提高单个请求的执行速度，但是可以增加整体应用的负载能力。

JavaEye的服务器上也使用了GC补丁，并且根据推荐参数进行了调整。在使用GC补丁之后，Web服务器的CPU负载下降了大概15%左右，效果非常显著。当然开大内存堆的代价就是ruby进程会多消耗内存，在我们的服务器上，ruby打补丁之后多消耗了50%左右的物理内存。

——

1.1 创建Rails应用程序
$ rails [_VERSION_] app_name
可选项:
VERSION: 指定rails的版本(如果安装了多个rails版本),VERSION前后各加一下划线, 如”_1.2.6_”
-d, database=xxx 指定安装一个数据库(mysql oracle postgresql sqlite2 sqlite3 ), 默认情况下是数据库
-r, ruby-path= 指定Ruby的安装路径,如果没有指定，scripts使用env去找Ruby
-f, freeze (冻结)freezes Rails在vendor/rails目录

1.2 API Documentation
$ gem_server
启动一个WEBrick服务器。这时候你可以通过Http://localhost:8808/ 打开浏览器去查看rails API文档

1.3 Rake
rake db:fixtures:load
# 载入fixtures到当前环境的数据库
# 载入指定的fixtures使用FIXTURES=x,y

rake db:migrate
# 迁移数据库通过在db/migrate目录下的脚本.可以指定版本号通过VERSION=x
——-

* db:charset 检索当前环境下数据库的字符设置
* db:collation 检索当前环境下数据库的校对
* db:create 用config\database.yml中的定义创建当前 RAILS_ENV 项目环境下的数据库
* db:create:all 用config\database.yml中的定义创建所有数据库
* db:drop 删除当前 RAILS_ENV项目环境中的数据库
* db:drop:all 删除所有在 config\database.yml中定义的数据库
* db:reset 从db\schema.rb中为当前环境重建数据库（先删后建）.
* db:rollback 回滚(清华出版社一本SQLSERVER书的名词[很奇怪为什么不直接用滚回])数据库到前一个版本. 指定回滚到哪一步要用 STEP=n 参数
* db:version 检索当前模式下的版本
——-

rake db:schema:dump
# 创建一个db/schema.rb文件，通过AR能过够支持任何数据库去使用

rake db:schema:load
# 再入一个schema.rb文件进数据库

rake db:sessions:clear
# 清空sessions表

rake db:sessions:create
# 用CGI::Session::ActiveRecordStore创建一个sessions表为用户

rake db:structure:dump
# 导出数据库结构为一个SQL文件

rake db:test:clone
# 重新创建一个测试数据库从当前环境数据库中

rake db:test:clone_structure
# 重新创建测试数据库从开发模式数据库

rake db:test:prepare
# 准备测试数据库并在入schema

rake db:test:purge
# 清空测试数据库

rake doc:app
# 创建HTML文件的API Documentation

rake doc:clobber_app
# 删除Documentation

rake doc:clobber_plugins
# 删除 plugin Documentation

rake doc:clobber_rails
# 删除Documentation

rake doc:plugins
# 产生Documation为所有安装的plugins

rake doc:rails
# 创建HTML文件的API Documentation

rake doc:reapp
# 强制重新创建HTML文件的API Documentation

rake doc:rerails
# 强制重新创建HTML文件的API Documentation

rake log:clear
# 清空目录log/下的所有日志文件

rake rails:freeze:edge
# Lock this application to latest Edge Rails. Lock a specific revision with REVISION=X

rake rails:freeze:gems
# Lock this application to the current gems (by unpacking them into vendor/rails)

rake rails:unfreeze
# Unlock this application from freeze of gems or edge and return to a fluid use of system gems

rake rails:update
# Update both scripts and public/javascripts from Rails

rake rails:update:javascripts
# Update your javascripts from your current rails install

rake rails:update:scripts
# Add new scripts to the application script/ directory

rake stats
# Report code statistics (KLOCs, etc) from the application

rake test
# Test all units and functionals

rake test:functionals
# Run tests for functionalsdb:test:prepare

rake test:integration
# Run tests for integrationdb:test:prepare

rake test:plugins
# Run tests for pluginsenvironment

rake test:recent
# Run tests for recentdb:test:prepare

rake test:uncommitted
# Run tests for uncommitteddb:test:prepare

rake test:units
# Run tests for unitsdb:test:prepare

rake tmp:cache:clear
# 清空tmp/cache目录下的所有文件

rake tmp:clear
# 清空session, cache, 和socket文件从tmp/目录

rake tmp:create
# 为sessions, cache, and sockets创建tmp/目录

rake tmp:sessions:clear
# 清空所有在tmp/sessions目录下的文件

rake tmp:sockets:clear
# 清空所有在tmp/sessions 目录下的ruby_sess.* 文件

rails 2.0新增的Rake Tasks
rake routes：打印当前路由列表；

rake db:drop, rake db:drop:all, 删除当前环境或config/database.yml中的所有数据库；

rake db:create, rake db:create:all，创建当前环境数据库或或config/database.yml中的所有数据库；

rake db:version，显示当前环境数据库的schema版本号；

rake db:reset, 删除并重新创建当前环境的数据库。

1.4 Scripts
script/about
# 输出当前环境信息

script/breakpointer
# 启动断点server

script/console
# 启动交换式的Rails控制台

script/destroy
# 删除通过generators创建的文件

script/generate
# -> generators

script/plugin
# -> Plugins

script/runner
# 执行一个任务在rails上下文中

script/server
# 启动开发模式服务器http://localhost:3000

//以下几个不知道怎么去使用
script/performance/profiler
script/performance/benchmarker
script/process/reaper
script/process/spawner

1.5 Generators

ruby script/generate model ModelName

ruby script/generate controller ListController show edit

ruby script/generate scaffold ModelName ControllerName

ruby script/generate migration AddNewTable

ruby script/generate plugin PluginName

ruby script/generate mailer Notification lost_password signup

ruby script/generate web_service ServiceName api_one api_two

ruby script/generate integration_test TestName

ruby script/generate session_migration

可选项:
-p, –pretend Run but do not make any changes.
-f, –force Overwrite files that already exist.
-s, –skip Skip files that already exist.
-q, –quiet Suppress normal output.
-t, –backtrace Debugging: show backtrace on errors.
-h, –help Show this help message.
-c, –svn Modify files with subversion. (Note: svn must be in path)
———
ruby script/generate scaffold helloworld
生成某个Model的CRUD操作的应用框架

ruby script/destroy scaffold helloworld
删除某个Model的CRUD操作的应用框架

1.6 Plugins

script/plugin discover
# discover plugin repositories

script/plugin list
# list all available plugins

script/plugin install where
# install the a€wherea€? plugin

script/plugin install -x where
# install where plugin as SVN external

script/plugin install http://invisible.ch/projects/plugins/where

script/plugin update
# update installed plugins

script/plugin source
# add a source repository

script/plugin unsource
# removes a source repository

script/plugin sources
# lists source repositories

以下是关于rake的一个经典的教程

原文：Ruby on Rails Rake Tutorial (aka. How rake turned me into an alcoholic)
引言：作为一个rails的开发者，你可能很熟悉使用rake进行你的测试，或者使用rake db:migrate运行你的migrations，但是你真的知道Rake的背后故事吗？你意识到可以自己写一个Rake任务或者一个有用的lib吗？

下面是我们使用Rake任务的例子：

1、给列表中的用户发送邮件
2、每晚数据的计算和报告
3、过期或重新生成缓存
4、备份数据和svn版本(how’s this : subversion repository)
5、运行数据处理脚本(sort of,how much is called this )
6、Pouring drinks to get a good buzz on(一句玩笑，是这两位仁兄的风格)

这篇文章中，我们将讨论为什么要创建Rake，和他怎么样帮助我们的rails应用。最好你可以写自己的Rake。

一、历史回顾：make

为了了解Rake的来历，我们先了解一下Rake的爷爷：Make。
让我们回到那个代码块需要编译，解释性语言和iphone还没出现在地球上的时代。

回到那时，我们下载的大型程序，还是一堆源代码和一个shell脚本。这个shell脚本包含了所有需要用来compile/link/build的代码。你需要运行“install_me.sh”这个脚本，每一行代码将被运行（编译每一行源文件），然后生成一个你能够运行的文件。

对于大多数人这样是不错的，但是对于程序开发人员却是一个不幸。每次你对源代码进行一个小的改动，并进行测试的时候，你需要回到shell脚本，并重新编译所有的源代码，显然对于大的程序“那是相当的”耗时的。

1977年（作者出生那年，我78年），贝尔实验室的Stuart Feldman创造了“make”。解决了编译时间过长的问题。Make用来编译程序，取得两方面的进步：

Stuart Feldman

（1）Make可以发现哪个文件在上一次编译后改动过，根据这点，再次运行Make时，仅编译改动过的文件。这个很大程序上减少了重新编译大型程序的时间。

（2）Make可以进行从属跟踪。你可以告诉编译器，源文件A的编译需要源文件B，源文件B的编译需要源文件C，所以Make在编译A时发现B没有编译，将会先编译B。

可以这样定义：Make是一个可执行程序。像ls或dir一样。让Make理解如何让编译一个项目，需要创建一个makefile文件，描述所有的源文件和依赖关系。makefiles有自己的语法，你不用去了解。

这些年Make出现了其他的变体，并且被其他的语言使用。事实上，ruby用户在rake出现前也在使用它。

“但是，ruby并不需要编译，我们用它来干嘛？”

是啊。ruby是一个解释性语言，我们不需要编译它的源代码，所以ruby程序员为什么使用它呢？

两个重要的原因：

（1）创建任务
在大型的应用中，你经常编写脚本，在命令行下运行一些任务。比如清除缓存，维护任务，或者迁移数据库。你可以写一个MakeFile来组织你的任务，而不是写十个不相干的脚本（或者一个复杂的）。这样你可以简单的运行：“make stupid”。

（2）从属任务跟踪
当你开始写一些维护任务的时候，可能发现有些任务的使用可能有重复。比如，“migrate”任务和“schema:dump”都需要链接数据库，这样我可以创建一个任务”connect_to_database”，使“migrate”和“schema:dump”都依赖于”connect_to_database”，这样下次运行“migrate”时，”connect_to_database”会先于“migrate”运行

二、如何得到Rake

几年前，Jim Weirich在一个java项目上使用了Make，他发现如果在他的Makefile中写一小段ruby代码将会带来非常大的方便。所以他创建了Rake。

左：Jim Weirich，中：Jason Seifer，右：Gregg Pollack
（后面两位为本文作者）

Jim 为Rake创建了任务功能，附属关系跟踪，甚至创建了时间段判断(timestamp recognition)，（在上一次编译的基础上仅编译改动的部分），当然，对于ruby，我们并不需要编译。

我很想知道Jim在代码里做了什么，你也想知道吧。Jim可能从来没想给这个代码写个文档，可能现在他也是被烦透了，写了一个。呵呵

三、Rake如何工作

开始我想给这个部分起名为”How to get wasted with Rake”。

那么我想喝点酒，该怎么做呢？

1、去买酒
2、喝酒
3、喝醉

如果我要使用Rake完成这个任务，我会创建一个“Rakefile”文件：

task :purchaseAlcohol do
  puts "Purchased Vodka"
end

task :mixDrink do
  puts "Mixed Fuzzy Navel"
end

task :getSmashed do
  puts "Dood, everthing's blurry, can I halff noth'r drinnnk?"
end

这样我可以在这个Rakefile的目录，分别运行这些任务：

$ rake purchaseAlcohol
 Purchased Vodka
$ rake mixDrink
 Mixed Fuzzy Navel
$ rake getSmashed
 Dood, everthing's blurry, can I halff noth'r drinnnk?

酷！但是从顺序上看，我可以用任何的顺序运行这个任务。比如喝醉在买酒或者喝酒之前。当然这不符合人的习惯。

四、Rake的顺序

task :purchaseAlcohol do
  puts "Purchased Vodka"
end

task :mixDrink => :purchaseAlcohol do
  puts "Mixed Fuzzy Navel"
end

task :getSmashed => :mixDrink do
  puts "Dood, everthing's blurry, can I halff noth'r drinnnk?"
end

这样，如果想喝酒，就得先去买，如果想喝醉，就得先喝酒。

$ rake purchaseAlcohol
 Purchased Vodka
$ rake mixDrink        
 Purchased Vodka
 Mixed Fuzzy Navel
$ rake getSmashed
 Purchased Vodka
 Mixed Fuzzy Navel
 Dood, everthing's blurry, can I halff noth'r drinnnk?

看到了吧，我喝醉和，因为酒已经买了，也被我喝了。(译者：我是喜欢百事的，所以倘若我写，定然拿百事当例子。但是我让我儿子和可口，为什么呢？下面告诉你。)

现在，你的欲望无法满足了，你想让你的朋友加入进来。就像一个团队的开发，如果你想加入一个新人，你得有合适的规划。你得有文档。那么问题来了。

五、如何给我的Rake添加文档

Rake添加文档非常的方便，使用“desc”就可以了：

desc "This task will purchase your Vodka"
task :purchaseAlcohol do
  puts "Purchased Vodka"
end

desc "This task will mix a good cocktail"
task :mixDrink => :purchaseAlcohol do
  puts "Mixed Fuzzy Navel"
end

desc "This task will drink one too many"
task :getSmashed => :mixDrink do
  puts "Dood, everthing's blurry, can I halff noth'r drinnnk?"
end

看到了吧，我的每个任务都添加了desc，这样我们可以输入”rake -T”或者”rake –tasks”:

$rake --tasks
 rake getSmashed        # This task will drink one too many
 rake mixDrink          # This task will mix a good cocktail
 rake purchaseAlcohol  # This task will purchase your Vodka

简单乎？呵呵

六、Rake的命名空间

当你开始酗酒，并且开始使用大量的rake任务的时候，你需要一个好方法将他们分类，这时用到了命名空间，如果我在上面的例子使用了命名空间，那么：

namespace :alcoholic do
  desc "This task will purchase your Vodka"
  task :purchaseAlcohol do
    puts "Purchased Vodka"
  end

  desc "This task will mix a good cocktail"
  task :mixDrink => :purchaseAlcohol do
    puts "Mixed Fuzzy Navel"
  end

  desc "This task will drink one too many"
  task :getSmashed => :mixDrink do
    puts "Dood, everthing's blurry, can I halff noth'r drinnnk?"
  end
end

命名空间允许你将一些任务放到特定的分类中，在一个Rakefile中，你可以加入几个命名空间。运行rake –tasks

rake alcoholic:getSmashed        # This task will drink one too many
rake alcoholic:mixDrink          # This task will mix a good cocktail
rake alcoholic:purchaseAlcohol  # This task will purchase your Vodka

所以如果想运行这个任务，只要输入 rake alcoholic:getSmashed：

desc "Create blank directories if they don't already exist"
task(:create_directories) do
  
  # The folders I need to create
  shared_folders = ["icons","images","groups"]
  
  for folder in shared_folders
    
    # Check to see if it exists
    if File.exists?(folder)
      puts "#{folder} exists"
    else
      puts "#{folder} doesn't exist so we're creating"
      Dir.mkdir "#{folder}"
    end
    
  end
end

当然，还可以在rake中使用更多的 文件工具File Utils，或者加入其他的部分。

为了给你的rails应用添加一个新的任务，你可以打开/lib/tasks目录（已经存在的），添加一个叫something.rake的文件，这个任务会被自动的检索到，这些任务会被添加到rake tasks列表中，你可以在根目录里运行他们，现在把我们上面的例子放到这个rails应用中。

utils.rake

namespace :utils do
  desc "Create blank directories if they don't already exist"
  task(:create_directories) do
  
    # The folders I need to create
    shared_folders = ["icons","images","groups"]
          
    for folder in shared_folders
        
      # Check to see if it exists
      if File.exists?("#{RAILS_ROOT}/public/#{folder}")
        puts "#{RAILS_ROOT}/public/#{folder} exists"
      else
        puts "#{RAILS_ROOT}/public/#{folder} doesn't exist so we're creating"
        Dir.mkdir "#{RAILS_ROOT}/public/#{folder}"
      end
         
    end
  end
end

注意上面的代码，我使用了#{RAILS_ROOT} 来得到rails应用的当前位置，现在运行“rake –tasks”，你可以看到我们的任务已经添加到tasks列表中了。

...
rake tmp:pids:clear              # Clears all files in tmp/pids
rake tmp:sessions:clear          # Clears all files in tmp/sessions
rake tmp:sockets:clear           # Clears all files in tmp/sockets
rake utils:create_directories    # Create blank directories if they don't already exist
...

九、如何在任务中调用rails的model

呵呵，这个正是我最多使用rake的地方，写一个rake任务，代替原来需要手工操作的地方，或者一些任务代替经常需要按照计划自动执行（使用 cronjobs）的事情。就像我开头说的那样我用rake任务执行下面的擦作：

1、给列表中的用户发送邮件
2、每晚数据的计算和报告
3、过期或重新生成缓存
4、备份数据和svn版本(how’s this : subversion repository)
5、运行数据处理脚本(sort of,how much is called this )

这个补充了原来的功能，而且相当简单。下面这个任务是检查用户的过期时间，对快过期的用户发送邮件。

namespace :utils do
  desc "Finds soon to expire subscriptions and emails users"
  task(:send_expire_soon_emails => :environment) do
        # Find users to email
        for user in User.members_soon_to_expire
                puts "Emailing #{user.name}"
                UserNotifier.deliver_expire_soon_notification(user)
        end
  end
end

使用你的model只用一步，”=> :environment”

task(:send_expire_soon_emails => :environment) do

如果在我的开发环境上运行这个任务，我只需要“rake utils:send_expire_soon_emails”，如果我想在产品环境下运行这个任务，我需要“rake RAILS_ENV=production utils:send_expire_soon_emails”。

如果你想在每晚都运行这个任务，你需要写一个 cronjob ，像这样：

0 0 * * * cd /var/www/apps/rails_app/ && /usr/local/bin/rake RAILS_ENV=production utils:send_expire_soon_emails

相当的方便。

十、在哪找到一些例子

brand new rake tasks 在edge rails 中，这个可以创建和重置你的数据库。

Craig Ambrose写的数据库备份， database backups。

Adam Greene写了一组任务 set of Rake tasks，可以将所有的数据备份到amazon S3。他还给了我一个升级版本，你可以在这下载here。

Jay Fields的任务测试，testing rake tasks。

a new way of setting the RAILS_ENV and teaches how to use rake to boot you into a Mysql shell （看的时候留意一下他的注释）

Rake Bookshelf Books，和Martin Fowler的Using the Rake Build Language 教程，这两个都很有用，虽然有点过时。

如果你发现其他更好的文章，发贴子给我们。

译者：恩，这段不用翻译，懂的朋友自然会去看的了。

Still reading? If you are, I wanted to let you know that we’re looking for more people to write for RailsEnvy. If you have an idea for a good rails tutorial we want to hear from you! Basically we would work with you to flesh out the tutorial and help polish (acting as an editor). It could definitely be a great way to get your name out there, and start getting some hits (for your blog or company). Email Gregg at RailsEnvy if you’re interested.

另：我刚收到jim的邮件，如何更简单的创建我的目录。

# This is needed because the existing version of directory in Rake is slightly broken, but Jim says it'll be fixed in the next version.
alias   riginal_directory :directory
def directory(dir)
  original_directory dir
  Rake::Task[dir]
end

# Do the directory creation
namespace :utils do
  task :create_directories => [
    directory('public/icons'),
    directory('public/images'),
    directory('public/groups'),
  ]
end

注：图片均来自英文原文(Pics come from the english page)

前段时间，我们的CE平台不断出现上述错误。原因是：mysql server 的链接断开后，Rails的Active Record没有检测到，断续执行数据库查询。

Mysql链接保持时间默认为3600秒，在/etc/my.cnf 里可以修改名为wait_time参数的值以改变链接保持的时间。
Rails中Active Record的并不会自动检测与数据库的链接是否是活动的，断开后也不会自动重新链接；如果mysql链接超时，自动断开后，Active Record并不知道，再执行时，就会抛出Mysql::Error: Lost connection to MySQL server during query:的错误。

解决方法时：修改Active Record检证时间。
     修改config/environment.rb配置文件，将config.active_record.verification_timeout = XXX 这句加入到Rails::Initializer.run do |config|  ….  end中， 值设为小于或等于mysql wait time的值 。
    

例如，mysql server 的wait_time=120，那我们rails的设置应该如下：
Rails::Initializer.run do |config| 

     config.active_record.verification_timeout = 118   #注，理论上小于等于120都没问题的

    ………

end