Files
cline/testing-platform/README.md
T
Jose Castelli 592e1a6d49 Simple cli to trigger spec file calls against the standalone extension core (#6029)
Simple cli to trigger spec file calls against the standalone extension core #6029
2025-09-09 17:43:12 +02:00

66 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Cline Testing Platform
A CLI testing framework for the Cline Core extension, providing gRPC-based integration clients and utilities for automated scenarios.
## Overview
The platform enables end-to-end validation of Cline's core functionality through:
- **gRPC Adapters** clients for Clines gRPC services
- **Test Harness** runner, utilities, and type definitions
- **Spec Files** JSON instructions for automated test cases
## Structure
```
testing-platform/
├── adapters/ # gRPC communication adapters
│ ├── grpcAdapter.ts # Main gRPC adapter implementation
├── harness/ # Test execution framework
│ ├── runner.ts # Main test runner
│ ├── types.ts # Type definitions
│ └── utils.ts # Utility functions
```
## Prerequisites
- **Node.js** ≥ 18 and **npm** ≥ 8
- **Protocol Buffers** (used for gRPC)
Generate proto files in the **root Cline project**:
```bash
npm run protos
```
## Setup
From the root of the Cline project:
```bash
npm run install:all
npm run protos
```
Then install and build the testing platform:
```bash
cd testing-platform
npm install
npm run build
```
## Running Spec File Tests
Before running specs, make sure the standalone Cline Core gRPC server (that runs mocks and host gRPC as well) is running:
```bash
npm run test:sca-server
```
Then finally you can run the cli as:
```bash
npm run start:dev <spec-file-or-folder>
```bash