WebOQL — Web-based OQL Scenario Editor

AI Cost Tracking

• 🤖 LLM usage: $0.7500 (5 commits)
• 👤 Human dev: ~$360 (3.6h @ $100/h, 30min dedup)

Generated on 2026-04-15 using openrouter/qwen/qwen3-coder-next

Web-based editor and executor for OQL (Operation Query Language) scenarios.

Features

• File Browser: Browse and select OQL scenario files from the scenarios directory
• Code Editor: Edit scenario files with syntax highlighting
• Execution: Run scenarios using OqlOS runtime in mock or real mode
• Live Preview: Real-time execution logs and status updates

Installation

Development Mode

make install

With Development Dependencies

make dev

Usage

Start the Server

make run

The editor will be available at http://localhost:8203

Production Mode

make run-prod

API Endpoints

• GET /api/v1/editor/files - List all scenario files
• GET /api/v1/editor/file/{path} - Read file content
• POST /api/v1/editor/file/{path} - Write file content
• POST /api/v1/editor/execute - Execute a scenario

Configuration

Environment variables:

• WEB_PORT - Server port (default: 8203)
• HARDWARE_MODE - Hardware mode: mock|real (default: mock)

Development

Build Distribution Packages

make build

Run Tests

make test

Clean Build Artifacts

make clean

Publishing

Publish to PyPI

make publish

Publish to Test PyPI

make publish-test

Project Structure

weboql/
├── weboql/
│   ├── __init__.py
│   ├── main.py          # FastAPI application entry point
│   └── api/
│       ├── __init__.py
│       ├── editor.py    # Editor API endpoints
│       └── static/
│           └── editor.html  # Web interface
├── pyproject.toml       # Project configuration
├── Makefile            # Build and deployment automation
└── README.md           # This file

License

Licensed under Apache-2.0.