Interactive Browser Playground
To lower Gherkio's learning curve to zero, the repository includes a self-contained, browser-based Interactive Playground and Documentation Hub located under docs/book/playground/index.html.
You can use the playground to experiment with test scenarios, visualize complex execution paths, and translate legacy commands in real-time.
🚀 How to Launch the Playground
Since the playground is a static, modern vanilla web application, you can run it instantly:
- Online Sandbox: Access the hosted web workspace directly on GitHub Pages Playground.
- Open via File Manager: Double-click docs/book/playground/index.html to launch it in your default web browser offline.
- Open via Terminal:
# Linux xdg-open docs/book/playground/index.html # macOS open docs/book/playground/index.html
🛠️ Main Features
+-------------------------------------------------------------------+
| [ Read Chapters ] [ Visual DSL Stepper ] [ cURL Convert ] |
+-------------------------------------------------------------------+
```text
### 1. Visual DSL Stepper
- **What it does**: Type or edit Gherkio declarative YAML test steps on the left pane, and see a live graphical flowchart built on the right pane!
- **Interactive Cards**: Shows step-by-step HTTP methods (GET, POST, etc.), request URL routing, expected assertions, and saved context variables.
- **Timeline Connectors**: Displays step sequence borders with glowing accents.
### 2. cURL-to-YAML Step Translator
- **What it does**: Paste standard legacy cURL terminal logs (e.g., copied from Chrome Developer tools network inspector) and get back perfectly compiled Gherkio steps instantly.
- **Features**: Automatically extracts custom headers, handles multi-line request bodies, parses methods, and includes placeholder 200 expect blocks.
- **Copy Target**: Click "Copy" to drop the translated output straight into your `.gherkio/tests/` files.