Django Test Manager

The ultimate tool for managing, running, and debugging Django tests in VS Code.

Features • Installation • Quick Start • Shortcuts • Configuration • Docs

Django Test Manager brings a powerful, native-feeling test runner to your Django workflow. Discover, organize, search, run, and debug your tests with zero configuration required.

✨ Features

🔍 Smart Test Discovery

• Automatic detection of all Django test classes and methods
• Hierarchical view by app → file → class → method
• Async test support (async def test_...)
• Custom base class recognition (configure your own test base classes)

⚡ Fast Test Execution

• One-click run for individual methods, classes, files, or entire suite
• Run test at cursor - No need to navigate, just press a shortcut
• Run failed tests - Re-run only the tests that failed
• Parallel execution support with --parallel flag

🐞 Zero-Config Debugging

• Click the debug icon next to any test to start a debug session
• No launch.json required - Debug config is passed directly
• Full breakpoint support

👁️ Watch Mode

• Automatic test running when files change
• Smart detection of affected tests
• Desktop notifications on pass/fail
• Configurable debounce to avoid running tests while typing

🔄 Live Test Status (NEW!)

• Real-time status updates - See which test is currently running
• Running indicator - Animated spinner shows active test
• Progress tracking - Status bar shows 3/20 style progress
• Aborted state - Cancelled tests show distinct visual indicator
• Status icons:
  • 🕐 Pending (waiting to run)
  • 🔄 Running (currently executing)
  • ✅ Passed
  • ❌ Failed
  • ⏭️ Skipped
  • 🚫 Aborted (cancelled)

📊 Test History & Analytics (NEW!)

• Track all test runs with persistent history
• Flakiness detection - Find tests that fail intermittently
• Slowest tests report - Identify performance bottlenecks
• Pass/fail rate analytics
• Export to JSON

🧪 VS Code Native Test Explorer (NEW!)

• Integrates with VS Code's built-in Test Explorer
• Tests appear in the native Testing view (beaker icon)
• Run/Debug profiles
• Works alongside the Django Test Explorer sidebar

📝 CodeLens Integration

• "Run" and "Debug" shortcuts appear directly in your Python files
• Works in untitled files and Git diff views

⚙️ Test Profiles

• Define multiple test configurations (Fast, CI, Clean, etc.)
• Switch between profiles on the fly
• Custom arguments per profile

📦 Installation

Via VS Code Marketplace (Recommended)

1. Open VS Code
2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
3. Search for "Django Test Manager"
4. Click Install

Via Open VSX Registry

Via VSIX (Manual)

1. Download the latest .vsix from GitHub Releases
2. Run Extensions: Install from VSIX... in VS Code
3. Select the downloaded file

🚀 Quick Start

1. Open Your Django Project

Open any folder containing a Django project (must have manage.py).

2. View Your Tests

Click the Django Tests icon in the Activity Bar to see your test tree.

3. Run a Test

• Click the ▶️ Play button next to any test
• Or use keyboard shortcuts (see below)
• Or use CodeLens links in your test files

4. Enable Watch Mode (Optional)

Press Ctrl+Cmd+W (Mac) or Ctrl+Alt+W to enable Watch Mode. Tests will run automatically when you save files.

⌨️ Keyboard Shortcuts

⚙️ Configuration

Configure the extension in Settings (Cmd+, / Ctrl+,) or settings.json:

Basic Settings

Test Profiles

Default Profiles:

{
	"Default": [],
	"Fast": ["--keepdb", "--failfast", "--parallel"],
	"Clean": ["--noinput"]
}

Watch Mode Settings

Advanced Settings

📖 Documentation

For detailed documentation, see the docs folder:

• Getting Started Guide
• Watch Mode Guide
• Test History & Analytics
• Configuration Reference
• Troubleshooting

🎯 Commands

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and type "Django":

🤝 Contributing

We love contributions! Here's how to set up the project:

# Clone the repository
git clone https://github.com/viseshagarwal/django-test-manager.git
cd django-test-manager

# Install dependencies
npm install

# Compile
npm run compile

# Run the extension (F5 in VS Code)

Project Structure

django-test-manager/
├── src/
│   ├── extension.ts          # Extension entry point
│   ├── testDiscovery.ts      # Test discovery logic
│   ├── testRunner.ts         # Test execution
│   ├── testCodeLensProvider.ts # CodeLens integration
│   ├── watchMode.ts          # Watch mode manager
│   ├── testHistory.ts        # Test history & analytics
│   ├── nativeTestController.ts # VS Code native test API
│   └── ...
├── docs/                     # Documentation
├── package.json              # Extension manifest
└── README.md

📦 Release Notes

0.3.3 (Latest)

• 🔧 FIX: Status bar now shows accurate test counts (clears state before each run)
• ✨ NEW: GitHub Actions CI/CD workflows (lint, test, package, release)
• ✨ NEW: ESLint configuration for TypeScript linting
• ⚡ Improved: Added npm run lint and npm run test scripts

0.3.2

• 🔧 FIX: Status bar tooltip now shows correct statistics (Total, Success, Failed, Skipped) (#10)

0.3.1

• ✨ New: Support for loading environment variables from .env files via envFilePath configuration.
• ✨ New: Support for projectRoot configuration to specify custom project root path.
• ✨ New: Support for absolute paths and variable substitution (${workspaceFolder}) in managePyPath and envFilePath.
• 🔧 FIX: Module not found errors when project root differs from workspace root (#3, #8)

0.3.0

• ✨ NEW: Live Test Status - Real-time running/aborted indicators
• ✨ NEW: Watch Mode - Auto-run tests on file changes
• ✨ NEW: Test History & Analytics dashboard
• ✨ NEW: VS Code Native Test Explorer integration
• ✨ NEW: Run/Debug Test at Cursor commands
• ✨ NEW: Keyboard shortcuts for all commands
• 🔧 FIX: Debug no longer modifies launch.json (PR #6)
• ⚡ Improved: Performance optimizations with caching
• ⚡ Improved: Better test class detection

0.2.2

• Added full support for Async Tests (async def)
• Improved status bar performance with smart debouncing
• Added Test Profiles support
• Tree view now respects your Active File Icon Theme
• CodeLenses now appear in new/untitled files and Git Diff views

0.2.0 - 0.2.1

• Added Configuration Panel and Search
• Improved argument handling and performance

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.