easy_installがパッケージを見つけられません！

すべてのコンポーネントがうまく一緒に動作するように、TurboGearsはコンポーネントプロジェクトの特定のバージョンを要求するようにセットアップされますが、時々unreleasedなバージョンに依存するときがあるでしょう。このためeasy_installはPyPIで正しいパッケージを常に見つけられるとは限りません。

あなたのプラットフォームに合った ダウンロードの説明 に従っているかを確認してみてください。ダウンロードの説明では easy_install で -f (リンクを探す) オプションを使うようになっています。これによって easy_install はパッケージをどこに探しにゆけばよいか知るのです。

error: No local packages or download links found for TurboGears?

もしあなたがウェブにアクセスするのにプロクシを使う必要があるならば、 easy_install に対して環境変数 http_proxy を設定することによってプロクシを使うことを教えることができます。

このエラーはたいていファイアーウォールがパッケージのダウンロードを妨げていることを反映しています。これについてはPhillip Edyが以下のようにコメントしています:

この場合は（http://ntlmaps.sf.net/などを使って）ファイアーウォールをバイパスするような方法を探すか、あるいはダウンロードページにリストアップされているすべてのeggファイルを手動でダウンロードして

easy_install -f *dldir* TurboGears?

のように実行する必要があるでしょう。 *dldir*はeggファイルをダウンロードしたディレクトリです。

Conflict Warning

TurboGears?はPythonの新しいパッケージングシステムであるPython Eggs（Eggsの機能が提供するsetuptoolsも参照してみてください）というシステムに依存しています。もしあなたがEggsを使わずにパッケージをインストールすると、 easy_install はコンフリクトエラーを表示するでしょう。

TurboGears?を動作させるためには、Eggsで正しくインストールする必要があります。正しくインストールするための選択肢としては２つあります: non-rootインストールと、既存パッケージの削除です。

non-rootインストールは既存のPythonのセットアップを保持しますが、やや複雑です。あなたのシステムに異なるバージョンのライブラリが入ることを気にするようであれば、これは安心できる選択肢です。

既存のパッケージを削除する場合には、 easy_install コマンドを -D オプション付きで実行します。 easy_install は古いパッケージを新しいEggで置き換えるでしょう。例えばもしシステムに elementtree がインストールされている状態で -D オプション付きの easy_install コマンドを実行すると、古い elementtree パッケージは削除され、新しいEggがインストールされます。もちろんこの状態でも import elementtree することは可能です。

Error: Couldn't find a setup script in TurboGears?

Phillip Eby（setuptools/easy_install の作者）の説明は以下の通りです:

もしあなたが"Couldn't find a setup script in TurboGears?"というエラーに遭遇したならば、TurboGearsという名前のサブディレクトリがあるディレクトリで easy_install を実行していることを意味しています。``easy_install`` はあなたの要求に応じてTurboGearsディレクトリがあることを知り、それをインストールしようとするため、こういうことになってしまいます。そのディレクトリがTurboGearsの source でない限り、 easy_install は動きません。

こういうときには異なるディレクトリに移るか、TurboGearsという名前のサブディレクトリを削除してください。

またWindowsやOSXは大文字小文字を区別しないファイルシステムであることに気をつけてください。すなわち 'turbogears' という名前のディレクトリがある場合も同じ問題が起こります。

もしあなたがsetup.pyによってチェックアウトされたTurboGearsの中で easy_install を動かしているならば以下のようにしてください:

sudo easy_install -f http://www.turbogears.org/download/index.html --script-dir /usr/local/bin .

コマンドの最後に「TurboGears」ではなく '.' （ピリオド）があることに注意してください。これによってTurboGearsというサブディレクトリではなく、カレントディレクトリにインストールするということを easy_install に教えるのです。

"File exists"エラー

Windowsマシンでは、setuptoolsがcElementTreeを上書きする必要があると判断したときに問題が起こるようです。これを回避するための一番簡単な方法は --always-unzip オプションを付けて easy_install を実行することです。また Documents and Settings\Your User\Application Settings\Python Eggs ディレクトリを削除することによってもすぐにエラーを直すことができます。

error: invalid Python installation: unable to open /usr/lib/python2.4/config/Makefile (No such file or directory)

いくつかのDebianベースのLinuxシステムでは、Cのエクステンションをコンパイル可能にするために、 python2.4-dev パッケージをインストールする必要があるでしょう。