关于作者

笔名:uncutstone
地区: china-beijing
作者相册

日历 

快速登录

+ 用户名:
+ 密 码:

在线留言

友情Blog

访问统计:596


从比特到系统

 

日志

Rails 创建者为 Ruby for Rails 写的序言

我不会为了学语言而学语言。 我需要用它来做一些具体的事??解决一个问题或完成一个任务,产生某种有价值的东西…… 在 2003 年的夏天,我正是这样开始涉足 Ruby的。当时我想要构建一个 Web 应用,我认定这是一个绝佳的学习 Ruby 的机会。这个 Web 应用是 Basecamp,Rails 就是从它抽取出来的。

由于我的 PHP 和 Java 背景,我记得 Ruby 的很多最精彩的特性在开始时看起来很奇怪。“究竟是什么让块(block)这么特殊呢?”我思考着。“它们终究不过是为编写代码提供了一点方便而已”,我还知道得很少… 随着我开始使用 Ruby 和抽取 Rails ,我迅速地理解了。Ruby 是一门那么不可置信的功能强大和富于表现力的语言,所以很难用过去使用其他语言的经验来欣赏和理解它的美。

为了创建 Basecamp, 我需要泡在 Ruby 中。在这样做的过程中,我不断发现该语言的一些特性正好就是解决我手头的问题所需要的。在 PHP 或 Java 中让我头疼的事现在让我会心地微笑,Ruby 一次一次让我看到,编程可以是简单的、充满乐趣的、非常美好的。

在学习这门语言的时候,我经常在 ruby-talk 邮件列表中咨询问题。在那里,有一个人看起来对Ruby 了解特别多,而且很愿意也有能力帮助其他人更多地了解 Ruby。他就是本书的作者,David A. Black。

David 显然对 Ruby 有百科全书一般的了解。他不仅仅了解怎样使用它,而且可以解释事物运转的原理。他可以将分散的知识点关联起来,并补足缺失的部分,让你可以看到全貌。我想 象不出还有比他更合适的人来写这本书。那个曾教过我那么多 Ruby 知识的人,现在在帮助其他人理解这门语言从而可以在我开发的框架中使用,这是我莫大的荣幸。

每一个从其他语言转到 Rails 的人都应该拥有这本书。为了充分发挥 Rails 的潜力,花点时间去透彻地了解 Ruby 是至关重要的——通过 Ruby for Rails,David 正好提供了达到这一目标所需要的东西。

DAVID HEINEMEIER HANSSON
Ruby on Rails 的创建者
37signals 的合伙人

- 作者: uncutstone 2006年10月23日, 星期一 23:27  回复(1) |  引用(0)

现代诗,一个时代的一次失败的尝试


现代诗中虽然有少量的好诗。
  例如:黑夜给了我黑色的眼睛,等等。
  
  但总的说来,我认为现代诗是一个时代的一次失败的尝试。
  
  任何一种艺术都需要传递情感和意义,这是艺术的共性,不同的艺术最关键的不同在于它的形式。 诗歌最关键的地方在于形式的对仗和工整,押韵的讲究,由此产生的视觉美、韵律美、节奏美、意境美等等。 但由于唐诗和宋词已经发展得过于成熟,现代人很难在这种艺术形式下有所创新。 于是现代诗应运而生,但是它受白话运动的影响和西方思潮的影响太重,也由于遭受外来侵略后的过分自卑,抛弃了传统, 抛弃了传统诗歌形式中最好的部分(对仗,工整,押韵),成为一种过于自由、象是在写散文但又不好好说话的东西。 所以现代诗总的感觉就是酸溜溜的,不自然。
  
  传统的艺术形式并非不允许突破和创新,例如,从唐诗到宋词,诗歌的形式发生了很大的变化,但是宋词仍然有它独特的形式美。现代诗的形式过于松散,完全没有形式美可言。
  
  现代诗过于自由了,那就好好写篇散文吧,但是还要拽一下,那就是现代诗了。 一次失败的尝试。

- 作者: uncutstone 2006年10月16日, 星期一 09:21  回复(1) |  引用(0)

Ruby for Rails 封面的故事: 本书唯一非技术性的,带一点人文气息的文字
Ruby for Rails 已经翻译完毕,目前在紧张校对中。这段文字我觉得有点意思,先放上来给大家看看。最后一段我可能还会修改。

