迁移到 Subversion

CVS 存在许多限制，这些限制已被 Subversion 消除。对于 Python 的开发而言，最显著的改进是

• 能够重命名文件和目录，并删除目录，同时保留这些文件的历史记录。
• 通过全局版本号支持变更集（对多个文件进行关联更改的集合）。变更集是事务性的。
• 原子化、快速的标记：CVS 标记可能需要很多分钟；Subversion 标记（svn cp）将快速且原子化地完成。同样，分支也非常高效。
• 支持离线 diff，这在创建补丁时非常有用。

迁移到 python.org

过去几年，SourceForge 提供了重要的基础设施。不幸的是，SF 受到的关注也导致过去多次出现过载情况，SF 运营商无法总是及时响应。特别是对于 CVS，他们不得不通过引入第二个只读 CVS 服务器用于匿名访问来减轻主 CVS 服务器的负载。该服务器定期同步，但在同步之间滞后于读写 CVS 仓库。因此，没有提交访问权限的用户只能在延迟后才能看到仓库的最新更改。

在 python.org 上，可以使仓库可供匿名访问。

收集 SSH 密钥

经过一番讨论，svn+ssh 被选为仓库写入访问的最佳方法。开发人员可以继续使用他们的 SSH 密钥，但它们必须安装在 python.org 上。

为了避免为每个开发人员创建新的 Unix 用户，应使用单个帐户，并在 authorized_keys 文件中使用 command= 属性。

authorized_keys 文件中的行应如下所示（为便于阅读而换行）

command="/usr/bin/svnserve --root=/svnroot -t
--tunnel-user='<username>'",no-port-forwarding,
no-X11-forwarding,no-agent-forwarding,no-pty
ssh-dss <key> <comment>

作为用户名，应使用真实姓名而不是 SF 帐户名，以便在日志消息中更好地识别人员。

管理员访问

应授予 Python SF 项目所有当前管理员对 pythondev 帐户的管理员访问权限。为了区分 shell 登录和 svnserve 登录，管理员需要维护两个密钥。使用 OpenSSH，可以使用以下过程创建第二个密钥

cd .ssh
ssh-keygen -t DSA -f pythondev -C <user>@pythondev
vi config

在配置文件中，需要添加以下行

Host pythondev
  Hostname dinsdale.python.org
  User pythondev
  IdentityFile ~/.ssh/pythondev

然后，可以通过“ssh pythondev”进行 shell 登录。

下载 CVS 仓库

CVS 仓库可以从以下地址下载：

http://cvs.sourceforge.net/cvstarballs/python-cvsroot.tar.bz2

由于此 tarball 每天只生成一次，因此在仓库冻结后需要经过一段时间才能获取 tarball。应验证 python-commits 邮件列表中记录的最后一次提交确实包含在 tarball 中。

转换后，转换后的 CVS tarball 应永久保存在 www.python.org/archive/python-cvsroot-.tar.bz2

转换 CVS 仓库

Python CVS 仓库包含两个模块：distutils 和 python。python 模块进一步分为 dist 和 nondist，其中 dist 只包含 src（Python 代码本身）。nondist 包含各种子目录。

这些应在 Subversion 仓库中重新组织，以获得更短的 URL，遵循 <项目>/{trunk,tags,branches} 结构。将为每个 nondist 目录创建一个项目，以及用于 src（称为 python）和 distutils。重新组织仓库最好在 CVS 树中完成，如下所示。

应使用 fsfs 后端作为仓库格式（这需要 Subversion 1.1）。fsfs 后端具有更利于备份的优点，因为它允许增量仓库备份，而无需运行任何 dump 命令。

转换应使用 cvs2svn 实用程序完成，例如在 cvs2svn Debian 包中可用。由于 cvs2svn 目前不支持 project/trunk 结构，因此每个项目都需要单独转换。为了将每个转换结果放入目标仓库中的单独目录，必须使用 svnadmin load。

Subversion 对二进制文件与文本文件的看法与 CVS 不同。为了正确地传递 CVS 语义，应将所有在 CVS 中未标记为二进制的文件上的 svn:eol-style 设置为 native。

总之，转换脚本是

#!/bin/sh
rm cvs2svn-*
rm -rf python py.new
tar xjf python-cvsroot.tar.bz2
rm -rf python/CVSROOT
svnadmin create --fs-type fsfs py.new
mv python/python python/orig
mv python/orig/dist/src python/python
mv python/orig/nondist/* python
# nondist/nondist is empty
rmdir python/nondist
rm -rf python/orig
for a in python/*
do
  b=`basename $a`
  cvs2svn -q --dump-only --encoding=latin1 --force-branch=cnri-16-start \
  --force-branch=descr-branch --force-branch=release152p1-patches \
  --force-tag=r16b1 $a
  svn mkdir -m"Conversion to SVN" file:///`pwd`/py.new/$b
  svnadmin load -q --parent-dir $b py.new < cvs2svn-dump
  rm cvs2svn-dump
done

此转换的示例结果可在以下地址获得：

http://www.dcl.hpi.uni-potsdam.de/pysvn/

发布仓库

仓库应发布在 http://svn.python.org/projects。应通过 svn+ssh://pythondev@svn.python.org/ 授予所有当前 SF 提交者读写访问权限；还应通过 WebDAV 授予只读匿名访问权限。

作为选项，可以提供 websvn（例如来自 Debian websvn 包）。不幸的是，在测试安装中，websvn 因为内存不足而崩溃。

当前的 SF 项目管理员应获得 pythondev 帐户的 authorized_keys2 文件的写入权限。

禁用 CVS

CVS 似乎无法完全禁用。只能从项目页面中删除用户界面；仓库本身仍然可用。如果需要，可以通过 CVS commitinfo 条目禁用对 python 和 distutils 模块的写入访问权限。