Merge pull request #32 from srl-labs/v0.3.0_ready

Bump version to 0.3.0 and update changelog and README

Author: FloSch62

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+## [0.3.0] - 2025-26-01
+* Fix Selected lab status turn grey on selection by @FloSch62 in https://github.com/srl-labs/vscode-containerlab/pull/24
+* Add lab folder to workspace by @FloSch62 in https://github.com/srl-labs/vscode-containerlab/pull/25
+* Add command to open lab folder in a new window by @FloSch62 in https://github.com/srl-labs/vscode-containerlab/pull/26
+* Add copy sub-menu for containers by @kaelemc in https://github.com/srl-labs/vscode-containerlab/pull/27
+* Add exec command setting & mapping by @kaelemc in https://github.com/srl-labs/vscode-containerlab/pull/28
+* Open drawio by @FloSch62 in https://github.com/srl-labs/vscode-containerlab/pull/30
+* Inspect for labs by @FloSch62 in https://github.com/srl-labs/vscode-containerlab/pull/31
+
 ## [0.2.1] - 2025-25-01
 ### Added
 - Add buttons for shell, ssh and logs next to Containers

README.md

@@ -3,16 +3,35 @@
 A Visual Studio Code extension that integrates [containerlab](https://containerlab.dev/) directly into your editor, providing a convenient tree view for managing labs and their containers.
 
 ---
-
-- **Auto-discovery** of local `*.clab.yml` or `*.clab.yaml` files in your workspace.
-- **Tree view** showing labs (green/red/grey icons) based on container states.
-- **Right-click context menus** on labs to deploy, destroy, redeploy (with or without cleanup), or open lab files.
-- **Right-click context menus** on containers to start/stop, attach a shell, SSH, or view logs.
-- **Color-coded statuses**:
-  - **Green**: all containers in the lab are running.
-  - **Grey**: undeployed (no containers found).
-  - **Yellow**: partially running (some containers running, others stopped).
-
+## Features
+
+- **Auto-discovery** of local `*.clab.yml` or `*.clab.yaml` files in your workspace.  
+- **Tree view** showing labs (green/red/gray/yellow icons) based on container states:
+  - **Green**: all containers in the lab are running  
+  - **Gray**: undeployed (no containers found)  
+  - **Red**: all containers are stopped  
+  - **Yellow**: partially running (some containers running, others stopped)
+- **Right-click context menus** on labs:
+  - **Deploy**, **Destroy**, **Redeploy** (with or without cleanup)
+  - **Open Lab File**, **Copy Lab File Path**
+  - **Graph** topologies (local Web or draw.io modes)
+  - **Inspect** single lab
+  - **Add Lab to Workspace**
+  - **Open Folder in New Window**
+- **Right-click context menus** on containers:
+  - **Start**, **Stop**  
+  - **Attach shell** (with user-defined exec commands per node kind)  
+  - **SSH**  
+  - **View logs**  
+  - **Copy** submenu for container properties:
+    - Name, ID, IPv4, IPv6, Kind, Image
+- **Inspect** commands:
+  - **Inspect (All Labs)**: shows a webview with **all** labs in a grouped table
+  - **Inspect Lab**: show only the selected lab’s containers in a webview
+- **Graph**:
+  - **Graph Lab (Web)**: runs `containerlab graph` in a Terminal
+  - **Graph Lab (draw.io)**: runs `containerlab graph --drawio` , then opens the `.drawio` file
+  - **Graph Lab (draw.io, Interactive)**: runs in Terminal with in interactive mode
 
 ---
 
@@ -22,6 +41,7 @@ A Visual Studio Code extension that integrates [containerlab](https://containerl
 - **Docker** (or another container runtime) must be set up and running if your labs rely on container-based nodes.
 - (Optional) A local folder with `*.clab.yml` or `*.clab.yaml` topologies, opened in VS Code.
 
+
 ---
 
 ## Getting Started
@@ -31,30 +51,56 @@ A Visual Studio Code extension that integrates [containerlab](https://containerl
 3. **Click** on the _Containerlab_ icon in the Activity Bar to view your labs.
 4. **Right-click** on a lab or container to see context menu commands (Deploy, Destroy, Redeploy, etc.).
 
+---
 
-## Extension Settings
+## Commands
 
-You can customize the following settings under `containerlab.*`:
+These are some key commands contributed by the extension:
 
-- **`containerlab.defaultSshUser`** (string): Default SSH user to use when connecting to containerlab nodes. Default: `admin`.
-- **`containerlab.sudoEnabledByDefault`** (boolean): Whether to prepend `sudo` to containerlab commands by default. Default: `true`.
-- **`containerlab.refreshInterval`** (number): Refresh interval (in milliseconds) for the Containerlab Explorer. Default: `10000`.
+### Lab Management
+- **Deploy / Deploy (cleanup)**  
+- **Redeploy / Redeploy (cleanup)**  
+- **Destroy / Destroy (cleanup)**
+- **Deploy lab file** (choose a `.clab.yml/.yaml` from a file picker)
 
----
+### Lab Inspection
+- **Inspect (All Labs)**: Summaries all labs in one webview  
+- **Inspect Lab**: Summaries the containers for a single lab
 
-## Commands
+### Graph
+- **Graph Lab (Web)**: runs in Terminal  
+- **Graph Lab (draw.io)**: uses a spinner and opens the `.drawio` file  
+- **Graph Lab (draw.io, Interactive)**: same but with additional `--drawio-args "-I"`.
+
+### Node / Container Management
+- **Start node**, **Stop node**  
+- **Attach shell** (exec into container—respects `containerlab.node.execCommandMapping` in settings)  
+- **SSH**  
+- **View logs** (tails `docker logs -f ...`)  
+- **Copy** menu (Name, ID, IPv4, IPv6, Kind, Image)
+
+### Other
+- **Add Lab to Workspace**: adds the lab’s folder to the current VS Code workspace  
+- **Open Folder in New Window**: opens a separate VS Code window rooted at the lab’s folder  
+
+All these commands are accessible via:
+- **Context menus** on labs/containers (in the _Containerlab Explorer_)
+- **Editor title** (top-right) when editing a `.clab.(yml|yaml)`
+- **Command Palette** (`Ctrl+Shift+P` or `Cmd+Shift+P`, then type “Containerlab:”)
+
+## Extension Settings
+
+You can customize the following settings under `containerlab.*`:
 
-- **Deploy** / **Deploy (cleanup)**  
-- **Destroy** / **Destroy (cleanup)**  
-- **Redeploy** / **Redeploy (cleanup)**  
-- **Deploy lab file** (pick a file from the file‐open dialog)  
-- **Attach shell**, **SSH**, **View logs** for individual containers  
-- **Graph** in either local web mode or draw.io mode  
-
-These commands are available via:
-- **Context menus** on labs and containers
-- **Editor Title** actions (when editing a `*.clab.yml` or `*.clab.yaml` file)
-- **Command Palette** (`F1` or `Ctrl+Shift+P` / `Cmd+Shift+P`)
+- **`containerlab.defaultSshUser`** (string)  
+  Default SSH user for the **SSH** command (e.g. `"admin"`).
+- **`containerlab.sudoEnabledByDefault`** (boolean)  
+  Whether to prepend `sudo` to containerlab commands. Default: `true`.
+- **`containerlab.refreshInterval`** (number)  
+  How often (in ms) the Containerlab Explorer refreshes. Default: `10000`.
+- **`containerlab.node.execCommandMapping`** (object)  
+  Mapping of node `kind` to the exec command used by **Attach shell**.  
+  For example, if you have `"nokia_srlinux": "sr_cli"`, then `docker exec -it <container> sr_cli` is used.
 
 ---
 

package.json

@@ -4,7 +4,7 @@
   "displayName": "Containerlab",
   "icon": "resources/containerlab.png",
   "description": "Manages containerlab topologies in VS Code",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "engines": {
     "vscode": "^1.70.0"
   },