关于Daily Build的ant 脚本中列出svn log 的步骤

最近闲着没事，真的是很闲，居然要我去看看oracle数据库performance tuning,而且应为太闲，发现了effective oracle by design 的第八章了，是itpub 上的一位会员找tom ，要的，这个帖子在 http://www.itpub.net/221173,2.html , 超爆笑，具体请看我的另一篇文章

因为公司的QA抱怨说速度很慢,我们只有Stage环境，生产环境不在我们这边，公司唯一的一个DBA 被派去做enhancement 了(汗) ,于是被指派研究如何在ant 脚本中显示svn 中的commit 消息.需求大概是这样的:

每次commit 的时候我们都会填写commit 的message , 比如 bug fix #98435 : <<bug description="">> 或者类是 EN #19841 : <<xxxx enhancement="">> , 然后我们的Stage 环境，就是大家可以公共访问的环境也同时提供给QA 做test 的环境，每天会更新两次早上8：30一次（这个时候大家还没有上班），然后下午5：00一次（我们6:00下班），8：30更新的时候公司没人，主要是针对昨天新做完的EN 和 5点过后check in 的bug , 5：00 的更新最要是让QA 做Bug verify (因为每天结束了，Team Leader 要把bug 发到美国那边去，美国那边就不用做重复的工作了) .我们以前有什么check in 都是Team Leader 发邮件给QA , 告诉他们那些bug check in 了，那些enhancement check in 了，然后全部都是靠搜集我们每天提交给他的work list , 然后他就凭脑袋记住然后发邮件给QA , 这样一个是容易出错，有可能是我们自己写的work list 出错了，比如写错了bug number ,另一个是Team Leader 忘记搜集某个人work list 了( 我们不用issue tracking 工具，因为美国那边认为不值得花钱买一个JIRA , 而且他们相信他们用手工的方式工作了多年也没有什么很大的问题，即使我们自己用开源的issue tracking 工具,他们也拒绝合作，强吧），所以就要我写个ant script 来自动在邮件里面列出更新了bug 或者enhancement.</xxxx></bug>

现在的情况：
我们已经有ant script 可以执行 更新code > 编译code > 混淆 code > 最后发邮件给所有人 ， 我们更新的时候是用的windows 系统的task scheduler.

改变之后的状态：
update 的时候要有update log 和 更新的文件列表 , 邮件里面要有update.log 的消息

方便QA 快速知道开发的状态.

用ant 脚本来更新code 都是用的svnkit 包，首先下载svnkit 包, 大概是以下几个文件，svnkit.jar , svnant.jar , SvnClientAdapter.jar ，svnjavahl.jar（文件名记得不是很清楚了）,放到ant 的lib 目录下面, 具体参考http://subclipse.tigris.org/svnant.html 上面的文档.

我查了一下如何显示svn 的update log 方法 :

http://svnbook.red-bean.com/en/1.0/re15.html

你要先装svn 的客户端（运行这个例子的时候需要，不是你用svnkit 的时候需要)

然后

svn log [PATH]

svn log URL [PATH...]

它有几个参数:
--revision (-r) REV
--quiet (-q)
--verbose (-v)
--targets FILENAME
--stop-on-copy
--incremental
--xml
--username USER
--password PASS
--no-auth-cache
--non-interactive
--config-dir DIR

比如：
svn log http://svn.red-bean.com/repos/test/foo.c
它会列出所有的foo.c 这个文件的所有修改历史

svn log http://svn.red-bean.com/repos
它会列出你整个项目的修改历史

svn log http://svn.red-bean.com/repos -r 14 >mylog.txt
svn log http://svn.red-bean.com/repos -r 19>>mylog.txt
svn log http://svn.red-bean.com/repos -r 20>>mylog.txt
它会先创建一个revision 14 的mylog.txt 文件，后面两个命令会把revision 19 个和revision 20 的log 加入到mylog.txt 文件中.
关于svn log 命令行的详细用法请参考
http://svnbook.red-bean.com/en/1.0/re15.html

接着我就研究怎么样在ant script 里面加入svn 的log 信息.