Ruby for Rails 封面上的图是一个“伟大的陛下的军官”, 或者可以称之为奥斯曼苏丹的军队的军官。这幅插图来自一本奥斯曼帝国的服饰集,该服饰集在 1802 年1月1号由伦敦 Old Bond 大街的 William Miller 出版。该服饰集的标题页丢失了,直到现在也没有找到。该服饰集的目录同时用英语和法语标识图片,每一幅插图都记载了两个创建它的艺术家的名字,如果这两个 艺术家发现他们的艺术品在200年后用于装饰一本计算机编程书籍的封面,毫无疑问他们一定大为惊奇。

这本服饰集是一个 Manning 的编辑在曼哈顿西26街车库的一个古董跳蚤市场购买的。卖货者是来自土尔其安卡拉的美国人,这笔交易是在他那天准备收摊的时候做成的。 Manning 的编辑当时身上没有带够现金,而信用卡和支票支付都被礼貌地拒绝。因为卖货者要在当晚飞回安卡拉,看起来没有希望成交了。事情是怎么解决的呢?很简单,通 过一个握手达成的旧式的口头协议。卖货者建议通过网络将钱汇给他,编辑走的时候拿着一张写着银行信息的纸片,胳膊下夹着那本服饰集。不用说,第二天,我们 汇了那笔钱,而且我们一直很感谢这个不认识的人对我们的信任,一直对此印象深刻。这让我们想起某些应该是发生在很久很久以前的事情。

来自这本奥斯曼服饰集的这张图片,和出现在我们的书籍封面上的其他插图一样,带来了两百年前着装风俗的丰富性和多样性。它们让人回想起那个时代以及任何其他时代,惟独除了我们这个过于躁动的时代,所具有的那种隔绝感和距离感。

从那时起,服装风格就改变了,地区之间的多样性,在那个时代是如此丰富,已经渐渐地消失。现在,常常很难区分不同大陆之间的居民。也许,应该试图 乐观地去看待它,我们用文化的和视觉的多样性换取了一个更加多样化的个人生活。或者说一个更加多样化的和更有趣的心智的和技术的生活。

我们 Manning 的这些人庆祝计算机商务的创造性、首创性,以及,是的,还有乐趣,我们使用这个服饰集中的图片作为封面,它们让人回想起两百年前地区生活的丰富的多样性,我们就用这些封面来庆祝。

- 作者: uncutstone 2006年09月29日, 星期五 00:12  回复(2) |  引用(0)

是该坐而论道的时候了吗?
作为一个程序员, 确实在有的时候会有一种悟道的感觉。 编程的人容易产生很多的哲学思考,确实也会有很多阶段性的思考成果. 每每这种时候, 会觉得自己或许该写一本编程之道一类的书.

确实有人写了此类的中文书籍。 对这些书籍的浏览一次一次让我头脑冷静。我看到模糊、含混的思想,牵强的比喻,故弄的风雅,常常玄虚而不知所云, 偏偏没有道家的自然、简单、质朴却仍然深刻的特点。谈论编程之道,至少再等10年。在这十年中, 好好写写代码, 好好做几个成功的产品, 好好挣钱, 而且如果还能坚持思考的话, 或许可以坐而论道。

对于想要谈论编程之道的朋友(包括自己), 我现在的建议是:如果有所体会,不妨写些豆腐块的文章互相交流;如果要写书,还请慎重,书籍要求承载的应该是更成熟、更清晰、更完整的思想。 

- 作者: uncutstone 2006年07月2日, 星期日 19:09  回复(2) |  引用(0)

今天凌晨的巴西队真让人失望




一直很喜欢巴西队,所以晚上熬夜看球。结果和过程都让人很失望。今天睁着犯困的眼睛,后悔耽误一场好觉(如果有一场好球那还值得), 需要发发牢骚。

巴西队的实力永远都是强大的。 这一届, 由于新老交替做得不好, 桑吧足球的魅力根本没有展现。 罗纳尔多懒洋洋的在场上梦游, 理所当然的等着别人给他制造机会,卡福的边路助攻锋芒已尽,失误连连, 卡洛斯的漏人造就了亨利齐达内的珠联壁合的一击。我很喜欢当年罗纳尔多在中路直插敌心脏的尖刀般锐利的冲击, 双卡在边路的两翼齐飞, 那时的巴西队就是天下无敌的。 不过,俱往矣, 8年甚至12年,英雄末路,让人感叹。 巴西在本届世界杯的失败是必然的, 巴西需要这一个失败来告别12年以来的成功, 需要一个失败才能开始新的冠军历程。让人惋惜的是昔日的英雄以一个如此黯然的方式告别足球。

