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 ] |
+-------------------------------------------------------------------+
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.