BUSY ビルドシステム入門

**BUSY（BUild SYstem）**は、GCC、Clang、MSVC のツールチェーンに対応した軽量なクロスプラットフォーム・ビルドシステムです。

主な特徴と背景

• 低依存性: システムへの要件が極めて低く、容易にセルフ・ブートストラップ可能です。
• 静的型付け: CMake や Meson、GN などの動的スクリプト言語とは異なり、静的型付けされたビルド仕様言語を採用しています。
• ゼロから構築: ホストシステムへの追加要件を求めず、プロジェクトからゼロでコンパイル可能です。
• 統合性: 軽量化が進んでおり、プロジェクトのソースツリーに直接統合することも可能です。

サンプルプロジェクト: NAppGUI

• Francisco García 氏による大規模なクロスプラットフォーム GUI ライブラリ（C89/C++98/Objective-C）。
• 詳細は README を参照してください。

シンタックスと記法例

BUSY は Lua の文脈に統合されています（実装言語は C89）。構文は柔軟で、Pascal 風スタイルや Lua 風の両方が利用可能です。

トップレベル構成例

トップレベルの BUSY ファイルでは、主要なターゲットを定義します。

submod src

let shared_lib* = src.shared_lib
let static_lib* = src.static_lib

let all! : Group {
    .deps = [ shared_lib static_lib ]
}
# 上記 'all' のように ! を付けることでデフォルトビルド対象を指定

ソースファイル定義例 (

src

)

コンパイルに必要な設定や、ソースの実体部を定義します。

let main_config : Config {
    .include_dirs += [ ./geom2d ./osbs ./sewer ]
    .defines += [ 
        "NAPPGUI_LIBRARY" 
        "NAPPGUI_BUILD_DIR=\"" + tostring(root_build_dir) + "\""
        "NAPPGUI_BUILD=" + readstring('../prj/build.txt') 
    ]
}

submod core
submod draw2d

let all_lib_sources : Group {
    .deps = [
        core.sources
        draw2d.sources
    ]
}

