An open API service indexing awesome lists of open source software.

https://github.com/kiwamizamurai/vscode-testrail

A VS Code extension that seamlessly integrates TestRail into your development workflow.
https://github.com/kiwamizamurai/vscode-testrail

developer-tools qa test-management testing testrail testrail-api testrail-vscode vscode-extension

Last synced: 6 days ago
JSON representation

A VS Code extension that seamlessly integrates TestRail into your development workflow.

Awesome Lists containing this project

README

        

# TestRail VSCode Extension

> [!IMPORTANT]
> If you like this project, please consider giving it [a star on GitHub](https://github.com/kiwamizamurai/vscode-testrail) or leaving [a review on the Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=kiwamizamurai-vscode.testrail-vscode&ssr=false#review-details).

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![VS Code Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/kiwamizamurai-vscode.testrail-vscode)](https://marketplace.visualstudio.com/items?itemName=kiwamizamurai-vscode.testrail-vscode)
[![VS Code Marketplace Downloads](https://img.shields.io/visual-studio-marketplace/d/kiwamizamurai-vscode.testrail-vscode)](https://marketplace.visualstudio.com/items?itemName=kiwamizamurai-vscode.testrail-vscode)
[![VS Code Marketplace Rating](https://img.shields.io/visual-studio-marketplace/r/kiwamizamurai-vscode.testrail-vscode)](https://marketplace.visualstudio.com/items?itemName=kiwamizamurai-vscode.testrail-vscode)
[![VS Code Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/kiwamizamurai-vscode.testrail-vscode)](https://marketplace.visualstudio.com/items?itemName=kiwamizamurai-vscode.testrail-vscode)

Seamlessly integrate TestRail into your VS Code workflow. View, edit, and manage test cases without leaving your IDE.

This is an open-source alternative to the [Paid extension by Railflow](https://railflow.io/testrail/vscode-extension).

logo

## ✨ Features

- 🚀 **Quick Access** - One-click access to TestRail from VS Code
- 🌳 **Tree View Integration** - Browse TestRail projects, suites, sections, and test cases in VS Code's sidebar
- ⌨️ **Unified Command Shortcuts**
- `[c]` - Create new item
- `[e]` - Edit existing item
- `[d]` - Delete item
- `[x]` - Duplicate/Close item
- `[v]` - View details
- 📋 **Test Case Management**
- View test case details with full markdown support
- Create new test cases
- Edit existing test cases
- Delete test cases
- Duplicate test cases
- 📁 **Suite Management**
- Create new test suites
- Edit existing suites
- Delete suites
- 📂 **Section Management**
- Create new sections
- Edit existing sections
- Delete sections
- 🏃 **Test Run Management**
- Create new test runs
- Edit existing runs
- Close runs
- Delete runs
- 📊 **Test Result Management**
- Add test results
- View test results history
- Manage test statuses for runs
- 🔄 **Drag and Drop Support** - Easily reorganize test cases and sections
- 💬 **Feedback System** - Submit bug reports and feature requests directly from the extension

## 🚀 Installation

1. Open VS Code
2. Press `Ctrl+P` / `Cmd+P`
3. Type `ext install testrail-vscode`

## 🔧 Setup

1. Click the TestRail icon in the activity bar
2. Click "Login" and enter your credentials:
```
Host URL: https://example.testrail.io or https://example.tmxtestrail.com
Email: [email protected]
API Key: Generate from TestRail > My Settings > API Keys
```
3. (optional) Specify the project you want to use. (If you only use a specific project, select the project. otherwise, sidebar will show all projects)

## 🛠️ Development

### Running & Debugging

1. Clone the repository

```bash
git clone https://github.com/kiwamizamurai/vscode-testrail.git
cd vscode-testrail
```

2. Install dependencies

```bash
npm install
```

3. Open in VS Code and press `F5` to start debugging

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- [TestRail API Documentation](https://support.testrail.com/hc/en-us/articles/7077083596436-Introduction-to-the-TestRail-API)
- [VS Code Webview API](https://code.visualstudio.com/api/extension-guides/webview)
- [testrail-modern-client](https://github.com/kiwamizamurai/testrail-modern-client)