VS Code extensions release (#161)

**What changed**
- Restructured WASM samples to match the VS Code extension layout:
graphs under wasm, Rust operators under operators, Python operators
under operators.
- Updated builder assets and GitHub Actions to point to new paths;
refreshed Rust and Python build instructions and README links.
- Added schema/state-store scenario placeholders and dataflow graph
files alongside operators and sample data.
- Fixed the WASM development doc copy to align WIT schema links, builder
links, example paths, and Python build steps with the new structure.

**Testing**
- Docker build: Python map operator from map using `python-wasm-builder`
(produced `bin/x86_64/release/map.wasm`).
- Docker build: Rust operator previously validated from an operator
directory.

**Notes**
- No API/flag changes—only path/layout updates.

---------

Co-authored-by: vipeller <51135538+vipeller@users.noreply.github.com>
Co-authored-by: Gayathri Jegan Mohan <33068020+ggjjj@users.noreply.github.com>
Co-authored-by: Nagaraju Machavarapu <machavarapun@microsoft.com>

Author: 4 people

.github/workflows/ghcr_graph.yml

@@ -58,7 +58,7 @@ jobs:
         run: |
           owner=$(echo "${{ github.repository_owner }}" | tr '[:upper:]' '[:lower:]')
 
-          cd samples/wasm/rust
+          cd samples/wasm
 
           if [ -n "${{ inputs.graph-name }}" ]; then
             echo "Pushing specific graph: ${{ inputs.graph-name }}"

.github/workflows/ghcr_module.yml

@@ -65,7 +65,7 @@ jobs:
 
           source $HOME/.cargo/env
 
-          cd samples/wasm/rust
+          cd samples/wasm
           make graphs
 
           if [ -n "${{ inputs.module-name }}" ]; then

.github/workflows/wasm-python-build.yml

@@ -5,15 +5,15 @@ on:
   push:
     branches: [ main, wasm ]
     paths:
-      - 'samples/wasm/python/Dockerfile'
-      - 'samples/wasm/python/schema/**'
-      - 'samples/wasm/python/inject_pdb.py'
+      - 'samples/wasm-python/Dockerfile'
+      - 'samples/wasm-python/schema/**'
+      - 'samples/wasm-python/inject_pdb.py'
   pull_request:
     branches: [ main ]
     paths:
-      - 'samples/wasm/python/Dockerfile'
-      - 'samples/wasm/python/schema/**'
-      - 'samples/wasm/python/inject_pdb.py'
+      - 'samples/wasm-python/Dockerfile'
+      - 'samples/wasm-python/schema/**'
+      - 'samples/wasm-python/inject_pdb.py'
 
 jobs:
   build-and-push:
@@ -49,8 +49,8 @@ jobs:
     - name: Build and push Docker image
       uses: docker/build-push-action@v5
       with:
-        context: samples/wasm/python
-        file: samples/wasm/python/Dockerfile
+        context: samples/wasm-python
+        file: samples/wasm-python/Dockerfile
         push: true
         tags: ${{ steps.meta.outputs.tags }}
         labels: ${{ steps.meta.outputs.labels }}

.github/workflows/wasm-rust-build.yml

@@ -5,11 +5,11 @@ on:
   push:
     branches: [ main, wasm ]
     paths:
-      - 'samples/wasm/rust/Dockerfile'
+      - 'samples/wasm/Dockerfile'
   pull_request:
     branches: [ main ]
     paths:
-      - 'samples/wasm/rust/Dockerfile'
+      - 'samples/wasm/Dockerfile'
 
 jobs:
   build-and-push:
@@ -45,8 +45,8 @@ jobs:
       - name: "Build and Push Rust Builder Image"
         uses: docker/build-push-action@v5
         with:
-          context: samples/wasm/rust
-          file: samples/wasm/rust/Dockerfile
+          context: samples/wasm
+          file: samples/wasm/Dockerfile
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}

.gitignore

@@ -421,3 +421,4 @@ target
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
+install.sh

samples/wasm/python/Dockerfile samples/wasm-python/Dockerfilesamples/wasm/python/Dockerfile renamed to samples/wasm-python/Dockerfile

@@ -1,12 +1,13 @@
-# Python WASM Operators Development Guide
+# Python WASM Operators (VS Code extension ready)
 