反观法国,齐达内却光芒四射, 与亨利珠联壁合。也许是因为作为中场球员,经验、老到是更重要的东西。 反观当年老马告别的时候,与巴蒂的配合也是这样的完美无缺。

这就是时间, 时间剥夺一些东西,时间也给予了一些东西。在时间的无情车轮下,几家欢乐几家愁。

- 作者: uncutstone 2006年07月2日, 星期日 14:00  回复(0) |  引用(0)

ruby 社区的一些人物
收集了一下 Ruby 的一些主要的 developer, 先给出我目前关注的,以后再慢慢增加。 欢迎大家也列出自己心目中的人物, 请多多补充。

Ruby(the language) developers:

Yukihiro Matsumoto
Dave Thomas
Michael Neumann
Kouhei Sutou
Nobuyoshi Nakada
Tom Copeland
Usaku Nakamura
Richard Kilmer

Rails developers:

David Heinemeier Hansson

Rake developers:

Jim Weirich

Ruby gem developers:

Gavin Sinclair
Chad Fowler
David A. Black
Eric Hodel
Jim Weirich
Richard Kilmer
Paul Brannan
Ryan Davis

RbYaml developers:

Ola Bini

YARV developers:

SASADA Koichi

Watir main developers:

Bret Pettichord
Chris Morris
Jonathan Kohl
Paul Rogers

Rmagic developers:

Kaspar Schiess
Tim Hunter

rdoc and ri developers:

Ryan Davis

One-Click Installer ? Windows main developers

Curt Hibbs
Andy Hunt

FreeRIDE main developers

Laurent Julliard
Richard Kilmer
Curt Hibbs

Mongrel developers:

Austin Godber
Luis Lavena
why the lucky stiff
Zed Shaw

FxRuby developers:

Lyle Johnson

JRuby developers:

tom enebo

- 作者: uncutstone 2006年06月17日, 星期六 12:18  回复(1) |  引用(0)

用Ruby 创建领域特定语言(DSL)
by Jim Freeze
英文原文见:http://www.artima.com/rubycs/articles/ruby_as_dsl.html

摘要:

总的说来,有两种创建 DSL 的方法。 一种方法是从零开始发明一个新的语法,并为之构造一个编译器或解释器。 另一种方法是裁剪一个现存的通用目的语言, 增加或修改方法(methods), 操作符(operators),以及缺省的行为。 本文讲述使用第二种方法来在 Ruby 之上创建 DSL.


一个 DSL, 是一个针对相对窄的应用范围设计的编程或描述语言。相对于通用目的语言, 它被设计来处理特定的计算任务, DSL 仅适用于特定领域。 你可以用两种方式创建一个 DSL.

  • 从零开始发明一个新的语法,并为之构造一个编译器或解释器。
  • 裁剪一个现存的通用目的语言, 增加或修改方法(method), 操作符(operator),以及缺省的行为。

第二种方法的优势是你节省了时间, 因为你不需要生成和调试一个新的语言, 这样你有更多的时间用于解决最终用户面临的问题。缺点是 DSL 会受限于其下的通用目的语言的语法和能力。 更进一步来说,基于另一个语言来构造DSL 常常意味着最终用户可以获得这个基础语言所有的威力,这可能是优点也可能是缺点, 它取决于特定的应用环境。 这篇文章讲述怎么使用第二种方法来在Ruby之上创建 DSL.

描述堆叠模型(stackup models)

我是一个互连模型(interconnect modeling) 工程师,在工作中, 我们需要一种方式来描述半导体晶片上的电路的垂直几何结构(vertical geometric profile)。这些描述被保存在一个堆叠模型(stackup model) 文件中。(我们造了一个词stackup,因为金属连线是在装配过程(fabrication process)中通过层层堆叠形成的)。现在的问题是,每一个供货商有他们自己的描述堆叠模型(stackup) 的格式, 而我们想要一个公共的格式使得我们可以在不同的格式间进行转换。 换句话说, 我们需要定义一个公共的堆叠模型(stackup) DSL, 并且写一个程序用来从我们格式转换为不同供货商的特定的格式。

