@tspec/cli

Command-line interface for running TSpec tests

ℹ️ Important Note

Provides the tspec command for discovering and running your test files.

The CLI automatically includes @tspec/core as a dependency. For full functionality, you'll also want @tspec/assert for assertions.

📖 View complete documentation and examples →

Installation

1npm install --save-dev @tspec/cli

Features

• Zero-config test runner with intelligent defaults
• Automatic TypeScript compilation with tsx
• Flexible CLI options for different workflows
• CI/CD integration with proper exit codes

Usage

1# Run all tests
2npx tspec
3
4# Run with verbose output
5npx tspec --verbose
6
7# Run specific test files
8npx tspec tests/unit.tspec.ts
9
10# Global installation
11npm install -g @tspec/cli
12tspec

Complete Testing Example

First, create a test file example.tspec.ts:

1import { describe, test } from '@tspec/core';
2import { expect } from '@tspec/assert';
3
4describe('Math Operations', () => {
5  test('addition works correctly', () => {
6    expect(2 + 2).toBe(4);
7  });
8});

Then run with the CLI:

1npx tspec example.tspec.ts

Related Packages

TSpec is designed as a cohesive framework. Here are the related packages:

• @tspec/core - Core testing framework functionality for TSpec
• @tspec/assert - Assertion library for TSpec testing framework
• @tspec/mock - Mocking and spying utilities for TSpec testing framework

Documentation & Support

• 📖 Complete Documentation - Full usage guide and API reference
• 🚀 Getting Started Guide - Step-by-step setup
• 💡 Examples - Real-world usage examples
• 🐛 Issues - Report bugs or request features

Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Setting up the development environment
• Running tests and ensuring quality
• Submitting pull requests

License

MIT License - see the LICENSE file for details.

---