我的Wiki | Python / 安装TurboGears2

怎样安装TurboGears 2

强烈建议在虚拟环境中安装TurboGears 2，例如virtualenv

安装条件

Python
Setuptools ?
数据库及其驱动
其他依赖
virtualenv

Python

虽然TurboGears可以工作在从2.4到2.6版本的Python，但是强烈建议在Python 2.5环境下安装TurboGears，因为2.4和2.6版的Python都需要额外的步骤才能使得TurboGears正常工作。

Python 3.0 当前并不被支持。

获得Python版本信息的命令：

    $ python -V
    Python 2.5.4

安装setuptools ?

Windows 环境

下载 http://peak.telecommunity.com/dist/ez_setup.py 并在命令行运行

Unix环境（需要root权限）

    $ wget http://peak.telecommunity.com/dist/ez_setup.py | sudo python

当然你完全可以使用系统已经安装好的setuptools

Unix环境（非root权限）

TODO

升级setuptools

推荐使用setuptools 0.6c9或更高版本，如果系统原来的setuptools版本过低，可以使用如下命令升级：

    $ easy_install -U setuptools

可以使用如下命令确认版本

    $ python
    >>> import setuptools
    >>> setuptools.__version__
    '0.6c9'

数据库及其驱动

TurboGears 使用 SQLAlchemy 作为它缺省的 ORM 层。

SQLAlchemy支持的数据库列表

Python 2.5或更高版本已经内含支持了SQLite，而Python 2.4需要安装pysqlite。

如果需要支持MySQL，还需要安装MySQLdb。
注意，可能需要在激活了virtualenv虚拟环境后安装。

安装非Python依赖

大多数情况可能需要C编译器和Python的头文件。

Windows

在我们的包索引里，包含了为Windows预编译的二进制文件。

你也需要Pywin32包。

Debian, Ubuntu

    $ apt-get install python-dev
    $ apt-get install build-essential

RedHat, Fedora, CentOS

    $ yum install python-devel

Gentoo

Gentoo不需要安装更多的东西了

other Linux and unix

需要GCC编译器和Python头文件

安装virtualenv

强烈建议在Virtualenv环境下安装TurboGears

安装TurboGears

手工安装

首先，cd 到打算安装Turbogears 2的虚拟环境的目录，注意virtualenv将会在这里建立子目录。

现在建立一个新的虚拟环境，名叫tg2env

    $ virtualenv --no-site-packages tg2env

Activate 你的 virtualenv

首先进入虚拟环境

    $ cd tg2env

在Windows下激活虚拟环境的命令：

    Scripts\activate.bat

在Unix下激活虚拟环境的命令：

    $ source bin/activate

安装 Turbogears 2

使用如下命令可以安装最新版本的 TurboGears ：

    (tg2env)$ easy_install -i http://www.turbogears.org/2.0/downloads/current/index tg.devtools

注意：如果你是从以前的TG2版本升级，命令是：

    (tg2env)$ easy_install -U -i http://www.turbogears.org/2.0/downloads/current/index tg.devtools

TurboGears 和它所有的依赖将被下载并自动安装。（这将花费几分钟时间）

Deactivating 虚拟环境

当完成工作后，撤销激活虚拟环境：

    (tg2env)user@host:~/tg2env$ deactivate
    user@host:~/tg2env$

这并不是必须的，但是确实一个好习惯。

验证安装

要检查 TurboGears 2 是否正确安装，输入：

    (tg2env)$ paster --help

安装TurboGears2