供货商没有使用一个复杂的DSL 语言,他们的语言仅仅包含静态的数据元素于一个基本平坦的文本数据库中。他们的文件格式不允许有参数化类型(parameterized type), 变量, 常量, 以及等式(equation)。 只有静态数据。更进一步来说,格式非常简单。它是基于行的,或者基于只有一个层次的块结构。

我们开始描述我们的堆叠模型格式时,要求并不高,因为我们仅仅需要达到供货商实现的程度就行。但我们很快扩展了我们的格式。为什么我们可以做到这一点, 而我们的供货商却做不到。我相信这是因为我们使用了 Ruby, 而不象我们的供货商用 C 从零开始。我相信也可以用其他的语言, 但是我不认为最终的产品可以同样出色。通用语言的选择是关键的一步。

我也相信供货商的开发速度因为使用 C 而受到阻碍, 因为他们要保持他们的堆叠模型的语法尽量简单以便于分析(parse). 可能并非偶然,很多供货商在他们的文件格式中使用一些共同的简单的语法结构。 因为这些简单的语法结构出现频繁, 我们将先在 Ruby 中仿制它们, 然后再转到更复杂的语法结构。

基于行和块级别的 DSL 结构(constructs)

基于行的结构是一种将一个值或一个范围的值赋予一个参数(parameter)的方式。 在我们所考察的供货商的文件中,使用了下面的格式。

1. parameter = value
2. parameter value
3. parameter min_value max_value step_value

除了2 中没有显式出现’=’ , 格式1和2 是等价的。 格式3 将一个范围的值赋给了一个参数。

更为复杂的格式包含一个块结构。有两种格式如下所示。 这两种块结构可以使用一个基于行的分析器和一个堆栈 ,或一个带堆栈的关键字分析器(key-letter and word parser)来手动分析。

begin
type = TYPE
name = NAME
param1 = value1
param2 = value2
...
end

下面一种块格式使用 C 风格的大括号{}来标识一个块, 但参数/值对用空格来分隔。

TYPE NAME {param1 = value1 param2 = value2 }

三次是一个咒语

在我们构建我们的堆叠文件的DSL时, 我们把问题解决了三次。 首先, 我们写了自己的语法分析器,然后发现那样的话有太多的工作要维护。不仅仅是代码,而且还有文档。因为我们的DSL 足够复杂,如果没有足够文档,没有显然的方法去使用它的所有特性。

接着,在一个短时间内,我们用 XML实现了 DSL。 这样,我们不需要去写自己的语法分析器,因为XML 有现成的分析器。但是 XML引入太多的噪声,模糊了文件的实际内容 。我们的工程师发现思维在理解堆叠文件的含义和理解XML之间进行切换很困难。由此我认识到,XML 不适合人来阅读,XML可能不是用来创建DSL 的好的选择, 尽管我们有不用开发语法分析器(parser)的好处。

最后,我们用Ruby实现了DSL。 因为利用了 Ruby 解释器的分析功能,实现起来是很快的。我们不需要写分析器(就是Ruby)的文档,因为它已经存在。而且,最终的DSL 非常容易被人理解,也很简洁灵活。

好的。 让我们用Ruby来创建一个 DSL,该DSL允许我们定义形如‘parameter = value’的语句。请考虑以下假想的DSL 文件。

% cat params_with_equal.dsl
name = fred
parameter = .55

这不是合法的Ruby代码,我们需要稍微修改一下语法使得Ruby可以接受它。让我们将它改为:

% cat params_with_equal.dsl
name = "fred"
parameter = 0.55

一旦我们让DSL 遵循Ruby的语法,Ruby 就为我们做了所有的分析工作,并且提供了一种方式访问分析的结果。 现在,让我们写一些 Ruby 代码来读DSL。

首先,我们想要将这些参数用某种方式封装起来。 一个好的方法是将它们放到一个类中。我们称这个类为 MyDSL。

% cat mydsl.rb
class MyDSL
...
end#class MyDSL

从开发者的角度看,我们需要一个简单和直接的方式来分析DSL 文件。就如下面所示:

my_dsl = MyDSL.load(filename)

