-
Notifications
You must be signed in to change notification settings - Fork 0
開発用Kawazのインストール
Warning
ここでは開発用のKawazをインストールするための方法が書かれています。 公開用のKawazのインストール方法は Django serverの構築 および Django serverを用いてKawazを公開する を参照してください
下記の手順をほぼ全自動で行うスクリプトを用意したので忙しい人はこっちを利用してください。なおKawazのクローン先はホームディレクトリになります。
curl https://raw.github.com/gist/1224448/kawaz.sh | bash
wget -q -O - https://raw.github.com/gist/1224448/kawaz.sh | bash
Pythonの開発環境を pythonbrew を用いて構築します。pythonbrewを用いる利点として
- 複数バージョンのPythonの切り替えが容易
- 多様な環境での開発が容易（簡単にクリーンな環境を構築可能）
- Mac OS Xにてnarrow build pythonではなくwide build pythonを容易に使用可能
などが挙げられます。なおこの部分だけ自動インストールしたい場合は上記の自動インストーラーのURLを https://raw.github.com/gist/1224448/7ac17e00d0a354a1d6f253ca1dc5ca8e42e1412e/buildenv.sh に書き換えればおｋ
pythonbrewをインストールします。 curl などのコマンドが入っていないUbuntuなどのOSではまず下記のコマンドを実行して必要なパッケージをインストールしてください:
sudo apt-get install curl python-all-dev python3-all-dev sudo apt-get install libreadline6-dev libsqlite3-dev libgdbm-dev sudo apt-get install libbz2-dev build-essential libxml2-dev libxslt1-dev
つぎに curl コマンドを利用してワンライナーでpythonbrewをインストーするします。下記コマンドをターミナルで実行してください:
curl -kL http://xrl.us/pythonbrewinstall | bash
最後に以下の行を .bashrc や .bash_profile などのrcファイルに記載してターミナルをリロード（方法がわからない場合はターミナルの再起動）をしてください:
# pythonbrew
if [ -s "$HOME/.pythonbrew/etc/bashrc" ]; then
source "$HOME/.pythonbrew/etc/bashrc"
fi
最後に仮想環境を利用するための下準備を行います。以下のコマンドを実行してpythonbrewに virtualenv パッケージをインストールしてください:
pythonbrew venv init
容易にクリーンな開発環境を構築するために開発は仮想環境上で行うこととします。以下コマンドによりKawaz用仮想環境を構築してください:
pythonbrew venv create -n Kawaz
なおコマンド中の -n オプションはシステムパッケージを読み込まない（クリーンな環境）ことを設定しています。
これで仮想環境ができたので以下コマンドによって作成した仮想環境を使用してください。このコマンドは毎度Kawazの開発を開始する前に実行してください:
pythonbrew venv use Kawaz
なお、以下のようなエイリアスをrcファイルに記載しておくと virtualenvwrapper 的な使い方ができて楽です:
alias mkvirtualenv="pythonbrew venv create" alias rmvirtualenv="pythonbrew venv delete" alias workon="pythonbrew venv use"
Kawazレポジトリをクローンしてきます。コラボレーターとしてクローンしないとコミットができないので注意してください（コラボレーター権限は管理者に問い合せてください）:
git clone [email protected]:kawazrepos/Kawaz.git
PILのコンパイルにはいくつかのパッケージが必要だったりリンクを適切に行う必要があったりする。 これらについてはパッチを用意したため以下のコマンドをターミナルにて実行すれば良い。
curl https://raw.github.com/gist/1229763/patch.sh | bash
$ wget -q -O - https://raw.github.com/gist/1225180/patch.sh | sudo bash
Kawazを開発バージョンとしてインストールします。これにより実際にはインストールではなくシンボルリンクが作成されるため編集の即時反映が行われます。
また setup.py には必要なパッケージ等が指定されているため自動的にこの段階で必要なPythonパッケージがインストールされます:
cd Kawaz python setup.py develop
以上で環境構築は完了です。以下コマンドを実行後 http://localhost:5000/ にアクセスしてKawazがエラーなく起動するか確認してください:
python src/Kawaz/manage.py syncdb python src/Kawaz/manage.py runserver 5000
なおKawazではデザインなどを見るためにデフォルトで大量のサンプルデータを用意しています。このサンプルデータを見るためには以下のコマンドを実行して サンプルデータをデーターベースに書きこんでください。 既存データーベースが上書きされるためこのコマンドは注意して実行すること:
python src/Kawaz/manage.py loaddata debug
このコマンドを実行することで大量のサンプルデータがデータベースに書きこまれます。なおサンプルデータの出典などは AUTHORITIES.rst に記載してあります。