setuptools の開発が停滞し、 fork の distribute が開発を継続していた状態で、初心者にとって最初の大きな罠になっていました。 この2つがマージされることになり、 setuptools 0.7 がリリースされました。
移行手順
How do I upgrade... にあります。
setuptools からの upgrade
あまり居ないとおもいますが、 setuptools 0.6x を使っている場合は、 easy_install -U setuptools で upgrade できます。
distribute からの upgrade
移行用パッケージとして、 setuptools 0.7.x に依存する空の distribute 0.7 が提供されています。
ただしこの方法は実験的なものという扱いで、 distribute 0.7 は PyPI にはアップロードされていません。
easy_install -U https://bitbucket.org/pypa/setuptools/downloads/distribute-0.7.zip で、アップグレードインストールします。
クリーンインストールする場合は、まず今の setuptools, distribute を一旦アンインストールします。
site-packages ディレクトリで rm -rf setuptools* distribute* してください。
bin/ ディレクトリに easy_install コマンドが残っていますが、これは上書きインストールできます。
あとは https://bitbucket.org/pypa/setuptools/downloads からダウンロードした tar.gz ファイルを展開して、 python setup.py install で新規インストールするか、同じダウンロードページにある ez_setup.py を利用します。