接着,让我们来写类方法 load:

def self.load(filename)
dsl = new
dsl.instance_eval(File.read(filename), filename)
dsl
end

类方法load 产生一个MyDSL对象, 并且以DSL 文件的内容为参数调用该对象的instance_eval。Instance_eval的第二个参数是可选的, 它使得Ruby 在出现语法分析错误时可以报告文件名。 一个可选的第三个参数(没有使用)可以使Ruby 在出现分析错误时能提供错误开始的行号
这个代码能工作吗? 让我们看看发生了什么?

% cat dsl-loader.rb
require 'mydsl'

my_dsl = MyDSL.load(ARGV.shift) # put the DSL filename on the command line
p my_dsl
p my_dsl.instance_variables
% ruby dsl-loader.rb params_with_equal.dsl
#
[]

发生了什么? name 和parameter到那里去了? 这是因为name和parameter在等号的左侧,Ruby 认为他们是局部变量。我们可以告诉Ruby它们是实例变量。有两种方式,一种是使用 self.name = “fred” self.parameter = 0.55 , 另一种是使用@符号。

@name = "fred"
@parameter = 0.55

但是对我来说,这样很丑陋。写成下面的形式也是一样。

$name = "fred"
$parameter = 0.55

还有一个办法让Ruby 知道这些方法(method)执行的上下文, 那就是利用块(block)和 yield self(MyDsl的对象实例) 来显式的声明作用域。 为了做到这一点,我们将加一个顶层方法来开始我们的DSL, 并且将实际内容放进所附的块(block)中。 修改过的 DSL 看起来是这样:

% cat params_with_equal2.dsl
define_parameters do |p|
p.name = "fred"
p.parameter = 0.55
end

define_parameter 已经被定义为一个实例方法(instance method)。

% cat mydsl2.rb
class MyDSL
def define_parameters
yield self
end

def self.load(filename)
dsl = new
dsl.instance_eval(File.read(filename), filename)
dsl
end
end#class MyDSL

修改dsl-loader中的require,让它使用mydsl2.rb 中的新版本的MyDSL 类:

% cat dsl-loader.rb
require 'mydsl2'

my_dsl = MyDSL.load(ARGV.shift)
p my_dsl
p my_dsl.instance_variables

理论上,这可以工作, 让我们测试一下。

% ruby dsl-loader.rb params_with_equal2.dsl
params_with_equal2.dsl:2:in `load': undefined method `name=' for # (NoMethodError)

噢,我们忘记了为name 和parameter 定义访问函数(accessor)。 让我们加上它们, 然后看一下完整的程序:

% cat mydsl2.rb
class MyDSL
attr_accessor :name, :parameter

def define_parameters
yield self
end

def self.load(filename)
# ... same as before
end
end

现在, 再测试一遍。

% ruby dsl-loader.rb params_with_equal2.dsl
#
["@name", "@parameter"]

成功! 现在工作了。但是我们在DSL文件中加了额外的两行, 还有额外的 .p , 这些都引入了噪声。这样的记法(notation)更适合于当DSL文件中存在多个层次, 并且需要显式指定上下文的情况。 在我们的简单例子里,我们应该隐式的定义上下文, 且让Ruby 知道name 和parameter 是方法(method)。 让我们删掉 ‘=’ , 将DSL 文件写成:

% cat params.dsl
name "fred"
parameter 0.55

现在,我们需要为name 和 parameter 定义新的访问方法(accessor)。这里的窍门是:不带参数的name 是@name的读方法(reader), 带一个或多个参数的name 是@name的写方法(setter)。(注意:使用这个办法很方便,即使是DSL文件有多个层次而且上下文是显式声明的)。 我们下面为name 和parameter 定义访问方法, 删除attr_accessor那一行,加入以下代码:

% cat mydsl3.rb
class MyDSL
def name(*val)
if val.empty?
@name
else
@name = val.size == 1 ? val[0] : val
end
end

def parameter(*val)
if val.empty?
@parameter
else
@parameters = val.size == 1 ? val[0] : val
end
end

def self.load(filename)
# ... same as before
end
end#class MyDSL

如果 name 或parameter 不带参数,它们将返回它们的值。如果带参数:
  • 如果带一个参数,它们会被赋予该参数的值
  • 如果带多个参数,它们会被赋予一个数组,该数组包含所有的参数值

