VS CodeでDotLiquidをローカルデバッグ

Logic Apps開発者の皆さん、喜んでください—少なくとも悪態をつくのはおやめください。新たなVS Code拡張機能がAzureと同じエンジンでDotLiquidテンプレートをローカルデバッグします。ついにです。

VS CodeのDotLiquidデバッガーがLogic AppsのLiquid開発の悪夢を終わらせる — theAIcatchup

Key Takeaways

  • DotLiquidエンジンの完全一致でLogic Appsのデプロイ推測作業を根絶。
  • 100ms未満レンダリングとステップデバッグでフィルター連鎖を即時可視化。
  • B2Bテンプレート変換で数時間節約—クラウド待ちループ終了。

深夜2時、Logic Appsの実行履歴に没頭し、シンプルな販売注文が意味不明のXMLに変わってしまったDotLiquidテンプレートの理由に頭を悩ませているあなた。

VS Code DotLiquid Debuggerが、カフェイン点滴のように登場しました。ShopifyのLiquidプレビュー? かわいいですが、ここでは役立たず—Logic Apps StandardはDotLiquidを処理しますが、あのフレーバーではありません。挙動が衝突します。テンプレートはプレビューでは完璧でも、本番で失敗。デフォルトのテストループ? 更新、デプロイ、待機、履歴を凝視、繰り返し。B2Bデータ加工では、これを開発とは呼びません。中世の拷問です。

この拡張機能は、.liquidファイルをローカルで実行し、Azureと同じDotLiquid 2.0.361エンジンをそのまま使用します。同じNuGetの中身、同じ癖のある整数除算、同じsentence-caseフィルター。シミュレーションなし。「まあ近い」嘘なし。ここでクリーンにレンダリングされれば、本番で失敗しません—ほとんど。

見ての通り、以前パリティを約束したツールはありました。実現しませんでした。でもこれは本物の.NETレンダラーに薄いVS Codeのスキンをかけただけ。TypeScriptフロント、NDJSONパイプ経由のDotLiquidバックエンド。初回コンパイルは遅め(当然)、その後は? 100ms未満のレンダリング。キーストロークで出力。至福です。

Logic AppsのLiquidデバッグが純粋な地獄だった理由

任意の.liquidファイルでCtrl+Shift+Lを押すだけ。プレビューパネルが登場。保存時やキーストローク(デバウンス済み、ありがたい)で自動更新。クラウド待ちはもうありません。

ペア入力? 隣に.liquid.jsonを置くだけ。なければバナーが作成を促します。賢い。

最大の魅力はDebugボタン。ステップごとの再生。代入、ループ、if—すべてがスポットライト。ソース行が光ります。変数パネルで状態をダンプ。未代入変数は薄く表示。生きているものが一目瞭然です。

スライダーでステップをスクロール。前/次。最後へジャンプ。あの変数がゴミになった理由を特定。

フィルター連鎖? 見事な分解表示です:

499.9 | Times:5 → 2499.5 | DividedBy:100 → 24.995 | Round:2 → 25.0

数学フィルター(Times、DividedByなど)、文字列(Upcase、Replace)、配列(Split、Map)—31種類対応。Logic Appsではゼロの可視性。これで連鎖の失敗を即座に特定。4つのフィルターの混乱? 乖離点が見えます。推測不要です。

if文? 条件表示、実行されたら緑チェック。未実行ブランチはスキップ—DotLiquidを正確に再現。ブランチの謎が解けます。

変数は代入行にリンク—クリックでジャンプ。出力チャンクはソースにマップ。JSONの”grandTotal”: 336.20をクリック—計算行へ即移動。XML? JSON? フラットテキスト? すべてOK。ハックなデバッグ出力不要です。

パネルは折り畳み、リサイズ可能。クリーンです。

これ、本当にAzure Logic Apps本番と一致するのか?

答え:めちゃくちゃ近い。

これが肝心です:まったく同じエンジンを使用します—シミュレーションではなく。互換実装でもなく。同じNuGetパッケージ、同じバージョン、同じsentence-caseフィルター、同じコンテンツラッピング挙動、同じ整数除算の癖。

ドキュメントからの引用。強気な主張です。でも本当—長時間実行の.NETサブプロセス、オンデマンドコンパイル、NDJSONで同時性対応。Logic Appsの4種類の出力形式(フラットJSON、XMLなど)を処理します。

懐疑的? 私もです。Microsoftのエコシステムは落とし穴好き—Shopify Liquid対DotLiquidが典型例。でもこれはその落とし穴を回避。ローカル=本番エンジン。デプロイ回数減、請求ショック減。

ここで私の独自見解:これはNodeのinspector時代を彷彿とさせます。2010年代以前のJSデバッグ? console.logと祈りだけ。次にInspectorが登場—ステップデバッグの至福。Liquid開発者はその石器時代にいました。これで2024年に引き上げます。大胆予測:Logic AppsへのShopify移行者が急増。クラウド遅延と戦う必要なし、ローカルが即時です。

企業宣伝? なし—オープン寄りで実用的。ハイプなし。稀有な勝利です。

本当のワークフローの変化

旧:テンプレート修正、Logic App実行、30秒以上待機、履歴解剖、フィルターを呪う。

新:.liquid編集、生レンダリング確認、ステップデバッグ、連鎖修正、完了。

B2B変換—販売注文から請求書へ—これで花開きます。高額エラー? 消滅。

癖? ウォームアップコンパイル、MacはCmd+Shift+L。些細です。

配列? ループが輝く—各イテレーションをステップ、変数ライブ更新。ブラックボックスなし。

文字列加工? Truncate失敗? トレース可能。

数学爆弾—Moduloの意外性、Floor対Round? 露呈。

Logic Appsユーザー:今すぐインストール。VS Codeマーケットプレイスで「DotLiquid Debugger」検索。無料。言い訳なし。

すべてキャッチ? いいえ。ランタイムコンテキストの癖(カスタムフィルター? 不可)ですが、90%の痛み? 完璧。

Logic Appsのインラインエディター? 複雑テンプレートにはゴミ。これ? プロ仕様。

少し脱線:初期Terraformデバッグの地獄を思い出します。こういうツールがエコシステムを成熟させます。Microsoft、メモを。

開発者がこれを無視すると危険な理由

ボトルネック粉砕。

本番サプライズ激減。

デバッグハック陳腐化。

Logic Apps Liquidを扱うなら—苦しむのをやめて。

これはお飾りじゃありません。ワークフローの手術です。

ドライなユーモアを交えて:ようやく、ラップトップを投げつけたくなるツールじゃなくなりました。


🧬 関連インサイト

よくある質問

VS Code DotLiquid Debuggerとは?

Azure Logic Apps Standardの正確なエンジンを使ったDotLiquidテンプレートのローカルデバッグ用VS Code拡張機能。即時プレビュー、ステップスルーデバッグ。

VS CodeでDotLiquidテンプレートをデバッグするには?

拡張機能をインストール、.liquidファイルを開き、Ctrl+Shift+L(MacはCmd)。データ用に.liquid.jsonを追加、Debugでステップ実行。

DotLiquid DebuggerはLogic Appsに対応?

はい—DotLiquid 2.0.361と完全に一致。フィルター、癖、出力が揃い、本番失敗を減らします。

Elena Vasquez
Written by

Senior editor and generalist covering the biggest stories with a sharp, skeptical eye.

Worth sharing?

Get the best AI stories of the week in your inbox — no noise, no spam.

Originally reported by dev.to