virtualenv-sh

（virtualenvのの使用を容易にするためのシェル関数の集合）;

virtualenvの-SHは、由緒あるvirtualenvwrapper＆NBSPの代用である。
開発者のコ​​メント
多くのように、私は何年もvirtualenvwrapper使ってきたが、それは時間をかけて重いビットを得ています。私は最終的に私が唯一の基本的な機能を使用する傾向があったにもかかわらず、新しいシェルが起動するために自分があまりにも長い間待っていた。
このプロジェクトは、その問題を解決するための試みである。私は、virtualenvwrapperの巧妙なビットを借り、私は高価なまたは単に面白くないと考え、すべてを捨てて、機能や自分のうちの2つを追加しました。このプロジェクトの最優先事項は、スピードです。 grepのかsedのような標準的なツールの1つまたは2つの呼び出しがあるかもしれないが、コードは、ほぼ純粋なシェルスクリプトです。
この実装はあなたのためではないかもしれないと警告される。それは高価だったので、私はどちらか、あなたが好きな特徴を取り除く得ているか、または私はそれを気にしなかったため。私が誤って私が遭遇していないいくつかの環境のための修正または回避策を捨てた可能性があります。私はちょうど導入された新しいバグ（シェルが微妙に間違って取得する簡単な言語である）を有することができる。自分自身の責任で行って下さい。
のインストールの
virtualenvの-SHは、PIPまたはeasy_installを一緒にインストールすることができます。それを使用するには、シェル環境で、単一のシェルスクリプトをソースにする必要があります。デフォルトでは、PIPまたはeasy_installをは/ usr / local / binにインストールする必要があります。あなたはbashやzshを使用している場合は、シェル固有のスクリプトをインポートする必要があり、そうでなければ、あなたは一般的なものを試すことができます。シェルのinitスクリプト（.bashrcの、.zshrcなど）に、次のいずれかを追加します。
。 /usr/local/bin/virtualenv-sh.bash
。 /usr/local/bin/virtualenv-sh.zsh
。 /usr/local/bin/virtualenv-sh.sh
他に何もする必要はありません。あなたがWORKON_HOMEある構成で、使用できる唯一の​​環境変数があります。これはvirutalenvsのあなたのコレクションへのパスです。あなたは$ {HOME} /のデフォルトを受け入れ、空白のままにすることができます。virtualenvs。それは、それ自身がパスに含まれているVIRTUALENVあるとする。
WORKON_HOME = $ {HOME} /。virtualenvs
のzshの
の
あなたはzshを使用している場合、これはあなたのマシン上でソースからコンパイルする必要がありますが、その代わりに、最適なパフォーマンスを得るためにプリコンパイルされた関数アーカイブを使用することができます。あなたは直接ソースをダウンロードしたり、試すことができます。
 --upgrade --no-インストールvirtualenvの-SHをインストールピップ