让我们运行我们的分析器(现在是mydsl3.rb)来测试一下:

% ruby dsl-loader.rb params.dsl
#
["@parameter", "@name"]

又成功了。但是显式地定义访问方法( accessors) 很烦人。让我们定义一个定制的访问方法,并且让所有的类都可以使用它。 我们通过将此方法(method)放到 Module class 中来做到这一点。

% cat dslhelper.rb
class Module
def dsl_accessor(*symbols)
symbols.each { |sym|
class_eval %{
def #{sym}(*val)
if val.empty?
@#{sym}
else
@#{sym} = val.size == 1 ? val[0] : val
end
end
}
}
end
end

上面的代码简单的定义了一个 dsl_accessor 方法, 它是我们的DSL特定的访问方法。现在我们用它取代attr_accessor:

% cat mydsl4.rb
require 'dslhelper'

class MyDSL
dsl_accessor :name, :parameter

def self.load(filename)
# ... same as before
end
end#class MyDSL

再一次,我们更新dsl-loader.rb 中的require 语句,加载mydsl4.rb, 然后运行loader:

% ruby dsl-loader.rb params.dsl
#
["@parameter", "@name"]

一切都很好。但是如果我不能事先知道参数的名字怎么办? 在实际使用中,参数名应该可以由用户来生成。 别害怕。有Ruby 在, 我们可以使用 method_missing 的威力。给 MyDSL加一个两行的方法, 我们可以用dsl_accessor 根据需要随时定义新的属性(attribute)。 也就是说,如果一个值被赋予一个不存在的参数,method_missing 会定义一个 getter 和一个setter ,并且将该值赋予新生成的参数。

% cat mydsl5.rb
require 'dslhelper'

class MyDSL
def method_missing(sym, *args)
self.class.dsl_accessor sym
send(sym, *args)
end

def self.load(filename)
# ... Same as before
end
end

% head -1 dsl-loader.rb
require 'mydsl5'

% ruby dsl-loader.rb params.dsl
#
["@parameter", "@name"]

哇!是不是感觉很好? 仅仅写了一点代码,我们有了一个可以读和定义任意数目参数的分析器。还可以吧。但是如果最终用户不知道Ruby,且使用了与现存的Ruby 方法冲突的名字,怎么办? 举例来说,如果我们的DSL文件包含以下内容:

% cat params_with_keyword.dsl
methods %w(one two three)
id 12345

