パッケージシステム

Ergのパッケージはアプリケーションであるappパッケージとライブラリであるlibパッケージに大別できます。 appパッケージのエントリポイントはsrc/app.erです。app.er内に定義されたmain関数が実行されます。 libパッケージのエントリポイントはsrc/lib.erです。パッケージをインポートすることはlib.erをインポートすることと等価になります。

パッケージにはモジュールという下位構造があります。Ergにおいてモジュールとはすなわち、Ergファイルもしくはそれで構成されたディレクトリです。外部のErgファイル/ディレクトリはモジュールオブジェクトとして操作可能な対象になるのです。

ディレクトリをモジュールとして認識させるには、ディレクトリ内に__init__.erファイルを置く必要があります。 これはPythonの__init__.pyと同じようなものです。

例として、以下のようなディレクトリ構成を考えてみましょう。

└─┬ ./src
  ├─ app.er
  ├─ foo.er
  └─┬ bar
    ├─ __init__.er
    ├─ baz.er
    └─ qux.er

app.erではfooモジュールとbarモジュールをインポートできます。barディレクトリがモジュールとして認識できるのは__init__.erファイルがあるためです。 fooモジュールはファイルからなるモジュールで、barモジュールはディレクトリからなるモジュールです。barモジュールはさらにbaz, quxモジュールを内部に持ちます。 このモジュールは単にbarモジュールの属性であり、app.erからは以下のようにアクセスできます。

# app.er
foo = import "foo"
bar = import "bar"
baz = bar.baz
# または`baz = import "bar/baz"`

main args =
    ...

サブモジュールにアクセスするための区切り文字が/であることに注意してください。これは、bar.baz.erのようなファイル名があり得るためです。 しかしこのようなファイル名は推奨されません。Ergでは.erの直前の識別子、プレフィックスが意味を持つためです。 例えば、テスト用のモジュールです。.test.erで終わるファイルは(ホワイトボックス)テスト用のモジュールであり、テスト実行時に@Testでデコレーションされたサブルーチンが実行されます。

└─┬ ./src
  ├─ app.er
  ├─ foo.er
  └─ foo.test.er

# app.er
foo = import "foo"

main args =
    ...

また、__init__.er内でre-importされていないモジュールはプライベートモジュールであり、同一ディレクトリ内のモジュールからしかアクセスできません。

└─┬
  ├─ foo.er
  └─┬ bar
    ├─ __init__.er
    ├─ baz.er
    └─ qux.er

# __init__.py
.qux = import "qux" # this is public

# foo.er
bar = import "bar"
bar.qux
bar.baz # AttributeError: module 'baz' is private

# qux.er
baz = import "baz"