Github: https://github.com/joblib/joblib
ユーザーマニュアルを含むjoblibのホームページは、次の場所にあります。
https://pythonhosted.org/joblib/
最新のコードを取得する
gitを使って最新のコードを入手するには、次のように入力します。
git clone git://github.com/joblib/joblib.git
gitがインストールされていない場合は、最新のコードのzipまたはtarballをダウンロードできます: http : //github.com/joblib/joblib/archives/master
インストール
pipを使ってjoblibをインストールすることができます:
pip install joblib
任意のディレクトリから、または:
python setup.py install
ソースディレクトリから取得します。
JoblibはPython(依存バージョンは2.7以上、3.4以上)以外の依存関係はありません。 Numpy(少なくともバージョン1.6.1以上)は、配列操作のオプションの依存関係です。
貢献するワークフロー
joblibに貢献するには、まずgithubでアカウントを作成します。 これが完了したら、 joblibリポジトリを自分のリポジトリにフォークし、作業したいコンピュータ上で ‘git clone’を使ってクローンします。 クローンを変更してgithubアカウントにプッシュし、複数のコンピュータでそれらをテストし、満足したらメインリポジトリにプルリクエストを送信します。
テストスイートの実行
テストスイートを実行するには、pytest(バージョン> = 3)およびカバレッジモジュールが必要です。 以下を使用してテストスイートを実行します。
pytest joblib
プロジェクトのルートから
ドキュメントの作成
ドキュメントを構築するには、sphinx(> = 1.4)といくつかの依存関係がインストールされている必要があります:
pip install -U -r .readthedocs-requirements.txt
ドキュメントは、次のコマンドでビルドすることができます。
make doc
htmlドキュメントは、 doc/_build/html
ディレクトリにあります。
ソースtarballを作る
パッケージングや配布などのソースtarballを作成するには、次のコマンドを実行します。
python setup.py sdist
tarballはdistディレクトリに作成されます。 このコマンドはドキュメントをコンパイルし、結果として得られるtarballは、Python標準ライブラリよりも余分な依存関係なしでインストールすることができます。 setuptoolとsphinxが必要です。
リリースを作成してPyPIにアップロードする
このコマンドはプロジェクトマネージャによってのみリリースされ、PyPIにアップロードされます:
python setup.py sdist bdist_wheel upload_docs --upload-dir doc/_build/html twine upload dist/*
変更ログの更新
変更はCHANGES.rstファイルに記載されています。 それらは手動で更新する必要がありますが、以下のgitコマンドを使って行を生成することができます:
git log --abbrev-commit --date=short --no-merges --sparse
ライセンス
joblibはBSD-licensedです (3節)。
このソフトウェアはOSI認定オープンソースソフトウェアです。 OSI CertifiedはOpen Source Initiativeの認証マークです。
Copyright(c)2009-2011、joblib developpersすべての権利を保有します。
次の条件が満たされていれば、ソースおよびバイナリ形式での再配布および使用は、変更の有無にかかわらず許可されます。
- ソースコードの再配布には、上記の著作権表示、この条件リスト、および以下の免責条項を保持する必要があります。
- バイナリ形式で再配布する場合は、上記の著作権表示、この条件一覧および次の免責条項を、配布に付属のドキュメントおよび/またはその他の資料に複製する必要があります。
- Gael Varoquauxの名前もありません。 特定の書面による事前の許可なしに、このソフトウェアから派生した製品を推薦または宣伝するために、他のジョブリブ貢献者の名前を使用することはできません。
このソフトウェアは著作権者および寄稿者によって「現状有姿」で提供されており、商品性および特定目的への適合性の黙示の保証を含むが、明示または黙示の保証は一切否認されます。 いかなる場合でも、著作権者または寄稿者は、直接的、間接的、偶発的、偶発的、特別、模範的、または結果的損害(代替商品またはサービスの調達、使用、データまたは利益の喪失、本ソフトウェアの使用から何らかの形で生じた契約上、厳格責任上、または不法行為(過失を含む)に関わらず、たとえそのような損害の可能性について知らされた場合であっても責任を負いません。