% ruby dsl-loader.rb params_with_keyword.dsl
params_with_keyword.dsl:2:in `id': wrong number of arguments (1 for 0) (ArgumentError)

噢,真不好意思。不过我们可以迅速的解决这个问题。 这里要用到一个类叫BlankSlate, 它最初是由 Jim Weirich构思出来的。 用在这的BlankSlate 和Jim 的有细微的差别,因为我们想要多保留一些功能。 我们将留下七个方法。 你可以试一试看看那些是绝对需要的,那些是用来辅助我们看MyDSL 的对象实例的内容。

% cat mydsl6.rb
require 'dslhelper'

class BlankSlate
instance_methods.each { |m| undef_method(m) unless %w(
__send__ __id__ send class
inspect instance_eval instance_variables
).include?(m)
}
end#class BlankSlate

# MyDSL now inherits from BlankSlate
class MyDSL < BlankSlate
# ... nothing new here, move along...
end#class MyDSL

现在我们试一下加载包含关键字(keyword)的DSL 文件, 我们会看到一些更合理的东西。

% head -1 dsl-loader.rb
require 'mydsl6'

% ruby dsl-loader.rb params_with_keyword.dsl
#
["@id", "@methods"]

可以确信, 我们成功了。 这是一个好消息, 我们可以去掉那些没用的方法,给予我们的最终用户更自由的使用参数名字的权利。但是不管怎样,请注意,我们终究不能让最终用户完全自由的使用参数名。这是使用通用编程语言创建DSL的一个缺点, 但我认为,禁止最终用户使用’class’作为参数名,应该不会给我们的产品销路带来多大的风险。

更复杂的DSL

我们现在来实现更复杂的DSL 特性。 不仅仅操作数据,而且要执行更具体的行为。 想象一下我们厌烦了在每次开始一个新的项目的时候,手动的生成一个通用的目录集和文件集。 如果Ruby可以帮我们做这些就好了。更进一步,如果我们有一个小的DSL使得我们可以直接修改项目目录结构而不用去编写低级的代码,岂不更好。

我们现在开始为这个问题定义一个DSL。 下面的文件是这个DSL 的0.01 版本:

% cat project_template.dsl
create_project do
dir "bin" do
create_from_template :exe, name
end

dir "lib" do
create_rb_file name
dir name do
create_rb_file name
end
end

dir "test"

touch :CHANGELOG, :README, :TODO
end

在这个DSL文件里,我们生成了一个项目,在其中加了三个目录和三个文件。在’bin ‘ 目录中,我们使用’:exe’模板生成了一个与项目名字同名的可执行文件。在’lib’目录,我们生成了一个.rb 文件和一个目录, 都与项目名字同名。在这个内部子目录中,又生成另一个与项目名字同名的’.rb’ 文件。最后,在项目顶级目录下,生成了一个’test’目录,和三个空文件。

这个DSL需要的方法(method)是:create_project,dir,create_from_template,create_rb_file, 以及 touch。 让我们逐个的看一下这些方法。

方法create_project是最外层的壳(wrapper)。 这个方法提供了一个作用域让我们将所有的DSL代码都放在一个块(block)中。(完整的代码列表请看文章的最后)

def create_project()
yield
end

方法dir 完成实质性的工作。该方法不仅仅生成目录,而且将当前的工作目录保存在实例变量 @cwd中。 在这里,使用ensure 来保证@cwd 的始终有正确的值。


def dir(dir_name)
old_cwd = @cwd
@cwd = File.join(@cwd, dir_name)

FileUtils.mkdir_p(@cwd)
yield self if block_given?
ensure
@cwd = old_cwd
end

方法touch 和 create_rb_file 基本是一样的,除了后面一个给文件名加了一个后缀’rb’以外。 这些方法可以接受一个或多个文件名,这些名字可以是字符串或符号(symbols)。

def touch(*file_names)
file_names.flatten.each { |file|
FileUtils.touch(File.join(@cwd, "#{file}"))
}
end

最后,方法create_from_template 是一个粗略的例子用于说明怎么样可以在一个DSL中实现一些实际的功能。(请看代码的完整列表)

为了运行这些代码,我们构建了一个小的测试应用。

% cat create_project.rb
require 'project_builder'

project_name = ARGV.shift
proj = ProjectBuilder.load(project_name)
puts "== DIR TREE OF PROJECT '#{project_name}' =="
puts `find #{project_name}`

运行结果是:

% ruby create_project.rb fred
== DIR TREE OF PROJECT 'fred' ==
fred
fred/bin
fred/bin/fred
fred/CHANGELOG
fred/lib
fred/lib/fred
fred/lib/fred/fred.rb
fred/lib/fred.rb
fred/README
fred/test
fred/TODO

% cat fred/bin/fred
#!/usr/bin/env ruby

require 'rubygems'
require 'commandline
require 'fred'

class FredApp < CommandLine::Application
def initialize
end

def main
end
end#class FredApp


哇!工作得很好。 并且没费多少力气。

总结

我做过的很多项目要求一个非常详细的控制流描述。 在每个项目中,这常常让我停下来并思考怎么将这些详细的配置数据引入到应用(application)中。 现在,Ruby作为一个DSL,几乎是最适合的,而且常常可以非常高效和快速的解决问题。

在培训Ruby 的时候,我会让整个班级用以下方法来解决问题,我们先用英语来描述问题,然后用伪代码,然后用Ruby。但是,在某些情况下,伪代码就是合法的 Ruby 代码。 我认为,Ruby的高度可读性使得 Ruby是一个可用做DSL的理想语言。 当Ruby 为更多的人所了解, 用Ruby 写的DSL 将成为一个与应用通信的流行的方式

项目 ProjectBuilder DSL 的代码列表:

% cat project_builder.rb
require 'fileutils'

class ProjectBuilder
PROJECT_TEMPLATE_DSL = "project_template.dsl"

attr_reader :name

TEMPLATES = {
:exe =>
<<-EOT
#!/usr/bin/env ruby

require 'rubygems'
require 'commandline
require '%name%'

class %name.capitalize%App < CommandLine::Application
def initialize
end

def main
end
end#class %name.capitalize%App
EOT
}