我发现打开svnant.jar 包的时候里面有个 svn.xml 文件，里面记录的就是所有svnkit 支持的svn ant task . 其中只需要一个就够了，

<taskdef classname="org.tigris.subversion.svnant.SvnTask" name="svn"></taskdef>

接着我就写script ,

<taskdef classname="org.tigris.subversion.svnant.SvnTask" name="svn"></taskdef>

<!----><target name="updateSVN"><svn javahl="true" password="xxxPassword" username="xxxUser"><svn javahl="true"><log destfile="revision.log"></log></svn></svn></target>

<target name="updateSVN"><svn javahl="true" password="xxxPassword" username="xxxUser"><svn javahl="true"><echo message="Update finished successfully, please see revision.log for version information!">
</echo></svn></svn></target>

其中startRevision 和 stopRevision 的值可以是

这段代码就是在你的script 目录下面会产生一个revision.log 文件，大概这样的格式

------------------------------------
r14 | ... xxx bug fix #123456 :xxx

------------------------------------
r15 | ... xxx en #123456 : xxx

------------------------------------

然后发邮件:
<target depends="obfuscate" name="email"> <mail mailhost="xxx.xxx.xxx"><from address="developers@xxx.com" name="xxx"></from></mail></target>

<target depends="obfuscate" name="email"><mail mailhost="xxx.xxx.xxx"><from address="developers@xxx.com" name="xxx"> </from></mail></target>

#---
# Excerpted from "Everyday Scripting in Ruby"
# We make no guarantees that this code is fit for any purpose. 
# Visit http://www.pragmaticprogrammer.com/titles/bmsft for more book information.
#---
class SubversionRepository
  def initialize(root)
    @root=root
  end
  def date(a_time)
    a_time.strftime("%Y-%m-%d")
  end
  def change_count_for(name, a_time)
    extract_change_count_from(log(name, date(a_time)))
  end
  def extract_change_count_from(log_text)
    lines = log_text.split("\n")
    dashed_lines = lines.find_all do | line |
      line.include?('--------') 
    end
    dashed_lines.length - 1     
  end
  def log(subsystem,start_date)
    timespan = "--revision HEAD:{#{start_date}}"
    `svn log #{timespan} #{@root}/#{subsystem}`
  end
end
class Formatter
  
  # Public interface 
  def initialize
    @lines = []
  end
  def report_range(from, to)
    @from = from
    @to = to
  end
  def use_subsystem_with_change_count(name, count)
    @lines.push(subsystem_line(name, count))
  end 
  def output
   ([header] + lines_ordered_by_descending_change_count).join("\n")
  end
  # Helpers   
  
  def date(time)
    date_format = "%Y-%m-%d"
    time.strftime(date_format).sub(' 0', ' ')
  end
  
  def header
    "Changes between #{date(@from)} and #{date(@to)}:"
  end
  
  def subsystem_line(subsystem_name, change_count)
    asterisks = asterisks_for(change_count)
    "#{subsystem_name.rjust(14)} #{asterisks} (#{change_count})"
  end
  
  def asterisks_for(an_integer)
    '*' * (an_integer / 5.0).round
  end
  
  def lines_ordered_by_descending_change_count
    @lines.sort do | first, second |
      first_count = churn_line_to_int(first)
      second_count = churn_line_to_int(second)
      - (first_count <=> second_count)
    end
  end
  
  def churn_line_to_int(line)
    /\((\d+)\)/.match(line)[1].to_i
  end
end
def month_before(a_time)
  a_time - 28 * 24 * 60 * 60
end


if $0 == __FILE__
  subsystem_names = ['lib', 'test']
  root = "http://127.0.0.1/svn/script/trunks/"
  repository = SubversionRepository.new(root)
  last_month = month_before(Time.now) 
  
  formatter = Formatter.new
  formatter.report_range(last_month, Time.now)
  subsystem_names.each do | name |  
    formatter.use_subsystem_with_change_count(
                                              name, repository.change_count_for(name, last_month)) 
  end
  puts formatter.output
end