Cro – Rakuにおけるエレガントなリアクティブサービス
Cro – elegant reactive services in Raku (cro.raku.org)
要約
Croは、Raku言語の機能を最大限に活用して構築された、リアクティブ分散システム開発のためのライブラリセットです。高レベルAPIにより簡単なタスクは容易になり、中心的な非同期パイプラインコンセプトにより複雑なタスクも可能になります。HTTPサーバー、Webソケット、ツールキットなどが含まれており、開発を迅速に進めるためのコマンドラインツールも提供されています。
全文翻訳
Croへようこそ
Croは、Rakuが提供するすべての機能を活用するために愛情を込めて作られた、リアクティブ分散システムを構築するためのライブラリ群です。高レベルAPIは簡単なことを簡単にし、Croの中心にある非同期パイプラインの概念は難しいことを可能にします。
すぐに始めたいですか? zef install --/test cro を実行し、ドキュメントをご覧ください。
ルートを設定し、提供する
use Cro::HTTP::Router;
use Cro::HTTP::Server;
my $application = route {
get -> 'greet', $name {
content 'text/plain', "Hello, $name!";
}
}
my Cro::Service $hello = Cro::HTTP::Server.new:
:host<localhost>, :port<10000>, :$application;
$hello.start;
react whenever signal(SIGINT) { $hello.stop; exit; }
組み込みHTTPサーバー
[画像]
HTTP/1.1永続接続
[画像]
HTTP/2.0(ALPNでネゴシエート使用)
[画像]
HTTPSサポート
[画像]
サーバーレベルでのミドルウェアの追加
[画像]
ボディパーサーとシリアライザーの設定
[画像]
マルチコアCPUを活用するためのスレッドプールへのリクエストディスパッチ
柔軟なリクエストルーター
# シグネチャでルートセグメントをキャプチャ/制約する。
get -> 'product', UUIDv4 $id {
content 'application/json', get-product($id);
}
# ルートセグメントをスループットし、静的コンテンツを提供する
get -> 'css', *@path {
static 'assets/css', @path;
}
# クエリ文字列から値を取得する
get -> 'search', :$term! {
content 'application/json', do-search($term);
}
プラグ可能なボディ解析とシリアライゼーション
www-form-urlencoded、multi-part、およびJSONボディの組み込みサポートをお楽しみください。または、独自のボディパーサーとシリアライザーをプラグインしてください。
put -> 'order', UUIDv4 $id {
request-body -> %json-object {
# 保存してから...
content 'application/json', %json-object;
}
}
HTTPクライアントが含まれています
[画像]
レスポンスとボディ(ボディは一度に配信されるかストリーミング)を取得するための非同期API
[画像]
HTTP/1.1永続接続をサポート
[画像]
HTTPS、オプションでカスタム証明書局を使用可能
[画像]
HTTP/2.0サポート、リクエスト多重化付き
[画像]
プラグ可能なボディパーサー/シリアライザー(サーバーと同じものを使用)およびミドルウェアサポート
HTTPルーターとのきれいに統合
my $chat = Supplier.new;
get -> 'chat' {
web-socket -> $incoming {
supply {
whenever $incoming -> $message {
$chat.emit(await $message.body-text);
}
whenever $chat -> $text {
emit $text;
}
}
}
}
WebSocketクライアント
Croには、SupplyベースのWebサービスクライアントが含まれています。
サービス間のWebSocketの使用、WebSocketクライアントの作成、またはWebSocketによって公開されるサービスの統合テストの作成にまさに必要なものです。
優れたデフォルト設定で始める
cro stub ... コマンドは、新しいHTTPおよびZeroMQサービスをスタブ化します。
より速く始めるのを助けるだけでなく、良い方向性で開始するのにも役立ちます。例えば、環境変数からホストとポートを受け入れ(コンテナデプロイメントに最適)、サービスの依存関係を宣言するためのMETA6.jsonを生成します。
cro run
軽量な開発サービスランナー。
[画像]
サービスを開始し、空いているポートを自動的に割り当てる
[画像]
コードが変更されたときにサービスを自動的に再起動する
[画像]
サービス出力を収集・表示し、どの出力がどのサービスから来たかを示す
cro trace
トレーシングを有効にして、1つ以上のサービスを実行します。
トレーシングにより、非同期パイプラインをリクエストがどのように進むかを確認でき、問題が発生した場所をより迅速に理解するのに役立ちます。