いくつかのモジュールを使う

より大きなウェブサイトをプログラムする時に、ソースコードをいくつかのモジュールに切り離す必要をすぐに感じると思います。これを行うには２つのやり方があります:

あなたのモジュールが完全に独立している場合。この場合、単にそのファイルを作成して(例:Hello1.cpy, Hello2.cpy, そしてHello3.cpy)、以下のようにコンパイルするだけです:
```
python ../cherrypy.py Hello1.cpy Hello2.cpy Hello3.cpy
```
CherryPyが生成する実行ファイルはHello1Server.pyと呼ばれるのに注意してください。
もしくは、一つのモジュールが他から必要とされている場合(たとえば、一つが他のもう一つによって使われているライブラリ)。この場合にやるべきことは、ファイルの一番最初の行でキーワードuse moduleをタイプすることです。これはPythonのimportのような働きをします。例えば、以下のようにすることができます:
```
***** File BoldTime.cpy: *****
import time

CherryClass BoldTime:
view:
    def getBoldTime(self):
        # Display the time in bold
        return "<b>%s</b>"%time.time()

***** File Hello.cpy: *****
use BoldTime

CherryClass Root:
view:
    def index(self):
        return "<html><body>Hello, time is %s</body></hello>"%boldTime.getBoldTime()
```
To compile this, just use:
```
python ../cherrypy.py Hello.cpy
```
注意点が５つあります。
- useステートメントはファイルの一番最初の行でなければいけません(その前の行にコメントを挿入してはいけません)。
- CherryPyは自動的に依存するもののリストを作成し、これに沿ってファイルを読み込み、実行ファイルを生成します。もし依存関係がループするものを作ってしまった場合、CherryPyはエラーを出します。
- ここでのCherryClassの名前はBoldTime (Bが大文字)です。よって、BoldTimeはファイル名であり、そしてuseステートメント内で使った名前でもあります。しかしboldTime.getBoldTimeを呼び出した時、小文字のbが使われます。なぜならこれは自動的に作成されたクラスのインスタンスを参照するからです。
- 通常のPythonのimportステートメントも使うことができます(import ...かfrom ... import ...のどちらか)
- もしuseを使ってたくさんのモジュールをインクルードする場合、「use」ステートメントをいくつかの行に切り分けることができます(それらがファイルの最初の行でなければいけません)。たとえば、以下のように使うことができます。
```
****** File Root.cpy: *****
use HttpAuthenticate, CookieAuthenticate
use Mail, MaskTools

CherryClass Root:
mask:
        def index(self):
                OK
```

仮にモジュールが同じディレクトリにない場合はどうしましょう？

ええと、必要なことは -Iオプションをファイルをコンパイルする時に使うことです。これはCherryPyにファイルを入力する時にCherryPyが捜し出すディレクトリを指定することができます。たとえば、もし以下のファイルだった場合:

/dir1/Module1.cpy
/dir2/Module2.cpy
Hello.cpy (uses Module1 and Module2)

あなたはHello.cpyを以下を使ってコンパイルします:

python ../cherrypy.py -I /dir1 -I /dir2 Hello.cpy

デフォルトでは、CherryPyは., ../libと../srcを探します。

CherryPyがインストールされているディレクトリ名を含むCHERRYPY_HOMEとよばれる環境変数を設定することもできます。この場合、CherryPyはモジュールを探すのにCHERRYPY_HOME/libとCHERRYPY_HOME/srcを探します。

次の章では、CherryPyのいくつかの標準モジュールの使い方について学ぶことにします。

Debian User 2003-10-13