メタ情報ファイルとは、モジュールが公開しているクラスや、 そのモジュールが import している他のモジュールの依存関係などの情報を まとめたファイルです。

import する際、モジュールを解析する代わりに このメタ情報ファイルを読み込むことで、解析時間を短縮できます。

メタ情報ファイルは、次のコマンドで生成できます。

$ lnsc hello.lns SAVE

先程のコマンドと何が違うかというと、 "save" と "SAVE" の違いです。

小文字の save は、トランスコンパイルした Lua コードだけ生成しますが、 大文字の SAVE は、 Lua コードとメタ情報ファイルを生成します。

具体的には、上記コマンドを実行すると hello.lua と hello.meta が生成されます。

LuneScript はモジュールを import する際、 次の条件が全て成り立つ時に .meta ファイルをロードします。 このとき、import 対象の .lns ファイルの解析は行ないません。

• .lns に対応する .lua と .meta が存在する

• それぞれのファイルの更新時間について、次の条件を満す

  • .lns < .meta

• インポート対象の mod1.lns 内で import しているモジュール mod2 の更新時間に対し、 次の条件を満す。

  • mod1 > mod2
• .meta ファイルのフォーマットバージョンが正しい

2 つのモジュール mod1, mod2 があった時、 mod1 が mod2 を import していると、「mod1 が mod2 に依存する」ことになります。

「mod1 が mod2 に依存する」ということは、 mod2 を修正した時は「mod2 だけでなく、mod1 もトランスコンパイルが必要になる」 ということです。

このような依存関係があるモジュールをビルドするには、 古くから make コマンドが利用されています。 近年は様々なビルドツールがありますが、 make が代表的なビルドツールであることには違いありません。

make コマンドは、定義された依存関係によって、 あるファイルが修正された際、 そのファイルに依存するファイルを更新する制御を行ないます。

この依存関係を手動で定義するのは、意外と面倒なものです。

LuneScript は、 make コマンドの依存関係を自動生成する機能を提供します。

LuneScript で依存関係を自動生成するには、次のように SAVE 時にオプションを指定します。

$ lnsc mod1.lns --depends depends/mod1.d SAVE

これは、 mod1.lns をトランスコンパイルすると同時に、 depends/mod1.d に mod1.lns の依存関係情報を出力します。

この依存関係情報を Makefile に取り込むことで、 手動で依存関係を定義することなく、簡単に make によるビルド制御が可能になります。

test/proj/
      |
      +--- Mod1.lns
      |
      +--- Mod2.lns
      |
      +--- Mod3.lns
      |
      +--- Mod4.lns

// @lnsFront: skip
import test.proj.Mod2;

pub fn func(): str {
   return "%s -> %s" (__func__, Mod2.func() );
}
print( func() );

// @lnsFront: skip
import test.proj.Mod3;

pub fn func(): str {
   return "%s -> %s" (__func__, Mod3.func() );
}

// @lnsFront: skip
import test.proj.Mod4;

pub fn func(): str {
   return "%s -> %s" (__func__, Mod4.func() );
}

// @lnsFront: ok
pub fn func(): str {
   return __func__;
}

PROJ_DIR=test/proj
MKFILE=$(PROJ_DIR)/Makefile
SRC_DIR=$(PROJ_DIR)/

.PHONY: test all build setup

define comp
	@echo "$1 -> $2"
	lnsc $1 --depends depends/$(shell echo $1 | sed 's@/@.@g').d SAVE
endef

%.meta: %.lns
	$(call comp,$<,$@)

SRCS =
SRCS += Mod1.lns
SRCS += Mod2.lns
SRCS += Mod3.lns
SRCS += Mod4.lns

SRCS := $(addprefix $(SRC_DIR),$(SRCS))

META_LIST=$(SRCS:.lns=.meta)
LUA_LIST=$(SRCS:.lns=.lua)

-include depends/*.d

all:
	@echo make setup
	@echo make build

setup:
	mkdir -p depends

build: $(META_LIST)