let static_lib* : Library {
    .name = "NAppGUI"
    .lib_type = `static
    .deps = [ all_lib_sources ]
}

オペレーティングシステム判定例 (

draw2d

)

プラットフォームごとの依存関係やソースを切り分けできます。

submod gtk3

let sources* : SourceSet {
    .sources = [
        ./draw2d.cpp 
        ./drawg.cpp 
        ./btext.c 
    ]
    .configs += ^main_config
    
    if target_os == `linux {
        .deps += gtk3.sources
    } else if target_os == `win32 {
        # Windows 固有の設定
    } else {
        error("target os not supported")
    }
}

Pascal 風スタイルもサポートされます。

let sources* : SourceSet 
begin
    .sources := [ ./draw2d.cpp, ./drawg.cpp, ./btext.c ]
    if target_os == `linux then
        .deps += gtk3.sources
    elif target_os == `win32 then
        # ...
    else
        error("target os not supported")
    end
end

実行方法

ビルドの実行

通常、

build.lua

デフォルトコマンド:

lua build.lua

• ソースツリールート:

  ..

• ビルド出力先（デフォルト）:

  ./output

コマンドラインオプション

-T my_lib

-P "string_val=\"test\""

-P symbol=\

-M debug

-opt

-nopt

-dbg

-G qmake

注意:

build.lua

を直接実行せず、サブディレクトリに置いた状態から

-S .

などを用いても構いません。

言語仕様と設計思想

基本構成

• ファイル名:

  BUSY

  または

  BUSY.busy

  。
  両方が存在する場合、BUSY が優先されます。
• モジュール宣言:

  submod <ディレクトリ>

  を使用し、対応するディレクトリに関連付けます。
• 可視性ルール:
  • デフォルト: モジュール内でしか参照できない。
  • パブリック (

    *

    ): 外部またはネストされたモジュールから参照可能。
  • 保護 (

    -

    ): ネストされたモジュールのみ参照可能。

プリdeclares（基本型とグローバル変数）

BUSY は静的なデータ構造に基づいており、以下のプリ declares タイプを使用します。

• 基本型:

  bool

  ,

  int

  ,

  real

  ,

  string

  ,

  path

  ,

  symbol

• 列挙型:

  • LibraryType* = (

    static,

    shared, 

    framework)`
• クラス型例:

  type Config* = class { 
      cflags : string[]
      defines: string[]
      include_dirs: path[]
      configs: Config[] 
  }
  

クラス階層（継承）

「魔法のクラス」が存在せず、通常の構文で定義された標準的なクラス継承です。

class Product {
    deps: Product[] // 依存関係を表すフィールド
}

class Executable extends Product { }
class Library extends Product { }
class SourceSet extends Product { }

動作フェーズ（BAZEL に類似）

1. ローディング: すべての BUSY ファイルを解析。
2. 分析: ステートメントを実行し、ワークツリーを作成。
3. 実行: ワークツリーを深さ優先順に実行（デフォルトは

   !

   でマークされたもの）。

グローバル変数と機能

• 環境適応:

  • root_build_dir

    : ビルドディレクトリのパス。

  • host_os

    : ホスト OS タイプ（例:

    OsType

    ）。

  • host_toolchain

    : コンパイラチェーン情報（例:

    CompilerType

    ）。
• 型変換:
  • 数字を文字列に変換するには

    tostring()

    を使用します。
  • 直接文字列代入はコンパイルエラーになります。

現在の機能と非目標 (Non-Goals)

動作確認済みプラットフォーム

• Linux: x86, x86_64, ARMv7 (GCC)
• Windows: Windows 10/7 x86/x64 (MSVC)
• macOS: 10.11 - 12.2 (x86_64), M1 (CLANG)

今後の予定機能

• ✅ レンタル Qt ソースツリーの実装（LeanQt）
• ✅ QMake バックエンドの完成（Linux/Windows/macOS 対応）
• 🚧 Ninja バックエンドの実装
• 🚧 CMake バックエンドの実装
• 🚧 チュートリアル作成

非目標 (Non-Goals)

以下の領域は BUSY の機能範疇外です。

• 完全なプログラミング言語ではないため、それを目指しません。
• パッケージマネージャーやジェネレータとしての機能はありません。
• Git クライアントやテストフレームワークではありません。
• ライブラリやツールの自動ダウンロード・検索機能はありません（ユーザーが提供するものを使用）。
• C プリアンプレッサ機能（

  #include

  チェックなど）はありません。
• Ninja の代替ではなく、ビルド可能コードベースのデプロイや高速な編集サイクル補助として位置づけられます。

実用的なクロスコンパイル例

x86 → ARM Cortex-A7 (Allwinner H3) 向け Linux クロスコンパイルは以下のコマンドで成功します：

lua build.lua ../LeanQt \
  -P target_toolchain_path=//home/me/toolchain/bin \
  -P HAVE_OBJECT \
  -P target_toolchain_prefix="arm-linux-gnueabihf-"

ビルド手順

BUSY のビルド自体は非常に簡素です。

1. ソースコード取得: ビルドツリーを構築する前に、まず

   bus

   ツールチェーンと必要なライブラリを入手します。
2. Lua インタプリタコンパイル:
   • Unix/MacOS/Linux:

     cc *.c -O2 -lm -o lua
     

   • Windows (MSVC):

     cl /O2 /MD /Fe:lua.exe *.c
     

3. ビルド実行:
   • コンパイル結果（

     lua

     や

     lua.exe

     ）は、統合された Lua 実行可能ファイルとなり、

     build.lua

     をそのまま動作させます。

サポートとライセンス

ライセンス情報

• Lua VM: Luiz Henrique de Figueiredo, Roberto Ierusalimschy, Waldemar Celes (MIT License)
  • lua.org
• OS/CPU/Toolchain 検出ロジック: Qt ソースコード由来 (LGPL/GPL)
  • Qt.io
• GN の概念: Brett Wilson 他 (BSD-like License)
  • gn.googlesource.com/gn

サポート連絡先

問題報告や機能リクエストは、以下の方法で送信できます。

• GitHub Issues: BUSY/issues
• メール: 著者宛てに直接連絡