-This guide provides comprehensive documentation for developing WebAssembly (WASM) operators using Python for Azure IoT Operations data flow graphs.
+This guide shows how to build and run Python-based WASM operators for Azure IoT Operations. The folder follows the VS Code extension layout: operators live under `operators/`, and builds drop artifacts into each operator’s `bin/` directory.
 
 ## Table of Contents
 
 - [Overview](#overview)
 - [Prerequisites](#prerequisites)
 - [Development Environment Setup](#development-environment-setup)
+- [Build Options](#build-options)
 - [Python Operator Development](#python-operator-development)
 - [Building Python WASM Operators](#building-python-wasm-operators)
 - [Available Operator Templates](#available-operator-templates)
@@ -82,8 +83,19 @@ sudo apt-get update
 sudo apt-get install -y clang lld musl-dev git perl make cmake
 ```
 
+## Build Options
+
+You can build operators three ways:
+- **VS Code extension (recommended):** Open `samples/wasm-python` → `Ctrl+Shift+P` → **Azure IoT Operations: Build All Data Flow Operators** → pick **release** or **debug**. Output: `operators/<name>/bin/<arch>/<mode>/`.
+- **Docker builder:** Use the published builder image (see [Building Python WASM Operators](#building-python-wasm-operators)). Run it from an operator directory; output goes to that operator’s `bin/` folder.
+- **Local componentize-py:** Install prerequisites and run `componentize-py` directly (see [Build WASM Component](#build-wasm-component)).
+
+To run any module you need a graph YAML that references the built operator (for example `graph.dataflow.yaml`). Keep the graph file alongside the operators when running locally or with the extension.
+
 ## Python Operator Development
 
+Operators live under `operators/`. The sections below cover the interfaces and workflow.
+
 ### Understanding the Interface
 
 Python operators implement specific interfaces defined by the WebAssembly Interface Types (WIT). Unlike Rust, Python doesn't have a high-level SDK, so you work directly with the exported function interfaces.
@@ -239,7 +251,7 @@ componentize-py -d ./schema/ -w map-impl componentize map_debug -o my-operator-d
 
 ## Building Python WASM Operators
 
-### Using the Streamlined Docker Builder
+### Using the streamlined Docker builder
 
 The recommended approach uses a single Docker command with the built-in builder:
 
@@ -286,12 +298,12 @@ bin/x86_64/debug/my-operator.wasm
 bin/x86_64/debug/my-operator_debug.py
 ```
 
-### Build the Docker Builder (One-time Setup)
+### Build the Docker builder (one-time setup)
 
 The recommended approach is to use the published images from GitHub Container Registry. However, if you need to build the Docker builder image locally:
 
 ```bash
-cd /path/to/samples/wasm/python
+cd /path/to/samples/wasm-python
 docker build -t python-wasm-builder .
 ```
 
@@ -302,17 +314,17 @@ docker build -t python-wasm-builder .
 The repository includes templates for all supported operator types:
 
 ### Map Operator
-- **Path**: `examples/map/`
+- **Path**: `operators/map/`
 - **Purpose**: Transform individual data items
 - **Interface**: `process(timestamp, input) -> output`
 
 ### Filter Operator  
-- **Path**: `examples/filter/`
+- **Path**: `operators/filter/`
 - **Purpose**: Allow/reject data based on conditions
 - **Interface**: `process(timestamp, input) -> bool`
 
 ### Branch Operator
-- **Path**: `examples/branch/`
+- **Path**: `operators/branch/`
 - **Purpose**: Route data to different output paths
 - **Interface**: `process(timestamp, input) -> int`
 

samples/wasm/python/README.md samples/wasm-python/README.mdsamples/wasm/python/README.md renamed to samples/wasm-python/README.md

@@ -0,0 +1,37 @@
+import branch_impl;
+import payload
+from branch_impl import exports
+from branch_impl import imports
+from branch_impl.imports import types
+from payload import Payload
+
+
+def to_bytes(payload_variant):
+    if isinstance(payload_variant, types.BufferOrBytes_Buffer):
+        return payload_variant.value.read()
+    if isinstance(payload_variant, types.BufferOrBytes_Bytes):
+        return payload_variant.value
+    raise ValueError("Unexpected payload type")
+
+class Branch(exports.Branch):
+    def init(self, configuration) -> bool:
+        imports.logger.log(imports.logger.Level.INFO, "module3/branch", "Init invoked")
+        return True
+
+    def process(self, timestamp: int, input: types.DataModel) -> bool:
+        imports.logger.log(imports.logger.Level.INFO, "module3/branch", "processing from python")
+
+        if not isinstance(input, types.DataModel_Message):
+            raise ValueError("Unexpected input type: Expected DataModel_Message")
+
+        message = input.value
+        payload = to_bytes(message.payload)
+        decoded = payload.decode("utf-8")
+        p = Payload(decoded)
+
+        if p.is_temperature():
+            imports.logger.log(imports.logger.Level.INFO, "module3/branch", "temperature")
+            return False  # first branch
+
+        imports.logger.log(imports.logger.Level.INFO, "module3/branch", "humidity")
+        return True  # second branch