Added docs for canvas code

Author: tara-natarajan

examples/chem-sync-local-flask/local_app/benchling_app/handler.py

@@ -25,17 +25,25 @@ class UnsupportedWebhookError(Exception):
 
 def handle_webhook(webhook_dict: dict[str, Any]) -> None:
     logger.debug("Handling webhook with payload: %s", webhook_dict)
+
+    # Receive the webhook and initialize the app
     webhook = WebhookEnvelopeV0.from_dict(webhook_dict)
     app = init_app_from_webhook(webhook)
+
+    # Route the webhook to the appropriate handler
     # Could also choose to route on webhook.message.type
+
     # Note: if your manifest specifies more than one item in `features`,
     # then `webhook.message.feature_id` may also need to be part of your routing logic
     try:
         if isinstance(webhook.message, CanvasInitializeWebhookV2):
+            # This webhook is triggered when a canvas is initialized as a part of a run
             render_search_canvas(app, webhook.message)
         elif isinstance(webhook.message, CanvasInteractionWebhookV2):
+            # This webhook is triggered when a user clicks a button on the canvas
             route_interaction_webhook(app, webhook.message)
         elif isinstance(webhook.message, CanvasCreatedWebhookV2Beta):
+            # This webhook is triggered when a canvas is created in an entry
             render_search_canvas_for_created_canvas(app, webhook.message)
         else:
             # Should only happen if the app's manifest requests webhooks that aren't handled in its code paths

examples/chem-sync-local-flask/local_app/benchling_app/views/canvas_initialize.py

@@ -16,6 +16,16 @@
 
 from local_app.benchling_app.views.constants import SEARCH_BUTTON_ID, SEARCH_TEXT_ID
 
+"""
+This file contains examples of how to handle different Canvas Webhooks
+
+Use a CanvasBuilder to create or update a canvas associated with your app 
+This sdk tool can be used for easy creation and updates
+
+Check out https://benchling.com/sdk-docs/1.22.0/benchling_sdk.apps.canvas.framework.html
+for more details on the CanvasBuilder class
+"""
+
 
 def render_search_canvas(app: App, canvas_initialized: CanvasInitializeWebhookV2) -> None:
     with app.create_session_context("Show Sync Search", timeout_seconds=20):
@@ -24,7 +34,11 @@ def render_search_canvas(app: App, canvas_initialized: CanvasInitializeWebhookV2
             feature_id=canvas_initialized.feature_id,
             resource_id=canvas_initialized.resource_id,
         )
+
+        # Add the input blocks to the canvas 
         canvas_builder.blocks.append(input_blocks())
+
+        # Create the canvas
         app.benchling.apps.create_canvas(canvas_builder.to_create())
 
 
@@ -36,6 +50,13 @@ def render_search_canvas_for_created_canvas(app: App, canvas_created: CanvasCrea
 
 
 def input_blocks() -> list[UiBlock]:
+    """
+    Create 3 blocks to populate the canvas: 
+
+    Markdown block to display text 
+    TextInput block to capture user input 
+    Button block to trigger the search 
+    """
     return [
         MarkdownUiBlock(
             id="top_instructions",