发掘Trac

使用何种工具做Feature或Defect或Task的跟踪一直是挺让我闹心的一件事。用Excel记录，但却不便于共享、统计和直观展示；Jira算是做的好的工具之一了，但无奈它是商业软件，咱没付那份儿钱，所以也就"无福享用"；Mingle是著名的Thoughtworks公司的产品，虽说不到5个license是可以免费使用的，但它却是出了名的"内存杀手"，无奈我的机器配置太差，运行起来实在太慢，遂没有坚持下去(我"眼冒金星"的渴望着更换一台无所不能的超级计算机^_^)；甚至我曾经用过ONENOTE来做跟踪，可是条目多了后，就基本不可用了。寻觅依旧进行中，这不Trac这款软件进入了我的视线中。

网络让我知道了"Trac"。"Trac"这个名字，估计与Track"异曲同工"。至于Trac具体能做什么，你可以到其Demo站点去体验一下。简单的说，Trac = wiki + 问题处理工作流；Wiki可以用来做知识积累和管理；问题处理工作流恰是我需要的功能。但到底Trac做到啥子程度，那还需要用起来后才能知道。还有一件让我觉得很"幸福"的事，那就是Trac自带一个独立的web server程序Tracd，并且Trac可使用Python 2.5.x自带的SQLite，这样我可以不用安装和配置庞大的Apache和MySQL了。让用户能快速上手应该是Trac值得其他开源软件学习和参考的一个亮点，要知道一些庞大的开源软件繁复的安装和配置过程让很多使用者产生了"挫败感"而"另辟蹊径"了。

Trac是用Python开发的，可以跨平台使用。这里我以Windows上的Trac为例。Trac官方站上有详尽的文档可以指导你的安装、配置和使用。这里用中文做简单介绍吧，留下一个记录，也便于自己以后参考。安装不是最重要的，但是没有了安装却是万万不能的。

1、安装Python, 设置环境变量
对于Trac而言，其解释执行环境Python是必不可少的，虽然Python发布了最新版是3.0.x，但是在已存的Python代码中，Python 2.x版本还是占据绝大多数，过渡到Python 3.0还需要时间。我这里用的是Python 2.5版本。安装完Python后，别忘了将{Python_INSTALL_DIR}和{Python_INSTALL_DIR}/Scripts加入到你系统的环境变量(path变量)中去(一般Python_INSTALL_DIR为"C:\Python25")。

2、使用Windows installers安装Trac
比起手动安装(Manual Install)，在Windows上使用Installer安装Trac更为简便。依次下载和安装：SetupTools、Genshi和Trac 0.11。注意要下载对应Python 2.5版本的安装文件。如果你要用Trac与Subversion接口的话，建议你下载一份svn-python程序，使用其他svn客户端程序似乎不好用。另外Trac只支持连接本地svn repository，不支持远程svn repository。以上安装程序会把相应可执行程序或脚本放到Python相关目录下，所以不需重新设置环境变量。

3、初始化一个工程
完成以上两步，你就可以使用Trac了。Trac运行和管理的基本环境单位是一个工程(Project)。首先你要确定你的工程所在的目录，这里以D:\TracProjects\Foo为例，我们建立一个名为"Foo"的Trac工程。打开一个命令行窗口，执行：
trac-admin.exe D:\TracProjects\Foo initenv
这是个交互执行的过程，你需要填写一些工程的基本信息，比如工程名字、数据库连接字符串等，你大可一路默认下来就可以得到一个默认的工程环境。

4、启动Trac
一切就绪。我们现在就可以启动Trac了。到目前为止，一切都是那么简单，这也充分证明Trac入门简单。在命令行下执行如下命令启动Trac Web server：
tracd.exe -p 8000 D:\TracProjects\Foo
现在你打开浏览器，访问Url: http://localhost:8000，Trac的界面就会展现在你面前。界面上你只能看到"Available Projects"的列表，由于我们只是建立了一个Project，所以你只能看到Foo这一个超链接。点击Foo，进入Foo的工程页面。

