Hello World

最初のWippyアプリケーション - JSONを返すシンプルなHTTP API。

構築するもの

1つのエンドポイントを持つ最小限のWeb API：

GET /hello → {"message": "hello world"}

プロジェクト構造

hello-world/
├── wippy.lock           # 生成されたロックファイル
└── src/
    ├── _index.yaml      # エントリ定義
    └── hello.lua        # ハンドラコード

ステップ1: プロジェクトディレクトリの作成

mkdir hello-world && cd hello-world
mkdir src

ステップ2: エントリ定義

src/_index.yamlを作成：

version: "1.0"
namespace: app

entries:
  # HTTPサーバー
  - name: gateway
    kind: http.service
    addr: :8080
    lifecycle:
      auto_start: true

  # ルーター
  - name: api
    kind: http.router
    meta:
      server: gateway
    prefix: /

  # ハンドラ関数
  - name: hello
    kind: function.lua
    source: file://hello.lua
    method: handler
    modules:
      - http

  # エンドポイント
  - name: hello.endpoint
    kind: http.endpoint
    meta:
      router: app:api
    method: GET
    func: hello
    path: /hello

4つのエントリが連携して動作：

gateway - ポート8080でリッスンするHTTPサーバー
api - meta.server経由でgatewayに接続されたルーター
hello - リクエストを処理するLua関数
hello.endpoint - GET /helloを関数にルーティング

ステップ3: ハンドラコード

src/hello.luaを作成：

local http = require("http")

local function handler()
    local res = http.response()

    res:set_content_type(http.CONTENT.JSON)
    res:set_status(http.STATUS.OK)
    res:write_json({message = "hello world"})
end

return {
    handler = handler
}

httpモジュールはリクエスト/レスポンスオブジェクトへのアクセスを提供します。関数はエクスポートされたhandlerメソッドを持つテーブルを返します。

ステップ4: 初期化と実行

# ソースからロックファイルを生成
wippy init

# ランタイムを起動（-c でカラフルなコンソール出力）
wippy run -c

次のような出力が表示されます：

╦ ╦╦╔═╗╔═╗╦ ╦  Adaptive Application Runtime
║║║║╠═╝╠═╝╚╦╝  v0.1.20
╚╩╝╩╩  ╩   ╩   by Spiral Scout

0.00s  INFO  run          runtime ready
0.11s  INFO  core         service app:gateway is running  {"details": "service listening on :8080"}

ステップ5: テスト

curl http://localhost:8080/hello

レスポンス：

{"message":"hello world"}

動作の仕組み

gatewayがポート8080でTCP接続を受け入れる
apiルーターがパスプレフィックス/に一致
hello.endpointがGET /helloに一致
hello関数が実行されJSONレスポンスを書き込む

CLIリファレンス

コマンド	説明
`wippy init`	`src/`からロックファイルを生成
`wippy run`	ロックファイルからランタイムを起動
`wippy run -c`	カラフルなコンソール出力で起動
`wippy run -v`	詳細なデバッグログで起動
`wippy run -s`	サイレントモードで起動（コンソールログなし）

次のステップ

Echoサービス - リクエストパラメータの処理
タスクキュー - バックグラウンド処理付きREST API
HTTPルーター - ルーティングパターン