カスタムdistutilsコマンド

Question

グローバルサイトパッケージディレクトリにインストールする "example"というライブラリがあります。しかし、私は生産用とテスト用の2つのバージョンをインストールできるようにしたいと思います（私はこのようにバージョン管理されたWebアプリケーションと他のものを持っています）。

別のeggをサイトパッケージにインストールするだけでなく、モジュールの名前を "example"から "example_stage"などに変更する "python setup.py stage"という方法がありますか？

もしdistutilsがこれを行うことができないのであれば、他にもできるツールはありますか？

Answer 1

もちろん、distutilsを新しいコマンドで拡張することもできます。あなたのdistutilの設定ファイルでは、追加：

[global] 
command-packages=foo.bar 

これはdistutilsパッケージ自体でdistutils.cfg、ホームディレクトリ（Windowsの場合なし先頭のドット）で..pydistutils.cfg、または現在のディレクトリにsetup.cfgにすることができます。

次に、Pythonのsite-packagesディレクトリにfoo.barパッケージが必要です。

次に、stage、サブクラスdistutils.cmdなど、新しい目的のコマンドを実装するクラスを追加します。ドキュメントは弱いですが、既存のdistutilsコマンドもすべてその方法で構築されているので、たくさんの例があります。

Answer 2

複数のバージョンを使用する場合は、virtualenvとvirtualenvwrapperを使用してください。

Answer 3

distutilsでこれを行う方法をご希望の場合は、Alex's answerをご覧ください。しかし、私はPaverがこの種のものに適していると感じています。カスタムコマンドを作成したり、既存のコマンドを上書きする方がずっと簡単です。また、distutilsやsetuptoolsに慣れていると、移行は非常に難しいことではありません。

Answer 4

これは、distutilsを使用して簡単に行うことができます。distutils.core.Command setup.pyの中にサブクラス化します。例えば

：

from distutils.core import setup, Command 
import os, sys 

class CleanCommand(Command): 
    description = "custom clean command that forcefully removes dist/build directories" 
    user_options = [] 
    def initialize_options(self): 
     self.cwd = None 
    def finalize_options(self): 
     self.cwd = os.getcwd() 
    def run(self): 
     assert os.getcwd() == self.cwd, 'Must be in package root: %s' % self.cwd 
     os.system('rm -rf ./build ./dist') 

あなたが（設定でそれを参照する必要があり、コマンドを有効にするには）：あなたは、何としてもこのよう組み込みコマンドを無効にすることができ

setup(
    # stuff omitted for conciseness. 
    cmdclass={ 
     'clean': CleanCommand 
} 

注意私は「きれい」でやった。 （私は「DIST」と「ビルド」ディレクトリを残しどのようにビルトインバージョンが好きではありませんでした。）が使用されている規則の数

% python setup.py --help-commands | grep clean 
    clean   custom clean command that forcefully removes dist/build dirs. 

あります

• あなたが指定したが、任意のコマンドライン引数user_options。
• initialize_options（）メソッドで使用する変数を宣言します。これは、初期化後に呼び出され、サブクラスのカスタム名前空間を設定します。
• finalize_options（）メソッドは、run（）の直前に呼び出されます。
• コマンド自体の不具合は、run（）で発生します。その前に他の準備作業を行ってください。

使用するための最良の例では、まさにこのようなinstall.pyまたはbuild.pyとしてPYTHON_DIR /のdistutils /コマンドで見つけ、デフォルトのコマンドのいずれかのソースコードを見ることです。