5、为Trac Project添加用户
Ticket是Trac Project管理和操作的基本元素，但是在通过上面方式以匿名登录方式打开的页面上你只能"View Tickets"，而无法"New Ticket"；要想拥有"New ticket"的权限，你需要以一个Trac用户的身份登录。初始情况下，Trac没有建立任何用户。Trac创建用户是通过建立"Password file"的方式来完成的。Trac默认的密码文件格式与Apache的相同，都是.htdigest格式的。如果你的系统内没有安装Apache，你可以用Trac wiki上提供的trac-digest.py脚本来生成密码文件。你可以将trac-digest.py文件放到{Python_INSTALL_DIR}/Scripts下面。

# trac-digest.py
from optparse import OptionParser
# The md5 module is deprecated in Python 2.5
try:
from hashlib import md5
except ImportError:
from md5 import md5
realm = 'trac'

# build the options
usage = "usage: %prog [options]"
parser = OptionParser(usage=usage)
parser.add_option("-u", "–username",action="store", dest="username", type = "string",
                  help="the username for whom to generate a password")
parser.add_option("-p", "–password",action="store", dest="password", type = "string",
                  help="the password to use")
parser.add_option("-r", "–realm",action="store", dest="realm", type = "string",
                  help="the realm in which to create the digest")
(options, args) = parser.parse_args()

# check options
if (options.username is None) or (options.password is None):
   parser.error("You must supply both the username and password")
if (options.realm is not None):
   realm = options.realm

# Generate the string to enter into the htdigest file
kd = lambda x: md5(':'.join(x)).hexdigest()
print ':'.join((options.username, realm, kd([options.username, realm, options.password])))

我们使用如下命令生成密码文件：
python trac-digest.py -u "foo" -p "foo123" >> d:\tracprojects\foo\conf\users.htdigest，
这里我们建立一个用户：用户名为foo，密码为foo123。

我们再次来启动Trac，这次由于带有了用户鉴权，启动命令行与前面略有不同。
tracd –port 8000 –auth=Foo,d:\tracprojects\foo\conf\users.htdigest,trac d:\trarojects\foo
启动后，我们点击login，Trac会提示我们输入用户名和密码，输入foo/foo123后，你就可以看到界面显示：logged in as foo，并且"New Ticket"菜单出现在页面上方。

6、Trac.ini
conf目录下的Trac.ini是针对Foo这个Trac Project的主配置文件。里面各个字段的含义说明在Trac官网都有说明。通过修改Trac.ini你可以很简单的在页面上添加你喜欢的Project Logo。

7、Ticket
Ticket是Trac的核心，默认情况下，Trac为Ticket设定了诸多属性，并且设定了围绕Ticket的默认工作流。对于Ticket的每个属性字段，我们都可以通过trad-admin工具对字段取值进行增删改，以适合你的需要。诸如：trac-admin d:\TracProjects\foo component add Webms foo，这句的含义就是添加一个属于foo工程的名为"Webms"的组件值。Ticket没有类似"Deadline"的时间属性，我们可以用milestone和priority来约束解决Ticket的时间范围。在"View tickets"页面中，Trac内置了多种"Report"，你同样也可以自定义搜索，但是目前用户尚不能在"View Tickets"中保存自定义搜索为固定的"Report"，但是你可以将自定义搜索语句放到一个WIKI页面的链接选项中，这样你就可以方便的直接得到搜索结果了，无需每次都配置搜索条件。

8、WIKI
Trac内置WIKI引擎，你可以通过trac-admin d:\TracProjects\foo wiki list来查看当前Project的所有WIKI page名称。你也可以通过trac-admin d:\TracProjects\foo wiki import WIKI_PAGE_NAME new_WIKI_page.txt为Foo Project导入一个名为"WIKI_PAGE_NAME"新WIKI页，该页内容来自文件new_WIKI_page.txt。和所有其他Wiki一样，你可以任意定制你的Project中的任意Wiki页面。

从上面的8个步骤来看，Trac简单而且实用，我已经根据我自己的需要对Trac Project进行了初步定制，并导入了我要追踪的需求、任务和问题，更多的高级功能还需要一段时间去发掘，今天的发掘到此为止了。