CDビルド/ virtualenvの-SH
sudoはmake installを
これは、あなたのパスにzshのを見つけvirtualenvの-sh.zwcをコンパイルするためにそれを使用し、/ usr / local / binにそれをインストールします。これで、これらの関数を自動ロードとvirtualenvの-SHを初期化することができます。あなたは、このプロセスに精通していないのであればzshのマニュアル内の関数のオートロードの項を参照したい場合があります。
＃は、自動ロードのためのすべてのvirtualenvの-SHの機能を設定します
FPATH =（は/ usr / local / binに/ virtualenvの-SHます$ FPATH）
オートロード-wは/ usr / local / binに/ virtualenvの-SH
＃主な初期化関数を呼び出します
virtualenv_sh_init
のの使い方
virtualenvの-SHの基本的なコマンドは、基本的にvirtualenvwrapperと同じです。ここでは簡単な要約です：
＆NBSP; mkvirtualenv
＆NBSP; $ WORKON_HOMEで新しいvirtual_envを作成します。すべての引数は、virtualenvのに直接渡されます。新しいvirtual_envがアクティブになります。 virtualenvwrapperとは異なり、これは追加の引数を取りません。
＆NBSP; rmvirtualenv
＆NBSPは、既存のvirtual_envを削除します。このvirtual_envが現在アクティブである場合、それは礼儀として最初に不活性化される。
＆NBSP; ] workon
＆NBSP;というvirtual_envをアクティブにします。別virtual_envが現在アクティブである場合には、最初に無効になります。引数がなければ、利用可能なvirtual_envsの一覧を表示します。
＆NBSP; autoworkon
＆NBSPは、自動的に特別なファイルに基づいてvirtual_envを設定します。下記参照。
＆NBSP;無効化
＆NBSP;（直接virtualenvの使用しているときのように）現在のvirtual_envを無効にします。
＆NBSP; lsvirtualenvs
＆NBSP;あなたが作成したvirtual_envsのリストを出力します。
＆NBSP; cdvirtualenv [サブディレクトリ]
＆NBSPは、アクティブvirtual_envのルート、またはそのサブディレクトリにカレントディレクトリを変更します。
＆NBSP; lssitepackages
＆NBSP;アクティブvirtual_envのsite-packagesディレクトリの内容を一覧表示します。
＆NBSP; cdsitepackages [サブディレクトリ]
＆NBSPは、アクティブvirtual_envのsite-packagesディレクトリ、またはそのサブディレクトリにcurrectディレクトリを変更します。
のフックの
virtualenvの-shがvirtualenvwrapperと同じグローバルとローカル（パー-ENV）のフックをサポート。グローバルフックは$ WORKON_HOME内のファイルです。地元のフックは、$ WORKON_HOME / {virtual_env} / binにあるファイルです。フックは、現在のシェルのコンテキストでそれらを調達することによって実行されます。
＆NBSPは、初期化（グローバル）
＆NBSP; virtualenv_sh_initの最後に呼び出されます。
＆NBSP; premkvirtualenv、postmkvirtualv、prermvirtualenv、postmkvirtualenv（グローバル）
＆NBSP; mkvirtualenvとrmvirtualenvの最初と最後に呼び出されます。
＆NBSP;予備活性化、postactivate（グローバル、ローカル）。 predeactivate、postdeactivate（ローカル、グローバル）
＆NBSP; virtual_envのアクティブ化および非アクティブ化を中心に示された順序で呼び出されます。
また、virtualenvの-SHは、あなたが動的にフックを実行したときに呼び出される関数を登録することができます：
virtualenv_sh_add_hook <関数名>
virtualenv_sh_remove_hook <関数名>
例えば：
my_virtualenv_cleanup（）
{
＆NBSP;＃ここでいくつかのものを行う
}
virtualenv_sh_add_hook postdeactivate my_virtualenv_cleanup
登録されたフック関数は、常にすべてのグローバルとローカルフックスクリプトの後に実行されます。
autoworkon のの
autoworkonは、自動的に現在のディレクトリに基づいてvirtual_envを更新するように設計された新しいコマンドです。ときに、現在のディレクトリの変更機能を実行するための標準のシェルメカニズムがないことに注意してください - と多くのシェルは、そのような仕組みを持っていない - ので、これはあなた次第ですインストールする。あなたはzshを使用している場合は、使用します。
自動ロードは、アドオンのzsh-hookを-U
アドオンzshのフックchpwd autoworkon
それが根に達するか、「.workon」という項目を見つけたのどちらかになるまでautoworkon関数は、現在のディレクトリからファイルシステムを歩いていく。これが可能なファイルである場合は、virtual_env名として最初の行を処理し、それを活性化する。心に留めておくべき特別なルールがいくつかあります：
- autoworkonは常に、最初に見つかっ.workonで停止します。これは、異なるレベルで異なるvirtual_envsを使用するようにディレクトリツリー内の複数のポイントで.workonファイルを持つことは完全に合理的です。
- 空または読めない.workonファイルが「NO virtual_env」と解釈されます。あなたが特定のサブツリーに自動virtual_envを無効にしたい場合に便利です。
- 手動でvirtual_envを有効にした場合、autoworkonは、それを上書きすることはありません。それが設定されていない、または以前autoworkonによって設定された場合autoworkonは、あなたのアクティブなvirtual_envに変更されます。