def initialize(name)
@name = name
@top_level_dir = Dir.pwd
@project_dir = File.join(@top_level_dir, @name)
FileUtils.mkdir_p(@project_dir)
@cwd = @project_dir
end

def create_project
yield
end

def self.load(project_name, dsl=PROJECT_TEMPLATE_DSL)
proj = new(project_name)
proj = proj.instance_eval(File.read(dsl), dsl)
proj
end

def dir(dir_name)
old_cwd = @cwd
@cwd = File.join(@cwd, dir_name)
FileUtils.mkdir_p(@cwd)
yield self if block_given?
ensure
@cwd = old_cwd
end

def touch(*file_names)
file_names.flatten.each { |file|
FileUtils.touch(File.join(@cwd, "#{file}"))
}
end

def create_rb_file(file_names)
file_names.each { |file| touch(file + ".rb") }
end

def create_from_template(template_id, filename)
File.open(File.join(@cwd, filename), "w+") { |f|
str = TEMPLATES[template_id]
str.gsub!(/%[^%]+%/) { |m| instance_eval m[1..-2] }
f.puts str
}
end
end#class ProjectBuilder

# Execute as:
# ruby create-project.rb project_name

资源

1.BlankSlate 是一个Ruby class,用于产生没有方法(method-free)的对象实例。 参见:
http://onestepback.org/index.cgi/Tech/Ruby/BlankSlate.rdoc
2.JimWeirich是BlankSlate 的创建者,也是很多著名的Ruby 工具和库的创建者。
http://onestepback.org

关于作者


Jim Freeze 从2001年初学习Ruby以来,一直是 Ruby 的热爱者。
Jim 是 CommandLine and Stax gems 的作者

- 作者: uncutstone 2006年06月16日, 星期五 23:07  回复(2) |  引用(0)

鲁拜集

最近又买了几本好书。
《玻璃球游戏》, 打听了好多书店, 终于在五道口光合作用书店买到。
《鲁拜集》, 终于买到了。
《费曼传》
《牛顿传》

特别好的是《鲁拜集》, 这本书我上大学的时候曾经从图书馆借阅, 从此留下一个很深的印象。这次买到属于旧友重逢。很棒的一本诗集, 作者是古波斯的文武双修的诗人兼数学家,俄谟.伽亚谟。这本书是中英文对照版,译者是郭沫若, 翻译得很好。

摘几句在此, 算做惊鸿一瞥。

四野正在鸡鸣,
人们在茅店之前叩问---
开门罢!我们只得羁留片时,
一朝去后, 怕就不再回程

当我在青春时分,
也曾热访过博士圣人,
炎炎的伟论听了多回,
可我依然出来--由那原径

我也学播了智慧之种,
亲手培植他渐渐葱茏,
而今我所获得的收成,
只是来“如流水,逝如风”

朋友们哟, 你们是知道的,
我家中开了个盛大的欢筵,
我休了无育的“理智”老婆,
娶了“葡萄的女儿”来续弦。

这本书可作为那些沉迷于科学与软件技术的人的解毒剂, 多读读这句,“我休了无育的“理智”老婆,娶了“葡萄的女儿”来续弦”。 人生真是矛盾啊, 我想只有深中理性之毒的人, 才真正体会诗人的寓意。

- 作者: uncutstone 2005年02月1日, 星期二 13:34  回复(0) |  引用(0)

C++ guru herb sutter 预言软件技术革命
由于CPU 的主频增长已经到达极限(大约4GHZ), hyperthread  和 multicore 是将来 CPU 的发展方向, 由此将在软件领域将引发深刻的技术革命, 而这一切围绕着一个大家熟知的概念: concurrency.
请看下面这篇文章。
The Free Lunch Is Over: A Fundamental Turn Toward Concurrency in Software
 
http://www.gotw.ca/publications/concurrency-ddj.htm
 
文摘:
The biggest sea change in software development since the OO revolution is knocking at the door, and its name is [color=red]Concurrency[/color].

- 作者: uncutstone 2005年01月1日, 星期六 19:22  回复(0) |  引用(0)

三思论坛中关于逻辑的讨论
一个错误的命题可以推导出任意的命题。
 

- 作者: uncutstone 2004年12月28日, 星期二 22:05  回复(0) |  引用(0)